Claude Code 配置与代理（2026）：国内使用、自定义 API 地址、环境变量、模型与网络设置

国内使用：指向网关，不用 VPN

# ~/.zshrc / ~/.bashrc / PowerShell 配置文件
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=你的网关密钥
claude

Claude Code 和官方 SDK 一样读取这两个变量，请求会发往网关而不是 api.anthropic.com，因此国内网络可以直连。地址填裸域名，不要带 /v1。设置后重开终端，进入会话用 /status 确认。VS Code 插件和桌面应用读取的是启动它们的那个 shell 的环境，改完配置要完全退出编辑器再从新终端启动。

什么时候需要代理

只有当你的网络连网关本身都不稳定时才需要。设置方式与其他命令行工具一致：

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

如果 /login 的 OAuth 登录超时（"timeout of 15000ms exceeded"），多半是代理或 DNS 问题；用 API 密钥登录可以完全绕过 OAuth。

模型配置

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Claude Code 按档位思考（Sonnet / Opus / Haiku），这三个变量决定每个档位对应哪个具体模型。Haiku 档位比看起来重要：Claude Code 用它做每次会话里的小任务，指向便宜的模型能省不少。网关当前提供 30 个 Claude 模型 id，/model 里都能选。

配置文件在哪

CLAUDE.md（项目根目录）— 项目记忆：构建、测试命令、约定；CLAUDE.local.md 是个人备注，不入库。
.claude/settings.json（项目）/ ~/.claude/settings.json（全局）— 权限、hooks、环境变量、statusLine。
.claude/agents/ — 子智能体定义；.claude/skills/ 与 ~/.claude/skills/ — 技能。
.mcp.json — 项目共享的 MCP 服务器配置。

配置错误的排查

404 且日志里出现 /v1/v1/messages → BASE_URL 多写了 /v1。
401 / invalid key → 密钥与地址不匹配：网关地址要配网关密钥。
登录了 Max 却按 token 扣费 → 环境里还有 ANTHROPIC_API_KEY，密钥优先于登录；不想用就 unset。
模型不存在 → 该 id 不在当前端点的 /v1/models 列表里。
settings.json 改完启动就退出 → JSON 语法错误（多了逗号），用校验工具检查。

费用

指向网关后计费也随之改变：额度按 7.69 倍面值出售，$13 得到 $100 额度；重度使用可选 $1 起的不限量套餐。详情见价格页。

先免费试一下

新账户使用优惠码 CLAUDECODE 注册即可获得 $5 的 API 余额，无需绑卡——足够跑一晚上 Claude Code。同样的 Claude 模型，两行环境变量即可切换。

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

使用优惠码 CLAUDECODE 注册

常见问题

国内能用 Claude Code 吗？

能。Claude Code 支持自定义 API 地址（ANTHROPIC_BASE_URL），指向本网关后国内网络直连，不需要 VPN，也不需要海外账号或银行卡。

Claude Code 怎么设置代理？

设置 HTTPS_PROXY / HTTP_PROXY 环境变量即可。但指向网关后大多数用户不需要代理。

ANTHROPIC_BASE_URL 要不要加 /v1？

不要。SDK 会自己拼接 /v1/messages，多加一层会得到 404。

在网关上运行 Claude Code

同样的模型，两行环境变量，积分按 7.69 倍面值充值，或选择不限量套餐。新账户使用优惠码 CLAUDECODE 可获得 $5 的 API 余额。

获取 API 密钥查看套餐

AI Prime Tech is an independent API gateway and is not affiliated with, endorsed by, or sponsored by Anthropic. “Claude” and “Claude Code” are trademarks of Anthropic. Claude Code features described here follow Anthropic’s public documentation at the time of writing and change frequently; prices and model lists on this page are read from this gateway’s live settings.

Claude Code 配置：国内怎么用、代理与 API 地址、常用环境变量

要点