Claude Code 和普通聊天客户端不太一样。它不是只在网页里回答问题，而是运行在终端里，能读取项目、执行命令、修改文件，更像一个面向开发者的 AI 编程助手。

如果你想让 Claude Code 使用第三方 API，关键点不是简单把 OpenAI 的地址粘进去，而是要确认第三方网关是否支持 Anthropic Messages API。Claude Code 发出的请求更接近 /v1/messages 这一类原生 Anthropic 接口，而不是普通 OpenAI chat/completions。

本文以 147AI 的 API接口文档 的说明为例：文档提到 Claude 模型支持原生 v1/messages 接口，具体路径和 Header 要求需要以 Claude 原生接口页面为准。Claude Code 自身的环境变量说明可参考 Anthropic 官方文档：Environment variables。

---

开始前准备

在配置前，先确认你准备好了这些东西：

• Claude Code 已安装并能在终端执行 claude
• 第三方 API 平台账户余额大于 0（本文使用的API平台为147AI）
• 已创建 Claude 相关分组的 API Key
• 已在模型广场确认 Claude 模型名称和接口端点
• 当前网络能访问第三方 API 地址

如果你还没创建 API Key，先完成系列第一篇的流程：注册、充值、创建令牌、选择分组、复制模型名。

---

先理解：Claude Code 和 OpenAI 兼容客户端有什么区别

Cursor、Chatbox、Cherry Studio 这类客户端很多时候走 OpenAI 兼容接口，常见地址是：

https://147ai.com/v1

Claude Code 则更关注 Anthropic 原生接口。也就是说，网关最好能支持类似：

/v1/messages

这就是为什么你不能把 Cursor 里的 OpenAI Base URL 原样搬到 Claude Code 里。路径拼接、Header、模型映射都可能不同。

---

第一步：准备 API Key 和模型分组

进入控制台「密钥管理」，创建一个 Claude 相关分组的令牌。创建时建议：

• 给令牌起一个容易识别的名字，比如 claude-code-dev
• 设置合理额度，避免误调用造成高消耗
• 确认分组覆盖你要用的 Claude 模型

然后打开模型广场，复制你要使用的 Claude 模型名。模型名不要手写，尤其不要把展示标题和真实模型 ID 混在一起。

---

第二步：用环境变量配置 Claude Code

在启动 Claude Code 的同一个终端里，设置这两个变量：

export ANTHROPIC_BASE_URL="https://147ai.com"
export ANTHROPIC_API_KEY="SK-替换成你的真实令牌"

两个变量分别是什么意思？

• ANTHROPIC_BASE_URL：告诉 Claude Code 把请求发到哪里。
• ANTHROPIC_API_KEY：作为 X-Api-Key 之类的鉴权凭证使用。

如果某个第三方网关明确要求 Authorization: Bearer ... 方式，Claude Code 也提供 ANTHROPIC_AUTH_TOKEN。但具体到某个平台，应以它的 Claude 原生接口页面为准，不要盲目同时设置多个认证变量。

设置后可以这样检查：

echo $ANTHROPIC_BASE_URL
echo ${ANTHROPIC_API_KEY:0:7}...

---

第三步：让配置长期生效

如果只是临时测试，直接在终端里 export 就可以。关闭终端后，这些变量会失效。

如果希望每次打开终端都自动生效，可以写入 shell 配置文件。

macOS / Linux 常见写法：

echo 'export ANTHROPIC_BASE_URL="https://147ai.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="SK-替换成你的真实令牌"' >> ~/.zshrc
source ~/.zshrc

如果你用的是 Bash，把 ~/.zshrc 换成 ~/.bashrc。

注意：这会把 Key 明文写入本机配置文件。如果是公司电脑或多人共用设备，更建议使用系统密钥管理、临时环境变量或团队统一的安全方案。

---

可选：写入 Claude Code 设置文件

Claude Code 支持在设置文件里通过 env 注入环境变量。适合团队统一配置、固定网关地址的情况。

