CLI 一键配置
使用 Models Hub CLI 自动配置 Claude Code、Codex、Gemini CLI 和 OpenClaw。
Models Hub CLI 是一个本地命令行配置工具，可以把 Models Hub 的 API Key、API 地址和默认模型一键写入主流 Agent 工具的本地配置文件，省去逐个手动编辑的麻烦。
适用场景
- 已经有 Models Hub API Key，希望快速把常用 Agent 工具接入 Models Hub。
- 同一台电脑上同时使用 Claude Code、Codex、Gemini CLI 或 OpenClaw，不想逐个编辑配置文件。
- 需要在新电脑、服务器或团队环境里用脚本快速初始化 Agent 工具配置。
- 对 Claude Code、Gemini CLI 等会合并写入，尽量保留你已有的其它设置。
一键安装
根据你的操作系统选择对应命令安装（命令会根据你当前访问的站点域名自动生成）：
curl -fsSL https://your-domain/cli/install.sh | sh安装完成后，重新打开终端或 PowerShell，确认命令可用：
models --help安装位置
macOS、Linux 和 Windows 默认都安装到 ~/.local/bin/models（Windows 即 %USERPROFILE%\.local\bin\models.exe）。如果提示找不到 models 命令，请确认安装目录已加入 PATH，或重新打开终端。支持的系统：macOS（Intel / Apple Silicon）、Linux（x64 / arm64）、Windows（x64 / arm64）。
交互式配置
直接运行：
modelsCLI 会显示交互式菜单，你可以选择配置全部工具，或只配置某一个目标。按提示先输入接入网址（即你当前使用的站点域名，末尾不要带 /），再输入 Models Hub API Key和模型名称后，工具会自动写入对应平台的配置文件。
支持的目标：
| 目标 | 说明 |
|---|---|
all | 一次性配置 Claude Code、Codex、Gemini CLI 和 OpenClaw |
claude | 配置 Claude Code |
codex | 配置 Codex CLI |
gemini | 配置 Gemini CLI |
openclaw | 配置 OpenClaw |
非交互式配置
适合脚本、CI 或批量初始化。--yes 会对未指定的 API 地址和模型使用默认值，全程无需人工输入：
# 用一个 API Key 一次性配置全部工具
models configure --target all --api-key <你的_API_KEY> --yes
# 只配置 Claude Code 和 Codex
models configure --target claude,codex --api-key <你的_API_KEY>
# 也可以通过环境变量提供 API Key
export MODELS_API_KEY=<你的_API_KEY>
models configure --target all --yes命令行选项
| 选项 | 说明 |
|---|---|
--target <list> | 目标工具：codex、claude、gemini、openclaw 或 all（默认 all） |
--base-url <url> | 接入网址（即你当前使用的站点域名，末尾不要带 /） |
--api-key <key> | API 密钥；未提供时会提示输入，或读取环境变量 MODELS_API_KEY |
--model <model> | 所有选中工具统一使用同一个模型 |
--codex-model <name> | 单独指定 Codex 使用的模型 |
--claude-model <name> | 单独指定 Claude Code 使用的模型 |
--gemini-model <name> | 单独指定 Gemini CLI 使用的模型 |
--yes | 对未提供的基础 URL 和模型使用默认值 |
-h, --help | 显示帮助 |
默认模型：Codex 为 gpt-5.5，Claude Code 为 claude-sonnet-4-6，Gemini CLI 为 gemini-3.1-pro-preview。
写入的配置文件
运行后，CLI 会把 API Key、Base URL 和模型写入各工具的标准配置位置：
| 工具 | 写入文件 |
|---|---|
| Codex | ~/.codex/config.toml、~/.codex/auth.json |
| Claude Code | ~/.claude/settings.json（合并 env，保留已有设置） |
| Gemini CLI | ~/.gemini/settings.json、~/.gemini/.env |
| OpenClaw | ~/.openclaw/openclaw.json、~/.openclaw/.env |
配置完成后，直接启动对应工具即可使用 Models Hub 的模型服务，无需再手动设置环境变量。
提示：写入配置后，对应工具的所有请求都会走 Models Hub 接入点（
ANTHROPIC_BASE_URL/OPENAI_BASE_URL等），使用你的 Models Hub 额度，而不再走各家官方账号。
更多 Agent 工具配置入口
以下卡片与 接入 Agent 工具 页面保持一致。你可以继续查看每个工具的详细配置方式。