opentoken-cli 0.0.1

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

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

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

## 安装

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

```bash
cargo install opentoken-cli
```

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

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

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

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

## 快速开始

```bash
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. 测试默认模型的连接

输出示例:

```text
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

```bash
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

```bash
opentoken cdt -k $OPENTOKEN_API_KEY
opentoken cdt test
```

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

### Codex

```bash
opentoken cx -k $OPENTOKEN_API_KEY
opentoken cx test
```

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

### OpenCode

```bash
opentoken od -k $OPENTOKEN_API_KEY
opentoken od test
```

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

### OpenClaw

```bash
opentoken oc -k $OPENTOKEN_API_KEY
opentoken oc test
```

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

### Hermes

```bash
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

```bash
opentoken pi -k $OPENTOKEN_API_KEY
opentoken pi test
```

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

### Atomcode

```bash
opentoken ac -k $OPENTOKEN_API_KEY
opentoken ac test
```

- 在 `~/.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** 配置,重复执行只更新这一个,不会重复新增,也不会改动你原有的配置。

## 连接测试

```bash
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](https://github.com/farion1231/cc-switch),配置时会自动同步:

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

## 查看可用模型

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

## 全部命令

```bash
opentoken --help
```

## License

MIT