Skip to content

Qwen Code

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

懒人方式

不想手动改配置?使用 LimAPI Agent 桌面客户端 可一键完成安装与配置。

安装 Qwen Code

需要 Node.js 18+,在终端中执行:

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

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

bash
qwen-code --version

配置接入凭证

编辑或新建配置文件,将 YOUR_API_KEY 替换为你在 Portal 创建的 API Key。文件路径如下:

  • macOS / Linux~/.qwen/settings.json
  • WindowsC:\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_KEYPortal 创建的 API Key,供下方各模型的 envKey 引用
modelProviders.openai[].baseUrlLimAPI 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 生效。

LimAPI — 大模型聚合网关