🚀 @model-go/config

一键把 ModelGo 接入 12 个主流 AI 编程客户端 —— 粘贴 Key 即用

支持国际站 modelgo.ai 与国内站 modelgo.com

30 秒上手

npx -y @model-go/config -k sk-你的token

跑完直接启动，无需任何手动配置：

claude     # 启动 Claude Code
codex      # 启动 Codex

💡 不带 -r 时会先让你选择国际 / 国内站点；不带 -k 则会提示你粘贴 Key。

✨ 特性

• ✅ 一条命令配置多达 12 个 AI 编程客户端（交互多选，或 --only all 全配）
• ✅ 国际 / 国内双站，执行时用 -r 区分，无需改配置
• ✅ 交互式 / 非交互式两种模式
• ✅ 内置 BaseURL，无需手动输入
• ✅ 配置完成后自动验证链路连通性
• ✅ Claude Code / Codex 复用业界成熟的 zcf 写入逻辑

支持的客户端

| id | 客户端 | 配置写入 | |---|---|---| | claude | Claude Code | ~/.claude/settings.json（via zcf） | | codex | Codex | ~/.codex/config.toml + auth.json（via zcf） | | openclaw | OpenClaw | openclaw onboard 子命令（需先装 openclaw） | | hermes | Hermes | hermes config set，失败回退写 ~/.hermes/config.yaml | | factory | Factory Droid | ~/.factory/config.json | | cc-switch | CC Switch | ccswitch:// deeplink 唤起 | | copilot | Copilot CLI | shell 环境变量（~/.zshrc / setx） | | nanobot | nanobot | ~/.nanobot/config.json | | crush | Crush | ~/.config/crush/crush.json | | opencode | OpenCode | ~/.config/opencode/opencode.json | | oh-my-pi | Oh My Pi | ~/.omp/agent/models.yml + .env | | codebuddy | CodeBuddy | ~/.codebuddy/models.json + settings.json |

不带 --only 且交互式运行时，会弹出多选让你勾选；非交互（带 -k 无 --only）默认配 Claude Code + Codex。

安装

| 方式 | 命令 | 适用 | |---|---|---| | 免安装（推荐） | npx -y @model-go/config -k sk-xxx | 接入只需一次，跑完即走 | | 全局安装 | npm i -g @model-go/config 后 mgc -k sk-xxx | 想反复使用，mgc 为简写 |

常见用法

# 不指定站点：交互式选择国际 / 国内
npx -y @model-go/config -k sk-你的token

# 指定国际站 modelgo.ai（全程非交互）
npx -y @model-go/config -k sk-你的token -r global

# 指定国内站 modelgo.com
npx -y @model-go/config -k sk-你的token -r domestic

# 只配 Claude Code（或换成 codex）
npx -y @model-go/config -k sk-你的token --only claude

# 一次配多个客户端
npx -y @model-go/config -k sk-你的token --only claude,codex,crush

# 一键配全部 12 个客户端
npx -y @model-go/config -k sk-你的token --only all

# 跳过连通性验证
npx -y @model-go/config -k sk-你的token --skip-verify

命令行参数

| 参数 | 简写 | 说明 | |---|---|---| | --api-key <key> | -k | ModelGo API Key | | --region <area> | -r | global（国际 modelgo.ai）| domestic（国内 modelgo.com）；省略则交互选择 | | --only <list> | | 逗号分隔的客户端 id（见上表）或 all；省略则交互多选 | | --skip-verify | | 跳过连通性验证 | | --verbose | -v | 显示底层 zcf 子进程的详细输出 | | --help | -h | 显示帮助 | | --version | -V | 显示版本 |

工作原理

@model-go/config 是 zcf 的薄封装：

1. 通过交互或参数收集 API Key
2. 按 -r 选定区域，内置对应 BaseURL（国际 api.modelgo.ai、国内 api.modelgo.com）
3. 调用 npx zcf init 两次（一次配 cc Claude Code，一次配 cx Codex）
4. zcf 实际写入：
   • Claude Code → ~/.claude/settings.json（注入 ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY）
   • Codex → ~/.codex/config.toml + ~/.codex/auth.json
5. 通过 GET {BASE_URL}/v1/models 探测连通性

完全等价于手动执行（以国际站为例）：

npx -y zcf init -s --code-type cc --provider custom --api-type auth_token \
  -u https://api.modelgo.ai -k sk-xxx
npx -y zcf init -s --code-type cx --provider custom --api-type auth_token \
  -u https://api.modelgo.ai/v1 -k sk-xxx

但你只需要记住一行：npx -y @model-go/config。

ModelGo 是什么

ModelGo 是统一的 LLM 网关与 AI 模型平台：聚合多家上游模型供应商，提供统一接口、配额、计费与限流体系，支持按量付费。

开发

npm install
npm run build
node ./dist/index.js --help

License

MIT © ModelGo