命令行

一条命令，取代一屏环境变量

Token CLI 把端点、密钥和模型选择存成一份具名 profile，然后带着这份配置启动 Claude Code、OpenClaw 或 Hermes。不必每开一个终端就重新粘一遍环境变量。

让 AI agent 帮你配置？

直接让它运行 token help profile add 并读取输出，不要从本页复制命令。CLI 的帮助信息由校验参数的同一份定义生成，永远是最新的——文档会过时，帮助不会。

token help profile add

整体流程

三条命令，各跑一次。之后启动就是一行，可以直接写进 shell 别名。

保存 profile

一份 profile 就是给「端点 + 密钥 + 一组模型」起的名字。下面这些也都可以交互式回答——不带任何参数运行 token profile add，它会逐项询问。

token profile add claude-code \
  --name work \
  --base-url "https://token-share.app" \
  --api-key "sk-token-…" \
  --all-models "claude-sonnet-5[1m]" \
  --context-tokens 1000000 \
  --compact-pct 95 \
  --default \
  --json

有哪些模型参数取决于 harness。Claude Code 有五个槽位（--model、--opus、--sonnet、--haiku、--subagent）；OpenClaw 和 Hermes 各有一个（--model）。用 --all-models 可以把某个 harness 的所有槽位填成同一个模型。

写入 ~/.token-share/profiles.json——端点、密钥、模型槽位都归到同一个名字下

启动

它会在 PATH 里找到 harness 的二进制，带上该 profile 的环境启动。-- 之后的参数原样转交给 harness。

token launch
token profile launch work

# forward flags to the harness
token profile launch work -- --resume

在 PATH 里找到二进制，套上 profile 的环境，然后把终端交给它

两种密钥

账号会签发两类互不相通的密钥，谁也干不了对方的活。这样拆分正是为了：无论泄露哪一把，损失都止步于那一半。

CLI 密钥

能做什么

不能做什么

跑推理——泄露的 CLI 密钥花不了钱，也无法再造一把 CLI 密钥

推理密钥

能做什么

通过 API 和各类 harness 调用模型

不能做什么

碰你的账号——泄露的推理密钥只能查到它自己发出的请求花了多少，看不到账户余额和其他请求，列不出密钥，也吊销不了任何东西

两种都在控制台创建，创建时选择类型。token login 需要 CLI 密钥；profile 里存的是推理密钥。

打开密钥页

支持的 harness

一份 profile 只属于一个 harness，因为各家读取端点和模型的位置都不一样。要跨 harness 复用，用 token profile copy——传入 profile 名称和 --target 目标 harness。

Harness 名称	二进制	模型槽位
Claude Code	`claude`	5 个——主模型，外加 opus、sonnet、haiku、subagent 四个别名
OpenClaw	`openclaw`	1 个——需要一个 prompt，写在 -- 之后
Hermes	`hermes`	1 个

或者只要环境变量

如果你想自己启动 harness，token profile env 会打印出这次启动本该使用的 export 行，两者不会出现偏差。

eval "$(token profile env work)"
claude

其余命令

每条命令都能打印自己的说明，任何命令加上 --json 都会输出可供脚本解析的结果。

常用命令

token profile list
token profile show work
token profile edit work --sonnet "claude-opus-5[1m]"
token profile copy work --target openclaw
token official usage --period 7d
token doctor
token help