当前位置： 首页 > news >正文

Claude Code 怎么配置自定义 API 地址？5 步完整教程

news 2026/5/1 10:25:39

View Post

Claude Code 怎么配置自定义 API 地址？5 步完整教程

最近在用 Claude Code 写代码，官方 API 用着挺好，但成本有点高。想着能不能配置自己的 API 地址，折腾了半天终于搞定了，记录一下完整步骤。

为什么要配置自定义 API

用 Claude Code 官方 API 有几个痛点：

  • 按月订阅，不用也要扣费
  • 高频使用时容易触发限流
  • 团队多人用成本叠加

如果能配置自己的 API Key，按量计费会更灵活。Claude Code 其实支持自定义 API 地址，只是藏得比较深。

前置条件

开始之前需要准备：

  • Claude Code 桌面版或 VS Code 插件（版本 ≥ 1.5.0）
  • 一个兼容 Anthropic API 协议的 API Key
  • 基本的 JSON 配置文件编辑能力

步骤一：找到配置文件位置

Claude Code 的配置文件路径因系统而异：

macOS：

~/.claude/settings.json

Windows：

C:\Users\你的用户名\.claude\settings.json

Linux：

~/.claude/settings.json

如果文件不存在，手动创建一个空的 settings.json 文件。

步骤二：编辑配置文件

打开 settings.json，添加以下配置：

{"apiKey": "sk-ant-your-api-key-here","apiBaseUrl": "https://api.anthropic.com/v1"
}

把 apiKey 替换成你自己的 Key，apiBaseUrl 替换成你要用的 API 地址。

ofox.ai 聚合平台配置示例

如果你用的是聚合平台，配置会更简单。

ofox.ai 是一个 AI 模型聚合平台，一个 API Key 可以调用 Claude Opus 4.6、GPT-4o、Gemini、DeepSeek 等 50+ 模型，兼容 Anthropic SDK 协议，低延迟直连，支持支付宝按量计费。

配置示例：

{"apiKey": "sk-your-ofox-key","apiBaseUrl": "https://api.ofox.ai/v1"
}

多供应商冗余备份，某一路挂了自动切换，成功率 99.2%。我用了一个月，基本没遇到过服务不可用的情况。

步骤三：重启 Claude Code

配置文件保存后，必须完全退出 Claude Code 再重新打开，配置才会生效。

注意：

  • macOS 用户要在 Dock 右键点击「退出」，不是直接关窗口
  • Windows 用户要在任务栏托盘右键退出
  • VS Code 插件需要重新加载窗口（Cmd/Ctrl + Shift + P → Reload Window）

步骤四：验证配置是否生效

重启后，随便问 Claude Code 一个问题，比如：

帮我写一个 Python 的快速排序

如果正常返回结果，说明配置成功。

如果报错，检查以下几点：

  • API Key 是否正确（注意前后有没有多余空格）
  • apiBaseUrl 末尾不要加斜杠 /
  • JSON 格式是否正确（逗号、引号不能错）

步骤五：检查 API 调用日志

想确认是不是真的在用自己的 API，可以查看调用日志。

大部分 API 平台都有使用记录，去后台看一下最近的调用时间和次数，和你使用 Claude Code 的时间对得上就没问题。

常见问题 & 踩坑记录

1. 配置后还是用的官方 API

现象：改了配置文件，但后台没有调用记录。

原因：Claude Code 有配置缓存，改完配置没有完全退出重启。

解决方法：

  • macOS：Activity Monitor 里搜索 Claude，强制退出所有相关进程
  • Windows：任务管理器里结束 Claude Code 进程
  • 删除缓存文件：~/.claude/cache/ 目录下的所有文件

2. 报错：Invalid API key format

现象：启动后提示 API Key 格式错误。

原因：

  • API Key 前后有空格或换行符
  • 用了错误的 Key 格式（比如把 OpenAI 的 Key 填进去了）

解决方法：

  • 重新复制 API Key，确保没有多余字符
  • 检查 Key 前缀是否正确（Anthropic 官方是 sk-ant-，聚合平台可能是 sk- 开头）

3. 报错：Connection timeout

现象：请求一直转圈，最后超时。

原因：

  • API 地址填错了（比如多了 /v1/messages）
  • 网络环境访问受限

解决方法：

  • apiBaseUrl 只填到 /v1，不要加具体的 endpoint
  • 检查网络环境配置，确保能访问 API 地址
  • 用 curl 测试一下 API 是否可达：
curl https://api.ofox.ai/v1/models \-H "x-api-key: sk-your-key"

4. 报错：Model not found

现象：提示找不到模型 claude-sonnet-4-6。

原因：你用的 API 平台不支持这个模型，或者模型名称不一样。

解决方法：

  • 去 API 平台后台查看支持的模型列表
  • 在配置文件里指定模型名称：
{"apiKey": "sk-your-key","apiBaseUrl": "https://api.ofox.ai/v1","model": "claude-sonnet-4-6"
}

进阶配置

设置请求超时时间

默认超时是 60 秒，如果你的 API 响应比较慢，可以调大：

{"apiKey": "sk-your-key","apiBaseUrl": "https://api.ofox.ai/v1","timeout": 120000
}

单位是毫秒，120000 = 120 秒。

配置代理

如果需要通过代理访问 API：

{"apiKey": "sk-your-key","apiBaseUrl": "https://api.ofox.ai/v1","proxy": "http://127.0.0.1:7890"
}

多账号切换

Claude Code 暂时不支持多账号配置，如果要切换账号，只能手动改配置文件。

我的做法是准备两个配置文件：

  • settings-personal.json（个人账号）
  • settings-work.json（工作账号）

需要切换时，复制对应的文件覆盖 settings.json，然后重启 Claude Code。

成本对比

配置自己的 API 后，成本能降多少？我实测了一下：

方案 月费用 适合场景
Claude Code 官方订阅 $20/月 轻度使用，不想折腾
Anthropic 官方 API 按量计费 重度使用，需要稳定性
聚合平台（如 ofox.ai） 按量计费 多模型切换，成本敏感

我自己一个月大概用 500 万 tokens（写代码 + 改 bug），用聚合平台的话成本在 $8 左右，比订阅便宜 60%。

总结

配置 Claude Code 自定义 API 地址其实不难，核心就是改 ~/.claude/settings.json 文件，然后完全退出重启。

踩坑点主要是：

  1. 改完配置没有完全退出重启
  2. apiBaseUrl 格式不对（多了斜杠或 endpoint）
  3. API Key 前后有多余空格

配置成功后，按量计费会比订阅灵活很多，特别是团队多人使用的场景。

如果你也在用 Claude Code，可以试试这个方法，有问题欢迎留言交流。