---
url: https://limapi.com/docs/agents/qwen-code.md
---
# Qwen Code

Qwen Code 是一款终端 AI 编程工具，通过 OpenAI 兼容协议接入 LimAPI。

::: tip 懒人方式
不想手动改配置？使用 [LimAPI Agent 桌面客户端](/agents/limapi-agent) 可一键完成安装与配置。
:::

## 安装 Qwen Code

需要 Node.js 18+，在终端中执行：

```bash
npm install -g @qwen-code/qwen-code
```

验证安装，若有版本号输出，则表示安装成功：

```bash
qwen-code --version
```

## 配置接入凭证

编辑或新建配置文件，将 `YOUR_API_KEY` 替换为你在 [Portal](https://limapi.com/) 创建的 API Key。文件路径如下：

* **macOS / Linux**：`~/.qwen/settings.json`
* **Windows**：`C:\Users\<用户名>\.qwen\settings.json`

```json
{
  "env": {
    "LIMAPI_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-max",
        "name": "[LimAPI] qwen3.8-max",
        "baseUrl": "https://limapi.com/api/v1",
        "envKey": "LIMAPI_API_KEY"
      },
      {
        "id": "qwen3.7-max",
        "name": "[LimAPI] qwen3.7-max",
        "baseUrl": "https://limapi.com/api/v1",
        "envKey": "LIMAPI_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.7-plus",
        "name": "[LimAPI] qwen3.7-plus",
        "baseUrl": "https://limapi.com/api/v1",
        "envKey": "LIMAPI_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-flash",
        "name": "[LimAPI] qwen3.6-flash",
        "baseUrl": "https://limapi.com/api/v1",
        "envKey": "LIMAPI_API_KEY"
      },
      {
        "id": "claude-sonnet-4-6",
        "name": "[LimAPI] claude-sonnet-4-6",
        "baseUrl": "https://limapi.com/api/v1",
        "envKey": "LIMAPI_API_KEY"
      },
      {
        "id": "deepseek-v4-pro",
        "name": "[LimAPI] deepseek-v4-pro",
        "baseUrl": "https://limapi.com/api/v1",
        "envKey": "LIMAPI_API_KEY"
      },
      {
        "id": "glm-5.2",
        "name": "[LimAPI] glm-5.2",
        "baseUrl": "https://limapi.com/api/v1",
        "envKey": "LIMAPI_API_KEY"
      },
      {
        "id": "kimi-k2.7-code",
        "name": "[LimAPI] kimi-k2.7-code",
        "baseUrl": "https://limapi.com/api/v1",
        "envKey": "LIMAPI_API_KEY"
      }
    ]
  }
}
```

| 字段 | 说明 |
|------|------|
| `env.LIMAPI_API_KEY` | Portal 创建的 API Key，供下方各模型的 `envKey` 引用 |
| `modelProviders.openai[].baseUrl` | LimAPI OpenAI 兼容端点，固定为 `https://limapi.com/api/v1` |
| `modelProviders.openai[].envKey` | 指向 `env` 中的密钥变量名 |
| `generationConfig.extra_body.enable_thinking` | 需要思考过程的模型可保留；不需要时可删除该项 |

如需添加其他模型，在 `openai` 数组中以相同格式追加即可，完整列表通过 `GET /api/v1/models` 查询或在 Portal 模型广场查看。

## 验证配置

启动 Qwen Code：

```bash
qwen-code
```

进入交互界面后输入 `/model`，选择 `[LimAPI]` 前缀的模型，发送一条消息（如「你好」），模型正常返回响应即配置成功。

## 常见问题

### 报错 401 / 认证失败

* 确认 `LIMAPI_API_KEY` 已填写且复制完整、无首尾空格；
* 确认 API Key 在 Portal 的「API Keys」页面状态正常。

### 配置后模型列表为空

`settings.json` 必须为合法 JSON，可用 `cat ~/.qwen/settings.json | python3 -m json.tool` 校验；修改配置后需重启 Qwen Code 生效。