Claude Code

Claude Code 接入教程，说明如何通过环境变量把 Claude Code 指向 Tokaify，并在启动后选择可用模型。

先记住这几个值

Claude Code 这一类 Anthropic 风格接入，核心看这 3 项：

ANTHROPIC_API_KEY：控制台复制出来的完整 sk-...
ANTHROPIC_BASE_URL：https://api.tokaify.com
模型选择：启动 Claude Code 后，通过 /model 选择

第一步：先在 Tokaify 生成 Key

登录 Tokaify 官网。
打开控制台的令牌管理。
点击「添加令牌」并完成保存。
在令牌列表里点击「复制密钥」，拿到完整的 sk-...。

注意

接入 Claude Code 时请直接使用完整密钥，不要手动删除 sk- 前缀。

第二步：参数配置

Claude Code 配置项	填写内容	说明
`ANTHROPIC_API_KEY`	`sk-...`	Claude Code 会把它作为 `X-Api-Key` 发送
`ANTHROPIC_BASE_URL`	`https://api.tokaify.com`	这里填 API 根地址，不要手动补 `/v1`
`/model`	选择你账号里可用的模型	启动 Claude Code 后再选
`ANTHROPIC_CUSTOM_MODEL_OPTION`	可选	仅当你要手动加一个网关模型入口时使用

第三步：在 Claude Code 中填写

Claude Code 当前主流做法是通过环境变量接入。

直接在 PowerShell 中执行：

setx ANTHROPIC_API_KEY "sk-your-token"
setx ANTHROPIC_BASE_URL "https://api.tokaify.com"

执行后关闭当前终端，重新打开 PowerShell 再启动 claude。

把下面内容写入你的 shell 配置文件，例如 ~/.zshrc 或 ~/.bashrc：

export ANTHROPIC_API_KEY="sk-your-token"
export ANTHROPIC_BASE_URL="https://api.tokaify.com"

保存后执行：

source ~/.zshrc

如果你用的是 bash，则改成：

source ~/.bashrc

第四步：启动 Claude Code 并选择模型

先启动 Claude Code：

claude

然后在 Claude Code 里执行：

/model

接下来按下面理解即可：

如果列表里已经出现你要的模型或别名，直接选
如果你的网关模型没出现在列表里，但它本身支持 Anthropic 风格调用，可以额外加一个自定义模型入口

可选示例：

setx ANTHROPIC_CUSTOM_MODEL_OPTION "claude-sonnet-4-5"
setx ANTHROPIC_CUSTOM_MODEL_OPTION_NAME "Sonnet via Tokaify"

export ANTHROPIC_CUSTOM_MODEL_OPTION="claude-sonnet-4-5"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Sonnet via Tokaify"

如果你不确定具体模型 ID，就先不要加 ANTHROPIC_CUSTOM_MODEL_OPTION，直接用 /model 看当前能选什么。

第五步：验证是否配置成功

最直接的验证方式，是启动后先发一句：

请先回复一句“Claude Code 已连接 Tokaify”，再列出当前项目顶层目录。

如果能正常返回，就说明请求链路已经通了。

常见问题

为什么 `ANTHROPIC_BASE_URL` 填根域名，不是 `/v1`

因为 Claude Code 走的是 Anthropic 风格接口，它会自行请求相应的 API 路径。这里按网关根地址填写即可，不要手动改成 https://api.tokaify.com/v1。

为什么返回 401 / 403

优先检查：

ANTHROPIC_API_KEY 是否填写为完整 sk-...
令牌是否被禁用、过期或额度不足
你在 /model 中选择的模型，是否属于该令牌允许访问的模型
是否触发了 IP 限制

为什么会出现 `ERR_BAD_REQUEST`，底部还提示 `context_management: Extra inputs are not permitted`

如果你看到顶部提示：

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

同时底部还有类似报错：

API Error: 400
Provider API error: context_management: Extra inputs are not permitted

这通常不是 Key 填错，而是 Claude Code 当前启用的 experimental betas 会额外发送 context_management 请求字段，部分网关或上游渠道暂时不接受这个字段。

排查时请优先看底部这条 400 报错；上面的“Unable to connect to Anthropic services”很多时候只是 Claude Code 的通用提示，不一定代表你真的在直连 api.anthropic.com，也不一定是单纯网络问题。

建议在 Claude Code 的 settings 中关闭 experimental betas：

编辑或创建：

~/.claude/settings.json

编辑或创建：

C:\Users\你的用户名\.claude\settings.json

写入下面内容：

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

保存后，关闭当前终端并重新打开，再执行 claude，用一条最简单的消息验证是否恢复。

如果只是 Base URL、Key 或模型权限配置错误，更常见的是 401、403 或 404，而不是这种参数校验类的 400 报错。

为什么 `/model` 里没有我想要的模型

先确认你的账号是否真的开放了该模型。如果网关模型不在 Claude Code 的内置选择里，但接口本身支持，可以再用 ANTHROPIC_CUSTOM_MODEL_OPTION 手动补一个入口。