opentoken-cli-0.0.1 is not a library.
opentoken-cli
一条命令把 OpenToken 接入常用的 AI 编程工具:写入 API Key、Base URL 和模型列表,设置默认模型,同步到 CC Switch,并自动测试连接。
支持 Claude Code、Claude Desktop、Codex、OpenCode、OpenClaw、Hermes、pi、Atomcode。
安装
需要 Rust 工具链和 C 编译器(macOS 执行 xcode-select --install)。
安装后的命令为 opentoken,位于 ~/.cargo/bin,请确认该目录在 PATH 中:
如果装过 npm 版
@tokenaut/opentoken,两者命令同名,建议先执行npm uninstall -g @tokenaut/opentoken。
升级:再次执行 cargo install opentoken-cli。
快速开始
每个工具的配置方式相同,只需换成对应的子命令。一键配置会依次完成:
- 写入 API Key 和 Base URL(默认 OpenToken 网关)
- 拉取网关模型列表,写入工具的模型选择器
- 设置默认模型(未指定
-m时自动选择,见下文) - 同步到 CC Switch(未安装时跳过)
- 切换到 OpenToken 配置,启动工具即生效
- 测试默认模型的连接
输出示例:
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 |
用 -m <模型> 可指定默认模型,例如 opentoken od -k $OPENTOKEN_API_KEY -m gpt-6.1-sol。查看可用模型:opentoken models。
Claude Code
- 网关上的 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
- 在 Desktop 的第三方推理配置库(
configLibrary)中新增名为 OpenToken 的配置,并设为当前配置。 - 网关上的 Claude 模型写入模型列表,第一项为默认模型。
- 配置后重启 Claude Desktop 生效。
Codex
- 只写入 OpenAI 自己的对话模型(生图、语音、Embedding 等模型自动排除),默认模型为网关标价最贵的 OpenAI 模型。
- 独立配置保存在
~/.codex-opentoken/,切换时写入~/.codex/,直接运行codex即可。 - 不切换时可单独启动:
CODEX_HOME="$HOME/.codex-opentoken" codex。
OpenCode
- 在
~/.config/opencode/opencode.jsonc(不存在时为opencode.json)中新增opentoken供应商,写入网关全部模型,并把默认模型model设为opentoken/<模型>。 - 其它供应商保留,可在 OpenCode 中随时切换。
OpenClaw
- 在
~/.openclaw/openclaw.json的models.providers中新增opentoken,写入网关全部模型,并把主模型设为opentoken/<模型>。 - 已有的其它供应商、模型别名和设置保留。
Hermes
- 在
~/.hermes/config.yaml的custom_providers中新增opentoken,并把model.provider设为custom:opentoken。 - API Key 同时写入
~/.hermes/.env的OPENTOKEN_API_KEY;如果条目已用key_env引用环境变量,会保留这种写法。
pi
- 在
~/.pi/agent/models.json中新增opentoken供应商并写入网关全部模型,~/.pi/agent/settings.json的默认供应商和模型切换到 OpenToken。
Atomcode
- 在
~/.atomcode/config.toml中新增OpenToken供应商并设为default_provider。Atomcode 每个供应商只有一个模型,用-m切换。
常用选项
所有工具通用:
| 选项 | 说明 |
|---|---|
-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 配置,重复执行只更新这一个,不会重复新增,也不会改动你原有的配置。
连接测试
CC Switch
如果安装了 CC Switch,配置时会自动同步:
- 新增名为 OpenToken 的供应商(带 OpenToken 图标),重复执行只更新这一个。
- Claude Code、Claude Desktop、Codex:切换为 CC Switch 的当前供应商。
- OpenCode、OpenClaw、Hermes、pi:同步到对应的供应商列表。
- 每次写入前自动备份数据库到
~/.cc-switch/backups/。 - CC Switch 正在运行时,配置后重启即可看到变化。
查看可用模型
全部命令
License
MIT