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

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

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (расширение по протоколу Anthropic / Copilot через Messages) · GPT ✅ · китайские модели ✅ (кастомный эндпоинт Copilot) · Gemini ❌ |
| Протокол и Base URL | Расширение Claude Code: переменные окружения на `https://api.qcode.cc/api` · Copilot: полные URL в `chatLanguageModels.json` |
| Где настраивается | `~/.claude/config.json` + переменные окружения; Copilot — `chatLanguageModels.json` |
| Официальная документация | [расширение Claude Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) · [языковые модели](https://code.visualstudio.com/docs/agent-customization/language-models) |

> **Используете Trae IDE?** Trae — это форк VS Code; большинство шагов здесь применимы напрямую. Специфичные для Trae детали — различия маркетплейса, офлайн-установка через `.vsix`, сосуществование со встроенным AI Trae — см. в [Руководстве по интеграции с Trae](/docs/ide/trae).

Помимо использования Claude Code CLI в терминале, вы можете работать с Claude Code прямо в редакторе через расширение для VS Code, что обеспечивает более удобный процесс разработки.

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

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

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

2. **VS Code версии >= 1.98.0**

## Установка

### Шаг 1: Установка VS Code

Если VS Code ещё не установлен, скачайте его с [официального сайта VS Code](https://code.visualstudio.com/).

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

В VS Code:

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

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

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

Или установите через командную строку:

```bash
code --install-extension anthropic.claude-code
```

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

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

<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`. Обратите внимание на различие между этими двумя файлами.

### Шаг 4: Перезапуск VS Code

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## Кастомные эндпоинты GitHub Copilot

Начиная с VS Code 1.122 встроенный Custom Endpoint Copilot подключает протокольные ветки QCode прямо к Copilot (Claude — только через `messages`, `url` — полный путь). Минимальная конфигурация:

```json
[
  { "name": "QCode Claude", "vendor": "customendpoint", "apiKey": "cr_your-QCode-key",
    "apiType": "messages",
    "url": "https://api.qcode.cc/api/v1/messages",
    "toolCalling": true,
    "models": [ { "id": "claude-sonnet-5" } ] }
]
```

Полная настройка трёх веток, BYOK в Copilot CLI и известные ограничения (инлайн-подстановки идут через GitHub) — на отдельной странице [Подключение GitHub Copilot](/docs/ide/github-copilot).

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

### Расширение не запускается

1. Убедитесь, что Claude Code CLI корректно установлен

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

3. Убедитесь, что формат файла `config.json` корректен

### Ошибка primaryApiKey

1. Проверьте правильность пути к файлу:
   - Windows: `C:\Users\ваше_имя_пользователя\.claude\config.json`
   - macOS/Linux: `~/.claude/config.json`

2. Убедитесь, что это `config.json`, а не `settings.json`

3. Убедитесь, что формат JSON корректен

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

1. Проверьте сетевое соединение

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

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

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

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

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