Claude Code 接入第三方 API 完美教程

Claude Code 接入第三方 API 完美教程1. 背景与核心痛点在使用 Claude Code 命令行工具时如果直接配置三方代理地址 (ANTHROPIC_BASE_URL) 和秘钥 (ANTHROPIC_API_KEY)通常会遇到以下致命问题强制前缀校验Claude Code 源码会严格检查 API Key 是否以官方规定的sk-ant-开头。本地登录状态拦截即使你在交互模式Interactive Mode强行填入了不报格式错的 Key只要客户端发现本地没有经过二次登录验证在发出任何消息时它都会在底层直接拦截并抛出Not logged in · Please run /login的错误信息。2. 终极解决方案OAuth 环境变量静默穿透Claude Code 官方为了在 CI/CD (持续集成) 等无头机器环境下自动化运行其实在代码深处预留了一个具有最高认证特权的“上帝变量” ——CLAUDE_CODE_OAUTH_TOKEN。经过测试一旦暴露这个环境变量Claude 客户端将完全无视本地~/.claude是否具有登录账单。完全跳过烦人的sk-ant-格式要求。发送请求的 Header 将从x-api-key: xxx变更为Authorization: Bearer xxx。由于市面上几乎所有标准的第三方代理接口协议都天然同时支持以上两种 Auth 传参形式两者兼容得完美无缺3. 详细配置步骤步骤一配置环境变量打开终端配置文件如~/.zshrc或~/.bash_profile彻底删除或注释掉原有的ANTHROPIC_API_KEY行替换配置如下# 1. 替换为你的第三方 API 网关地址 (注意绝大多数时候只需要填到 Base URL不需要加 /v1 后缀)exportANTHROPIC_BASE_URLhttps://xxx.com# 2. 填入你的三方 API Key (必须用 OAUTH_TOKEN 变量承载达成免拦截静默穿透)exportCLAUDE_CODE_OAUTH_TOKENsk-qVPxcxxxxxxxxxxxxxxxJdzEOv0bMX编辑完成后刷新环境变量生效source~/.zshrc步骤二配置内置模型映射可选针对模型重命名代理平台如果你的代理平台要求使用的模型名字不是官方的claude-3-7-sonnet-20250219或claude-3-5-sonnet-20241022而是比如gpt-5.4、deepseek-r1为了避免 Claude Code 因无法识别该模型而崩溃我们需要使用本地配置文件将其重定向。如果不存在该文件请手动创建~/.claude/settings.json参考填入配置{env:{ANTHROPIC_BASE_URL:https://xxx.com,CLAUDE_CODE_OAUTH_TOKEN:sk-qxcxxxxxxxxxx0bMX,ANTHROPIC_CUSTOM_MODEL_OPTION:gpt-5.4,ANTHROPIC_CUSTOM_MODEL_OPTION_NAME:GPT-5.4},modelOverrides:{claude-3-7-sonnet-20250219:gpt-5.4,claude-3-5-sonnet-20241022:gpt-5.4,claude-3-5-sonnet-20240620:gpt-5.4,claude-sonnet-4-6:gpt-5.4,claude-sonnet-4-20250514:gpt-5.4}}步骤三验证与运行重新开启终端并输入claude不出意外你将跳过一切烦人的交互式前置Login引导也不会遇到任何拦截成功进入本地工具工作区畅通且完美地使用第三方 API 处理任务一定要确保环境或 [settings.json]当中没有遗留的ANTHROPIC_API_KEY否则这将会触发 Claude Code 代码里的安全防御Auth Conflict报告环境变量相互冲突并引发致命错误。