# 配置 Codex 或 Claude

> 安装并配置 Provider，复用已有的账号、订阅或 API。

来源：https://vonvon.cc/docs/providers/
更新时间：2026-11-04

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

## 先在原来的应用里配好

Codex

在 Codex App 或 Codex 命令行中完成登录，或配置好要使用的 API 与模型，并确认能正常执行任务。Vonvon 可检测已有安装；没有 Codex 时，在 Provider 页面按提示安装。

Claude

先在 Claude Code 中完成账号登录或 API 配置，并确认能运行。Vonvon 使用 Claude Agent SDK 组件；在 Provider 页面安装 SDK 后，仍需检测 Claude Code 的现有配置。

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

## 回到 Vonvon 检测

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

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

![Codex 详情中的安装与本机配置是两行独立状态；示例已安装组件，但尚未配置账号或 API，可以点击检测配置。](https://vonvon.cc/bot/docs/provider-codex.png)

Codex 详情 · 示例：已安装，尚未配置账号

1.  **安装状态**：表示设备上能找到所需的运行组件，不能据此判断账号已可用。
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 状态；连接方法见[远程连接](https://vonvon.cc/docs/remote/)。

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

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

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

排错时保留这些信息

系统、Vonvon 版本、Provider 类型、检测结果与错误文字。分享前遮住 API Key、凭据和个人信息。