跳到正文

/quickstart

快速开始

三步接入 OpenToken：取密钥、写配置、验证连通。全程约五分钟。

这一页把最短路径走完。想了解每个配置项为什么这么写，看 Claude Code 或 Codex CLI 的完整说明。

1

拿到 API 密钥

在 OpenToken 控制台的密钥页面生成一个密钥。它以 sk- 开头，形如 sk-xxxxxxxx。

密钥只在生成时完整显示一次，先存到密码管理器里。

2

写进客户端的配置文件

两个客户端的配置文件和地址格式都不一样，按你用的那个来。

Claude Code —— 地址不带 /v1：

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://otokapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR-API-KEY"
  }
}

Codex CLI —— 地址带 /v1，密钥走环境变量：

~/.codex/config.toml
model = "gpt-5.5"
model_provider = "opentoken"
disable_response_storage = true

[model_providers.opentoken]
name = "OpenToken"
base_url = "https://otokapi.com/v1"
wire_api = "responses"
env_key = "OPENTOKEN_API_KEY"
~/.zshrc（或 ~/.bashrc）
export OPENTOKEN_API_KEY="sk-YOUR-API-KEY"
改完 source 一下，或者重开终端。
3

验证接通

先用 curl 直接打中转站，把「站点问题」和「配置问题」分开。Claude Code 用这条：

终端
curl -X POST "https://otokapi.com/v1/messages" \
  -H "Authorization: Bearer sk-YOUR-API-KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'
返回 JSON 就是通了。401 检查密钥，404 检查地址。

Codex 用这条（注意端点是 /v1/responses）：

终端
curl -X POST "https://otokapi.com/v1/responses" \
  -H "Authorization: Bearer sk-YOUR-API-KEY" \
  -H "content-type: application/json" \
  -d '{"model":"gpt-5.5","input":"ping"}'

curl 通了之后再启动 claude 或 codex，随便问一句话。能正常回复就完成了。

卡住了看排错手册，那里按报错现象索引。

两件容易忽略的事

模型 ID 是示例值。 上面 gpt-5.5 和 claude-sonnet-4-6 只是占位。先跑一次 /v1/models 确认你的账号能用哪些：

终端
curl -H "Authorization: Bearer sk-YOUR-API-KEY" https://otokapi.com/v1/models

配置要放在用户级目录。 两个客户端都不接受把中转配置放进项目目录——Claude Code 那样做会把密钥提交进仓库，Codex 则会直接忽略这些配置项。详情见各自的接入页。