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

> 面向 Claude Code CLI，说明 ANTHROPIC\_BASE\_URL、网关密钥、模型 ID 和 settings.json 配置，附 macOS、Linux、PowerShell 示例。以 TokenDance 为例。

- 原文：https://token.help/articles/claude-code-third-party-api
- 作者：词元有方编辑部
- 成稿时间：2026-09-28T10:11:25.000Z
- 发布时间：2026-09-29T07:58:51.000Z
- 最后更新：2026-09-29T07:58:51.000Z
- 分类：接入教程
- 核验方式：已核对官方文档
- 核验时间：2026-09-28T00:00:00.000Z

引用本文请使用上方原文链接；配置与结论以文中版本和核验时间为准。来源内容的许可说明保留在正文中。

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

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

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

先按 [Claude Code 官方安装说明](https://code.claude.com/docs/en/setup)完成安装，在终端执行：

```bash
claude --version
```

能看到版本号后，再去 TokenDance 的 [API 密钥页](https://tokendance.space/keys?utm_source=journal\&utm_medium=content\&utm_content=claude-code-third-party-api) 创建专用密钥，并在[模型列表](https://tokendance.space/models?utm_source=journal\&utm_medium=content\&utm_content=claude-code-third-party-api)复制目标模型的完整 ID。模型需要支持 **Anthropic Messages 协议**及相应的工具能力。

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

| 参数                     | 本文填写方式                             |
| ---------------------- | ---------------------------------- |
| `ANTHROPIC_BASE_URL`   | `https://tokendance.space/gateway` |
| `ANTHROPIC_AUTH_TOKEN` | TokenDance 的 API Key               |
| 模型 ID                  | 从 TokenDance 模型页复制                 |

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

## 2. 在当前终端设置连接

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

```bash
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 可以这样设置，执行前替换两个占位符：

```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. 启动后，先检查再提问

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

```bash
claude
```

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

第一次先发一个小任务：

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

然后打开 TokenDance 的[调用日志](https://tokendance.space/activity?utm_source=journal\&utm_medium=content\&utm_content=claude-code-third-party-api)，检查时间、模型和状态是否对应。**终端有回答，加上平台有对应成功记录**，才算完成本次验证。费用与 Token 用量以平台记录为准。

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

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

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

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

## 常见问题：按现象排查

| 现象             | 先检查什么                                                   |
| -------------- | ------------------------------------------------------- |
| 仍提示登录，或连接到了旧平台 | 是否在设置变量的同一终端启动；是否存在旧配置或组织管理配置                           |
| 401 / 认证失败     | 是否使用了 TokenDance 密钥；`ANTHROPIC_AUTH_TOKEN` 是否为空、失效或多了空格 |
| 404 / 路径错误     | 地址是否严格为 `/gateway`，有没有混入 OpenAI 的接口路径                   |
| 模型不存在          | 模型 ID 是否完整，平台是否提供该模型的 Anthropic 协议入口                    |
| 能回答，但不能完成文件任务  | 检查工具调用能力与客户端兼容性，先用小任务定位问题                               |

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

## 参考资料

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

- [TokenDance：Claude Code 接入](https://tokendance.space/docs/claude-code)
- [Claude Code：连接 LLM 网关](https://code.claude.com/docs/en/llm-gateway-connect)
- [Claude Code：模型配置](https://code.claude.com/docs/en/model-config)
- [Claude Code：网关支持范围](https://code.claude.com/docs/en/llm-gateway)

## 核验参考来源

- https://code.claude.com/docs/en/setup
- https://tokendance.space/docs/claude-code
- https://code.claude.com/docs/en/llm-gateway-connect
- https://code.claude.com/docs/en/model-config
- https://code.claude.com/docs/en/llm-gateway