jellytoken 命令行工具

jellytoken 是 JellyToken 官方 CLI，用于配置 API Key、一键接入 Codex / Claude Code / Hermes 等 AI 编程工具，并在服务端切换模型映射，无需反复改本地配置文件。

推荐流程：安装 → auth → setup，比手动编辑各工具配置文件更快。

---

安装

当前版本 v0.1.0，支持 macOS（Apple Silicon / Intel）、Linux x64、Windows x64。

下载地址

一行安装

macOS / Linux（推荐安装到 /usr/local/bin/jellytoken，该目录通常已在 PATH 中）：

curl -fsSL 'https://airt-oss.jellytoken.com/tools/jellytoken/v0.1.0/jellytoken-darwin-arm64' -o /tmp/jellytoken && chmod +x /tmp/jellytoken && sudo mv /tmp/jellytoken /usr/local/bin/jellytoken

这条命令会把 jellytoken 拷贝到 /usr/local/bin，执行 sudo mv 时需要输入本机 sudo 密码。

如果介意使用 sudo，可以下载到当前目录；后续请在当前目录执行 ./jellytoken：

curl -fsSL 'https://airt-oss.jellytoken.com/tools/jellytoken/v0.1.0/jellytoken-darwin-arm64' -o ./jellytoken && chmod +x ./jellytoken

Apple Silicon 用 jellytoken-darwin-arm64；Intel Mac 将 URL 中的文件名改为 jellytoken-darwin-x64；Linux 改为 jellytoken-linux-x64。

Windows（PowerShell）：

powershell -NoProfile -Command "
  $dir = '$env:LOCALAPPDATA\Programs';
  $exe = Join-Path $dir 'jellytoken-win-x64.exe';
  New-Item -ItemType Directory -Force -Path $dir | Out-Null;
  Invoke-WebRequest -Uri 'https://airt-oss.jellytoken.com/tools/jellytoken/v0.1.0/jellytoken-win-x64.exe' -OutFile $exe;
  $currentPath = [Environment]::GetEnvironmentVariable('Path', 'User');
  if (-not ($currentPath -split ';' -contains $dir)) {
    [Environment]::SetEnvironmentVariable('Path', \"$currentPath;$dir\", 'User');
  }
"

上述命令会下载二进制到 %LOCALAPPDATA%\Programs 并自动将该目录追加到用户 PATH。如果当前 PowerShell 会话需要立即使用 jellytoken，可额外执行：

$env:Path += ";$env:LOCALAPPDATA\Programs"

或重新打开 PowerShell/CMD 终端。

安装后验证：

jellytoken --version

---

快速开始

1. 配置 API Key

在 JellyToken 密钥管理 创建或复制 API Key（格式 uas_...），然后执行：

jellytoken auth uas_xxxxxxxx

配置保存在 ~/.jellytoken/config.json。默认 Base URL 为 https://aiservice.jellytoken.com，如需修改：

jellytoken baseurl --set https://your-aiservice.example.com

2. 接入 AI 编程工具

交互式配置（会列出已授权 TEXT 模型，可输入序号或模型 ID）：

jellytoken setup codex
jellytoken setup claude
jellytoken setup hermes

AI 编程工具仅使用文本生成模型。CLI 在 setup / switch / alias / models 中默认过滤并展示 TEXT 类型模型，避免误选图像、视频等模型。

一次性配置所有支持的工具：

jellytoken setup --all

指定模型 ID（跳过交互）：

jellytoken setup claude --model qwen3.6-plus

各工具详细说明见 接入总览 及对应子文档。

3. 切换模型

jellytoken switch qwen-plus          # 切换到指定 TEXT 模型
jellytoken switch                    # 查看当前映射 + 可切换 TEXT 模型列表
jellytoken models                    # 列出已授权 TEXT 模型
jellytoken models --all              # 列出全部类型（含图像、视频等）

不带模型 ID 执行 jellytoken switch 时，会显示当前别名映射，并在下方列出可切换的 TEXT 模型（当前模型以 * 标记）。

指定了错误的模型 ID 时，CLI 会直接打印 TEXT 模型列表，无需再单独跑 jellytoken models。

---

Codex 占位模型机制

Codex 的 provider 只能配置一个 model，改模型需重启。jellytoken setup codex 会：

1. 在 ~/.codex/config.toml 写入固定占位模型 jellytoken
2. 在 Codex provider 中写入当前 JellyToken API Key，避免依赖 OPENAI_API_KEY 环境变量
3. 引导确认默认映射 jellytoken → qwen3.7-max（可回车确认，或输入序号 / 模型 ID 选择其他已授权 TEXT 模型）
4. 将映射同步到 JellyToken 服务端

之后切换实际模型只需：

jellytoken switch <model-id>

无需重启 Codex、无需再改 config.toml。

写入的配置示例：

model = "jellytoken"
model_provider = "jellytoken"

[model_providers.jellytoken]
name = "JellyToken"
base_url = "https://aiservice.jellytoken.com/v1"
experimental_bearer_token = "uas_xxx"
wire_api = "responses"
namespace_tools = false

更多 Codex 细节见 Codex 接入 JellyToken。

---

命令参考

setup / switch / alias / models 需先执行 jellytoken auth。
未指定 --model 的 setup、以及 alias --create（TTY 下）会交互列出 TEXT 模型，支持输入序号或完整模型 ID。

别名示例

查看别名与可切换模型：

jellytoken alias

创建自定义别名并切换：

# 指定模型
jellytoken alias --create jellytoken-fast --model qwen-turbo

# 交互选择模型（TTY 下省略 --model）
jellytoken alias --create jellytoken-fast

jellytoken switch qwen-turbo --alias jellytoken-fast

models 输出示例

jellytoken models

当前模型: qwen-plus
占位模型 (jellytoken): 服务端映射 → qwen-plus

模型 ID (TEXT)  类型
──────────────  ────
 *qwen-plus      TEXT
  qwen3.7-max    TEXT
  ...

共 8 个 TEXT 模型 (* 为当前)
切换: jellytoken switch <model-id>

--json 输出包含 textOnly 字段；默认 true，加 --all 后为 false 并返回全部类型。

---

配置文件

~/.jellytoken/config.json 示例：

{
  "apiKey": "uas_xxx",
  "baseUrl": "https://aiservice.jellytoken.com",
  "activeModel": "qwen3.7-max",
  "aliasModel": "jellytoken",
  "setupTools": ["codex", "claude"]
}

---

常见问题

提示「尚未配置 API Key」

先执行 jellytoken auth uas_xxx。

模型不在授权列表中

在控制台「模型超市」确认账号已授权该模型。运行 jellytoken models 查看可用 TEXT 模型 ID；若需图像、视频等类型，加 --all。输入错误模型 ID 时，CLI 也会直接列出 TEXT 模型供参考。

jellytoken switch 不知道选哪个模型

直接执行 jellytoken switch（不带参数），会显示当前映射和可切换的 TEXT 模型列表。

Codex 切换模型后未生效

确认已执行 jellytoken switch <model-id>，且 Codex 配置中 model 仍为占位名 jellytoken（不要改成真实 model ID）。

macOS 提示 command not found

确认 ~/.local/bin 在 PATH 中，或在 shell 配置中加入：

export PATH="$HOME/.local/bin:$PATH"

---

相关文档

• 接入总览
• Codex 接入 JellyToken
• Claude Code 接入 JellyToken
• Hermes Agent 接入 JellyToken
• 鉴权与 API Key
• 模型列表与元信息