Claude Code 国内配置指南：通过中转 API 实现免代理直连

前言Claude Code 是 Anthropic 推出的命令行 AI 编程工具支持在终端里直接读代码、改代码、跑命令是不少开发者日常提效的工具之一。但在国内直接使用会遇到网络访问问题。本文介绍一种常见的解决思路——通过中转 API 地址配置让 Claude Code 在国内网络环境下正常工作。全文以环境变量配置为核心涵盖 macOS、Linux、Windows 三端按步骤操作大约 10 分钟即可完成。本文以 jiekou.vip 中转服务为例说明配置方法配置原理对其他兼容 Anthropic 格式的中转服务同样适用。一、原理Claude Code 是怎么找到 API 的在动手之前先理解 Claude Code 的请求机制后面的配置就很好懂了。Claude Code 本质上是一个调用 Anthropic API 的命令行客户端它依赖两个环境变量来决定请求发给谁、用谁的身份:环境变量作用默认值ANTHROPIC_API_KEY身份验证 Key无ANTHROPIC_BASE_URLAPI 请求的基础地址https://api.anthropic.com默认情况下请求都发往api.anthropic.com国内无法直连。一旦设置了ANTHROPIC_BASE_URL所有请求就改发到你指定的地址。中转服务正是利用这一点接收 Claude Code 的请求 → 转发到 Anthropic 官方服务器 → 把响应返回给你。整个过程对客户端透明无需修改 Claude Code 本身。所以国内配置的核心就是改这两个环境变量。二、前置准备1. 安装 Node.js 和 Claude CodeClaude Code 依赖 Node.js建议 18 及以上版本通过 npm 全局安装npm install -g anthropic-ai/claude-code验证安装是否成功claude --version能正常打印版本号即安装完成。2. 获取中转服务的 API Key注册并登录中转服务控制台在 API Key 管理页面创建一个新 Key记录下以sk-开头的字符串。同时确认账户余额可用。Key 等同于账户凭证请妥善保管不要提交到代码仓库或公开分享。三、环境变量配置核心步骤macOS / Linux临时配置仅当前终端窗口有效适合先测一下export ANTHROPIC_API_KEYsk-你的Keyexport ANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropic关闭终端后失效。永久配置推荐把变量写入 shell 配置文件。macOS 默认使用 Zshecho export ANTHROPIC_API_KEYsk-你的Key ~/.zshrcecho export ANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropic ~/.zshrcsource ~/.zshrc使用 Bash 的话把上面的~/.zshrc换成~/.bashrc即可。配置完成后验证是否生效echo $ANTHROPIC_API_KEYecho $ANTHROPIC_BASE_URL能正确打印出你设置的值就 OK。WindowsPowerShell永久写入用户级环境变量[System.Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY, sk-你的Key, User)[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://api.highwayapi.ai/anthropic, User)CMDsetx ANTHROPIC_API_KEY sk-你的Keysetx ANTHROPIC_BASE_URL https://api.highwayapi.ai/anthropic注意setx设置的变量不会对当前窗口生效需重新打开命令行窗口。WSL适用于 Windows Subsystem for Linux按上面 Linux 的方式配置~/.bashrc或~/.zshrc即可。四、项目级配置.env 文件如果你希望不同项目用不同的 Key可以在项目根目录创建.env文件ANTHROPIC_API_KEYsk-你的KeyANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropic重点防止 Key 泄露。一定要把.env加入.gitignore避免误提交到 Git 仓库echo .env .gitignore同时建议提交一份不含真实 Key 的模板文件.env.example方便协作者了解需要哪些变量# .env.exampleANTHROPIC_API_KEYyour-key-hereANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropic五、启动并验证在项目目录中启动 Claude Codecd /your/projectclaude看到欢迎界面后输入一个简单问题测试连通性 你好帮我解释一下这个项目的目录结构能收到正常回复说明中转 API 配置成功。常见错误排查Authentication failed/Invalid API Key认证失败检查ANTHROPIC_API_KEY是否完整复制首尾不要有多余空格确认账户余额充足、Key 未被禁用Connection refused/Network error连接失败检查ANTHROPIC_BASE_URL是否为https://api.highwayapi.ai/anthropic确认是https而非http且无拼写错误环境变量不生效确认执行了source ~/.zshrc或重开终端 / Windows 重开命令行窗口用echo $ANTHROPIC_API_KEY确认变量值已写入六、进阶多环境配置管理同时维护多个项目、需要在不同 Key 之间切换时可以用下面两种方案。方案一direnv 按目录自动切换direnv能在进入目录时自动加载该目录的.envrc配置离开时自动卸载# 安装brew install direnv # macOSsudo apt install direnv # Ubuntu# 在项目目录创建 .envrcecho export ANTHROPIC_API_KEYsk-项目专属Key .envrcecho export ANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropic .envrcdirenv allow首次使用 direnv 需按提示在 shell 配置里加一行 hook可参考其官方文档。方案二shell 别名快速切换在~/.zshrc里为不同环境定义别名alias claude-devANTHROPIC_API_KEYsk-dev-key ANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropic claudealias claude-prodANTHROPIC_API_KEYsk-prod-key ANTHROPIC_BASE_URLhttps://api.highwayapi.ai/anthropic claude之后直接claude-dev或claude-prod就能用对应配置启动。总结Claude Code 国内使用的核心其实就是配置ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL两个环境变量把请求指向一个国内可直连、兼容 Anthropic 格式的中转地址。无论 macOS、Linux 还是 Windows按本文步骤操作大约 10 分钟即可跑通。如果配置过程中遇到问题欢迎在评论区交流。