opentoken-cli 0.0.2

Configure Claude Code, Claude Desktop, Codex, OpenCode, OpenClaw, Hermes, pi and Atomcode for the OpenToken gateway in one command. OpenToken 一键接入 AI 模型。
opentoken-cli-0.0.2 is not a library.

opentoken-cli

一条命令把 OpenToken 接入常用的 AI 编程工具:写入 API Key、Base URL 和模型列表,设置默认模型,同步到 CC Switch,并自动测试连接。

支持 Claude Code、Claude Desktop、Codex、OpenCode、OpenClaw、Hermes、pi、Atomcode、Gemini CLI。

安装

需要 Rust 工具链和 C 编译器(macOS 执行 xcode-select --install)。

cargo install opentoken-cli

安装后的命令为 opentoken,位于 ~/.cargo/bin,请确认该目录在 PATH 中:

which opentoken          # 应输出 ~/.cargo/bin/opentoken
opentoken --version

如果装过 npm 版 @tokenaut/opentoken,两者命令同名,建议先执行 npm uninstall -g @tokenaut/opentoken。

升级:再次执行 cargo install opentoken-cli。

快速开始

export OPENTOKEN_API_KEY=sk-xxx

opentoken cc -k $OPENTOKEN_API_KEY     # 配置 Claude Code
claude                                 # 直接启动即可使用

每个工具的配置方式相同,只需换成对应的子命令。一键配置会依次完成:

  1. 写入 API Key 和 Base URL(默认 OpenToken 网关)
  2. 拉取网关模型列表,写入工具的模型选择器
  3. 设置默认模型(未指定 -m 时自动选择,见下文)
  4. 同步到 CC Switch(未安装时跳过)
  5. 切换到 OpenToken 配置,启动工具即生效
  6. 测试默认模型的连接

输出示例:

Claude Code 配置已更新:
  ✓ API Key  : sk-xxx****xxxx
  ✓ Base URL : https://gw.opentoken.io、https://cn2.gw.opentoken.io
  ✓ 默认模型 : claude-opus-5-5
  ✓ 模型列表 : 已写入 14 个模型到 /model 选择器
  ✓ CC Switch : 已新增 供应商 OpenToken
  ✓ CC Switch : 已切换到 供应商 OpenToken

正在测试 Claude Code 连接...
  ✓ Haiku (claude-haiku-5-5)  连接成功  820ms
  ✓ Sonnet (claude-sonnet-5-5)  连接成功  910ms
  ✓ Opus (claude-opus-5-5)  连接成功  1203ms
  ✓ Fable (claude-fable-5-2)  连接成功  1130ms

  4/4 连接成功

不带参数运行 opentoken 进入交互主菜单,可逐项设置 Base URL、API Key、模型和保存方式。

各工具配置

工具 命令(缩写) 默认模型 配置后如何使用
Claude Code claude(cc) 最新的 Claude Opus 直接运行 claude
Claude Desktop claude_desktop(cdt) 最新的 Claude Opus 重启 Claude Desktop
Codex codex(cx) 网关标价最贵的 OpenAI 模型 直接运行 codex
OpenCode opencode(od) opentoken/ + 最新 Claude Opus 直接运行 opencode
OpenClaw openclaw(oc) opentoken/ + 最新 Claude Opus 直接运行 openclaw
Hermes hermes(hm) 最新的 Claude Opus 直接运行 hermes
pi pi opentoken/ + 最新 Claude Opus 直接运行 pi
Atomcode atomcode(ac) 最新的 Claude Opus 直接运行 atomcode
Gemini CLI gemini(gm) 网关标价最贵的 Gemini 模型 直接运行 gemini

用 -m <模型> 可指定默认模型,例如 opentoken od -k $OPENTOKEN_API_KEY -m gpt-6.1-sol。查看可用模型:opentoken models。

Claude Code

opentoken cc -k $OPENTOKEN_API_KEY
opentoken cc -k $OPENTOKEN_API_KEY -m claude-sonnet-5-5   # 指定默认模型
opentoken cc test
  • 网关上的 Claude 模型写入 /model 选择器;haiku / sonnet / opus / fable 四个档位自动设为各系列最新版本。
  • 独立配置保存在 ~/.claude-opentoken/settings.json,切换时把 OpenToken 的配置写入 ~/.claude/settings.json,主题等其它设置保留。
  • 也可以不切换、单独启动独立配置:opentoken cc -k $OPENTOKEN_API_KEY --no-switch,然后 CLAUDE_CONFIG_DIR="$HOME/.claude-opentoken" claude。
  • 实验性 beta 开关:opentoken cc -p beta-disable / opentoken cc -p beta-enable。

Claude Desktop

