Конфигурация Qwen Code

Уровни конфигурации

Конфигурация применяется в следующем порядке приоритета (более низкие номера переопределяются более высокими):

Файлы настроек

Qwen Code использует файлы настроек в формате JSON для постоянной конфигурации. Эти файлы могут находиться в четырех местах:

Каталог .qwen в вашем проекте

Помимо файла настроек проекта, каталог .qwen проекта может содержать другие файлы, относящиеся к работе Qwen Code, например:

• Пользовательские профили песочницы (например, .qwen/sandbox-macos-custom.sb, .qwen/sandbox.Dockerfile).

Доступные настройки в settings.json

Настройки организованы по категориям. Все настройки должны быть размещены внутри соответствующего объекта категории верхнего уровня в вашем файле settings.json.

general

output

ui

ide

privacy

model

Пример model.generationConfig:

{
  "model": {
    "generationConfig": {
      "timeout": 60000,
      "disableCacheControl": false,
      "samplingParams": {
        "temperature": 0.2,
        "top_p": 0.8,
        "max_tokens": 1024
      }
    }
  }
}

Примеры model.openAILoggingDir:

• "~/qwen-logs" - Логи сохраняются в каталог ~/qwen-logs
• "./custom-logs" - Логи сохраняются в ./custom-logs относительно текущего каталога
• "/tmp/openai-logs" - Логи сохраняются по абсолютному пути /tmp/openai-logs

контекст

Устранение неполадок с производительностью поиска файлов

Если вы сталкиваетесь с проблемами производительности при поиске файлов (например, при использовании автодополнения с @), особенно в проектах с очень большим количеством файлов, попробуйте следующие решения в порядке рекомендации:

1. Используйте .qwenignore: Создайте файл .qwenignore в корне вашего проекта, чтобы исключить каталоги, содержащие большое количество файлов, на которые вам не нужно ссылаться (например, сборочные артефакты, логи, node_modules). Снижение общего числа просканированных файлов — это самый эффективный способ улучшить производительность.
2. Отключите нечеткий поиск: Если игнорирование файлов не помогает, можно отключить нечеткий поиск, установив значение disableFuzzySearch равным true в вашем файле settings.json. Будет использоваться более простой алгоритм точного совпадения, который может работать быстрее.
3. Отключите рекурсивный поиск файлов: В крайнем случае можно полностью отключить рекурсивный поиск файлов, установив значение enableRecursiveFileSearch равным false. Это будет самым быстрым вариантом, так как избежит рекурсивного сканирования проекта. Однако это означает, что при использовании автодополнения с @ вам придется вводить полный путь к файлам.

tools

mcp

безопасность

advanced

mcpServers

Настраивает подключения к одному или нескольким серверам Model-Context Protocol (MCP) для обнаружения и использования пользовательских инструментов. Qwen Code пытается подключиться к каждому настроенному серверу MCP для обнаружения доступных инструментов. Если несколько серверов MCP предоставляют инструмент с одинаковым именем, имена инструментов будут дополнены псевдонимом сервера, который вы определили в конфигурации (например, serverAlias__actualToolName), чтобы избежать конфликтов. Обратите внимание, что система может удалить некоторые свойства схемы из определений инструментов MCP для обеспечения совместимости. Необходимо указать хотя бы одно из следующих полей: command, url или httpUrl. Если указано несколько, приоритет имеет следующий порядок: httpUrl, затем url, затем command.

telemetry

Настраивает сбор логов и метрик для Qwen Code. Дополнительную информацию см. в разделе телеметрия.

Пример settings.json

Вот пример файла settings.json с вложенной структурой, новой начиная с версии v0.3.0:

{
  "general": {
    "vimMode": true,
    "preferredEditor": "code"
  },
  "ui": {
    "theme": "GitHub",
    "hideBanner": true,
    "hideTips": false,
    "customWittyPhrases": [
      "You forget a thousand things every day. Make sure this is one of 'em",
      "Connecting to AGI"
    ]
  },
  "tools": {
    "approvalMode": "yolo",
    "sandbox": "docker",
    "discoveryCommand": "bin/get_tools",
    "callCommand": "bin/call_tool",
    "exclude": ["write_file"]
  },
  "mcpServers": {
    "mainServer": {
      "command": "bin/mcp_server.py"
    },
    "anotherServer": {
      "command": "node",
      "args": ["mcp_server.js", "--verbose"]
    }
  },
  "telemetry": {
    "enabled": true,
    "target": "local",
    "otlpEndpoint": "http://localhost:4317",
    "logPrompts": true
  },
  "privacy": {
    "usageStatisticsEnabled": true
  },
  "model": {
    "name": "qwen3-coder-plus",
    "maxSessionTurns": 10,
    "enableOpenAILogging": false,
    "openAILoggingDir": "~/qwen-logs",
    "summarizeToolOutput": {
      "run_shell_command": {
        "tokenBudget": 100
      }
    }
  },
  "context": {
    "fileName": ["CONTEXT.md", "QWEN.md"],
    "includeDirectories": ["path/to/dir1", "~/path/to/dir2", "../path/to/dir3"],
    "loadFromIncludeDirectories": true,
    "fileFiltering": {
      "respectGitIgnore": false
    }
  },
  "advanced": {
    "excludedEnvVars": ["DEBUG", "DEBUG_MODE", "NODE_ENV"]
  }
}

