工具教程连接配置

Claude Code 配置与供应商切换教程

Claude Code

开始之前

在 NexoX 中选择 Claude Code,添加供应商并填写 API 地址、密钥与模型,再点击启用。原生 Anthropic Messages 供应商可以直接连接;使用其他协议时,需要匹配的本地路由转换。启用后用新的请求验证连接。

适用范围
NexoX 桌面客户端的供应商配置流程;具体字段以已安装版本为准。

开始前需要准备什么?

先安装 Claude Code 和 NexoX,确认 Claude Code 能在你的终端中启动。NexoX 管理供应商配置,实际编码与对话由 Claude Code 完成。

向供应商确认 API 地址、认证方式、可用模型,以及是否原生支持 Anthropic Messages。只有 OpenAI 兼容接口并不代表它可以直接用于 Claude Code。

如何添加 Claude Code 供应商?

优先选择与供应商对应的预设;没有适合的预设时,再创建自定义连接。API 地址以供应商文档为准,不要凭经验添加或删除路径。

  1. 在 NexoX 中选择 Claude Code,点击右上角的添加按钮。
  2. 选择预设或自定义供应商,并填写便于辨认的名称。
  3. 填写 API 地址和自己的 API Key,按供应商要求选择认证方式。
  4. 填写供应商提供的模型 ID,确认上游协议,然后保存。
如何添加 Claude Code 供应商?
配置项填写依据
API 地址供应商提供的 Anthropic 兼容服务地址,保留其指定路径。
API Key / Auth Token使用供应商要求的认证方式,避免同时设置冲突的凭据。
模型供应商实际提供的模型 ID,不能仅填写产品宣传名称。
上游协议原生 Anthropic Messages 可直连;其他协议按预设要求配置路由转换。

启用后如何确认配置生效?

在供应商卡片上点击启用,确认客户端显示该供应商已启用。常规配置写入 Claude Code 的 settings.json;如果你自定义了配置目录,应以 NexoX 的目录设置为准。

在 Claude Code 中发起新的简短请求,确认模型与响应正常。如当前会话仍使用旧配置,重新启动 Claude Code 再验证。

下面是字段示意,不是需要手工覆盖的配置文件。使用 NexoX 时由客户端管理这些字段,示例中的地址和密钥必须替换为供应商提供的信息。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.example.com",
    "ANTHROPIC_API_KEY": "YOUR_API_KEY"
  }
}

连接失败时先检查哪些地方?

先记录错误码与实际启用的供应商,再按下表排查。配置文件变更成功和供应商能够正常响应是两个不同的检查点。

连接失败时先检查哪些地方?
现象优先检查
401 / 403密钥是否有效、认证方式是否正确,以及账号是否有对应模型权限。
404 / 协议不匹配服务地址是否正确、是否支持 Anthropic Messages,或是否需要路由转换。
模型不存在模型 ID 是否与供应商文档一致,以及预设是否需要更新。
仍使用旧供应商当前启用卡片、配置目录,以及终端或项目中的环境变量是否覆盖了配置。
请求超时 / 429网络可达性、供应商状态、限流和可用额度。

常见问题

Claude Code 一定要开启 NexoX 本地路由吗?

不一定。供应商原生支持 Anthropic Messages 时可以直接连接。供应商使用其他协议时,需按对应预设配置本地路由转换。

Claude Code 与 Claude Desktop 使用同一套配置吗?

不是。它们是不同的工具,配置机制不同。这篇教程针对 Claude Code;配置 Claude Desktop 时,应在 NexoX 中切换到对应工具。

资料来源

  1. Claude Code 官方配置文档
继续阅读

相关内容

查看全部
故障排查

Claude Code 配置第三方 API 后出现 404 或协议错误

优先核对服务地址和 Anthropic Messages 兼容性。地址路径与请求协议都应以供应商文档和实际返回为依据。

阅读全文
故障排查

Claude Code 返回 401 或 403,应该检查什么?

检查密钥有效性、认证方式、模型权限和供应商状态。错误码可以缩小范围,但不能单凭 401 或 403 断定具体原因。

阅读全文