Claude Code 国内配置完整指南：通过中转 API 实现稳定访问（macOS / Linux / Windows）

引言

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，代码理解和生成能力出色。但在国内直接使用时，开发者常遇到网络访问不稳定的问题。一种常见的解决方案是通过中转 API 服务接入------只需配置两个环境变量，即可让 Claude Code 把请求发往中转地址。本文以 jiekou.vip 为例，详细讲解完整的配置流程和跨平台注意事项。

一、Claude Code 与中转 API 的工作原理

在配置之前，先理解 Claude Code 的请求机制。

Claude Code 如何调用 API

Claude Code 本质上是一个调用 Anthropic API 的命令行客户端，它通过两个关键环境变量确定请求目标：

ANTHROPIC_API_KEY：身份验证 Key
ANTHROPIC_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 协议的中转地址。