TokenCode CLI 接入

使用 TokenCode CLI 可以通过交互式菜单向导完成常用编程工具配置，也可以用子命令把 TokenCode API Key、Base URL 和默认模型一键写入配置文件。相比手动复制 JSON、TOML 或环境变量，CLI 会按每个工具的配置格式合并写入，并尽量保留你已有的其它配置。

安装与运行

推荐全局安装后运行交互式菜单：

bash
npm install -g @tokencode/tokencode
tokencode

回车后会打开交互式菜单向导。你只需要选择要配置的编程工具，然后按提示输入 TokenCode API Key、Base URL 和模型 ID。

如果不想全局安装，也可以直接用 npx 打开同一个交互式向导：

bash
npx @tokencode/tokencode

CLI 同时提供两个短别名：

bash
tcd
tkc

推荐方式：交互式菜单

bash
tokencode

进入菜单后按提示操作：

  1. 选择要接入的编程工具。
  2. 输入 TokenCode API Key。
  3. 确认或修改 Base URL。
  4. 选择或输入默认模型。
  5. CLI 自动合并写入对应工具的配置文件。

这种方式更适合大多数用户，因为不需要记住不同工具的子命令、配置文件路径或 Base URL 差异。

支持的工具

工具 子命令 写入位置
Claude Code cc、claude ~/.claude/settings.json
OpenAI Codex codex、cx ~/.codex/config.toml、~/.codex/auth.json
OpenCode opencode、od ~/.config/opencode/opencode.json
OpenClaw openclaw、oc ~/.openclaw/openclaw.json
Hermes Agent hermes、hm ~/.hermes/config.yaml、~/.hermes/.env
Atomcode atomcode、ac ~/.atomcode/config.toml

可选方式：一键写入

如果你已经清楚要配置哪个工具，也可以直接使用子命令一键写入。把下面命令中的 sk-your-api-key 换成你的 TokenCode API Key，--model 可改为模型列表中的任意可用模型 ID。

Claude Code

bash
npx @tokencode/tokencode cc -k sk-your-api-key -m claude-sonnet-4-6

Claude Code 使用 Anthropic 兼容入口，CLI 默认写入：

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_BASE_URL=https://tokencode.dev
  • ANTHROPIC_MODEL=<模型 ID>

OpenAI Codex

bash
npx @tokencode/tokencode cx -k sk-your-api-key -m gpt-5.5

Codex 使用 OpenAI Responses API，CLI 默认写入：

  • ~/.codex/config.toml 中的 model_provider = "tokencode"
  • model_providers.tokencode.base_url = "https://tokencode.dev/v1"
  • model_providers.tokencode.wire_api = "responses"
  • ~/.codex/auth.json 中的 OPENAI_API_KEY

OpenCode

bash
npx @tokencode/tokencode od -k sk-your-api-key -m claude-sonnet-4-6

OpenCode 会写入 provider.tokencode，默认使用 @ai-sdk/anthropic，Base URL 为：

text
https://tokencode.dev/v1

提供 API Key 后，CLI 会尝试拉取可用模型列表并写入 OpenCode 配置。

OpenClaw

bash
npx @tokencode/tokencode oc -k sk-your-api-key -m claude-sonnet-4-6

OpenClaw 会合并写入 models.providers.tokencode，并把默认主模型设置为：

text
tokencode/<模型 ID>

CLI 会保留已有的 channels、gateway、其它 provider 和其它顶级配置。

Hermes Agent

bash
npx @tokencode/tokencode hm -k sk-your-api-key -m claude-sonnet-4-6

Hermes 会写入：

  • ~/.hermes/config.yaml：model.provider=custom、model.base_url=https://tokencode.dev/v1、model.default=<模型 ID>
  • ~/.hermes/.env：TOKENCODE_API_KEY=<你的 API Key>

Atomcode

bash
npx @tokencode/tokencode ac -k sk-your-api-key -m claude-sonnet-4-6

Atomcode 会写入 providers.Tokencode，并将 default_provider 设置为 Tokencode。

常用参数

所有子命令都支持以下参数：

参数 说明
--key / -k 设置 TokenCode API Key
--url / -u 设置 Base URL
--model / -m 设置默认模型
--show / -s 查看当前配置

示例：

bash
tokencode cc --show
tokencode cx --show
tokencode od --show

如果只想改模型，可以只传模型：

bash
tokencode cc -m claude-opus-4-7
tokencode od -m deepseek-chat

Base URL 怎么选

大多数情况下不需要手动设置 Base URL，使用 CLI 默认值即可。

工具 默认 Base URL
Claude Code https://tokencode.dev
Codex https://tokencode.dev/v1
OpenCode https://tokencode.dev/v1
OpenClaw https://tokencode.dev/v1
Hermes Agent https://tokencode.dev/v1
Atomcode https://tokencode.dev/v1

如果你使用的是私有部署或自定义域名，可以通过 -u 指定：

bash
tokencode cc -u https://your-domain.com
tokencode cx -u https://your-domain.com/v1

验证连接

配置完成后，分别运行对应工具做一次简单请求：

bash
claude "请用一句话确认连接成功"
codex "请用一句话确认连接成功"

OpenCode、OpenClaw 和 Hermes Agent 可以在各自界面中查看模型列表，确认出现 TokenCode provider 或 TokenCode 模型后再开始使用。

常见问题

npx 无法运行

请先确认已经安装 Node.js：

bash
node --version
npm --version

如果网络环境无法访问 npm registry，可以先切换可用镜像源，或改用全局安装方式。

配置后仍然走官方服务

通常是旧配置优先级更高。建议先执行：

bash
tokencode <工具子命令> --show

确认 Base URL、API Key 和模型是否已经写入目标配置文件。必要时重新打开终端或重启对应工具。

返回 401 或认证失败

请检查 API Key 是否完整、没有多余空格，并确认账户仍有可用额度。不同工具读取 API Key 的字段不同，建议用 CLI 重新写入一次，避免手动配置字段名写错。

模型列表拉取失败

CLI 拉取模型列表失败时仍允许手动输入模型 ID。你可以先到模型列表页确认模型 ID，再通过 -m 指定：

bash
tokencode cc -m claude-sonnet-4-6