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

Использование расширения Claude Code в VS Code

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

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

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

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

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

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

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

4. VS Code версии >= 1.98.0

Установка¶

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

Если VS Code ещё не установлен, скачайте его с официального сайта VS Code.

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

В VS Code:

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

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

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

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

code --install-extension anthropic.claude-code

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ошибка primaryApiKey¶

1. Проверьте правильность пути к файлу:

2. Windows: C:\Users\ваше_имя_пользователя\.claude\config.json

3. macOS/Linux: ~/.claude/config.json

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

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

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

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

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

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

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

• Ознакомьтесь с интеграцией с Cursor для использования Claude Code в Cursor

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

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