Claude Code: полный гайд от установки до ежедневной работы

01 Что такое Claude Code

Claude Code — официальная консольная программа Anthropic: это не «чат рядом с редактором», а полноценный агент, который работает прямо в вашем проекте. Вы ставите задачу обычными словами, а он сам решает, какие файлы открыть, что изменить, какие команды выполнить и как проверить результат.

Что он умеет на практике:

• Понимать проект. Разбирает структуру, зависимости, тесты и стиль кода — от «объясни, что делает этот сервис» до поиска корня бага по стеку ошибки.
• Менять код. Правки идут диффом: вы видите, что именно меняется, и подтверждаете действие (или разрешаете заранее — по правилам).
• Запускать команды. Сборка, тесты, линтеры, git, миграции, запуск контейнеров — всё в одном цикле «правка → проверка → правка».
• Помнить контекст. Файл CLAUDE.md в проекте хранит правила и договорённости команды — агент читает его в каждой сессии.
• Расширяться. Навыки, субагенты, хуки и подключения MCP превращают агента в часть вашего рабочего процесса, включая CI.

02 Быстрый старт: 4 шага

Если хочется получить работающий агент прямо сейчас — вот вся последовательность целиком. Подробности по каждому шагу идут дальше.

# 1. Установить Claude Code (Windows PowerShell)
irm https://claude.ai/install.ps1 | iex

# 2. Прописать ключ и адрес шлюза в настройках Claude Code
#    файл: ~/.claude/settings.json (см. шаг 3)

# 3. Перейти в свой проект и запустить агента
cd C:\путь\к\проекту
claude

# 4. Внутри сессии проверить связь и модель
/status
/model

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

Claude Code ставится одним установщиком и работает в терминале: PowerShell, Windows Terminal, Терминал macOS, любой Linux-шелл. Отдельная IDE не нужна — агент редактирует файлы проекта напрямую.

# рекомендуемый способ для Windows
irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

winget install Anthropic.ClaudeCode

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

brew install --cask claude-code

claude --version

# обновление до свежей версии
claude update

# диагностика окружения (PATH, зависимости, доступ к сети)
claude doctor

04 Шаг 2. Ключ и кабинет

Claude Code нужен ключ — строка вида sk-…. В NeuroZal ключ создаётся в личном кабинете, расход считается по факту запросов, подписки и абонентской платы нет.

1. Войдите в кабинет: api.neurozal.ru/panel. Если аккаунта ещё нет — регистрация занимает минуту.
2. Пополните баланс. Сумма зачисляется на счёт, списание — только за фактически отправленные и полученные токены.
3. Создайте ключ: раздел «Ключи» → создать. Скопируйте значение сразу — полностью ключ показывается один раз.
4. Дайте ключу понятное имя — по устройству или задаче («ноутбук», «Claude Code на работе»). Так расход проще разбирать в журнале.

05 Шаг 3. Подключение к шлюзу

Claude Code — клиент Anthropic-протокола. Чтобы он работал через NeuroZal, ему нужно передать адрес API и ключ. Есть два способа: переменные окружения (быстро, удобно для одной машины) и файл settings.json (надёжнее, переносится и не путается при перезапусках).

Вариант A. Файл settings.json — рекомендуемый

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.neurozal.ru",
    "ANTHROPIC_AUTH_TOKEN": "sk-ваш-ключ-neurozal",
    "ANTHROPIC_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

Алиасы opus / sonnet / haiku за шлюзом Claude Code сам «угадать» не может, поэтому три переменные ANTHROPIC_DEFAULT_*_MODEL стоит задать явно: тогда команда /model sonnet и переключения режимов будут попадать в нужные модели.

Вариант B. Переменные окружения

$env:ANTHROPIC_BASE_URL = "https://api.neurozal.ru"
$env:ANTHROPIC_AUTH_TOKEN = "sk-ваш-ключ-neurozal"
$env:ANTHROPIC_MODEL = "claude-sonnet-4.6"
claude

setx ANTHROPIC_BASE_URL "https://api.neurozal.ru"
setx ANTHROPIC_AUTH_TOKEN "sk-ваш-ключ-neurozal"
setx ANTHROPIC_MODEL "claude-sonnet-4.6"

set ANTHROPIC_BASE_URL=https://api.neurozal.ru
set ANTHROPIC_AUTH_TOKEN=sk-ваш-ключ-neurozal
claude

export ANTHROPIC_BASE_URL="https://api.neurozal.ru"
export ANTHROPIC_AUTH_TOKEN="sk-ваш-ключ-neurozal"
export ANTHROPIC_MODEL="claude-sonnet-4.6"