示意写法类似：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://147ai.com",
    "ANTHROPIC_API_KEY": "SK-替换成你的真实令牌"
  }
}

具体文件路径和字段支持以 Claude Code 官方设置文档为准。个人用户如果不熟悉配置文件，先用终端 export 跑通更稳。

---

第四步：启动并做最小验证

进入一个普通项目目录：

cd your-project-folder
claude

第一次不要让它直接改代码，先发一个只读任务：

请先列出当前项目的主要目录，并说明你不会修改任何文件。

如果能正常回答，再继续测试：

读取 README，概括这个项目的启动方式。不要修改文件。

这一步的目标不是测试模型有多聪明，而是确认链路闭环：

• 请求能发出去
• Key 能通过鉴权
• 模型能返回内容
• 控制台能看到调用或扣费记录

---

推荐的使用习惯

先只读，再允许修改

Claude Code 能修改文件，所以第一次接入第三方 API 后，先让它只读项目。确认输出稳定后，再让它改一个很小的点。

例如：

先给出修改计划，列出你准备读取和修改的文件，等我确认后再动手。

每次任务前看 Git 状态

真实项目里建议先执行：

git status

如果工作区已经有你手动改过的文件，先记清楚，避免 Claude Code 后续改动和你的改动混在一起。

不要让它一次做太多事

适合 Claude Code 的任务是：

• 修一个具体 bug
• 补一个小测试
• 解释某个模块
• 重构一个小函数
• 根据报错定位问题

不适合一上来就让它“重构整个项目”。

---

常见问题与排查

Q1：启动后仍然要求官方登录

检查当前终端里是否真的有环境变量：

echo $ANTHROPIC_BASE_URL
echo ${ANTHROPIC_API_KEY:0:7}...

如果没有输出，说明变量没有进入当前会话。重新 export，或重启终端后再试。

Q2：401 或认证失败

按顺序检查：

1. Key 是否完整。
2. Key 是否来自 Claude 可用分组。
3. 余额是否大于 0。
4. 网关是否要求 ANTHROPIC_API_KEY 还是 ANTHROPIC_AUTH_TOKEN。
5. 是否设置了多个冲突的认证变量。

Q3：404 或接口不存在

重点检查 ANTHROPIC_BASE_URL。Claude Code 会自己拼接 Anthropic 相关路径，不要随意把 /v1/messages 也写进 Base URL，除非网关文档明确要求。

Q4：网关提示不支持某些 Header

Claude Code 会发送一些 Anthropic 相关 Header。部分代理如果不支持，可能报 anthropic-beta 或扩展字段错误。

可临时尝试：

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

如果这样能恢复，说明问题在网关对 beta Header 的兼容性。长期方案应回到网关配置或官方文档确认。

Q5：MCP 工具搜索不可用

Claude Code 官方文档提到，当 ANTHROPIC_BASE_URL 指向非官方主机时，MCP tool search 可能默认关闭。如果你的网关明确支持相关能力，可以按官方说明尝试：

export ENABLE_TOOL_SEARCH=true

如果只是普通代码任务，可以先不管它，优先保证基础对话和文件操作可用。

Q6：请求经常超时

可能原因有：

• 模型响应慢
• 网络代理不稳定
• 上下文太长
• 网关当前拥堵

可以先用短问题测试。如果短问题正常，长任务超时，再考虑分拆任务或调整超时变量 API_TIMEOUT_MS。

---

总结

Claude Code 接入第三方 API，最重要的是分清协议：普通 OpenAI 兼容客户端看的是 chat/completions 这类接口，而 Claude Code 更依赖 Anthropic Messages API。

新手可以按这个顺序排查：先确认令牌分组，再设置 ANTHROPIC_BASE_URL 和 Key，接着用只读问题验证，最后再进入真实代码任务。只要基础链路跑通，后面的问题大多都能归类到模型名、权限、Header 或网络超时上。