opentoken cdt -k $OPENTOKEN_API_KEY
opentoken cdt test
  • 在 Desktop 的第三方推理配置库(configLibrary)中新增名为 OpenToken 的配置,并设为当前配置。
  • 网关上的 Claude 模型写入模型列表,第一项为默认模型。
  • 配置后重启 Claude Desktop 生效。

Codex

opentoken cx -k $OPENTOKEN_API_KEY
opentoken cx test
  • 只写入 OpenAI 自己的对话模型(生图、语音、Embedding 等模型自动排除),默认模型为网关标价最贵的 OpenAI 模型。
  • 独立配置保存在 ~/.codex-opentoken/,切换时写入 ~/.codex/,直接运行 codex 即可。
  • 不切换时可单独启动:CODEX_HOME="$HOME/.codex-opentoken" codex。

OpenCode

opentoken od -k $OPENTOKEN_API_KEY
opentoken od test
  • 在 ~/.config/opencode/opencode.jsonc(不存在时为 opencode.json)中新增 opentoken 供应商,写入网关全部模型,并把默认模型 model 设为 opentoken/<模型>。
  • 其它供应商保留,可在 OpenCode 中随时切换。

OpenClaw

opentoken oc -k $OPENTOKEN_API_KEY
opentoken oc test
  • 在 ~/.openclaw/openclaw.json 的 models.providers 中新增 opentoken,写入网关全部模型,并把主模型设为 opentoken/<模型>。
  • 已有的其它供应商、模型别名和设置保留。

Hermes

opentoken hm -k $OPENTOKEN_API_KEY
opentoken hm test
  • 在 ~/.hermes/config.yaml 的 custom_providers 中新增 opentoken,并把 model.provider 设为 custom:opentoken。
  • API Key 同时写入 ~/.hermes/.env 的 OPENTOKEN_API_KEY;如果条目已用 key_env 引用环境变量,会保留这种写法。

pi

opentoken pi -k $OPENTOKEN_API_KEY
opentoken pi test
  • 在 ~/.pi/agent/models.json 中新增 opentoken 供应商并写入网关全部模型,~/.pi/agent/settings.json 的默认供应商和模型切换到 OpenToken。

Atomcode

opentoken ac -k $OPENTOKEN_API_KEY
opentoken ac test
  • 在 ~/.atomcode/config.toml 中新增 OpenToken 供应商并设为 default_provider。Atomcode 每个供应商只有一个模型,用 -m 切换。

Gemini CLI

opentoken gm -k $OPENTOKEN_API_KEY
opentoken gm test
  • 写入 .gemini/.env 的 GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY、GEMINI_MODEL,并在 .gemini/settings.json 中设置 security.auth.selectedType = "gemini-api-key" 和 model.name;其它设置保留。
  • 通过 OpenToken 网关的 Gemini 原生接口调用,默认模型为网关标价最贵的 Gemini 模型,用 -m 指定其它模型(opentoken models 可查看)。
  • 独立配置保存在 ~/.gemini-opentoken/.gemini/,切换时写入 ~/.gemini/,直接运行 gemini 即可。
  • 不切换时可单独启动:GEMINI_CLI_HOME="$HOME/.gemini-opentoken" gemini。

常用选项

所有工具通用:

选项 说明
-k, --key <apikey> API Key
-u, --url <baseurl> Base URL,默认 OpenToken 网关,可填自定义地址
-m, --model <model> 默认模型
--overwrite 覆盖本地正在使用的配置,并同步指向 OpenToken 网关的其它供应商
--no-switch 保存后不切换到 OpenToken 配置
--no-ccswitch 不同步 CC Switch

不加 --overwrite 时,工具会新增或更新一个独立的 OpenToken 配置,重复执行只更新这一个,不会重复新增,也不会改动你原有的配置。

连接测试

opentoken cc test                 # Claude Code 测试 haiku / sonnet / opus / fable 四个档位
opentoken cx test                 # 其它工具测试默认模型
opentoken od test -m gpt-6.1-sol  # 测试指定模型
opentoken cc test --overwrite     # 测试本地正在使用的配置

CC Switch

如果安装了 CC Switch,配置时会自动同步:

  • 新增名为 OpenToken 的供应商(带 OpenToken 图标),重复执行只更新这一个。
  • Claude Code、Claude Desktop、Codex、Gemini CLI:切换为 CC Switch 的当前供应商。
  • OpenCode、OpenClaw、Hermes、pi:同步到对应的供应商列表。
  • 每次写入前自动备份数据库到 ~/.cc-switch/backups/。
  • CC Switch 正在运行时,配置后重启即可看到变化。

查看可用模型

opentoken models                   # 使用已配置的 Key
opentoken models -k $OPENTOKEN_API_KEY

全部命令

opentoken --help

License

MIT