---
url: https://limapi.com/docs/agents/qoder-cn.md
---
# Qoder CN（原 Lingma）

Qoder CN（原 Lingma / 通义灵码）是阿里云智能编码助手，提供独立 IDE 与 IDE 插件两种形态，支持代码补全、智能问答与 Agent 模式。个人社区版与个人专业版支持添加自定义模型，可接入 LimAPI。

::: info 版本要求
接入自定义模型需要 **Qoder CN 个人社区版或个人专业版**，企业版不支持。
:::

## 安装

1. 前往 [Qoder CN 官网](https://qoder.com.cn) 下载并安装 Qoder CN。
2. 初次启动后完成初始配置并登录账号。

## 配置接入凭证

1. 在界面右上角打开 **Qoder CN 设置**，选择 **模型**，点击 **添加**。
2. 模型配置信息如下：

| 配置项 | 填写内容 |
|--------|----------|
| 提供商 | 选择「自定义 / OpenAI 兼容」（不同版本文案略有差异） |
| Base URL | `https://limapi.com/api/v1` |
| API Key | [Portal](https://limapi.com/) 创建的 API Key（`sk-` 开头） |
| 模型 | 在下拉菜单或模型 ID 中填入平台支持的文本生成模型，如 `qwen3.8-max` |

3. 点击 **添加**，通过校验后即可完成模型配置。
4. 在 Qoder CN 对话框中，选择对应模型即可开始使用。

::: tip 查询可用模型
完整模型列表见 [模型列表](/guide/models)，或调用 `GET /api/v1/models` 获取。
:::

## 验证配置

在对话框输入「你好」并发送，模型正常返回响应即配置成功；也可在 Agent 模式下让它执行简单代码任务验证工具调用链路。

## 常见问题

### 为什么在设置中找不到模型选项？

* **未完成登录**：需要先完成登录，才能进行对话和配置模型；
* **当前版本不支持**：接入自定义模型需要个人社区版或个人专业版，企业版不支持。

### 对话报错「自定义模型服务异常，请稍后重试或切换其他模型」

该报错是 Qoder CN 收到无法识别的后端响应时的通用提示，常见原因：

* **Base URL 填写错误**：应为 `https://limapi.com/api/v1`，注意末尾 `/v1`；
* **选用了不支持的模型**：仅文本生成模型可用于对话，图像 / 视频类模型请选择对应能力入口；
* **临时网络波动**：稍后重试。

### API Key 认证失败（HTTP 401）

* 确认使用的是 Portal 创建的 `sk-` 开头密钥；
* 确认密钥复制完整、无空格；
* 如仍报错，可在 Portal「API Keys」页面重置密钥后重试。

### 更推荐：Qoder 国际版

Qoder 国际版对自定义 OpenAI 端点支持更完整，接入方式见 [Qoder 接入教程](/agents/qoder)。