工具教程

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

使用 NexoX 为 Claude Code 添加 API 供应商,配置服务地址、认证和模型,了解 Anthropic 协议、切换验证及常见连接问题。

NexoX 文档更新于
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 中切换到对应工具。

资料来源

浏览资源中心