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

Использование расширения Claude Code в IDE Trae от ByteDance (включая офлайн-установку для Trae CN)

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

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

Кратко¶

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 установлен и работает корректно

2. Выполните установку по инструкции

3. Настройте переменные окружения

4. Trae или Trae CN установлен и обновлён до последней версии

5. Международная версия: trae.ai

6. Версия для Китая (Trae CN): 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

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 на машине со стабильным международным каналом и перенесите файл на целевую машину.

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

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

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

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

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

{
  "primaryApiKey": "qcode"
}

mkdir -p ~/.claude

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

mkdir -p ~/.claude

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

Примечание: значение 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».

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

В поле ID модели — строка ровно как в qcode.cc/models, в поле API-ключ — ваш cr_-ключ.

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

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

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

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

1. Объяснение кода

2. Выделите код

3. Нажмите правой кнопкой и выберите "Ask Claude" или используйте горячую клавишу

4. Введите вопрос, например "Объясни этот код"

5. Генерация кода

6. Откройте панель Claude

7. Опишите нужную функциональность

8. Claude сгенерирует код и предложит варианты вставки

9. Рефакторинг кода

10. Выделите код, требующий рефакторинга

11. Попросите Claude помочь с рефакторингом

12. Просмотрите и примените изменения

13. Исправление ошибок

14. Когда в коде возникает ошибка

15. Выделите код с ошибкой или сообщение об ошибке
16. Попросите Claude проанализировать и предложить решение

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

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

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

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

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

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

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

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

Расширение Trae и 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)

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

• Изучите советы по CLI для повышения эффективности

• Узнайте советы по рабочим процессам для оптимизации разработки

• Если вы также пользуетесь VS Code, см. Интеграцию с VS Code

Enterprise →