> 内容来源：Onevium 官方文档 > 文章: 连接 Claude Code 与其他模型服务商 > 原文: https://onevium.com/zh/docs/providers > 语言：简体中文 > 更新于: 2026-09-22 > 适用版本: 1.2.0+ --- # 连接 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 服务 → 自定义服务** | 按供方的接口类型配置，见[自定义连接](https://onevium.com/zh/docs/providers/custom) | 登录 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 兼容接口。自己配置网关时，应选择与网关一致的[连接类型](https://onevium.com/zh/docs/providers/custom#fields)。 名字以 **(1M)** 结尾的条目在 Claude Code 中按 1M 上下文窗口运行。OpenAI、Grok 和 Gemini 连接不会自动获得该窗口，需要添加的模型条目见[1M 上下文窗口](https://onevium.com/zh/docs/providers/context-window)。 表中的名称用于找到菜单选项，不是模型 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 预设 1. 打开 **设置 → 服务商 → 添加 AI 服务**。 2. 在 **聊天服务** 中找到 **DeepSeek**，点击 **连接**。 3. 粘贴自己 DeepSeek 账户的 API Key。预设会带入 `https://api.deepseek.com/anthropic` 和 Bearer 认证。 4. 检查 **显示的模型**，至少保留一个。首次连接先保留高级选项默认值。 5. 点击 **连接**。看到已保存的服务商记录后，回到聊天。 6. 在输入框的模型菜单中找到 **DeepSeek** 分组，选择 **DeepSeek V4.1 Flash** 或账户可用的对应选项。 OpenAI、Grok、Gemini 等预设也按这个流程添加，使用各自账户的 Key。保存记录不会自动测试上游，也不会切换所有会话。 以下保留的截图来自较早版本，字段位置和模型名称可能不同；按上面的步骤及当前应用菜单操作。 ![DeepSeek 预设连接表单](https://onevium.com/assets/docs/providers-connect-zh.png "真实组件的隔离示例：填写自己的 API Key，并选择可见模型；保存配置后仍需验证实际请求。") ## 管理模型与默认推理力度 开始任务前核对输入框中的服务商和模型。同名模型可能属于不同连接；以菜单选择为准，不用模型在回复中自报的名字判断。 在 **设置 → 服务商 → 已保存的服务商 → 管理模型** 中，可以显示或隐藏模型，也可以补充供方确认的真实模型 ID。每条聊天连接至少保留一个可见模型。具体字段见[模型条目与角色映射](https://onevium.com/zh/docs/providers/custom#model-routing)。 同一窗口中的 **默认推理力度** 按服务商和模型设置，修改后即时保存，作为新会话的默认值。已有会话保留自己的选择；临时调整当前任务时，在聊天输入框修改即可。只有支持可选力度的模型才显示相应设置。 服务商连接在应用内共享，会话各自保存选择。渠道与自动化也有独立配置，切换当前聊天不会全部改变它们。 **断开连接会删除服务商记录。** 日常换模型直接在输入框选择；删除前先把仍引用它的会话、渠道和自动化改为其他可用连接。 ## 先检查配置，再验证实际请求 点击已保存记录旁的听诊器图标 **检查配置**。它只检查本地地址、凭据和模型记录，**不会请求上游服务**。 然后选择目标模型，发送一个小请求： ```text 用一句话确认收到这条消息。 不要读取文件或执行命令。 ``` 文字回复成功后，在有 README.md 的测试项目里验证一次工具： ```text 只读取项目根目录的 README.md，概括其中的运行步骤。 如果文件不存在就说明，不要创建或修改文件，也不要执行命令。 ``` 检查是否出现实际文件读取工具及返回结果。若要使用图像生成、子 Agent、渠道或自动化，再在对应入口完成一次验证；文字回复不代表这些能力都已通过测试。 ## 排查常见问题 | 现象 | 优先检查 | | ----------------------------- | ------------------------------------------------- | | 401 或认证失败 | Key 是否属于当前地区和产品；是否误加了 `Bearer ` 前缀；自定义连接的认证类型是否正确 | | 模型不存在或无权访问 | 当前服务商、真实模型 ID、账户权限；预设目录不等于账户已开通 | | 找不到 OpenAI、Grok 或 Gemini 聊天入口 | 核对应用版本，在 **添加 AI 服务 → 聊天服务** 中查找；不要选择带“图像”的连接 | | 自定义连接仍显示 Claude 模型 | 核对连接类型并补齐真实模型条目；Anthropic 兼容连接还需检查角色映射 | | 超时或连接失败 | API 地址、网络和 **设置 → 网络代理**；代理地址不能填进模型 API 地址 | | 文字正常，工具报错 | 查看失败工具和上游错误，确认该接口与模型支持需要的工具能力 | | 换电脑后密钥无法解密 | 编辑该服务商，重新输入原账户的 API Key 并保存 | | 渠道或自动化仍使用旧模型 | 检查对应渠道或自动化自己的模型选择 | ## 下一步 连接可用后，完成[第一个任务](https://onevium.com/zh/docs/getting-started)。团队网关见[自定义服务商](https://onevium.com/zh/docs/providers/custom)；任务能做哪些操作，见[权限与计划](https://onevium.com/zh/docs/permissions)。