История командной строки

Интерфейс командной строки сохраняет историю выполненных вами команд оболочки. Чтобы избежать конфликтов между различными проектами, эта история хранится в специальном каталоге проекта внутри домашней папки пользователя.

• Расположение: ~/.qwen/tmp/<project_hash>/shell_history
  • <project_hash> — это уникальный идентификатор, сгенерированный на основе корневого пути вашего проекта.
  • История сохраняется в файле с именем shell_history.

Переменные окружения и файлы .env

Переменные окружения — это распространённый способ настройки приложений, особенно для конфиденциальной информации (например, токенов) или параметров, которые могут отличаться в зависимости от среды выполнения.

Qwen Code может автоматически загружать переменные окружения из файлов .env.
Подробнее о переменных, связанных с аутентификацией (например, OPENAI_*), и рекомендуемом подходе с использованием .qwen/.env см. в разделе Аутентификация.

Таблица переменных окружения

Аргументы командной строки

Аргументы, переданные непосредственно при запуске CLI, могут переопределять другие конфигурации для этого конкретного сеанса.

Таблица аргументов командной строки

Контекстные файлы (иерархический инструкционный контекст)

Хотя контекстные файлы (по умолчанию QWEN.md, но настраиваемые через параметр context.fileName) не являются строгой конфигурацией поведения CLI, они играют ключевую роль в настройке инструкционного контекста (также называемого “памятью”). Эта мощная функция позволяет передавать ИИ проектно-специфичные инструкции, руководства по стилю кодирования или любую другую релевантную информацию, благодаря чему ответы ИИ становятся более точными и соответствующими вашим потребностям. В CLI предусмотрены элементы интерфейса, например индикатор в нижнем колонтитуле, показывающий количество загруженных контекстных файлов, чтобы вы всегда были в курсе активного контекста.

• Назначение: Эти Markdown-файлы содержат инструкции, рекомендации или контекст, о котором вы хотите, чтобы модель Qwen знала во время взаимодействия. Система спроектирована так, чтобы управлять этим инструкционным контекстом иерархически.

Пример содержимого контекстного файла (например, QWEN.md)

Вот концептуальный пример того, что может содержать контекстный файл в корне проекта на TypeScript:

# Проект: Моя потрясающая библиотека на TypeScript

## Общие инструкции:
- При генерации нового кода на TypeScript следуйте существующему стилю кодирования.
- Убедитесь, что все новые функции и классы сопровождаются комментариями JSDoc.
- Предпочтение отдавайте парадигмам функционального программирования, где это уместно.
- Весь код должен быть совместим с TypeScript 5.0 и Node.js 20+.

## Стиль кодирования:
- Используйте 2 пробела для отступов.
- Имена интерфейсов должны начинаться с префикса `I` (например, `IUserService`).
- Частные члены классов должны начинаться с символа подчеркивания (`_`).
- Всегда используйте строгое равенство (`===` и `!==`).

## Конкретный компонент: `src/api/client.ts`
- Этот файл обрабатывает все исходящие запросы к API.
- При добавлении новых функций вызова API убедитесь, что они включают надежную обработку ошибок и ведение журнала.
- Используйте существующую утилиту `fetchWithRetry` для всех запросов GET.

Относительно зависимостей:

• Избегайте добавления новых внешних зависимостей, если в этом нет крайней необходимости.
• Если требуется новая зависимость, пожалуйста, укажите причину.

Этот пример демонстрирует, как можно предоставить общий контекст проекта, конкретные соглашения о кодировании и даже заметки о конкретных файлах или компонентах. Чем более релевантны и точны ваши файлы контекста, тем лучше ИИ сможет вам помочь. Файлы контекста, специфичные для проекта, настоятельно рекомендуются для установления соглашений и контекста.

