命令行工具
ModelGo 提供两个官方命令行工具。选择你要完成的任务，运行对应命令即可开始。
接入 AI 编程客户端
一条命令配置 Claude Code、Codex 等常用客户端。
bash
npx @model-go/config -r domestic使用官方 CLI
配合官方 ModelGo Skills，让 AI Agent 直接操作 ModelGo。
bash
npx @model-go/cli@latest install接入 AI 编程客户端 @model-go/config
如果你想在 Claude Code、Codex、OpenCode 等 AI 编程客户端中使用 ModelGo，可以选择引导式配置，也可以通过一条命令完成全部客户端配置。
引导式配置
根据终端提示输入 API Key、选择客户端并预览配置，确认后自动写入并验证连接。
bash
npx @model-go/config -r domestic一键式配置（非交互，适合自动化）
bash
npx @model-go/config -k sk-你的token -r domestic --only all支持的客户端
Claude Code
Hermes
Copilot CLI
OpenCode
Codex
Factory Droid
nanobot
Oh My Pi
OpenClaw
CC Switch
Crush
CodeBuddy
引导式配置支持勾选一个或多个客户端；使用 --only all 可一次配置全部客户端。
运行后会发生什么
| 步骤 | 引导内容 |
|---|---|
01 | 输入你的 ModelGo API Key。 |
02 | 勾选需要配置的客户端，也可以选择“全部配置”。 |
03 | 预览站点、Base URL、脱敏后的 API Key 和目标客户端。 |
04 | 确认后写入客户端配置，并自动验证连接。 |
配置成功： 终端会显示“配置完成”和“链路验证通过”，并给出启动所选客户端的命令。
让 AI Agent 操作 ModelGo @model-go/cli
如果你希望 Claude Code、Codex 等 Agent 直接使用 ModelGo，安装官方 CLI 和 ModelGo Skills。安装向导会完成 CLI 设置、Skills 分发、站点选择和可选登录。
bash
npx @model-go/cli@latest install运行后会发生什么
| 步骤 | 引导内容 |
|---|---|
01 | npm 首次运行时，确认安装 @model-go/cli。 |
02 | 选择安装向导语言，支持中文和英文，后续安装提示将使用所选语言。 |
03 | 安装或升级 ModelGo CLI，并安装 ModelGo Skills。 |
04 | 在向导中选择当前站点环境（https://api.modelgo.com）。 |
05 | 选择是否立即通过浏览器登录；也可以跳过并稍后运行 modelgo auth login。 |
安装后如何使用
安装完成后，重新启动 AI Agent 或新建会话。ModelGo Skills 会让 AI Agent 直接调用 ModelGo CLI 完成查询和操作，你可以用自然语言向它提问，例如：
- “当前 ModelGo 支持的模型有哪些？”
- “当前 ModelGo 的账户余额还剩多少？”
如果你希望自己在终端操作，输入 modelgo 即可查看全部可用命令和参数说明：
bash
modelgo常用能力按使用场景分为以下几类：
| 使用场景 | 常用命令 | 说明 |
|---|---|---|
| 登录与身份 | modelgo auth login、modelgo auth status、modelgo auth logout | 登录 ModelGo、查看当前登录状态或清除本地登录信息。 |
| 站点环境 | modelgo env list、modelgo env current、modelgo env use <name> | 查看可用环境、确认当前环境或切换站点；也可以通过 env add 和 env remove 管理自定义环境。 |
| 工作空间 | modelgo tenant list、modelgo tenant use <slug> | 查看当前账号可用的工作空间，并通过工作空间 slug 或 ID 切换 CLI 后续操作使用的工作空间。 |
| 账户与用量 | modelgo balance、modelgo permissions、modelgo logs | 查看余额和交易记录、账号权限、调用日志及用量统计。 |
| 模型调用 | modelgo models、modelgo chat、modelgo embeddings、modelgo call | 查询可用模型，发起对话或向量请求，或直接调用任意 /v1/* 模型接口。 |
| Key 与支付 | modelgo key、modelgo pay | 管理当前环境保存的模型 API Key，或管理 x402 按次支付配置。 |
| CLI 维护 | modelgo update、modelgo --version、modelgo --help | 更新 CLI、查看版本或重新打开完整帮助。 |
需要查看某个命令的参数时，运行 modelgo <command> --help。对于 balance、permissions 和 logs，还可以使用全局参数 --tenant <slug\|id> 临时指定本次查询的工作空间。