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 的命令行客户端，它依赖两个环境变量来决定"请求发给谁、用谁的身份":

默认情况下，请求都发往api.anthropic.com（国内无法直连）。一旦设置了ANTHROPIC_BASE_URL，所有请求就改发到你指定的地址。中转服务正是利用这一点：接收 Claude Code 的请求 → 转发到 Anthropic 官方服务器 → 把响应返回给你。整个过程对客户端透明，无需修改 Claude Code 本身。

所以国内配置的核心，就是改这两个环境变量。

二、前置准备

1. 安装 Node.js 和 Claude Code

Claude 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_KEY="sk-你的Key"

export ANTHROPIC_BASE_URL="https://api.highwayapi.ai/anthropic"

关闭终端后失效。

永久配置（推荐）：把变量写入 shell 配置文件。

macOS 默认使用 Zsh：

echo 'export ANTHROPIC_API_KEY="sk-你的Key"' >> ~/.zshrc

echo 'export ANTHROPIC_BASE_URL="https://api.highwayapi.ai/anthropic"' >> ~/.zshrc

source ~/.zshrc

使用 Bash 的话，把上面的~/.zshrc换成~/.bashrc即可。

配置完成后验证是否生效：

echo $ANTHROPIC_API_KEY

echo $ANTHROPIC_BASE_URL

能正确打印出你设置的值就 OK。

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 文件）

如果你希望不同项目用不同的 Key，可以在项目根目录创建.env文件：

ANTHROPIC_API_KEY=sk-你的Key

ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic

重点：防止 Key 泄露。一定要把.env加入.gitignore，避免误提交到 Git 仓库：

echo ".env" >> .gitignore

同时建议提交一份不含真实 Key 的模板文件.env.example，方便协作者了解需要哪些变量：

# .env.example

ANTHROPIC_API_KEY=your-key-here

ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic

五、启动并验证

在项目目录中启动 Claude Code：

cd /your/project

claude

看到欢迎界面后，输入一个简单问题测试连通性：

> 你好，帮我解释一下这个项目的目录结构

能收到正常回复，说明中转 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 # 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

（首次使用 direnv 需按提示在 shell 配置里加一行 hook，可参考其官方文档。）

方案二：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-dev或claude-prod就能用对应配置启动。

总结

Claude Code 国内使用的核心，其实就是配置ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL两个环境变量，把请求指向一个国内可直连、兼容 Anthropic 格式的中转地址。无论 macOS、Linux 还是 Windows，按本文步骤操作大约 10 分钟即可跑通。如果配置过程中遇到问题，欢迎在评论区交流。