Docs

开始接入

Token4AI CLI 与 Agent 自动化

通过浏览器授权 CLI，查询钱包、密钥、用量和资源，使用 JSON 输出构建自动化。

更新于

下载与授权

客户命令名是 token4ai。使用 Vega 提供的 CLI 下载入口获取当前平台的二进制；支持的平台文件名为 linux-x64、linux-arm64、darwin-x64、darwin-arm64。不要把 Polaris 运营 CLI 当作客户 CLI 使用。

Linux x64
curl --fail --location https://dash.token4ai.cloud/api/cli/download/linux-x64 --output token4ai
chmod +x token4ai
./token4ai auth login --host https://dash.token4ai.cloud
auth login 会显示浏览器授权链接和代码。由账户本人登录并确认后，CLI 才能获得访问权限。

常用命令

--json 用于机器读取，脚本还应检查进程退出码。通过 agent manifest 查看机器可读能力，通过 agent skill 获取接入指引，再选择相应命令。不要把 CLI 返回的管理令牌用于 api.token4ai.cloud 的模型请求。

After adding token4ai to PATH
token4ai auth status
token4ai whoami --live --json
token4ai overview --json
token4ai wallet --json
token4ai key list --json
token4ai usage --page 1 --page-size 20 --json
token4ai announcements --json
token4ai agent manifest --json

本地编码 Agent 接入

token4ai agent setup 会用一条命令写入 Codex、Claude Code、Gemini CLI 或 OpenCode 的配置。它会复用当前账户的 API Key，没有时创建一个；密钥不会出现在命令行参数或输出中。重复执行是安全的：写入前会备份原文件，保留无关字段，并在 --dry-run 下只显示计划。

  • Codex 与 OpenCode 使用 /v1；Claude Code 与 Gemini CLI 使用根地址。setup 会从 /api/public-config 读取当前网关地址，也可用 --base-url 覆盖。
  • OpenCode 配置含注释时默认拒绝覆盖；确认要保留其它内容并接受注释丢失时加 --force。Gemini CLI 与 OpenCode 的密钥写入 ~/.config/token4ai/agents/*.env（0600），并通过 shell profile 的托管块加载。
One command per agent
token4ai agent setup --agent codex
token4ai agent setup --agent claude-code
token4ai agent setup --agent gemini-cli
token4ai agent setup --agent opencode

token4ai agent status --json
token4ai agent doctor --agent codex --live --json

密钥测试与自动化约束

密钥测试会实际调用模型，可能产生费用。敏感密钥通过环境变量或标准输入传递，不作为普通命令参数。CI 可使用已授权的 TOKEN4AI_ACCESS_TOKEN，但它应对应目标控制台账户与 host。

使用完成后可执行 token4ai auth logout 撤销授权。删除资源时按 CLI 提示确认目标，避免让自动化在不了解影响范围时执行破坏性操作。

Key test
token4ai key test YOUR_KEY_ID --model YOUR_MODEL_ID --env TOKEN4AI_API_KEY

继续阅读

鉴权、API Key 与计费分组静态资源与文件目录概览、使用历史与费用排查