Проверка без Claude Code: один запрос к шлюзу

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

curl -X POST "https://api.neurozal.ru/v1/messages" \
  -H "Authorization: Bearer sk-ваш-ключ-neurozal" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4.6","max_tokens":32,"messages":[{"role":"user","content":"Привет!"}]}'

$h = @{ "Authorization" = "Bearer sk-ваш-ключ-neurozal"; "anthropic-version" = "2023-06-01" }
$b = '{"model":"claude-sonnet-4.6","max_tokens":32,"messages":[{"role":"user","content":"Привет!"}]}'
Invoke-RestMethod -Method Post -Uri "https://api.neurozal.ru/v1/messages" -Headers $h -ContentType "application/json" -Body $b

06 Шаг 4. Первый запуск и проверка

Дальше — самое короткое. Открываем терминал в папке проекта и запускаем агента.

cd C:\путь\к\проекту
claude

# первая проверка внутри сессии
/status
/model
# затем просто напишите задачу обычными словами:
посмотри проект и расскажи, из чего он состоит и где точка входа

При первом запуске Claude Code попросит подтвердить доверие к папке проекта и предложит выбрать тему терминала. Экран входа в аккаунт можно пропустить — при заданных ANTHROPIC_BASE_URL и ключе запросы идут через NeuroZal, а не через подписку.

07 Модели и алиасы

Внутри Claude Code удобно переключаться не именами моделей, а короткими алиасами. За шлюзом каждый алиас указывает на конкретную модель — именно для этого в настройках есть переменные ANTHROPIC_DEFAULT_*_MODEL.

Переключение — тремя способами, от разового до постоянного:

# 1) внутри сессии — список и переключение
/model
/model claude-opus-4.8

# 2) на один запуск из терминала
claude --model claude-sonnet-4.6

# 3) по умолчанию — в ~/.claude/settings.json в блоке "env"
"ANTHROPIC_MODEL": "claude-sonnet-4.6"

08 Ежедневная работа: интерфейс и режимы

Claude Code — не чат в браузере, а агент в терминале: он читает файлы проекта, правит их, запускает команды и тесты. Четырёх привычек достаточно, чтобы работать с ним уверенно.

Горячие клавиши и приёмы ввода

Режимы правок и разрешения

Режим плана — самый полезный инструмент для незнакомого проекта: агент исследует код, показывает план и не меняет файлы, пока вы не согласуете. Дальше три уровня свободы действий:

09 Контекст и расходы

Качество ответов и стоимость напрямую зависят от того, сколько в сессии «мусора». Следить просто: команда /context рисует карту заполнения контекстного окна и подсказывает, что его съедает.

10 Память проекта: CLAUDE.md

Файл CLAUDE.md — постоянная инструкция, которую агент читает в начале сессии. Один раз описываем правила проекта — и больше не повторяем в каждом диалоге «у нас pnpm, тесты через vitest, не трогай папку legacy».

# О проекте
Сервис расчёта заказов: FastAPI + PostgreSQL, фронт на React.

# Команды
- запуск: make dev
- тесты: pytest -q (перед коммитом обязательно)
- линт: ruff check .

# Правила
- Миграции только через alembic, руками схему не менять.
- Папку legacy/ не трогать: она выводится из эксплуатации.
- Комментарии в коде — на русском, сообщения коммитов — на английском.
- API-ключи и .env не читать и не печатать в ответах.

Быстрый старт: команда /init сама просканирует репозиторий и создаст черновик CLAUDE.md с командами сборки, структурой и соглашениями. Дальше файл правится вручную или командами /memory и #. Внутри файла работает импорт: строка @docs/architecture.md подтягивает содержимое другого файла в память.

11 Команды внутри сессии

Наберите / — откроется список. Ниже — набор, которым пользуются каждый день.

12 Флаги запуска из терминала

Флаги нужны для скриптов и точной настройки одного запуска: claude --help показывает не всё, поэтому ниже — основные.

13 Навыки: свои сценарии одной командой

Навык — это папка с файлом SKILL.md: инструкция, как выполнять повторяющуюся работу. Навык превращается в слэш-команду и запускается так же, как встроенные. Часть навыков идёт «из коробки»: /run, /verify, /code-review, /simplify, /batch.

---
name: release-notes
description: Собирает заметки о релизе из коммитов и создания задач. Использовать, когда просят «заметки о релизе» или «changelog».
---

Собери изменения с последнего тега: `git log --oneline $(git describe --tags --abbrev=0)..HEAD`

