Claude Code с нуля: установка и настройка за десять минут

Claude Code — консольный агент Anthropic: он читает проект, правит файлы, запускает команды и держит контекст между шагами. Ниже — установка с нуля и настройка на работу по вашему API-ключу.

Шаг 1. Установка

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

Этот вариант выручает, если claude.ai отдаёт 403 в вашем регионе: npm работает везде.

Шаг 2. Постоянный конфиг

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

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

Если файл уже существует, добавьте блок env внутрь, а не перезаписывайте целиком.

Два места, где ошибаются почти все. Адрес идёт без /v1 — Claude Code добавит путь сам. И переменная называется ANTHROPIC_AUTH_TOKEN: с ANTHROPIC_API_KEY агент решит, что вы работаете через аккаунт Anthropic, и начнёт просить вход.

Шаг 3. Слоты моделей

В меню /model три фиксированных слота — Opus, Sonnet, Haiku. Переменные из конфига выше переназначают каждый слот на конкретную модель, поэтому стандартный переключатель продолжает работать.

Это рычаг экономии: поставьте на слот Sonnet более дешёвую модель и переключайтесь на Opus точечно, когда задача действительно сложная. Разница в счёте за месяц получается кратной.

Шаг 4. Запуск

claude

Конфиг подхватывается автоматически. Задайте любой вопрос — если ответ пришёл, всё работает, а в истории кабинета появится первая запись о расходе.

Расширение VS Code

Установите Claude Code из Marketplace, убедитесь, что ~/.claude/settings.json уже создан, включите в настройках VS Code опцию Claude Code: Disable Login Prompt и перезагрузите окно через Developer: Reload Window.

Разовый запуск без конфига

Для быстрой проверки, без правки файлов:

export ANTHROPIC_BASE_URL="https://api.zukko.pro"
export ANTHROPIC_AUTH_TOKEN="fetch_ваш_ключ"
claude

Переменные живут до закрытия терминала.

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

claude не найден на Windows. Откройте новое окно PowerShell. Если не помогло — where.exe claude; при пустом выводе переустановите.

Просит войти в Anthropic. Проверьте имя переменной и валидность JSON. Если раньше логинились аккаунтом — выполните /logout один раз.

401. Ключ с опечаткой, с пробелом или отозван.

402. Пустой баланс.

404 на каждый запрос. Лишний /v1 в адресе.

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

Оплата идёт за использованные токены. Агентская сессия — это в основном входные токены, поэтому смотрите прежде всего на их цену: в Zukko↗ Opus 5 стоит $0.30 за миллион против $5 у Anthropic.

Ключ создаётся в кабинете, стартовый доллар начисляется при первом входе в @zukkopro_bot↗ — этого хватит на несколько реальных сессий.