> ## Documentation Index
> Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Qwen Code CLI

> Подключение Qwen Code CLI к SpeShu.AI — терминальный AI-агент с поддержкой OpenAI-совместимого API

Qwen Code — open-source AI-агент для терминала от команды QwenLM (Alibaba). Аналог Claude Code и Gemini CLI, но для моделей Qwen и любых OpenAI-совместимых провайдеров. Полноценный агентный workflow: читает файлы, пишет код, запускает команды.

## Требования

* Node.js 18 или новее
* macOS, Linux или Windows
* API-ключ [speshu.ai](https://speshu.ai/profile)

## Установка Qwen Code CLI

<Tabs>
  <Tab title="Windows">
    Откройте **cmd.exe** и выполните:

    ```cmd theme={null} theme={null}
    curl -fsSL -o %TEMP%\install-qwen.bat ^
    https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat ^
    && %TEMP%\install-qwen.bat
    ```

    <Note>
      После установки перезапустите терминал, чтобы переменные окружения вступили в силу.
    </Note>
  </Tab>

  <Tab title="macOS / Linux">
    ```bash theme={null} theme={null}
    npm install -g qwen-code
    ```

    Или через официальный установщик:

    ```bash theme={null} theme={null}
    curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh | bash
    ```
  </Tab>
</Tabs>

## Подключение к SpeShu.AI

Конфигурация Qwen Code хранится в файле `~/.qwen/settings.json`. Добавьте SpeShu.AI как OpenAI-совместимого провайдера и укажите нужные модели:

```json theme={null} theme={null}
{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen/qwen3.6-plus",
        "name": "Qwen 3.6 Plus",
        "baseUrl": "https://api.speshu.ai/v1",
        "envKey": "OPENAI_API_KEY",
        "generationConfig": {
          "contextWindowSize": 1000000
        }
      },
      {
        "id": "moonshotai/kimi-k2.5",
        "name": "Kimi K2.5",
        "baseUrl": "https://api.speshu.ai/v1",
        "envKey": "OPENAI_API_KEY",
        "generationConfig": {
          "contextWindowSize": 262000
        }
      },
      {
        "id": "z-ai/glm-5.1",
        "name": "GLM 5.1",
        "baseUrl": "https://api.speshu.ai/v1",
        "envKey": "OPENAI_API_KEY",
        "generationConfig": {
          "contextWindowSize": 203000
        }
      }
    ]
  },
  "env": {
    "OPENAI_API_KEY": "ваш-api-ключ",
    "OPENAI_BASE_URL": "https://api.speshu.ai/v1"
  },
  "security": {
    "auth": { "selectedType": "openai" }
  },
  "model": {
    "name": "qwen/qwen3.6-plus"
  },
  "$version": 3
}
```

Замените `ваш-api-ключ` на ключ из [личного кабинета](https://speshu.ai/profile).

<Note>
  Параметр `contextWindowSize` указывает размер контекстного окна модели в токенах. Укажите точное значение для каждой модели — оно влияет на то, как Qwen Code управляет памятью сессии. Актуальные значения можно посмотреть на странице каждой модели в [каталоге](/api-reference/models/list).
</Note>

Запустите Qwen Code из папки проекта:

```bash theme={null} theme={null}
cd /path/to/your/project
qwen
```

## Переключение между моделями

Модель по умолчанию задаётся в `model.name`. Переключиться можно при запуске:

```bash theme={null} theme={null}
qwen --model qwen/qwen3.6-plus
qwen --model moonshotai/kimi-k2.5
qwen --model z-ai/glm-5.1
```

Полный список доступных моделей — в [каталоге](/api-reference/models/list).

## Решение проблем

<AccordionGroup>
  <Accordion title="Ошибка аутентификации (401)">
    * Убедитесь что `OPENAI_API_KEY` содержит ваш ключ SpeShu.AI
    * Проверьте что `OPENAI_BASE_URL` установлен в `https://api.speshu.ai/v1`
    * Ключ можно скопировать в [личном кабинете](https://speshu.ai/profile)
  </Accordion>

  <Accordion title="Модель не найдена (model not found)">
    * Проверьте правильность ID модели в `model.name` (например, `qwen/qwen3.6-plus`)
    * Убедитесь что модель доступна в [каталоге SpeShu.AI](/api-reference/models/list)
    * ID модели чувствителен к регистру
  </Accordion>

  <Accordion title="Git-ветка не отображается">
    Ветка показывается только при наличии хотя бы одного коммита в репозитории. После `git init` выполните:

    ```bash theme={null} theme={null}
    git commit --allow-empty -m "init"
    ```
  </Accordion>
</AccordionGroup>