Сгруппируй по разделам: Новое, Изменения, Исправления.
Формат — markdown, по одному пункту на изменение, без технического жаргона.
Файл пиши в CHANGELOG.md, ссылки на задачи сохраняй.

Где лежат навыки: .claude/skills/<имя>/SKILL.md в проекте и ~/.claude/skills/ для личных. Простые однофайловые команды можно класть в .claude/commands/<имя>.md — они тоже появятся в меню «/». Полезные команды при работе с набором навыков: /skills, /skill-doctor, /reload-skills.

14 Субагенты: отдельная голова под задачу

Субагент — вспомогательный агент со своим контекстом и своим набором инструментов. Основная сессия остаётся чистой: субагент, например, может прочитать сорок файлов и вернуть только вывод.

---
name: test-writer
description: Пишет модульные тесты под изменённый код. Вызывать после правок в src/.
tools: Read, Grep, Glob, Edit, Bash
---

Ты пишешь тесты для этого проекта. Смотри на существующие тесты
и повторяй их стиль. Новые тесты запусти и добейся зелёного прогона.
Отчёт: что покрыто, что осталось непокрытым.

Управление: /agents — создать и настроить, /list-agents — список, /tasks — фоновая работа, /subtask описание — отдельный субагент с копией текущего диалога.

15 Хуки: автоматика вокруг шагов агента

Хук — команда, которая выполняется сама: до правки файла, после правки, в начале сессии, в конце. Так в проект приносят автоформатирование, проверку запретных файлов и уведомления.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npx prettier --write \"$CLAUDE_FILE_PATH\"" }
        ]
      }
    ]
  }
}

Основные события: PreToolUse, PostToolUse, UserPromptSubmit, SessionStart, Stop, SessionEnd. Своё правило удобнее добавлять через /hooks — Claude Code сам предложит структуру и запишет её в нужный файл. Хук с ненулевым кодом возврата может заблокировать действие — так запрещают правку .env или миграций.

16 MCP: подключение внешних источников

MCP — стандарт подключения инструментов к агенту: базы данных, трекеры задач, документация, ваш внутренний API. Подключённый сервер добавляет свои инструменты и команды.

# список подключённых серверов
claude mcp list

# HTTP-сервер (например, документация проекта)
claude mcp add --transport http docs https://docs.example.com/mcp

# сервер с авторизацией
claude mcp add --transport http notion https://mcp.notion.com/mcp \
  --header "Authorization: Bearer ВАШ_ТОКЕН"

# проверить внутри сессии
/mcp

17 Автоматизация: агент в скриптах и CI

Тот же агент запускается без диалога и возвращает результат в stdout — это открывает путь к ночным прогонам, pre-commit проверкам и разбору баг-репортов из задач.

# один запрос и выход — без интерактива
claude -p "объясни, что делает этот репозиторий, в пяти пунктах"

# машинно-читаемый ответ для скриптов и ботов
claude -p "найди функции без обработки ошибок" --output-format json

# передать данные из конвейера
git diff | claude -p "отревьюй этот дифф, отметь риски"

# разбор всех SQL-файлов по очереди, с ограничением по деньгам
for f in db/*.sql; do
  claude -p "проверь файл $f на тяжёлые запросы" \
    --allowedTools "Read,Grep" \
    --max-budget-usd 0.30 \
    >> report.txt
done

Для GitHub есть готовое подключение: команда /install-github-app ставит приложение, после чего Claude Code умеет отвечать на комментарии @claude в issue и PR, сам делает ревью и вносит правки в ветку. Ключ шлюза в этом случае хранится как секрет репозитория.

18 12 рабочих рецептов

Готовые формулировки, которые дают результат сразу. Копируйте и адаптируйте под свой проект.

19 Как экономить токены

Счёт в NeuroZal зависит только от фактически переданных токенов. Один и тот же результат стоит по-разному — разница в привычках работы.

20 Типичные ошибки и что делать

21 Чек-лист настройки

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

Шпаргалка на один экран

# подключение к шлюзу
ANTHROPIC_BASE_URL = https://api.neurozal.ru
ANTHROPIC_AUTH_TOKEN = sk-ваш-ключ
ANTHROPIC_MODEL = claude-sonnet-4.6

# модели
claude-opus-4.8 · claude-sonnet-4.6 · claude-haiku-4.5

# каждый день
/status   — проверка связи и модели
/plan     — сначала план, потом правки
/context  — что занимает контекст
/compact  — сжать историю
/clear    — начать заново
/cost     — сколько израсходовано
/rewind   — откатить правки назад
claude -p "запрос"   — разовый запуск без диалога

22 Вопросы и ответы