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

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

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

Trae — это AI-first IDE от ByteDance, построенное как форк VS Code. Оно совместимо с большинством расширений VS Code и одновременно содержит собственные AI-агенты Builder и Chat. В этом руководстве описана установка и использование расширения Claude Code в Trae (международной версии) или Trae CN (версии для Китая), с доступом к Claude, Codex и другим моделям через QCode.cc.

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

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

1. Claude Code CLI установлен и работает корректно

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

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

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

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

6. Версия для Китая (Trae CN): trae.com.cn

Когда использовать Trae CN? Trae CN оптимизирован под сетевые условия материкового Китая; если вы находитесь за его пределами или у вас уже есть стабильный международный канал, рекомендуется международная версия.

Установка¶

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

Trae совместим с большинством расширений VS Code. Расширение Claude Code можно установить двумя способами — пробуйте их по порядку.

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

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

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

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

Если расширение не найдено в маркетплейсе Trae (часто встречается в ранних сборках Trae CN), используйте путь B.

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

Это самый надёжный способ для пользователей Trae CN:

1. Откройте страницу расширения Claude Code

2. Найдите ссылку Download Extension в правой боковой панели и скачайте файл .vsix

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

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

Или используйте командную строку:

bash trae --install-extension /path/to/claude-code-x.x.x.vsix

Шаг 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¶

Trae поставляется с двумя AI-режимами — Builder и Chat, работающими на бэкенде ByteDance. Официальное расширение Claude Code от Anthropic обращается к ANTHROPIC_BASE_URL, который вы указали (то есть к прокси QCode.cc). Оба решения полностью независимы и могут сосуществовать:

Если вы уже подключили тариф 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 выше). В настоящее время это самый надёжный путь для пользователей Trae CN.

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 перехвачены Builder или Chat:

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

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

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

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

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

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

3. Пользователи в материковом Китае могут без прокси использовать точки входа asia.qcode.cc или cn.qcode.cc

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

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

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

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