一键配置编码工具
一条命令安装并配置 Claude Code、Codex、Grok Build、Antigravity CLI
先在控制台的「令牌」页新建一个令牌并复制（sk- 开头），再把下面一条命令复制到终端运行，即可安装并配置好编码工具。
电脑上还没有 Node.js 和 Git 也可以运行：命令会自动安装它们。新 Mac 弹出「安装命令行开发者工具」时，点击「安装」即可。
运行后按提示粘贴令牌（显示为 *，回车后会告诉你令牌是否有效）：
curl -fsSL https://vibecli.cn | sh && exec "$SHELL" -l也可以把令牌写在命令里（把 sk-xxx 换成你的令牌）：
curl -fsSL https://vibecli.cn | sh -s -- --key sk-xxx && exec "$SHELL" -l在 PowerShell 里运行，运行后按提示粘贴令牌：
irm https://vibecli.cn | iex也可以把令牌写在命令里（把 sk-xxx 换成你的令牌）：
& ([scriptblock]::Create((irm https://vibecli.cn))) --key sk-xxx
命令运行完，编码工具就已安装并配置好，在终端输入 claude、codex、grok 或 agy 即可使用，不需要再做下面的「手动安装」。遇到问题见常见问题。
工作原理与设计
一次 setup 做了什么，为什么只合并不覆盖，令牌怎么保存和发送，模型菜单从哪来。
各工具一览
Claude Code、Claude Desktop、Codex、Grok Build、Antigravity 各一页：写了什么、怎么验证、为什么这样设计。
命令参考
setup、config、base、doctor、upgrade 等命令与参数的完整说明。
配置、备份与安全
令牌存在哪，备份与还原，profile，自动更新与模型同步。
常见问题
配置后不生效、证书报错、Codex 401、旧会话不见了……
手动安装
用过页首命令的，可以跳过这一节。
常用命令
| 命令 | 作用 |
|---|---|
vibecli status | 查看当前配置 |
vibecli doctor | 检查网络、令牌、版本、配置 |
vibecli upgrade | 升级编码工具，官方渠道无法连接时改用国内镜像 |
vibecli config <工具> | 单独配置某个工具 |
vibecli config <工具> restore | 回到上一次修改前 |
vibecli config <工具> clear-model | 改回工具自带的默认模型 |
vibecli config <工具> --force | 整份重写为推荐配置 |
<工具> 可以是 claude-code、codex、grok、agy、claude-desktop。完整命令见命令参考。
主站无法连接
校园网、酒店网络有时会出现证书报错，或者请求一直超时。运行下面的命令，VibeCLI 会按顺序测试接入地址，换到第一个能用的：
vibecli base auto查看所有接入地址：
vibecli base网络恢复后回到主站：
vibecli base default最后更新于