Claude Code

将 Token Factory 配置为 Claude Code 的模型网关，在终端中使用国产模型完成编程任务。本页介绍 Claude Code CLI 的直接配置，也可以使用 CC Switch管理配置。

开始前准备

按官方安装指南安装 Claude Code，并用 claude --version 确认命令可用。
在控制台创建工具专用 API Key，确认通用余额充足。
在模型文档打开模型详情，确认“调用方式”包含 Anthropic Messages，并复制模型 ID。编程任务还需要模型支持工具调用与流式输出。

配置连接

配置项	填写内容
Base URL	`https://api.tokenfactory.cn/anthropic`
鉴权变量	`ANTHROPIC_AUTH_TOKEN`，值为 Token Factory API Key
模型变量	`ANTHROPIC_MODEL`，值为模型详情中的 ID
计费方式	通用余额按实际用量计费

Anthropic Base URL

Claude Code 会追加 /v1/messages，最终请求为 https://api.tokenfactory.cn/anthropic/v1/messages。Base URL 保留 /anthropic，不要填写完整 Messages 地址。

1. 提供 API Key

将 API Key 保存在本机的 TOKENFACTORY_API_KEY 环境变量中。执行下面的命令后会等待输入，粘贴 Key 并按回车；Key 不会显示在终端或写入命令历史。

macOS / Linux · Bash 或 ZshWindows · PowerShell

bash

export TOKENFACTORY_API_KEY
read -r -s TOKENFACTORY_API_KEY

powershell

$tokenFactorySecret = Read-Host "Token Factory API Key" -AsSecureString
$env:TOKENFACTORY_API_KEY = [System.Net.NetworkCredential]::new("", $tokenFactorySecret).Password

2. 设置地址与模型

将 <model-id> 替换为准备好的模型 ID，在同一终端执行：

macOS / Linux · Bash 或 ZshWindows · PowerShell

bash

export ANTHROPIC_BASE_URL="https://api.tokenfactory.cn/anthropic"
export ANTHROPIC_AUTH_TOKEN="$TOKENFACTORY_API_KEY"
export ANTHROPIC_MODEL="<model-id>"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
claude

powershell

$env:ANTHROPIC_BASE_URL = "https://api.tokenfactory.cn/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = $env:TOKENFACTORY_API_KEY
$env:ANTHROPIC_MODEL = "<model-id>"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = $env:ANTHROPIC_MODEL
claude

ANTHROPIC_DEFAULT_HAIKU_MODEL 将使用 Haiku 别名的后台任务指向同一个国产模型。其他模型别名、子代理或项目内指定的模型也需要使用平台已开放的模型 ID，规则见官方模型配置。

以上变量只作用于当前终端及其启动的进程。长期使用可交给 CC Switch 或本机凭据管理；不要把 API Key 写入项目内的 .claude/settings.json。

发起首次对话

在测试目录中启动 Claude Code，用 /status 确认当前凭据来源与模型。
发送：“只回复‘连接成功’，不读取文件、不执行命令。”
收到正常回复后，再用一个不含敏感内容的小文件测试解释或修改任务，并检查工具调用结果。

更换模型时可用 /model <model-id>。这里填写 Token Factory 模型 ID；模型名称与客户端的内置别名不一定相同。

常见问题

现象	检查方法
`404` 或路径错误	确认 Base URL 是 `/anthropic`，最终路径只有一段 `/v1/messages`。
`401` 认证失败	确认 Key 有效，`ANTHROPIC_AUTH_TOKEN` 在启动 Claude Code 的终端内生效；不要在诊断中打印 Key。
“没有可兑现所请求能力的供应路线”	核对该模型是否开放 Anthropic Messages；其他接口调用成功不能证明 Messages 可用。
主会话成功，后台任务报模型不存在	检查 Haiku 等模型别名和子代理是否仍指定内置模型。
能对话但不能调用工具	确认模型与当前接口支持工具调用，再检查客户端权限和具体错误。
`429`、余额不足或流式中断	查看错误处理；任务已开始修改文件时，先检查结果再决定是否重试。

Claude Code ​

开始前准备 ​

配置连接 ​

1. 提供 API Key ​

2. 设置地址与模型 ​

发起首次对话 ​

常见问题 ​

相关文档 ​