连接 Claude Code 与其他模型服务商
在 Onevium 登录 Claude Code，或连接 OpenAI、Grok、Gemini、DeepSeek、GLM、Kimi 与 MiniMax。了解聊天和图像模型的入口、选择与验证。
开始使用先选择连接方式#
只需先接通一个你已有账户的服务，就能开始第一个任务。以后可以增加其他服务，在会话里切换模型。
| 你已经有什么 | 在哪里连接 | 连接后做什么 |
|---|---|---|
| Claude Code 登录或订阅授权 | 打开 Claude Code 连接状态面板，使用登录入口；在内置终端完成登录 | 在聊天模型菜单的 Claude Code 分组选择模型 |
| 模型服务商的 API Key 或 Coding Plan 凭据 | 设置 → 服务商 → 添加 AI 服务，选择对应预设 | 在聊天输入框选择该服务商和模型 |
| 团队网关的地址、密钥和模型 ID | 添加 AI 服务 → 自定义服务 | 按供方的接口类型配置，见自定义连接 |
登录 Onevium、激活 Onevium 许可证与取得模型服务的使用权限是不同事项。Claude 订阅登录也不会生成可填入服务商表单的 API Key。
准备正确的账户与凭据#
确认自己的 Key 属于哪家服务、哪个地区、普通 API 还是 Coding Plan。Kimi Coding Plan 与 Moonshot 开放平台是两个入口；GLM、Moonshot、MiniMax 也要区分中国区和国际区。预设表单中的 获取 API 密钥 和 官方接入说明 可以帮助你确认。
密钥只填入 API Key 字段，不发送到聊天，也不放进截图。预设会选好认证方式；即使使用 Bearer 认证，也只填原始凭据，不加 Bearer 前缀。
查看聊天与图像模型#
打开 设置 → 服务商 → 添加 AI 服务。以下是 1.2.0 内置目录中的主要选择，展示的是应用预设，并非实时查询你账户的权限。
聊天服务
这些连接都可在聊天输入框选择。预设会填好地址和接口类型，通常只需要你的 API Key。
| 界面中的服务 | 使用的账户或入口 | 预设模型示例 |
|---|---|---|
| Anthropic | Anthropic API Key；与 Claude Code 登录分开 | Opus 5、Fable 5.1、Sonnet 5、Haiku 4.5；另有旧版条目 |
| OpenAI | OpenAI API Key；Responses 接口 | GPT-6 Astra、GPT-5.6 Sol、Terra、Luna |
| Grok | xAI API Key；Responses 接口 | Grok 4.7、Grok 4.6（4.7 随下一个版本提供） |
| Google Gemini | Google API Key；Gemini 接口 | Gemini 3.8 Flash、Gemini 3.5 Flash-Lite |
| DeepSeek | DeepSeek 开放平台 API Key | DeepSeek V4.1 Flash (1M)、DeepSeek V4.1 Flash |
| GLM (CN) / z.ai (Global) | 对应地区的 GLM Code Plan | GLM-5.3 (1M)、GLM-5.3-Flash (1M) |
| Kimi Coding Plan | Kimi Code 编程套餐 | Kimi K3 (256K)、Kimi K2.7 Code、Kimi K2.7 Code Highspeed |
| Moonshot (CN / Global) | 对应地区的 Moonshot 开放平台 API | Kimi K3 (1M)、Kimi K2.7 Code、Kimi K2.7 Code Highspeed、Kimi K2.6 |
| MiniMax (CN / Global) | 对应地区的 MiniMax Code Plan | MiniMax-M3 (1M)、MiniMax-M2.7、MiniMax-M2.7 Highspeed |
OpenAI、Grok 和 Google Gemini 可以使用各自的原生 API 连接聊天。Anthropic、DeepSeek、GLM、Kimi、Moonshot 和 MiniMax 预设使用 Anthropic 兼容接口。自己配置网关时，应选择与网关一致的连接类型。
名字以 (1M) 结尾的条目在 Claude Code 中按 1M 上下文窗口运行。OpenAI、Grok 和 Gemini 连接不会自动获得该窗口，需要添加的模型条目见1M 上下文窗口。
表中的名称用于找到菜单选项，不是模型 ID 填写清单。例如 DeepSeek V4.1 Flash 使用 deepseek-flash，Kimi Coding Plan 的 K3 主模型使用 k3-256k，Moonshot K3 则使用 kimi-k3[1m]。不要互换不同入口的 ID。已有自定义配置也可能与新预设不同；以自己的账户权限和实际请求结果为准。
图像生成
需要生成图片时，在同一个添加窗口的 图像生成 分组连接：
| 图像服务 | 预设模型选择 | 凭据 |
|---|---|---|
| OpenAI（图像） | GPT Image 2.5 Flare、GPT Image 2.5 Sunburst | OpenAI API Key |
| Google Gemini（图像） | Nano Banana 2、Nano Banana 2 Lite、Nano Banana Pro | Google API Key |
保存后，在服务商记录中设置 默认图片模型。有多个图像连接时，点击需要使用的那条记录上的 设为默认图像服务。图像服务不会出现在聊天模型菜单里；选择 GPT 或 Gemini 聊天连接，也不会自动替你配置图像服务。
例子：连接 DeepSeek 预设#
- 打开 设置 → 服务商 → 添加 AI 服务。
- 在 聊天服务 中找到 DeepSeek，点击 连接。
- 粘贴自己 DeepSeek 账户的 API Key。预设会带入
https://api.deepseek.com/anthropic和 Bearer 认证。 - 检查 显示的模型，至少保留一个。首次连接先保留高级选项默认值。
- 点击 连接。看到已保存的服务商记录后，回到聊天。
- 在输入框的模型菜单中找到 DeepSeek 分组，选择 DeepSeek V4.1 Flash 或账户可用的对应选项。
OpenAI、Grok、Gemini 等预设也按这个流程添加，使用各自账户的 Key。保存记录不会自动测试上游，也不会切换所有会话。
以下保留的截图来自较早版本，字段位置和模型名称可能不同；按上面的步骤及当前应用菜单操作。
真实组件的隔离示例：填写自己的 API Key，并选择可见模型；保存配置后仍需验证实际请求。
管理模型与默认推理力度#
开始任务前核对输入框中的服务商和模型。同名模型可能属于不同连接；以菜单选择为准，不用模型在回复中自报的名字判断。
在 设置 → 服务商 → 已保存的服务商 → 管理模型 中，可以显示或隐藏模型，也可以补充供方确认的真实模型 ID。每条聊天连接至少保留一个可见模型。具体字段见模型条目与角色映射。
同一窗口中的 默认推理力度 按服务商和模型设置，修改后即时保存，作为新会话的默认值。已有会话保留自己的选择；临时调整当前任务时，在聊天输入框修改即可。只有支持可选力度的模型才显示相应设置。
服务商连接在应用内共享，会话各自保存选择。渠道与自动化也有独立配置，切换当前聊天不会全部改变它们。
断开连接会删除服务商记录。 日常换模型直接在输入框选择；删除前先把仍引用它的会话、渠道和自动化改为其他可用连接。
先检查配置，再验证实际请求#
点击已保存记录旁的听诊器图标 检查配置。它只检查本地地址、凭据和模型记录，不会请求上游服务。
然后选择目标模型，发送一个小请求：
用一句话确认收到这条消息。
不要读取文件或执行命令。
文字回复成功后，在有 README.md 的测试项目里验证一次工具：
只读取项目根目录的 README.md，概括其中的运行步骤。
如果文件不存在就说明，不要创建或修改文件，也不要执行命令。
检查是否出现实际文件读取工具及返回结果。若要使用图像生成、子 Agent、渠道或自动化，再在对应入口完成一次验证；文字回复不代表这些能力都已通过测试。
排查常见问题#
| 现象 | 优先检查 |
|---|---|
| 401 或认证失败 | Key 是否属于当前地区和产品；是否误加了 Bearer 前缀；自定义连接的认证类型是否正确 |
| 模型不存在或无权访问 | 当前服务商、真实模型 ID、账户权限；预设目录不等于账户已开通 |
| 找不到 OpenAI、Grok 或 Gemini 聊天入口 | 核对应用版本，在 添加 AI 服务 → 聊天服务 中查找；不要选择带“图像”的连接 |
| 自定义连接仍显示 Claude 模型 | 核对连接类型并补齐真实模型条目；Anthropic 兼容连接还需检查角色映射 |
| 超时或连接失败 | API 地址、网络和 设置 → 网络代理；代理地址不能填进模型 API 地址 |
| 文字正常，工具报错 | 查看失败工具和上游错误，确认该接口与模型支持需要的工具能力 |
| 换电脑后密钥无法解密 | 编辑该服务商，重新输入原账户的 API Key 并保存 |
| 渠道或自动化仍使用旧模型 | 检查对应渠道或自动化自己的模型选择 |