终端截图展示 tf status 的输出：示例账户可用额度为 93.4 推理积分，今日 117 次请求，实际扣费 6.4993 推理积分。四个客户端分别绑定了各自的模型。
同一个入口。Claude CodeCodexOpenCodePi
少一点配置，多一点专注
换工具，不用重来一遍。
把连接的事情交给 tf，把编程的事情留给你的客户端。
原来的配置，留在原处
仅通过子进程环境和启动参数注入网关配置。不改 Claude、Codex 或 Pi 的全局配置文件，退出后不留下配置覆盖。
不同的 Key，各司其职
按客户端保存 Key 绑定，工作和个人账户各自独立。临时用 -k 换一把，不影响下次的默认选择。
主模型之外，也配置好
不只管理对话模型，也照顾摘要、标题和代码审查的模型槽。启动前按 Key 与协议校验，减少后台任务静默失败。
tf claude -mtf codex -k worktf pi -e hightf claude -- --resume支持 TokenFlux 与自建 TokenRouter。Key 以明文保存在本机，文件权限为 0600；tf 不代理会话流量，也不采集遥测。
了解安全边界开始使用
从一条安装命令开始。
工具免费开源。模型调用费用由你连接的网关计费。
npm install -g @tokenflux/tf需要 Node.js 18+。支持 macOS、Linux 和 Windows。
curl -fsSL https://raw.githubusercontent.com/tokenflux/tf-cli/main/install.sh | sh独立二进制，无需 Node.js。默认安装到 ~/.local/bin，不需要 sudo。
npx @tokenflux/tf status通过 npx 运行，不做全局安装。查看状态需要先保存本地 Key。
tf login从网页导入或粘贴 Key，在终端确认。
tf claude选定模型，进入熟悉的编程客户端。
tf status随时查看可用额度、今日扣费和模型绑定。
Windows 当前支持非交互模式。查看 TokenDocs 下载其他平台二进制
开始之前
你可能还想知道
tf-cli 和 TokenFlux 是什么关系？
tf-cli 是开源的客户端启动与凭据管理工具。你可以连接 TokenFlux 网关，也可以通过 --host 连接自己部署的 TokenRouter。它不是一个新的聊天客户端。
使用 tf-cli 需要付费吗？
tf-cli 使用 Apache-2.0 许可证，工具本身免费。模型调用会消耗你所连接网关的额度，费用和可用模型由网关服务决定。
会改动我原来的客户端配置吗？
不会写入客户端的全局配置。tf 管理自己的凭据与绑定，在启动时注入当前子进程。已有客户端设置仍可能覆盖注入；tf status 会提示已检测到的冲突。
可以在 CI 或容器中使用吗？
可以。通过环境变量 TF_API_KEY 注入 Key，无需先保存本地凭据。配合 --no-input 与明确的模型参数使用；自建网关请显式指定 --host。