Claude Code в VS Code — расширение и встроенный терминал

Claude Code можно использовать прямо в VS Code: через официальное расширение с графической панелью или как CLI во встроенном терминале. Оба варианта читают один и тот же файл настроек, поэтому подключение к Zukko делается один раз. Ниже — установка, конфиг, отличия режимов и разбор типичных ошибок.

Два способа использовать Claude Code в VS Code

1. Официальное расширение

Расширение Claude Code от Anthropic ставится из Marketplace (нужен VS Code 1.94.0 или новее, работает и в Cursor). По документации Claude Code, оно открывает графическую панель чата, в которой можно:

• просматривать и править план перед тем, как агент начнёт менять код;
• принимать правки по одной или включить автоприём;
• упоминать файлы через @, в том числе с диапазоном строк из выделения;
• открывать историю диалогов и вести несколько разговоров во вкладках.

Расширение содержит собственную копию Claude Code, отдельная установка CLI для панели не нужна.

2. CLI во встроенном терминале

Claude Code — консольная программа, которая работает в любом терминале. Откройте терминал VS Code (Terminal → New Terminal или Ctrl+`) и запустите claude. Для этого нужна отдельная установка CLI: расширение не добавляет команду claude в PATH.

Оба способа используют общий файл ~/.claude/settings.json — в нём и задаётся подключение к Zukko.

Что настроить для Zukko

Добавьте блок env в ~/.claude/settings.json:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zukko.pro",
    "ANTHROPIC_AUTH_TOKEN": "fetch_...",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

Ключевые моменты:

• ANTHROPIC_BASE_URL = https://api.zukko.pro — без /v1, Claude Code добавит путь сам.
• ANTHROPIC_AUTH_TOKEN = ваш ключ fetch_... со страницы API-ключей↗. Используйте именно эту переменную: она отправляется как Authorization: Bearer, и Claude Code не просит входа в аккаунт Anthropic.
• Переменные ANTHROPIC_DEFAULT_*_MODEL назначают модели Zukko на слоты Opus, Sonnet и Haiku в меню /model. Слот Haiku Claude Code также использует для фоновых задач.

Если settings.json уже существует, добавьте блок env внутрь, не затирая остальные настройки.

Где лежит файл:

• macOS / Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

Установка CLI

Нужна, если хотите запускать claude в терминале. Для работы только через расширение этот шаг можно пропустить.

macOS / Linux

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

После установки полностью закройте и снова откройте PowerShell — PATH обновляется только в новых окнах.

Через npm (все платформы):

npm install -g @anthropic-ai/claude-code

Запуск в терминале VS Code

1. Откройте папку проекта в VS Code.
2. Откройте встроенный терминал: Ctrl+` (на macOS тоже Ctrl).
3. Выполните claude.
4. Claude Code прочитает ~/.claude/settings.json и подключится к Zukko.

Задайте любой вопрос, а затем проверьте списание в разделе «Использование» в кабинете↗ — запрос должен появиться там.

Установка расширения

1. Откройте Extensions (Ctrl/Cmd+Shift+X).
2. Найдите Claude Code от Anthropic и нажмите Install.
3. Убедитесь, что ~/.claude/settings.json с блоком env из раздела выше уже создан.
4. В настройках VS Code (Ctrl/Cmd+,) найдите Claude Code: Disable Login Prompt и включите. Документация Claude Code рекомендует эту настройку для сторонних провайдеров, иначе расширение будет предлагать вход в аккаунт Anthropic.
5. Перезагрузите окно: Command Palette → Developer: Reload Window.

Панель Claude Code появится в боковой части окна и будет работать через Zukko.

Переменные окружения: разовый запуск

Для быстрой проверки можно не трогать settings.json, а задать переменные в текущем терминале:

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.zukko.pro"
export ANTHROPIC_AUTH_TOKEN="fetch_..."
claude

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://api.zukko.pro"
$env:ANTHROPIC_AUTH_TOKEN = "fetch_..."
claude

Ограничения: переменные живут до закрытия терминала, а панель расширения их не видит — она получает окружение самого VS Code. Поэтому для постоянной работы надёжнее settings.json.

Сколько это стоит

Claude Code отправляет в модель системный промпт, описание инструментов, ваш CLAUDE.md и историю диалога, поэтому основная часть расхода — входные токены. В Zukko claude-sonnet-5 и claude-opus-5-5 стоят $0,30 за 1M входных и выходных токенов. Учтите оговорку: у Anthropic повторяющийся контекст частично оплачивается по цене чтения из кэша (около 10% входной цены), а в Zukko кэшированные токены оплачиваются по обычной входной цене. Для длинных агентных сессий реальная разница с официальным прайсом меньше, чем при сравнении цен «в лоб». Расход по ключу видно в кабинете, а дневной лимит на ключе защитит от неожиданностей.

Если что-то не работает

Claude Code или расширение просит войти в Anthropic

Значит, токен не виден. Проверьте:

1. ~/.claude/settings.json — валидный JSON (лишняя запятая в конце тихо ломает весь файл).
2. Ключ задан именно как ANTHROPIC_AUTH_TOKEN.
3. В расширении включена Disable Login Prompt.
4. Если раньше входили в аккаунт Anthropic, выполните в сессии /logout один раз.

401 invalid_api_key

Ключ опечатан, отозван или вокруг него есть пробелы. Выпустите новый на странице ключей↗.

402

Закончился баланс. Пополните↗ и повторите запрос.

404 при запросе

Проверьте, что base URL — ровно https://api.zukko.pro без /v1. Claude Code добавит путь сам.

В терминале claude не находится

Расширение не устанавливает CLI в систему. Поставьте Claude Code по инструкции выше и откройте новый терминал.

Частые вопросы

Можно ли использовать разные ключи для разных проектов?

Да. Кроме пользовательского ~/.claude/settings.json, Claude Code читает настройки проекта, в том числе .claude/settings.local.json в корне репозитория (его не коммитят). Положите туда блок env с другим ключом fetch_... — он применится после того, как вы подтвердите доверие к папке проекта. Ключи с разными лимитами и списком моделей создаются на странице ключей↗.

Работает ли расширение без установленного CLI?

Да. В расширение встроена своя копия Claude Code. Отдельный CLI нужен только для запуска claude в терминале.

Можно ли пользоваться расширением и CLI одновременно?

Да. Настройки общие, и по документации Claude Code расширение и CLI используют одну историю диалогов: разговор из панели можно продолжить в терминале командой claude --resume.

Что если переменные заданы и в settings.json, и в терминале?

По документации Claude Code, в большинстве сессий побеждает значение из блока env в settings-файле: Claude Code записывает его в окружение процесса поверх унаследованного из оболочки.

Подробная настройка, включая выбор моделей, — в инструкции по Claude Code↗ в документации Zukko.