配置 Codex 或 Claude

Provider 是 Bot 执行任务时使用的 AI。先在实际运行 Bot 的设备上准备 Codex 或 Claude，至少一种可用即可。Vonvon 可以安装所需的运行组件，并读取已有的账号或自定义 API 配置；账号认证要在原来的应用或命令行中完成。

先在原来的应用里配好#

选择账号、订阅或自定义 API 的方式，由相应 Provider 决定。请在 Provider 自己的界面完成认证；Vonvon 不提供独立的 Codex 或 Claude 登录。

回到 Vonvon 检测#

1. 首次使用时打开「准备 Provider」，选 Codex 或 Claude；以后可从设置进入「Provider」，再点相应名称。
2. 先看安装状态。若显示未安装，按页面的「安装」或「安装 SDK」处理；如果已有外部安装但版本过旧，按页面提示用原安装方式更新。
3. 在「本机配置」一行点「检测配置」或「重新检测」。配置有效后，查看「可用模型」。Codex 的模型可在此刷新；读取失败时按提示重试。

✓完成标志 首次使用页显示「已准备好」，或设置中的 Provider 显示「已就绪」，并能读到模型。

12

1. 1安装状态表示设备上能找到所需的运行组件，不能据此判断账号已可用。
2. 2本机配置先在 Codex 配好账号或 API，再回来检测；以后以本机的实际检测结果和模型列表为准。

给群选择模型和思考强度#

Provider 就绪后，在群设置的「模型与权限」进入「模型设置」。先选 Provider，再打开「可用模型」勾选允许在这个群使用的模型；可在其中标记新话题的默认模型。打开「可用思考强度」，按各模型实际支持的选项勾选，并为默认模型选择默认强度，最后保存页面设置。

群里可以用 /model 在允许范围内切换。模型和强度来自当前 Provider 的实际目录，不同设备和账号显示的选项可能不同。某些 Codex 模型若明确支持 Fast 或 Ultrafast，模型旁还会出现加速选项；开启会消耗更多额度。换 Provider 后，需要为新的 Provider 重新选择模型和强度。

如果保存时提示某个模型或强度已不可用，刷新目录，在对应选择框取消失效项并重新保存。只修改默认值时，已有话题保留自己的选择，新话题使用新默认值。若收窄可用模型或思考强度，旧话题也必须符合新范围，否则下一轮需要用 /model 重新选择；换 Provider 后按提示新开会话。

需要指定 Codex 可执行文件时#

通常让 Vonvon 自动检测 Codex 即可。若设备上有多个 Codex 安装，或检测到了不想使用的路径，打开「设置 → Provider → Codex → 高级设置 → Codex 可执行文件」，选择这台设备上的可执行文件，在弹窗中点「保存路径」。页面会分别显示「已保存路径」和「当前路径配置」；保存的路径在下次启动后台服务时使用。重启后台服务后再重新检测配置，确认路径、版本与模型读取结果符合预期。要回到自动查找，点「恢复自动检测」；如果当前后台仍在运行，重启后再核对。

这项路径属于当前选中的设备，不改变其他设备的 Codex 安装，也不改变群的 Provider 或模型。它与「应用与启动」中的「未绑定工作目录时的运行后备」是不同设置；前者选择 Codex 程序，后者处理没有绑定工作目录时如何运行。

连远程设备时，在哪台配？#

在实际运行 Bot 的那台设备上安装并配置。当前电脑上的 Codex 或 Claude 可用，不代表另一台设备也可用。先在 Vonvon 切换到运行 Bot 的设备，再查看它的 Provider 状态；连接方法见远程连接。

终端可用，Vonvon 里却不可用#

先确认正在查看的设备和 Vonvon 版本，再看 Provider 详情的具体提示。若显示「未安装」或「需要更新」，核对安装来源；手动指定过 Codex 路径时，还要核对「高级设置」中的文件是否仍存在、能否执行。若显示「未检测到可用配置」，回到 Codex 或 Claude Code 确认账号或 API 配置，再点「重新检测」。若只是模型读取失败，可刷新模型或稍后重试，别把上次读取的列表当成最新结果。

Claude Code 无法启动时，先在同一台设备的终端运行 Claude Code，处理启动错误，再回来检测。检测仍失败时，把界面上的错误文字与设备、版本一同记录下来。