Claude Code 配置第三方 API：终端环境变量与连接验证

Claude Code 已经装好了，手里也有第三方平台的 API Key，接下来该改哪里？终端版主要需要三项信息：网关基础地址、网关密钥、模型 ID。本文以 TokenDance 为例，先在一个终端里完成配置，再验证调用。

适用于 Claude Code CLI 终端版。桌面应用和 VS Code 扩展的配置入口不同，不要直接套用本文的终端操作。配置方法依据文末官方资料整理，未进行真实付费调用实测。

1. 准备密钥和支持的模型

先按 Claude Code 官方安装说明完成安装，在终端执行：

claude --version

能看到版本号后，再去 TokenDance 的 API 密钥页 创建专用密钥，并在模型列表复制目标模型的完整 ID。模型需要支持 Anthropic Messages 协议及相应的工具能力。

初次配置建议选择平台提供且兼容的 Claude 模型。协议兼容不等于所有 Agent 功能兼容；Anthropic 的官方支持范围不包括通过网关使用非 Claude 模型。

这里的地址到 /gateway 为止，不要加 /v1 或 /chat/completions。Claude Code 使用的协议与普通聊天客户端不同。

2. 在当前终端设置连接

macOS / Linux 的 Bash、Zsh 可以使用下面的命令。输入密钥时不回显，模型占位符需要替换：

export ANTHROPIC_BASE_URL='https://tokendance.space/gateway'
printf '粘贴 TokenDance API Key，然后按回车：'
read -r -s ANTHROPIC_AUTH_TOKEN
printf '\n'
export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_MODEL='YOUR_MODEL_ID'

Windows PowerShell 可以这样设置，执行前替换两个占位符：

$env:ANTHROPIC_BASE_URL = 'https://tokendance.space/gateway'
$env:ANTHROPIC_AUTH_TOKEN = 'YOUR_API_KEY'
$env:ANTHROPIC_MODEL = 'YOUR_MODEL_ID'

这些设置对当前终端及其启动的进程生效。请在同一个终端启动 Claude Code；换一个终端窗口，需要重新配置。

如果已有其他网关的环境变量或用户配置，先检查是否冲突，尤其是旧的认证信息。不要把带真实密钥的命令、终端历史或配置文件分享出去。

3. 启动后，先检查再提问

进入你准备使用的项目目录，再运行：

claude

在 Claude Code 中输入 /status，核对网关地址与认证来源；输入 /model，确认当前选中的模型。若模型不对，可用 /model YOUR_MODEL_ID 切换，实际输入时替换占位符。

第一次先发一个小任务：

只回答问题，不读取或修改文件：用三句话解释 Git 分支适合解决什么问题。

然后打开 TokenDance 的调用日志，检查时间、模型和状态是否对应。终端有回答，加上平台有对应成功记录，才算完成本次验证。费用与 Token 用量以平台记录为准。

4. 跑通后再保存长期配置

如果不想每次设置环境变量，可以将网关配置合并到用户级 ~/.claude/settings.json（Windows 对应用户目录下的 .claude/settings.json）。已有文件请保留原来的其他字段：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokendance.space/gateway",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  },
  "model": "YOUR_MODEL_ID"
}

替换占位符后保存并重启 Claude Code。JSON 不支持注释，也不能在最后一个字段后多留逗号。密钥放在自己的用户配置中，不要提交到项目仓库。

常见问题：按现象排查

如果只是临时体验，退出 Claude Code 并关闭这个临时终端即可结束本次环境变量配置；如果已经写入用户配置文件，恢复时还需要移除或还原对应字段。

参考资料

配置核对日期：2026-09-28。模型可用性以实际账户为准。

• TokenDance：Claude Code 接入
• Claude Code：连接 LLM 网关
• Claude Code：模型配置
• Claude Code：网关支持范围