文档目录
接入 Claude Code
Claude Code 接入 Tokenway:两个环境变量、长期生效的配置方法、验证接通和常见报错。
Claude Code 是 Anthropic 的命令行编程助手。接入 Tokenway 只需要两样东西:接入地址和 API 密钥,通过环境变量交给它。Claude Code 发的是 Anthropic 原生格式,所以只能使用 Claude 模型,模型名见 模型定价。
开始之前
- 已经安装好 Claude Code(安装方式见 Anthropic 官方文档)。
- 已经有一把 Tokenway 的 API 密钥,见 创建 API 密钥。
- 版本尽量用较新的:个别新模型要求较新的 Claude Code,版本太旧时会提示“需要 Claude Code x.y.z 或更新版本”,升级即可。
接入地址不要带 /v1
Claude Code 会自己在地址后面补上
/v1/messages,所以这里只填 https://tokenwayapi.com。方式一:环境变量(当前终端有效)
macOS / Linux
export ANTHROPIC_BASE_URL="https://tokenwayapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://tokenwayapi.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxx"设置好之后,在项目目录里运行 claude 即可。
想让它每次打开终端都生效:
- macOS / Linux:把上面两行
export写进~/.zshrc(或~/.bashrc),再执行source ~/.zshrc。 - Windows:在 PowerShell 里执行下面两行,然后新开一个终端窗口。
Windows(长期生效)
setx ANTHROPIC_BASE_URL "https://tokenwayapi.com"
setx ANTHROPIC_AUTH_TOKEN "sk-xxxxxxxx"方式二:写进配置文件(长期有效)
编辑 ~/.claude/settings.json(Windows 在用户目录下的 .claude\settings.json),加入 env 段:
~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://tokenwayapi.com",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx"
}
}怎么确认接通了
- 在项目目录运行
claude,问一句简单的话(比如“你好”),能正常回复就说明接通了。 - 打开控制台的 使用记录,应该能看到刚才这一笔:模型名、输入输出 token、缓存命中和扣费。
- 想先用命令行验证一下,可以用 用 curl 测试 里的 Claude 示例。
选择模型
在 Claude Code 里用 /model 切换,或设置环境变量 ANTHROPIC_MODEL。可用的 Claude 模型名见 模型定价。填其他系列的模型名会返回 400(见 接口格式)。
费用怎么算
Claude Code 每次请求都会带上项目上下文,长对话的 token 数会比较多。命中缓存的部分按“缓存读取”价计费,比普通输入便宜很多;价格见 模型定价,计费方式见 计费与定价。每一笔扣费都能在 使用记录 里核对,余额不足时会返回 402。
常见问题
| 现象 | 原因和处理 |
|---|---|
401 | 密钥填错或已停用,回到 API 密钥 页确认。 |
402 | 余额不足,见 充值购买。 |
404 / 找不到模型 | 模型名和价格页不一致,或地址误带了 /v1。 |
400:需要 Claude Code x.y.z 或更新版本 | Claude Code 版本太旧,升级到提示的版本或更新的版本即可。 |
400:不支持 xxx 接口 / 模型不是 Claude | Claude Code 只能用 Claude 模型,换成 Claude 模型名。 |
| 连不上或很慢 | API 密钥 页里还有备用接入地址,换一个试试;到 服务状态 看线路是否正常。 |
其他错误见 错误码。
选好模型,核对费用再接入
查看当前模型的价格与参数,用自己的输入、输出和缓存用量估算成本;遇到报错时按错误码排查。