@vibeapi/api-helper

一条命令，在 Claude Code / Codex / OpenClaw / Hermes / AtomCode 之间统一配置 API Key 与模型。

CLI 名：vibecli（也可用 api-helper）。需要 Node.js >= 20。

安装 / 运行

npx @vibeapi/cli@latest          # 免安装直接跑（@latest 确保拿到最新版）
npm install -g @vibeapi/cli      # 或全局安装后用 vibecli

@vibeapi/cli 与 @vibeapi/api-helper 是同一产物的双包名（同版本等价），装哪个都一样。

npmjs.com 不可用时，可直接从 CNB 备用制品库启动：

npx --yes --registry https://npm.cnb.cool/vibeapi/npm/-/packages/ @vibeapi/cli@latest

全局安装的 vibecli 每次启动都会进入自动更新预检（6 小时内复用缓存），固定按 CNB → npmjs → npmmirror → Yarn registry 查询和安装；检测到新版会自动升级并重新执行当前命令。网络或权限错误不会阻断原命令，每个安装源最长等待 45 秒，安装失败后 1 小时内不重复打扰。设置 VIBECLI_DISABLE_AUTO_UPDATE=1 可关闭启动更新。npx @latest 在 CLI 启动前由 npm 解析，因此首次下载失败时请使用上面的 CNB 命令。

快速开始

下面三种方式三选一即可，任选一种就已经配置完成 —— 不要按顺序依次执行。

方式 A：一条命令直配（推荐）

无需任何交互，粘贴即用；重复执行即换令牌。

vibecli setup --key sk-xxx

拿到的是两个分组的令牌（如 Claude 分组 + GPT 分组），就各配各的：

vibecli setup --claudekey sk-a --codexkey sk-b

Codex 同时开启 1M 上下文时，末尾加最短参数 --1m；已经配置过的用户无需再次输入 Key。单独执行 --1m 只幂等更新上下文字段，不改写 Codex 凭据：

vibecli setup --codexkey sk-xxx --1m
vibecli setup --1m
vibecli setup --no-1m

配完直接运行 claude / codex 即可。

方式 B：交互式向导

想在菜单里挑工具和模型时用（中文系统自动中文界面，非中文系统先选语言）：

vibecli init

方式 C：CI / 脚本

vibecli auth sk-xxx --non-interactive
vibecli config claude-code --non-interactive

配完之后

vibecli status                            # 查看当前配置
vibecli config claude-code clear-model    # 模型选择被钉住时，交还给工具自带默认（保留 API Key）

能做什么

• 多工具一键配置：把当前 API Key / 模型注入 Claude Code、Codex、OpenClaw、Hermes、AtomCode（OpenCode 暂时下架，vibecli config opencode 仍可用）。
• 按工具选模型：使用默认 / 实时从 API 拉取 / 内置预设 / 手动输入；每个工具可用不同模型。
  • Claude Code 用默认模型时不写 ANTHROPIC_*_MODEL 环境变量，顶层 model 由 settings-template.json 提供（当前为 opus[1m]）；显式选择其它模型时会覆盖该模板值。Codex 默认 gpt-5.6-sol，其余工具默认 gpt-5.5。
  • Codex 默认启用 1M 上下文窗口（自动压缩阈值 900K）；交互配置 Codex 时可取消。
• 不动你的其它配置：只改本工具的 provider 字段，你的 hooks、MCP、插件、权限设置原样保留。
• 改前自动备份 + 一键还原：覆盖配置前先快照（每文件留 10 份），vibecli config <tool> restore 随时回退；还原本身也可再撤销。
• 多 Profile + 可迁移凭据：work/personal 各自独立；API Key 存在权限为 0600 的 ~/.vibecli/config.yaml，与 Claude/Codex 本身的明文凭据方式一致，换机不会被主机绑定加密阻断。
• CI 友好：所有命令支持 --json / --non-interactive / --yes / --dry-run / --no-color。

常用命令

vibecli config <tool>                 # 配置某工具（选模型 → 应用 / 移除 / 还原）
vibecli config <tool> restore         # 还原该工具到上次更改前
vibecli config <tool> clear-model     # 清掉钉死的模型设置，回到工具自带默认（保留 API Key）
vibecli config tool-model set codex gpt-5.6-sol   # 单独给某工具指定模型
vibecli config profile use work       # 切换 profile
vibecli doctor                        # 健康巡检

支持

主页 https://www.vibeapi.cn/ · 反馈 https://www.vibeapi.cn/support · CNB 备用制品库

License

UNLICENSED — 仅供 VibeAPI 用户使用，详见随包附带的 LICENSE。