文档目录
5 分钟接入
注册、创建密钥、按模型选对接入地址，再填进 Claude Code、Codex、Cursor 等客户端；附验证接通的方法和常见报错。
Tokenway 是大模型 API 中转站。注册、创建密钥，再把接入地址和密钥填进你正在用的客户端即可，一般不需要改代码。
第 1 步：先确认你要用哪个系列的模型
每个系列只支持它自己的接口格式，用错会返回 400 并提示该用哪个接口，详见 接口格式。
| 模型系列 | 接入地址 | 接口 | 密钥放哪里 |
|---|---|---|---|
| Claude | https://tokenwayapi.com（不带 /v1） | /v1/messages（Anthropic） | x-api-key 请求头 |
| GPT | https://tokenwayapi.com/v1 | /v1/chat/completions、/v1/responses（推荐 Responses） | Authorization: Bearer |
| 其他模型（DeepSeek、Kimi、Gemini、Grok 等） | https://tokenwayapi.com/v1 | /v1/chat/completions | Authorization: Bearer |
下面可以切换系列，直接复制地址和示例：
接入地址（Base URL）
https://tokenwayapi.com不要带 /v1：Claude Code 和 Anthropic SDK 会自己补上 /v1/messages。Claude 只支持这一个接口。
接口
- POSTAnthropic Messages
https://tokenwayapi.com/v1/messages
Claude Code
export ANTHROPIC_BASE_URL="https://tokenwayapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"curl
curl https://tokenwayapi.com/v1/messages \
-H "x-api-key: sk-xxxxxxxx" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"你好"}]}'把 sk-xxxxxxxx 换成你在“API 密钥”页创建的密钥。密钥只放在你自己的客户端或服务端配置里，不要写进前端代码。
第 2 步：注册并创建密钥
第 3 步：填进你的客户端
| 你用的客户端 | 能用的模型 | 教程 |
|---|---|---|
| Claude Code | Claude | 接入 Claude Code |
| Codex CLI | GPT | 接入 Codex CLI |
| Cursor | GPT 和其他模型（不能用 Claude） | 接入 Cursor |
| Cherry Studio | 全部（Claude 要选 Anthropic 类型的服务商） | 接入 Cherry Studio |
| OpenAI / Anthropic SDK | 按系列选 SDK | 使用 OpenAI SDK |
| 只想先测一下 | 全部 | 用 curl 测试 |
第 4 步：确认接通了
- 在客户端里发一句简单的话（比如“你好”），能正常回复就说明接通了。
- 打开控制台的 使用记录，应该能看到刚才这一笔：模型名、输入输出 token、缓存命中和扣费，每一笔都可查。
- 回到 控制台首页 看余额是否按这一笔变化。
常见问题
| 现象 | 原因和处理 |
|---|---|
401 | 密钥填错或已停用，回到 API 密钥 页确认，注意前后别带空格。 |
402 | 余额不足，见 充值购买。 |
404 / 找不到模型 | model 要和 模型定价 页完全一致；Claude 的接入地址别多带 /v1。 |
400：不支持 xxx 接口 | 这个系列的模型用错了接口格式，按提示改用对应接口，见 接口格式。 |
400：暂不支持 HTTP API 直连 | 这个模型的线路只接受 Claude Code / Claude Desktop 等官方客户端，请用官方客户端调用。 |
| 连不上或很慢 | API 密钥 页里还有备用接入地址，换一个试试；也可以到 服务状态 看线路是否正常。 |
其他错误见 错误码。
可以调用哪些模型？
以 模型定价 页列出的为准，请求里的
model 要和那里的名字完全一致。怎么计费？
按实际 token 实时扣费，规则见 计费与定价。
选好模型，核对费用再接入
查看当前模型的价格与参数，用自己的输入、输出和缓存用量估算成本；遇到报错时按错误码排查。