# Интеграция с Trae

> **Последняя проверка**: 2026-09-18 · 📄 По официальной документации (Trae 3.3.101 (выпуск 2026-09-15))

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (расширение Claude Code; встроенный ИИ также принимает кастомные модели в формате Anthropic Messages) · GPT ✅ · китайские модели ✅ (встроенный ИИ, формат OpenAI) · Gemini ❌ |
| Протокол и Base URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| Где настраивается | встроенный ИИ: Настройки → свои модели; расширение Claude Code делит `~/.claude/` |
| Официальная документация | [docs.trae.ai](https://docs.trae.ai) |

Trae — это AI-first IDE от ByteDance, происходящая из VS Code. Она принимает расширения и поставляется с собственными режимами **Agent** и **Chat**: начиная с v3.3.56 (2026-05-08) прежние Builder и Builder with MCP **объединены в Agent**, и в официальной документации слова Builder уже нет. Здесь мы разбираем два вопроса: как поставить и использовать расширение Claude Code в Trae (международная версия) или Trae CN (версия для Китая), и как добавить QCode.cc как **пользовательскую модель во встроенный AI**.

> **Про название**: официальная документация (китайская и англоязычная) сейчас называет эту IDE **TraeCode**, а китайский маркетинговый сайт выносит вперёд **TraeWork** (режимы Work / Code / Design). Официального объявления о переименовании нет — просто с v3.3.84 (2026-08-07) заголовки релизов в changelog стали писаться как TraeCode. Имя файла и URL этой страницы не меняются.

## Предварительные требования

Перед настройкой расширения Trae убедитесь, что:

1. **Claude Code CLI установлен и работает корректно**
   - Выполните установку по [инструкции](/docs/getting-started/installation)
   - Настройте [переменные окружения](/docs/getting-started/environment)

2. **Trae или Trae CN установлен и обновлён до последней версии**
   - Международная версия: [trae.ai](https://www.trae.ai/)
   - Версия для Китая (Trae CN): [trae.com.cn](https://www.trae.com.cn/)

> **Trae CN или международная версия?** Региональных различий в официальной документации не описано. Есть одна фраза: «если нужного расширения нет в маркетплейсе TraeCode, его можно поставить из маркетплейса VS Code». Поэтому все шаги ниже про «не нашлось в маркетплейсе» — условные: есть в маркетплейсе, идёте через него; нет — идёте через `.vsix`.

## Установка

### Шаг 1: Установка расширения Claude Code

Расширение Claude Code можно установить двумя способами — пробуйте их по порядку. Официальная оговорка тоже есть: релиз расширения, зависящий от свежих интерфейсов VS Code, может не работать в TraeCode — тогда документация советует взять более ранний релиз в Version History.

#### Путь A: Установка из встроенного маркетплейса Trae (рекомендуется)

1. Откройте Trae и перейдите в панель расширений (`Ctrl+Shift+X` / `Cmd+Shift+X`)

2. Найдите **"Claude Code"** (издатель: Anthropic)

3. Нажмите **Установить**

Если маркетплейс Trae не отдаёт Claude Code, используйте путь B. (Вендор не описывает, в каких сборках чего не хватает, поэтому мы этого и не утверждаем.)

#### Путь B: Офлайн-установка через .vsix

Этот путь — когда расширения нет в маркетплейсе:

1. Откройте [страницу расширения Claude Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)

2. Скачайте `.vsix`, **совпадающий с вашей платформой и архитектурой**. В документации Trae способ такой: на странице расширения открыть **Version History**, взять поля `itemName` и `version` и собрать адрес загрузки:

   ```text
   https://marketplace.visualstudio.com/_apis/public/gallery/publishers/<publisher>/vsextensions/<extension>/<version>/vspackage
   ```

   Для Claude Code это `publishers/anthropic/vsextensions/claude-code/<version>/vspackage`.
   🔴 **Архитектура обязательна должна совпадать**: Claude Code публикуется отдельно под каждую платформу (в именах файлов суффиксы вида `@win32-x64`, `@alpine-arm64`), и документация Trae прямо предупреждает: расширения, различающиеся по архитектуре, нужно скачивать под свою платформу. Возьмёте не тот файл — установка пройдёт, но работать не будет. macOS делится на Apple Silicon / Intel, Linux и Windows — на x64 / arm64.

   Либо, если на странице расширения справа видна ссылка **Download Extension**, скачайте через неё.

   > **Подсказка**: доступ к VS Code Marketplace из материкового Китая может требовать прокси. Если локальная загрузка не удалась, скачайте `.vsix` на машине со стабильным международным каналом и перенесите файл на целевую машину.

3. В Trae откройте панель расширений → меню **⋯** в правом верхнем углу → **Установить из VSIX** (Install from VSIX) и выберите скачанный `.vsix` файл

   В документации есть и ещё один способ: **перетащить скачанный `.vsix` прямо в панель расширений** — Trae начнёт установку сам.
   В некоторых средах существует команда запуска `trae`, но флагов для установки расширений через неё официальная документация не описывает, и мы это не проверяли, поэтому команду здесь не приводим.

### Шаг 2: Настройка primaryApiKey

Это ключевой шаг! Расширению Claude Code необходимо установить `primaryApiKey` в конфигурационном файле.

> **Хорошая новость**: Trae использует тот же путь конфигурации, что и VS Code (`~/.claude/config.json`). Пользователям, уже настроившим VS Code, повторять этот шаг не нужно.

<div data-os="windows" markdown="1">

#### Windows

Отредактируйте или создайте файл конфигурации `C:\Users\ваше_имя_пользователя\.claude\config.json`:

```json
{
  "primaryApiKey": "qcode"
}
```

</div>

<div data-os="macos" markdown="1">

#### macOS

Отредактируйте или создайте файл конфигурации `~/.claude/config.json`:

```bash
mkdir -p ~/.claude

cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF
```

</div>

<div data-os="linux" markdown="1">

#### Linux

Отредактируйте или создайте файл конфигурации `~/.claude/config.json`:

```bash
mkdir -p ~/.claude

cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF
```

</div>

> **Примечание**: значение `primaryApiKey` может быть любым (например, `qcode`), главное — чтобы это поле было заполнено. Фактическая аутентификация API по-прежнему использует `ANTHROPIC_AUTH_TOKEN`, заданный в переменных окружения.

> **Важно**: файл конфигурации — это `config.json`, а не `settings.json`. Обратите внимание на различие между этими двумя файлами.

### Шаг 3: Перезапуск Trae

После завершения настройки перезапустите Trae, чтобы изменения вступили в силу.

## Взаимодействие со встроенным AI Trae

Встроенный AI в Trae (**Agent** и **Chat**) больше не ограничен собственным бэкендом ByteDance. Документация прямо говорит: кроме встроенных моделей можно подключить пользовательские, и в разделе **пользовательской настройки** запрашиваются **формат API**, **адрес запросов**, **ID модели** и учётные данные. Один из форматов API — **Anthropic Messages**, дословно: совместим со спецификацией Anthropic `/v1/messages`, подходит для линейки Claude и совместимых сервисов, а среди типичных случаев упомянуты «некоторые прокси для Claude API».

| | Пользовательская модель во встроенном AI | Расширение Claude Code |
|---|---|---|
| Протокол | формат API: Anthropic Messages либо OpenAI Chat Completions | Anthropic Messages |
| Где | Настройки → **Модели** → **Добавить модель** → **Пользовательская модель** | настройки расширения плюс конфигурация в `~/.claude/` |
| Адрес | Два режима: включить тумблер **полный URL** и ввести адрес целиком либо оставить его выключенным и указать базовый адрес — Trae дополнит его по формату API | `ANTHROPIC_BASE_URL` |
| Подвох | **режим Auto не вызывает пользовательские модели** (официально), поэтому для своей модели Auto нужно выйти | с встроенным AI не пересекаются, сосуществовают |

В пересчёте на адреса QCode (**ориентировочно — внутри Trae мы не проверяли**):

| Формат API | Полный URL включён | Полный URL выключен (базовый адрес) |
|---|---|---|
| Anthropic Messages | `https://api.qcode.cc/api/v1/messages` | `https://api.qcode.cc/api` |
| OpenAI Chat Completions | `https://api.qcode.cc/openai/v1/chat/completions` | `https://api.qcode.cc/openai/v1` |

В поле **ID модели** — строка ровно как в [qcode.cc/models](https://qcode.cc/models), в поле **API-ключ** — ваш `cr_`-ключ.

Если вы уже подключили тариф QCode.cc, рекомендуем использовать расширение Claude Code как основной инструмент, чтобы получить максимум от подписки.

## Использование

### Горячие клавиши

| Горячая клавиша | Функция |
|-----------------|---------|
| `Cmd+Esc` / `Ctrl+Esc` | Открыть/закрыть панель Claude Code |
| `Cmd+Shift+P` / `Ctrl+Shift+P` | Открыть палитру команд и найти команды Claude |

### Основные функции

1. **Объяснение кода**
   - Выделите код
   - Нажмите правой кнопкой и выберите "Ask Claude" или используйте горячую клавишу
   - Введите вопрос, например "Объясни этот код"

2. **Генерация кода**
   - Откройте панель Claude
   - Опишите нужную функциональность
   - Claude сгенерирует код и предложит варианты вставки

3. **Рефакторинг кода**
   - Выделите код, требующий рефакторинга
   - Попросите Claude помочь с рефакторингом
   - Просмотрите и примените изменения

4. **Исправление ошибок**
   - Когда в коде возникает ошибка
   - Выделите код с ошибкой или сообщение об ошибке
   - Попросите Claude проанализировать и предложить решение

## Параметры конфигурации

В настройках Trae можно настроить поведение расширения Claude Code (эти настройки совпадают с VS Code):

1. Откройте настройки (`Ctrl+,` / `Cmd+,`)

2. Найдите "Claude Code"

3. Настройте параметры по необходимости

### Часто используемые настройки

```json
{
  "claude-code.autoSuggest": true,
  "claude-code.inlineChat": true
}
```

## Совместное использование с CLI

Расширение Trae и CLI для терминала можно использовать совместно:

| Сценарий | Рекомендуемый инструмент |
|----------|--------------------------|
| Быстрое редактирование кода | Расширение Trae |
| Анализ сложных проектов | CLI в терминале |
| Ревью кода | Оба варианта |
| Операции с Git | CLI в терминале |
| Генерация файлов | Оба варианта |

## Устранение неполадок

### Claude Code не найден в маркетплейсе

**Симптомы**: поиск "Claude Code" в панели расширений Trae не даёт результатов или возвращает не официальное расширение Anthropic.

**Решение**: используйте **Путь B: офлайн-установка через .vsix** (см. шаг 1 выше). Позиция вендора формулируется одной фразой: чего нет в маркетплейсе TraeCode, то можно поставить из маркетплейса VS Code; про разницу китайской и международной сборок там не говорится.

### Trae CN не может скачать .vsix

**Симптомы**: доступ к `marketplace.visualstudio.com` не работает, скорость загрузки равна 0.

**Решение**:

1. Скачайте `.vsix` через стабильный международный канал или прокси

2. Или запросите у поддержки QCode.cc зеркало-ссылку на `.vsix` расширения Claude Code

3. После получения файла установите его через "Установить из VSIX"

### Панель Claude Code пустая или не запускается

1. Убедитесь, что `~/.claude/config.json` существует и содержит корректный JSON

2. Убедитесь, что имя файла `config.json`, а НЕ `settings.json` (самая частая ошибка)

3. Убедитесь, что переменные окружения `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN` заданы

4. Запустите `claude` в терминале, чтобы убедиться, что CLI работает

### Горячие клавиши конфликтуют со встроенным AI Trae

Если `Cmd+Esc` / `Ctrl+Esc` перехвачены Agent или Chat:

1. Откройте настройки Trae → Сочетания клавиш

2. Найдите `claude-code` или `Claude Code`

3. Переназначьте "Claude Code: Toggle Panel" на свободную комбинацию

### Таймаут подключения

1. Проверьте, доступен ли `https://asia.qcode.cc` из вашей сети

2. Проверьте настройку переменной окружения `ANTHROPIC_BASE_URL`

3. Пользователям из КНР без прокси рекомендуется использовать узел ускорения для материкового Китая `https://api.qcode.cc/api` (поддерживает просмотр запросов через [probe.qcode.cc](https://probe.qcode.cc))

## Следующие шаги

- Изучите [советы по CLI](/docs/usage/cli-tips) для повышения эффективности

- Узнайте [советы по рабочим процессам](/docs/usage/workflow-tips) для оптимизации разработки

- Если вы также пользуетесь VS Code, см. [Интеграцию с VS Code](/docs/ide/vscode)