Claude Code

IDE Интеграции

Официальный coding-агент Anthropic (CLI + расширение VS Code). Ниже — быстрый старт и полный ручной разбор с troubleshooting в конце.

Сначала выберите режим Anthropic (не OpenAI). Base URL без /v1. См. Выбор провайдера.

Самый быстрый способ

Возьмите ключ на странице API-ключей — он вида fetch_....
Установите Claude Code (если ещё нет).
Пропишите ~/.claude/settings.json как в шаге 2 ниже.
Запустите claude в новом терминале.

Ключ никуда не отправляется, кроме локального файла настроек на вашем компьютере.

Ручная настройка

Всё то же по шагам: установка → постоянный конфиг через settings.json → запуск.

Обязательные значения

Провайдер: Anthropic
ANTHROPIC_BASE_URL = https://api.zukko.pro — без суффикса /v1, Claude Code сам добавит путь.
ANTHROPIC_AUTH_TOKEN = ваш ключ fetch_... со страницы ключей.

1. Установите Claude Code

Пропустите шаг, если claude --version уже работает.

macOS / Linux

bash

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

Windows (PowerShell)

bash

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

После установки полностью закройте и снова откройте PowerShell, затем проверьте claude --version.

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

bash

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

Если claude.ai отдаёт 403 в вашем регионе — используйте установку через npm: она работает везде.

2. Рекомендуется: постоянная настройка через settings.json

Claude Code читает ~/.claude/settings.json при каждом запуске — настроили один раз и забыли. И CLI, и расширение VS Code используют один и тот же файл.

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

bash

{
  "$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-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5",
    "DISABLE_TELEMETRY": "1",
    "DISABLE_ERROR_REPORTING": "1"
  }
}

Если settings.json уже есть — вмержите блок env внутрь файла, не затирайте весь конфиг.

3. Что делает этот конфиг

Подключение

bash

"ANTHROPIC_BASE_URL": "https://api.zukko.pro",
"ANTHROPIC_AUTH_TOKEN": "fetch_..."

Все запросы идут в Zukko вместо официального эндпоинта Anthropic. Используйте именно ANTHROPIC_AUTH_TOKEN (отправляется как Bearer), а не ANTHROPIC_API_KEY — так Claude Code не будет просить логин в Anthropic.

Слоты моделей

bash

"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"

В меню /model у Claude Code три фиксированных слота — Opus, Sonnet, Haiku. Эти переменные переназначают каждый слот на модель Zukko, чтобы стандартный переключатель продолжал работать. Можно указать любой ID из каталога, например закрепить Opus на claude-opus-4.7.

Приватность (опционально)

DISABLE_TELEMETRY и DISABLE_ERROR_REPORTING отключают аналитику и crash-репорты в Anthropic. На работу агента не влияют — оставляйте или убирайте по желанию.

4. Запуск

bash

claude

Конфиг подхватывается автоматически. Чтобы проверить связь, задайте любой вопрос — первый ответ подтвердит, что биллинг идёт с баланса Zukko. Модель можно сменить командой /model.

5. Разовый запуск без settings.json

Только для быстрой проверки — переменные живут до закрытия терминала.

macOS / Linux

bash

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

Windows (PowerShell)

bash

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

6. Расширение VS Code: один дополнительный шаг

Установите расширение Claude Code из Marketplace.
Убедитесь, что ~/.claude/settings.json из шага 2 уже есть — расширение читает тот же файл.
В настройках VS Code (Ctrl/Cmd + ,) включите Claude Code: Disable Login Prompt, чтобы не предлагался вход в Anthropic.
Перезагрузите окно (Developer: Reload Window).

7. Troubleshooting

Windows: `claude` is not recognized

Полностью закройте PowerShell и откройте новое окно — обновление PATH не доходит до уже открытых терминалов. Всё ещё не находится? Выполните where.exe claude: если пусто — переустановите Claude Code из шага 1.

Claude Code просит войти в Anthropic

Значит, токен не виден. Проверьте, что ключ задан как ANTHROPIC_AUTH_TOKEN (не ANTHROPIC_API_KEY) и что settings.json — валидный JSON: лишняя запятая в конце тихо ломает весь файл. Если раньше логинились аккаунтом Anthropic, один раз выполните /logout.

401 invalid_api_key

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

402 / запросы внезапно перестали проходить

Почти всегда пустой баланс. Пополните и повторите — перезапуск не нужен.

Cursor IDE

OpenCode