跳转到主要内容
文档目录

接入 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"
  }
}

怎么确认接通了

  1. 在项目目录运行 claude,问一句简单的话(比如“你好”),能正常回复就说明接通了。
  2. 打开控制台的 使用记录,应该能看到刚才这一笔:模型名、输入输出 token、缓存命中和扣费。
  3. 想先用命令行验证一下,可以用 用 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 接口 / 模型不是 ClaudeClaude Code 只能用 Claude 模型,换成 Claude 模型名。
连不上或很慢API 密钥 页里还有备用接入地址,换一个试试;到 服务状态 看线路是否正常。

其他错误见 错误码。

选好模型,核对费用再接入

查看当前模型的价格与参数,用自己的输入、输出和缓存用量估算成本;遇到报错时按错误码排查。