Token4AI CLI 与 Agent Skill

把后台操作带进你的开发流程。用 token4ai 命令查询余额与用量、管理 API Key 和文件，并用 `token4ai agent setup` 一条命令接入 Codex、Claude Code、Gemini CLI 或 OpenCode；配套 Skill 帮助 Agent 选择命令、理解返回值并完成你交代的操作。

作者：Token4AI Cloud 产品团队

1. 安装 CLI

Vega CLI 面向客户的命令名是 token4ai。选择你的实际系统架构，在终端执行以下命令，不需要 Node.js 或 Bun。

macOS · Apple Silicon

mkdir -p "$HOME/.local/bin" &&
curl --fail --show-error --location https://dash.token4ai.cloud/api/cli/download/darwin-arm64 -o "$HOME/.local/bin/token4ai" &&
chmod +x "$HOME/.local/bin/token4ai" &&
export PATH="$HOME/.local/bin:$PATH" &&
token4ai --help

Windows 请在 WSL2 中使用对应的 Linux 版本；macOS 可在“关于本机”查看芯片。重新打开终端后，若找不到命令，将上面的 export PATH 行加入 ~/.zshrc 或 ~/.bashrc，也可直接运行 ~/.local/bin/token4ai。

2. 在浏览器中授权

CLI 会显示授权链接与授权码。打开链接，登录你的 Token4AI 账户并确认本次设备授权，然后回到终端查看登录状态。浏览器已经登录也需要完成这一步。

Authorization

token4ai auth login --host https://dash.token4ai.cloud
token4ai auth status

授权令牌用于访问你的租户后台，与调用模型的 API Key 不同。无需把账户密码或 API Key 填入安装命令。

3. 验证连接，读取账户数据

先查看当前身份、余额和最近 5 条请求。--json 提供便于脚本和 Agent 解析的输出；这些命令只读取数据。若返回 401，请重新运行 token4ai auth login 并在浏览器确认授权；auth status 显示的是本地授权状态，不能代替实际接口验证。

Read-only commands

token4ai whoami --json
token4ai balance --json
token4ai usage --page-size 5 --json

4. 把 Skill 交给你的 Agent

在项目根目录选择 Codex 或 Claude Code，保存官方 SKILL.md，然后重新打开 Agent 会话。其他兼容工具也可以直接读取 Skill 链接。

Codex · SKILL.md

mkdir -p .agents/skills/token4ai
curl --fail --show-error --location https://dash.token4ai.cloud/api/cli/skill -o .agents/skills/token4ai/SKILL.md

试试把这段话发给 Agent

使用 token4ai skill 检查我当前的登录身份、账户余额和最近 5 条用量记录，并用中文总结。只查询，不创建或删除资源。

这份 Skill 管理的是你的 Token4AI 账户；云端 Agent 的运行环境在“AI AGENT → 运行设备”中配置。Agent 不能代替你完成浏览器设备授权。

查看 Skill 命令与接口清单

API Key

查看密钥与当前计费分组，再配置应用访问。

API Key

token4ai key list --json
token4ai key groups --provider openai --json

文件与资产

列出账户文件，查看存储用量。

文件与资产

token4ai asset list --json
token4ai asset storage --json

账单与支持

核对充值订单、查看工单进度。

账单与支持

token4ai billing orders --json
token4ai support tickets --json

需要结束授权时运行 token4ai auth logout。创建密钥后请立即保存一次性返回的密钥；删除等操作会修改账户资源，请确认目标后执行。

Token4AI CLI 与 Agent Skill

1. 安装 CLI

2. 在浏览器中授权

3. 验证连接，读取账户数据

4. 把 Skill 交给你的 Agent

继续阅读

AI 网关：统一 API 接入所有大模型

OpenAI 兼容 API 接入：Base URL、模型与 Key

AI Agent Cloud：云端 Agent 托管与编程任务

Token 用量、成本跟踪与 API Key 管理