TokenMix CLI

TokenMix 官方 CLI — 一行命令把任意 AI 编程 agent 接入 TokenMix

简介

TokenMix CLI 是 TokenMix 官方命令行工具，零配置把 Claude Code、Aider、OpenCode、Codex、Qwen Code、Goose、OpenHands 以及四款 VS Code 插件（Kilo Code、Cline、Roo Code、Continue）接入你的 TokenMix 账户——无需手动设置环境变量，无需修改配置文件。单一 API Key 覆盖三大协议：OpenAI Chat Completions、Anthropic Messages、Responses API。

准备工作

• Node.js 18 及以上版本。 用 node --version 确认；没有的话去 nodejs.org 下载。
• TokenMix 账户。 在 tokenmix.ai 注册，新账户赠送 $1 免费额度（可用于大多数非付费模型，包括 Qwen Flash）。

安装

方式一——全局安装（日常使用推荐）：

npm install -g tokenmix

方式二——免安装直接运行（npx）：

npx tokenmix <命令>

如果你在国内网络环境，先切换镜像再安装：

npm config set registry https://registry.npmmirror.com
npm install -g tokenmix

登录

tokenmix login

命令会打开浏览器，登录 TokenMix 账户后在终端确认短码即可。无浏览器 / CI 环境：

tokenmix login --paste          # 交互式粘贴 key，无需浏览器
tokenmix login --key sk-tm-...  # 直接传入 API Key

凭证存储路径：macOS ~/Library/Application Support/tokenmix/config.json，Linux ~/.config/tokenmix/config.json，Windows %APPDATA%/tokenmix/config.json，权限 0600，仅本人可读写。

一键启动各 Agent

首次运行会自动安装 agent（支持自动安装的情况下），并将其指向 TokenMix：

npx tokenmix opencode       # OpenCode — 自动安装
npx tokenmix claude         # Claude Code — 自动安装
npx tokenmix aider          # Aider — 需要先 pip install aider-chat
npx tokenmix codex          # Codex — 自动安装
npx tokenmix qwen           # Qwen Code — 自动安装
npx tokenmix goose          # Goose — 需先按官方文档安装 Goose
npx tokenmix openhands      # OpenHands — 需 Python 3.12+，uv tool install openhands

VS Code 插件（打印配置片段，粘贴到插件设置中即可）：

npx tokenmix kilo           # Kilo Code
npx tokenmix cline          # Cline
npx tokenmix roo            # Roo Code
npx tokenmix continue       # Continue（VS Code / JetBrains）

用 $1 免费额度试用

免费额度可用于非付费模型。把任意 agent 指向 qwen-flash 即可零成本体验：

TOKENMIX_DEFAULT_MODEL=qwen-flash npx tokenmix opencode

运行 tokenmix models 查看所有可用模型及价格。

验证

tokenmix balance   # 显示实时余额、赠送额度和总消费
tokenmix doctor    # 检查 key 有效性及各 agent 安装/配置状态

balance 显示余额、doctor 无报错，即可开始编程。

常见问题

运行 tokenmix login 时浏览器没有打开。 在服务器、容器或 SSH 会话中属于正常现象。终端会打印 URL 和短码，用任意设备打开 URL 输入短码即可。也可以用 tokenmix login --paste 粘贴 key，或在 CI 中用 tokenmix login --key sk-tm-... 直接传入。

如何更换默认模型？ agent 默认使用 claude-sonnet-4.6。启动时设置 TOKENMIX_DEFAULT_MODEL 环境变量即可覆盖。tokenmix models 列出所有可用模型。注意：tokenmix claude 和 tokenmix codex 只支持 Claude 系列模型；其他 agent 支持任意对话模型。

如何退出登录或卸载？ tokenmix logout 删除本地凭证并还原 CLI 修改过的 agent 配置。如已全局安装，npm uninstall -g tokenmix 完整卸载。