引言
Claude Code 是 Anthropic 推出的命令行 AI 编程助手，代码理解和生成能力出色。但在国内直接使用时，开发者常遇到网络访问不稳定的问题。一种常见的解决方案是通过中转 API 服务接入——只需配置两个环境变量，即可让 Claude Code 把请求发往中转地址。本文以 jiekou.vip 为例，详细讲解完整的配置流程和跨平台注意事项。
一、Claude Code 与中转 API 的工作原理
在配置之前，先理解 Claude Code 的请求机制。
Claude Code 如何调用 API
Claude Code 本质上是一个调用 Anthropic API 的命令行客户端，它通过两个关键环境变量确定请求目标：
ANTHROPIC_API_KEY：身份验证 KeyANTHROPIC_BASE_URL（可选）：API 请求的基础地址，默认为https://api.anthropic.com
当设置了ANTHROPIC_BASE_URL后，所有请求会发往该地址，而非官方默认地址。中转服务正是利用这一机制：接收来自 Claude Code 的请求，转发至 Anthropic 官方服务器，再将响应返回给客户端。理解这一点，你就能配置任意兼容的中转服务，而不局限于某一家。
中转 API 需要具备的特性
选择中转服务时，建议关注以下几点：
- 国内可直接访问：无需额外的网络代理配置
- 稳定性：企业级基础设施通常比个人自建代理更可靠
- 协议兼容：完整兼容 Anthropic 官方 API 格式，才能无缝对接 Claude Code
- 计费方式：按量计费更适合用量波动较大的个人开发者
二、前置准备
确保已完成以下准备工作。
1. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
验证安装：
claude --version
2. 获取中转服务的 API Key
以 jiekou.vip 为例：注册账户并完成邮箱验证后，登录控制台充值，在「API Keys」页面创建一个新 Key，记录下以sk-开头的字符串。注册入口：https://jiekou.vip
三、环境变量配置详解
macOS / Linux
临时配置（仅当前终端会话有效，适合测试）：
export ANTHROPIC_API_KEY="sk-你的-Key"
export ANTHROPIC_BASE_URL="https://api.highwayapi.ai/anthropic"
关闭终端后失效。
永久配置（推荐）：
Zsh（macOS 默认 shell）：
echo 'export ANTHROPIC_API_KEY="sk-你的-Key"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.highwayapi.ai/anthropic"' >> ~/.zshrc
source ~/.zshrc
Bash：
echo 'export ANTHROPIC_API_KEY="sk-你的-Key"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.highwayapi.ai/anthropic"' >> ~/.bashrc
source ~/.bashrc
验证是否生效：
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_BASE_URL
Windows
PowerShell（永久，写入用户级环境变量）：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-你的-Key", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.highwayapi.ai/anthropic", "User")
CMD：
setx ANTHROPIC_API_KEY "sk-你的-Key"
setx ANTHROPIC_BASE_URL "https://api.highwayapi.ai/anthropic"
注意：
setx设置的变量需要重新打开命令行窗口才能生效。
WSL（Windows Subsystem for Linux）：按上面 Linux 的方式配置~/.bashrc或~/.zshrc即可。
四、项目级配置（.env 文件）
如果希望按项目隔离 API 配置，可在项目根目录创建.env文件：
ANTHROPIC_API_KEY=sk-你的-Key
ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
防止 Key 泄露（重要）
把.env加入.gitignore，避免 Key 被提交到仓库：
echo ".env" >> .gitignore
再提交一份不含真实 Key 的模板.env.example供团队参考：
# .env.example
ANTHROPIC_API_KEY=your-key-here
ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
五、启动并验证
在项目目录中启动：
cd /your/project
claude
成功启动后会看到 Claude Code 的欢迎界面，输入一个简单问题验证连通性：
> 你好，帮我解释一下这个项目的目录结构
收到正常回复即表示中转 API 配置成功。
常见错误排查
Authentication failed/Invalid API Key
- 检查
ANTHROPIC_API_KEY是否完整复制，首尾不要有空格 - 确认中转服务账户余额充足
Connection refused/Network error
- 检查
ANTHROPIC_BASE_URL是否正确，注意是https而非http - 确认地址无拼写错误
环境变量不生效
- 确认执行了
source ~/.zshrc（或重开终端 / 重开命令行窗口） - 用
echo $ANTHROPIC_API_KEY验证变量值
六、进阶：多环境配置管理
同时维护多个项目或需要在不同环境间切换时，可参考以下方案。
用 direnv 按目录自动切换
# 安装
brew install direnv # macOS
sudo apt install direnv # Ubuntu
# 在项目目录创建 .envrc
echo 'export ANTHROPIC_API_KEY="sk-项目专属Key"' > .envrc
echo 'export ANTHROPIC_BASE_URL="https://api.highwayapi.ai/anthropic"' >> .envrc
direnv allow
进入目录时会自动加载对应配置，离开时自动卸载。
用 shell 别名快速切换
# 在 ~/.zshrc 中添加
alias claude-dev='ANTHROPIC_API_KEY="sk-dev-key" ANTHROPIC_BASE_URL="https://api.highwayapi.ai/anthropic" claude'
alias claude-prod='ANTHROPIC_API_KEY="sk-prod-key" ANTHROPIC_BASE_URL="https://api.highwayapi.ai/anthropic" claude'
总结
Claude Code 接入中转 API 的核心，只需配置ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL两个环境变量。理解了背后的请求转发机制，无论 macOS、Linux 还是 Windows，都能在 10 分钟内完成配置。本文以 jiekou.vip 为示例，你也可以替换为任意兼容 Anthropic 协议的中转地址。
