使用指南
返回主页

外观

Qoder 配置 ​

Qoder 是一款 AI 编程助手。这里通过 OpenAI Compatible（兼容 OpenAI 接口格式）连接 custom，并在 Qoder 的“自定义”模型中完成验证。

配置时会用到三个名称：Base URL 是 Qoder 访问 custom 的接口地址，API Key 是验证调用权限的密钥，Model ID 是要使用的模型名称。请直接复制页面提供的值，不要照着截图输入。

接入协议OpenAI Compatible / Chat Completions
打开安装说明

配置步骤

  1. 1

    打开 Qoder，点击窗口左下角账户信息旁的设置齿轮。

  2. 2

    在弹出的账户菜单中点击“设置”。

  3. 3

    在设置左侧菜单点击“模型”。

  4. 4

    点击模型页面右上角的“+ 添加模型”。

  5. 5

    在供应商列表的“自定义”区域选择“OpenAI Compatible”。

  6. 6

    API 类型选择 Chat Completions API；接口地址（Base URL）粘贴下方地址，API Key 粘贴自己的完整密钥，Model ID 填写下方模型名称，然后点击“下一步”。

  7. 7

    检查模型配置后点击“校验并添加模型”，等待校验完成。

  8. 8

    看到“模型已保存”后点击“完成”。

  9. 9

    点击左侧上方的“返回应用”，回到 Qoder 主界面。

  10. 10

    点击输入框底部的 Auto 模型菜单，切换到“自定义”，再选择刚添加的 custom 模型。

  11. 11

    在输入框输入一句简单问候，例如“你好”，然后点击右下角发送按钮。

  12. 12

    看到模型正常回复，即表示 Qoder 已经连通 custom。

复制配置

Qoder → 设置 → 模型 → 添加模型

供应商: OpenAI Compatible
API 类型: Chat Completions API
接口地址（Base URL）: 
API Key: sk-your-api-key
Model ID: gpt-5.6-sol

填写后点击“下一步”，再点击“校验并添加模型”；看到模型已保存后点击“完成”。

看图操作

Qoder 配置流程图

按照 12 张 Qoder macOS 中文界面截图，从设置进入模型管理，添加 OpenAI Compatible 自定义模型，校验后返回应用并发送消息验证。

截图中的供应商名称是示例，仅用于定位操作入口。实际供应商名称或 ID 统一填写 custom；地址、密钥和模型请使用本页复制区的值。

界面可能随版本变化
  1. 第 1 步

    点击账户旁的设置齿轮

    1. 1

      点击账户信息右侧的设置齿轮。

    打开 Qoder，点击窗口左下角账户信息右侧的设置齿轮。截图中的账号信息已脱敏。

    自行采集Qoder 当前 macOS 中文界面
  2. 第 2 步

    在账户菜单中点击设置

    1. 1

      点击账户菜单顶部的“设置”。

    账户菜单展开后，点击菜单顶部的“设置”。

    自行采集Qoder 当前 macOS 中文界面
  3. 第 3 步

    进入模型设置

    1. 1

      点击左侧导航中的“模型”。

    在设置左侧导航中找到并点击“模型”。模型设置页用于管理 Qoder 可使用的模型。

    自行采集Qoder 当前 macOS 中文界面
  4. 第 4 步

    点击添加模型

    1. 1

      点击右上角的“+ 添加模型”。

    进入模型页面后，点击右上角的“+ 添加模型”。

    自行采集Qoder 当前 macOS 中文界面
  5. 第 5 步

    选择 OpenAI Compatible

    1. 1

      在“自定义”区域点击“OpenAI Compatible”。

    在供应商列表底部的“自定义”区域，点击“OpenAI Compatible”。它表示使用兼容 OpenAI 格式的接口。

    自行采集Qoder 当前 macOS 中文界面
  6. 第 6 步

    填写模型连接信息

    1. 1

      确认 API 类型为“Chat Completions API”。

    2. 2

      接口地址（Base URL）粘贴页面复制区的 /v1 地址。

    3. 3

      API Key 粘贴自己的完整密钥。

    4. 4

      Model ID 填写页面复制区当前显示的模型名称。

    5. 5

      检查字段后点击“下一步”。

    API 类型选择“Chat Completions API”；接口地址（Base URL）粘贴页面复制区提供且只含一次 /v1 的地址；API Key 粘贴自己的完整密钥；Model ID 填写页面复制区显示的模型。填写完成后点击“下一步”。截图中的地址已脱敏、密钥已隐藏，模型名仅用于定位字段。

    自行采集Qoder 当前 macOS 中文界面
  7. 第 7 步

    校验并添加模型

    1. 1

      点击“校验并添加模型”。

    检查模型名称和 Model ID 后，点击右下角的“校验并添加模型”。Qoder 会先验证接口是否可用。

    自行采集Qoder 当前 macOS 中文界面
  8. 第 8 步

    完成模型保存

    1. 1

      点击“完成”关闭保存提示。

    看到“模型已保存”提示后，点击右下角的“完成”，结束添加流程。

    自行采集Qoder 当前 macOS 中文界面
  9. 第 9 步

    返回 Qoder 应用

    1. 1

      点击左上角的“返回应用”。

    点击设置页面左上角的“返回应用”，回到 Qoder 主界面。

    自行采集Qoder 当前 macOS 中文界面
  10. 第 10 步

    从自定义分类选择模型

    1. 1

      点击输入框底部的“Auto”，打开模型菜单。

    2. 2

      在模型菜单顶部切换到“自定义”。

    3. 3

      点击刚添加的 custom 模型。

    点击输入框底部的“Auto”打开模型菜单，切换到“自定义”，再点击刚添加的 custom 模型。截图中的模型名只用于说明位置。

    自行采集Qoder 当前 macOS 中文界面
  11. 第 11 步

    发送测试消息

    1. 1

      在输入框输入一句简单问候，例如“你好”。

    2. 2

      确认模型正确后点击右下角发送按钮。

    在输入框输入一句简单问候，例如“你好”，确认底部显示刚选择的 custom 模型，然后点击右下角发送按钮。

    自行采集Qoder 当前 macOS 中文界面
  12. 第 12 步

    确认模型正常回复

    1. 1

      看到模型正常回复，即表示配置成功。

    对话区出现模型回复，就表示 Qoder 的接口地址、API Key、模型和协议都已配置成功。截图中的账号信息已脱敏。

    自行采集Qoder 当前 macOS 中文界面

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

验证配置

选择页面复制区显示的模型，发送“你好”；能够正常返回内容即配置成功。

配置示例中如果出现 sk-your-api-key 必须替换为自己的完整密钥；不要把含密钥的配置提交到 Git。

常见错误 ​

  • 返回 404：接口地址（Base URL）应以 /v1 结尾，不要追加 /chat/completions，也不要重复成 /v1/v1。
  • 返回 401：重新粘贴完整 API Key，不要带首尾空格。
  • 校验模型失败：确认 API 类型选择“Chat Completions API”，并检查 Model ID 与页面复制区当前显示的模型一致。
  • 找不到模型：回到“设置 → 模型”，确认模型已保存并在“自定义”分类中启用。
  • 配置没有生效：回到聊天输入框，点击 Auto → 自定义，重新选择刚添加的 custom 模型。
  • 配置被覆盖或更新后消失：回到“设置 → 模型”检查自定义模型；如已不存在，请按本页复制区重新添加，保存后再次选择。
  • 网络无法连接：确认 Qoder 所在电脑能够访问页面复制区显示的 API 地址，并检查 DNS、防火墙和代理。

更多通用错误处理见常见问题。