Claude Code 中转怎么配置：环境变量教程

配置之前要准备什么？

• 电脑上已经装好 Claude Code（按 Anthropic 官方安装说明装，装完终端里能运行 claude）。
• MaCloud AI 账号：注册登录 后在控制台充值，人民币标价、人民币付款，最低 ¥19。验证过邮箱的新用户第一次进控制台会送一点试用额度，可以先用它试通。
• 一个 API Key：控制台的 API Key 页面创建，建议起个名字，比如“MacBook Claude Code”。
• 模型名：去 模型页 复制 Claude 模型的名字，原样填，不要自己改大小写或加前缀。

创建 Key 的位置：控制台左侧菜单 API Key → 右上角 创建 Key → 填名字 → 复制以 sk- 开头的那串。Key 只在创建时完整显示一次，先存到密码管理器里。

配置步骤（最快的方法）

1. 在控制台 API Key 页面创建一个 Key 并复制。
2. 在 模型页 复制一个 Claude 模型名。
3. 把 ANTHROPIC_BASE_URL 设为 https://api.macloudai.com，注意结尾不要加 /v1。
4. 把 ANTHROPIC_AUTH_TOKEN 设为刚才的 Key，把 ANTHROPIC_MODEL 设为模型名。
5. 打开一个新终端，进入项目目录运行 claude，发一句“你好”测试。
6. 去控制台 用量 页面确认这次调用已经记上了 token 和费用。

macOS / Linux 怎么设环境变量？

临时生效（只对当前终端窗口有效），适合先试通：

export ANTHROPIC_BASE_URL=https://api.macloudai.com
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=hk-5-5
claude

长期生效：把三行 export 加到 shell 配置文件末尾。macOS 默认是 zsh，写进 ~/.zshrc；大部分 Linux 是 bash，写进 ~/.bashrc。

cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.macloudai.com
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=hk-5-5
EOF
source ~/.zshrc
echo $ANTHROPIC_BASE_URL

最后一行能打印出 https://api.macloudai.com 就说明变量已经生效。用 bash 的把 ~/.zshrc 换成 ~/.bashrc。

Windows 怎么设？

$env:ANTHROPIC_BASE_URL="https://api.macloudai.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-..."
$env:ANTHROPIC_MODEL="hk-5-5"
claude

setx ANTHROPIC_BASE_URL "https://api.macloudai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
setx ANTHROPIC_MODEL "hk-5-5"
# 关掉 PowerShell 再重新打开才会生效

set ANTHROPIC_BASE_URL=https://api.macloudai.com
set ANTHROPIC_AUTH_TOKEN=sk-...
set ANTHROPIC_MODEL=hk-5-5
claude

setx 只对之后新开的窗口生效，当前窗口不会变。VS Code、Cursor 里的内置终端也要把整个编辑器关掉重开，否则读到的还是旧变量。在 WSL 里用 Claude Code 的，按 Linux 的写法写进 WSL 的 ~/.bashrc，Windows 那边的变量 WSL 读不到。

用 settings.json 配置（推荐）

不想动 shell 配置，或者一台电脑要在多个终端、IDE 里用，可以把变量写进 Claude Code 自己的配置文件 ~/.claude/settings.json 的 env 字段。Claude Code 每次启动都会读它，不受终端类型影响。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.macloudai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "hk-5-5"
  }
}

文件位置：macOS / Linux 是 ~/.claude/settings.json，Windows 是 %USERPROFILE%\.claude\settings.json。文件已经存在的话，只把 env 这一段合并进去，别覆盖掉原来的其他设置。JSON 里最后一项后面不能有逗号，写错了 Claude Code 会忽略整个文件。

项目目录里也可以放 .claude/settings.json，但那个文件常常会提交到 git。Key 只写在家目录这份里，别写进项目里，更别推到 GitHub。

怎么确认已经走中转了？

• 在 Claude Code 里输入 /status，看 API 地址是不是 https://api.macloudai.com、模型是不是你填的那个。
• 随便问一句，然后打开控制台 用量：最近 50 次调用里能看到这次的模型名、输入 / 输出 token 和费用。
• 如果报 401、403、404，对照 Claude Code 报错排查 一条条查，大多数是 Key 复制少了字符、地址多写了 /v1 或者模型名不对。

怎么让 Claude Code 少花 token？

Claude Code 是“代理式”工具：每一步都会把文件内容、命令输出和整段对话历史一起发给模型，所以输入 token 远比你打的字多。几条习惯能明显省钱：

• 换任务就 /clear 开新对话，别让上一个任务的历史一直跟着发。
• 对话太长时用 /compact 压缩历史。
• 在项目根目录写一份简短的 CLAUDE.md，说清项目结构和规矩，省得它每次到处翻文件。
• 用 .gitignore 或明确的指令让它别去读 node_modules、构建产物、大日志文件。
• 简单的活（改文案、写注释、格式化）换便宜一点的模型，难的再用大模型。各模型价格见下表。

现在的真实价格

按模型页上的价格估算：每次对话 2,000 个输入 token、500 个输出 token。实际扣费以控制台为准。

算账方法见 token 怎么算钱，更多接入方式见 接入文档。

常见问题

更多指南

• Claude Code 报错排查：401 / 403 / 404 / 429
• Cursor 自定义 API 配置：接 Claude 和 GPT
• VS Code Cline 接 Claude API 中转配置
• 海外怎么稳定用 Claude API：中转 vs 官方
• Claude、GPT、Gemini、DeepSeek 怎么选
• token 怎么算钱：API 计费公式和省钱方法