GUIDE · 通用
Claude Code 怎么接第三方 API：换 Base URL 用免费额度教程
Claude Code 默认走 Anthropic 官方 API，但支持通过环境变量换成第三方兼容接口。本文教你用 ANTHROPIC_BASE_URL 接入有免费额度的平台，零成本用 Claude Code 写代码。
- 适用对象
- 装了 Claude Code、想用免费额度代替官方 API 的人
- 预计用时
- 约 10 分钟
- 最后核实
准备
- 已安装 Claude Code（官网：claude.com/product/claude-code）
- 一个提供 Anthropic 兼容接口的 API Key（比如 OpenRouter、SiliconFlow；去平台文档里找 "Anthropic compatible" 或 "兼容 Anthropic"）
步骤
确认你的平台有 Anthropic 兼容接口
Claude Code 和 Codex 不一样：Codex 用 OpenAI 兼容接口，Claude Code 用 Anthropic 兼容接口。
- 去你的模型平台文档里搜 "Anthropic"，找到它的 Base URL（一般长这样：
https://xxx/v1，注意 Anthropic 接口不需要/v1后缀的版本各家不同，以文档为准）。 - OpenRouter 天然支持：在 OpenRouter 拿 Key 就行，它的 Anthropic 兼容端点是
https://openrouter.ai/api/v1。 - 免费模型选带
:free后缀的，比如anthropic/claude-3.5-sonnet:free（以 OpenRouter 模型页为准，免费模型会变）。
- 去你的模型平台文档里搜 "Anthropic"，找到它的 Base URL（一般长这样：
设置三个环境变量
Claude Code 认这三个环境变量（以 OpenRouter 为例）：
```bash
export ANTHROPIC_API_KEY="你的 Key"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_MODEL="anthropic/claude-3.5-sonnet:free"
```ANTHROPIC_BASE_URL：换成你的平台地址。ANTHROPIC_MODEL：换成你想用的模型名。- 建议写进
~/.bashrc或~/.zshrc，免得每次重开终端都要设。
启动验证
在终端运行
claude，随便问个简单问题（比如"1+1 等于几"）。- 能正常回答 = 接通了。
- 报 401 = Key 错了，检查
ANTHROPIC_API_KEY。 - 报 404 / 连接失败 = Base URL 错了，去平台文档核对。
- 报 429 = 触发免费额度限流，等一会儿再试。
免费额度的三个坑（和 Codex 一样）
- 模型名会变：免费模型经常上下架，定期去平台模型页确认。
- 限流：免费 tier 的 RPM/TPM 低，Claude Code 连续干活可能被限流。
- 别把 Key 写进分享的配置文件：用环境变量，配置文件里只留变量名。
注意事项
- Claude Code 也支持
~/.claude.json配置文件，但环境变量最简单，新手先用环境变量。 - 如果你同时用 Codex 和 Claude Code，注意两者环境变量不冲突（Codex 用 OPENAI 系变量，Claude Code 用 ANTHROPIC 系）。
- 本站另有《Codex 怎么用免费 API》指南，原理相通，只是接口标准不同。
常见问题
Claude Code 一定要用 Anthropic 官方 API 吗？
不用。通过 ANTHROPIC_BASE_URL 可以指向任何 Anthropic 兼容的第三方接口。
OpenAI 兼容的 Key 能给 Claude Code 用吗？
不能直接用。Claude Code 要的是 Anthropic 协议。不过很多平台（如 OpenRouter）两种协议都提供，换个 Base URL 就行。
ANTHROPIC_MODEL 不设置会怎样？
会用默认模型（通常是官方的 Claude）。用第三方时一定要设，否则可能调到不存在的模型而报错。
相关优惠
信息来源
- Claude Code 官网www.claude.com/product/claude-code
- OpenRouter 模型列表openrouter.ai/models
最后核实日期：2026-10-08 · 政策可能随时调整，请以官方页面为准