Claude Code 怎么配置自定义 API 地址？2026 最完整的 3 种方案实测

上周五晚上我正用 Claude Code 重构一个老项目的后端接口写到一半突然开始疯狂报401 Unauthorized。一看账户余额——没了。充值页面又打不开卡在支付环节转圈圈。当时项目第二天要交我差点原地爆炸。折腾到凌晨两点我把 Claude Code 的 API 地址换成了第三方聚合接口后面写代码丝滑得不行。核心操作就两个字段环境变量ANTHROPIC_BASE_URL或配置文件~/.claude/settings.json覆盖掉默认端点全程不到 5 分钟不需要改任何代码逻辑。踩过的坑和跑通的 3 种方案都在下面直接抄作业就行。先说结论方案适用场景配置难度是否持久化推荐指数环境变量ANTHROPIC_BASE_URL临时切换、CI/CD⭐否当次会话⭐⭐⭐⭐settings.json配置文件日常开发、长期使用⭐⭐是⭐⭐⭐⭐⭐Shell 别名封装多环境切换⭐⭐⭐是⭐⭐⭐三种方案都实测过日常开发最推荐方案二改一次配置文件后面就不用管了。环境准备开始之前确认这几个东西Claude Code CLI 已安装npm install -g anthropic-ai/claude-code当前最新版 1.xNode.js 18Claude Code 依赖一个可用的 API Key官方的或第三方聚合平台的都行确认安装没问题claude--version# 输出类似 claude-code/1.x.x方案一环境变量直接覆盖最快最简单粗暴的方式一行命令搞定# 设置自定义 API 地址exportANTHROPIC_BASE_URLhttps://api.ofox.ai/v1exportANTHROPIC_API_KEYyour-api-key-here# 然后正常启动 Claude Codeclaude进入 Claude Code 交互界面后它会自动读取这两个环境变量所有请求都走你指定的地址。验证是否生效在 Claude Code 里随便输入 帮我写一个 Python 的 hello world正常返回代码就说明配置成功。注意这种方式只对当前终端会话有效关掉终端就失效了。想每次打开终端都生效写进~/.bashrc或~/.zshrc# 追加到 ~/.zshrcmacOS 默认 zshechoexport ANTHROPIC_BASE_URLhttps://api.ofox.ai/v1~/.zshrcechoexport ANTHROPIC_API_KEYyour-api-key-here~/.zshrcsource~/.zshrc方案二配置文件持久化最推荐Claude Code 支持通过settings.json管理各种参数包括 API 端点。我目前在用的方案改一次就完事了。第一步找到或创建配置文件mkdir-p~/.claudetouch~/.claude/settings.json第二步编辑配置文件{apiBaseUrl:https://api.ofox.ai/v1,apiKey:your-api-key-here,model:claude-sonnet-4-20250514,permissions:{allow:[Read,Write,Bash]},preferences:{verbose:false,autoApprove:false}}第三步重启 Claude Code 验证claude进去之后随便问个问题看响应是否正常。想确认请求确实走了自定义地址开启 verbose 模式claude--verbose终端会打印出实际请求的 URL清楚看到请求发到了哪里。读取 settings.json自定义地址默认地址Claude Code CLIapiBaseUrl聚合 API 网关Claude Opus 4.6Claude Sonnet 4.6其他模型api.anthropic.commodel字段可以指定默认使用的模型。聚合平台通常支持多个 Claude 版本比如claude-opus-4-20250514、claude-sonnet-4-20250514按需填写。方案三Shell 别名封装多环境切换有时候用官方 API有时候用聚合平台需要快速切换的话用 Shell 别名# 追加到 ~/.zshrc# 官方 APIaliasclaude-officialANTHROPIC_BASE_URLhttps://api.anthropic.com ANTHROPIC_API_KEYsk-ant-xxx claude# 聚合平台aliasclaude-aggANTHROPIC_BASE_URLhttps://api.ofox.ai/v1 ANTHROPIC_API_KEYyour-ofox-key claude# 默认用聚合平台延迟更低aliasccclaude-aggsource~/.zshrc# 用聚合平台cc# 用官方claude-official不同场景一个命令切换不用反复改配置文件。踩坑记录几个我实际踩过的坑帮你少走弯路。坑 1base_url 末尾的斜杠问题这个坑很隐蔽。有些 API 端点对末尾的/敏感# ❌ 可能报错exportANTHROPIC_BASE_URLhttps://api.ofox.ai/v1/# ✅ 正确exportANTHROPIC_BASE_URLhttps://api.ofox.ai/v1多一个斜杠请求路径会变成https://api.ofox.ai/v1//v1/messages直接 404。我在这上面浪费了半小时一直以为是 Key 的问题。坑 2环境变量优先级Claude Code 读取配置的优先级命令行参数 环境变量 settings.json 默认值settings.json里配了地址 A但环境变量设了地址 B最终走地址 B。我之前配置文件改了半天不生效就是因为.zshrc里还残留着一个旧的环境变量。排查方法# 检查是否有残留的环境变量echo$ANTHROPIC_BASE_URLecho$ANTHROPIC_API_KEY# 清除unsetANTHROPIC_BASE_URLunsetANTHROPIC_API_KEY坑 3协议兼容性Claude Code 默认走 Anthropic 原生协议/v1/messages不是 OpenAI 的/v1/chat/completions。所以选的第三方服务必须兼容 Anthropic 协议随便找个 OpenAI 兼容的中转是不够的。ofox.ai 同时兼容 OpenAI、Anthropic、Gemini 三大 API 协议一个 Key 可以调用 GPT-5、Claude Opus 4.6、Gemini 3 等 50 模型所以 Claude Code 直接改 base_url 就能用不需要额外的协议转换。坑 4权限配置导致的假性失败有时候 API 调用成功了但 Claude Code 执行代码时报权限错误这不是 API 的问题是本地权限没开{permissions:{allow:[Read,Write,Bash]}}或者启动时加--dangerously-skip-permissions仅限本地开发别在生产环境用。配合 Skills 使用配置好自定义 API 之后Skills 完全不受影响——Skills 本质上是 prompt 模板 工具链定义跟 API 端点没关系。我现在的工作流读取 settings.json代码生成代码审查重构启动 Claude Code连接聚合 API选择任务加载对应 Skill加载 Review Skill加载 Refactor Skill调用 Claude Sonnet 4.6返回结果到终端Skills 配置放在项目根目录的.claude/skills/下面跟 API 配置互不干扰。小结三种方案各有适用场景赶时间 / CI 环境环境变量一行搞定日常开发settings.json一劳永逸多环境切换Shell 别名灵活方便我个人现在用方案二 方案三的组合——settings.json配好默认的聚合平台地址再用claude-official别名在需要直连官方时切换。Claude Code 的配置灵活度还是不错的比 Cursor 那套 Settings 界面透明得多至少你能看到请求到底发到了哪里。就是文档写得太散很多配置项要翻 GitHub issue 才能找到希望 Anthropic 后面能补全。有问题评论区聊踩到新坑我会更新上来。