- **Иерархическая загрузка и приоритет:** CLI реализует сложную иерархическую систему памяти, загружая файлы контекста (например, `QWEN.md`) из нескольких мест. Содержимое файлов, расположенных ниже в этом списке (более специфичные), обычно переопределяет или дополняет содержимое файлов выше (более общие). Точный порядок объединения и финальный контекст можно проверить с помощью команды `/memory show`. Типичный порядок загрузки следующий:
  1. **Глобальный файл контекста:**
     - Расположение: `~/.qwen/<configured-context-filename>` (например, `~/.qwen/QWEN.md` в вашем домашнем каталоге пользователя).
     - Область применения: Предоставляет стандартные инструкции для всех ваших проектов.
  2. **Файлы контекста корня проекта и его предков:**
     - Расположение: CLI ищет настроенный файл контекста в текущем рабочем каталоге, а затем в каждом родительском каталоге до корня проекта (определяется по папке `.git`) или вашего домашнего каталога.
     - Область применения: Предоставляет контекст, относящийся ко всему проекту или значительной его части.
  3. **Файлы контекста подкаталогов (контекстуальные/локальные):**
     - Расположение: CLI также сканирует наличие настроенного файла контекста в подкаталогах _ниже_ текущего рабочего каталога (с учетом распространенных шаблонов игнорирования, таких как `node_modules`, `.git` и т. д.). По умолчанию глубина этого поиска ограничена 200 каталогами, но может быть изменена с помощью параметра `context.discoveryMaxDirs` в вашем файле `settings.json`.
     - Область применения: Позволяет задать очень специфичные инструкции, относящиеся к конкретному компоненту, модулю или разделу вашего проекта.
- **Объединение и отображение в интерфейсе:** Содержимое всех найденных файлов контекста объединяется (с разделителями, указывающими их происхождение и путь) и предоставляется как часть системного запроса. В нижнем колонтитуле CLI отображается количество загруженных файлов контекста, что дает вам быстрый визуальный сигнал об активном инструкционном контексте.
- **Импорт содержимого:** Вы можете модульно организовать свои файлы контекста, импортируя другие Markdown-файлы с помощью синтаксиса `@path/to/file.md`. Для получения дополнительной информации см. [Документацию по процессору импорта памяти](../configuration/memory).
- **Команды управления памятью:**
  - Используйте `/memory refresh`, чтобы принудительно пересканировать и перезагрузить все файлы контекста из всех настроенных местоположений. Это обновляет инструкционный контекст ИИ.
  - Используйте `/memory show`, чтобы отобразить объединённый инструкционный контекст, который в данный момент загружен, позволяя вам проверить иерархию и содержимое, используемое ИИ.
  - Смотрите [Документацию по командам](../features/commands) для полной информации о команде `/memory` и её подкомандах (`show` и `refresh`).

Понимая и используя эти уровни конфигурации и иерархическую природу файлов контекста, вы сможете эффективно управлять памятью ИИ и адаптировать ответы Qwen Code под ваши конкретные нужды и проекты.

## Песочница

Qwen Code может выполнять потенциально небезопасные операции (например, команды оболочки и изменения файлов) в изолированной среде (песочнице), чтобы защитить вашу систему.

[Песочница](../features/sandbox) отключена по умолчанию, но вы можете включить её несколькими способами:

- Используя флаг `--sandbox` или `-s`.
- Установив переменную окружения `GEMINI_SANDBOX`.
- Песочница включается по умолчанию при использовании `--yolo` или `--approval-mode=yolo`.

По умолчанию используется предварительно собранный Docker-образ `qwen-code-sandbox`.

Для удовлетворения специфических потребностей проекта вы можете создать собственный Dockerfile по пути `.qwen/sandbox.Dockerfile` в корневой директории вашего проекта. Этот Dockerfile может быть основан на базовом образе песочницы:

FROM qwen-code-sandbox

Добавьте сюда ваши пользовательские зависимости или конфигурации

Например:

RUN apt-get update && apt-get install -y some-package

# COPY ./my-config /app/my-config

Когда файл .qwen/sandbox.Dockerfile существует, вы можете использовать переменную окружения BUILD_SANDBOX при запуске Qwen Code для автоматической сборки пользовательского образа песочницы:

BUILD_SANDBOX=1 qwen -s

Статистика использования

Чтобы помочь нам улучшить Qwen Code, мы собираем анонимизированную статистику использования. Эти данные помогают нам понять, как используется CLI, выявить распространенные проблемы и определить приоритеты для новых функций.

Что мы собираем:

• Вызовы инструментов: Мы записываем названия вызванных инструментов, информацию об успешном или неудачном выполнении и время их выполнения. Мы не собираем аргументы, переданные инструментам, или любые данные, возвращенные ими.
• Запросы API: Мы записываем модель, использованную для каждого запроса, продолжительность запроса и информацию о его успешном выполнении. Мы не собираем содержимое подсказок или ответов.
• Информация о сессии: Мы собираем информацию о конфигурации CLI, например, включенные инструменты и режим одобрения.

Что мы НЕ собираем:

• Персональные данные (PII): Мы не собираем никакой персональной информации, такой как ваше имя, адрес электронной почты или ключи API.
• Содержимое подсказок и ответов: Мы не записываем содержимое ваших подсказок или ответов модели.
• Содержимое файлов: Мы не записываем содержимое файлов, которые читаются или записываются CLI.

Как отказаться от сбора:

Вы можете отказаться от сбора статистики использования в любое время, установив значение свойства usageStatisticsEnabled на false в категории privacy в вашем файле settings.json:

{
  "privacy": {
    "usageStatisticsEnabled": false
  }
}