登录
开发者文档
编码工具(VibeCLI)

Claude Code

用 VibeCLI 把 VibeAPI 配置进 Claude Code:写了哪些配置、/model 菜单里的 GPT / Gemini / Grok / 国产模型、怎么验证、为什么这样设计、常见报错

前提:Claude Code 2.1.291 及以上;令牌能用 Claude 模型。还没有安装 Claude Code 的,setup 会问你是否安装,也可以先用安装命令安装。

配置

下面的命令里,把 sk-xxx 换成你的令牌。令牌能用 Claude 模型时,setup 会自动配置 Claude Code:

vibecli setup --key sk-xxx

只让 Claude Code 使用这个令牌:

vibecli setup --claudekey sk-xxx

打开菜单,选择模型、写入配置、移除或还原:

vibecli config claude-code

配置完成后新开一个终端,运行 claude。

一般不需要指定模型,默认用 Claude Code 自带的档位。

指定 Opus 档位使用的模型:

vibecli config tool-model set claude-code opus 'claude-opus-5-5[1m]'

再把它写进 Claude Code:

vibecli config claude-code --yes

取消指定,改回 Claude Code 的默认:

vibecli config claude-code clear-model

写了什么

settings.json 写地址、令牌、模型菜单;.claude.json 只跳过首次引导;shell 配置里删掉旧变量

settings.json 里旧的 ANTHROPIC_API_KEY 会被删掉,统一用 ANTHROPIC_AUTH_TOKEN。

验证

  1. 新开终端,运行 claude,输入 /status:Anthropic base URL 应是 VibeAPI 的地址,认证来源是 auth token。
  2. 输入 /model:能看到 Opus、Sonnet 等档位,后面是这个令牌能用的 GPT、Gemini、Grok、国产模型。
  3. 发一句话,能正常回复即配置完成。

也可以运行 vibecli doctor --deep:它检查配置是否仍指向 VibeAPI,并通过 Claude Code 实际发一条请求(消耗少量额度)。

为什么这样设计

默认不指定模型用 Claude Code 自带的档位

用默认组合时不写模型变量,Claude Code 升级后的新模型会自动出现在 /model 里;只有你明确选了别的模型才写。

档位回退令牌用不了内置模型时
令牌能用档位默认模型就照用,用不了就换成同系列第一个能用的 Claude 模型,不换成 GPT

换成能用默认模型的令牌后重新配置,回退会自动撤掉。

/model 里的其它模型GPT / Gemini / Grok / 国产
/model 菜单:Claude 自带档位,后面追加 GPT、Gemini、Grok、国产模型

上下文达到 100 万 token 的模型写成 <模型名>[1m],每个模型用到 80% 时自动压缩。最低版本定为 2.1.291:按模型设置压缩点从 2.1.288 起生效,2.1.288–2.1.290 有退出时丢消息的问题。

为什么用 AUTH_TOKEN不用 ANTHROPIC_API_KEY

ANTHROPIC_AUTH_TOKEN 是给网关用的 Bearer 凭据,ANTHROPIC_API_KEY 是直连 Anthropic 用的。两个同时存在会互相干扰,所以只保留前者。

清掉冲突的环境变量只在配置时清
shell 里 export 的变量优先级更高,会盖过 settings.json,所以配置时删掉

只在 setup、config 这类配置命令里删;doctor、base 不删,以免影响靠这些变量手动接入的用户。

推荐设置只补不改你的设置优先

你设置过的值都保留,只补没设置过的;只有「显示思考摘要」始终打开。

自动模式的安全检查CLAUDE_CODE_AUTO_MODE_SERVER=0

经第三方网关时,服务端安全检查不可用,每个动作都会停下等你回车。写入这个变量后改用本地检查;你设置过就不覆盖。

官方插件只安装一次
官方插件先从国内镜像市场安装,无法连接再用 GitHub 官方市场,都无法连接就跳过

安装 code-review、feature-dev、frontend-design 等 10 个插件,每个只安装一次,你卸载的不会再装回来;其余插件在 Claude Code 里用 /plugin 自选。安装插件需要 Git。

修改后要不要重启

已经打开的 Claude Code 会话读的是旧配置,重开一个会话即可。删了 shell 里的环境变量时,还要新开一个终端。

排障

现象原因处理
/status 里地址不是 VibeAPIshell 或企业托管配置里的变量盖过了 settings.json新开终端;运行 vibecli doctor,它会指出托管配置
第一条请求就报模型不存在令牌的分组没有 Claude Code 默认的模型重新运行 vibecli setup --key <你的令牌>,给这个档位换成能用的模型
/model 里缺某个模型这个令牌用不了它,或菜单还没同步在控制台确认令牌的分组;重新运行 vibecli setup --key <你的令牌> 立即同步
提示版本过旧Claude Code 低于 2.1.291运行 vibecli upgrade claude-code;更新渠道是 stable 时改成 latest
Windows 上提示未安装 Git没有 Git 时 Claude Code 改用 PowerShell 执行命令用安装命令安装 Git
插件没有安装未安装 Git,或镜像和 GitHub 都无法连接安装 Git 或等网络恢复后,在 Claude Code 里用 /plugin 安装

移除

运行 vibecli config claude-code remove,或在 vibecli config claude-code 的菜单里选「移除」:删掉 VibeAPI 的地址、令牌和菜单项,其它设置保留。想回到 VibeCLI 修改前的状态,运行 vibecli config claude-code restore。

最后更新于