Claude Code: Полное руководство по AI-ассистенту для разработчиков

– Освоите Claude Code от установки до продвинутых сценариев. Вы будете уверенно использовать все возможности инструмента, включая MCP, hooks, автоматизацию и командную работу.

– Научитесь эффективно общаться с AI. Составление промптов – это навык, и эта книга научит вас формулировать задачи так, чтобы получать максимально качественный результат с минимальным количеством итераций.

– Построите шесть полноценных проектов. Четвёртая часть книги – это практикум, где вы шаг за шагом создадите SaaS-платформу, мобильное приложение, CLI-утилиту, Telegram-бота, Data Pipeline и микросервисную систему.

– Поймёте архитектурные принципы. Claude Code – отличный инструмент для изучения архитектуры программного обеспечения, и книга использует его именно в этом контексте: каждый проект иллюстрирует определённые архитектурные паттерны.

– Сможете внедрить Claude Code в команде. Главы о командной работе, безопасности и стандартизации дадут вам необходимые инструменты для этого.

– Получите стратегическое видение. Последние главы помогут вам оценить, как AI-ассистенты изменят профессию разработчика в ближайшие годы, и подготовиться к этим изменениям.

1.8. Структура глав и условные обозначения

Каждая глава этой книги следует единой структуре:

– Введение – постановка задачи и мотивация

– Теоретическая часть – концепции и принципы

– Практическая часть – пошаговые инструкции с примерами кода

– Советы и предупреждения – типичные ошибки и лучшие практики

– Итоги – краткое резюме ключевых моментов

В тексте используются следующие условные обозначения:

Блоки кода содержат фрагменты, которые вы можете вводить в терминал или редактор. Комментарии внутри блоков кода объясняют ключевые моменты.

Промпты – примеры запросов к Claude Code – выделены курсивом и предваряются символом «>».

Совет – полезная рекомендация, которая поможет работать эффективнее.

Предупреждение – потенциальная ловушка или типичная ошибка.

Заметка – дополнительная информация для углублённого понимания.

Итоги главы

В этой главе мы рассмотрели:

– Историю Anthropic и эволюцию линейки Claude

– Место Claude Code среди AI-инструментов для разработки

– Подробное сравнение с GitHub Copilot, Cursor, Q Developer и Gemini Code Assist

– Философию Claude Code: AI как напарник, а не замена

– Основные сценарии использования: от прототипирования до DevOps

– Объективные ограничения и реалистичные ожидания

– Структуру книги и условные обозначения

В следующей главе мы перейдём к практике: установим Claude Code, настроим окружение и сделаем первые шаги.

Глава 2. Установка и настройка окружения

2.1. Системные требования

Прежде чем приступить к установке Claude Code, убедимся, что ваша система соответствует минимальным требованиям. Claude Code – это инструмент командной строки, построенный на платформе Node.js, что обеспечивает его кроссплатформенность, но накладывает определённые ограничения.

Аппаратные требования

Claude Code сам по себе не требует мощного оборудования – все вычисления происходят на серверах Anthropic. Однако комфортная работа предполагает:

– Оперативная память: минимум 4 ГБ (рекомендуется 8 ГБ и более). Claude Code использует память для хранения контекста диалога и индексов проекта.

– Дисковое пространство: около 500 МБ для самого инструмента и его зависимостей, плюс место для ваших проектов.

– Процессор: любой современный процессор. CPU не является узким местом, поскольку основные вычисления выполняются в облаке.

– Интернет-соединение: стабильное подключение обязательно. Без интернета Claude Code работать не будет, так как все запросы к модели отправляются через API. Рекомендованная скорость – не менее 10 Мбит/с для комфортной работы.

Программные требования

– Node.js: версия 18.0 или выше. Claude Code написан на TypeScript и выполняется в среде Node.js. Рекомендуется использовать LTS-версию (Long Term Support) для максимальной стабильности.

– npm: версия 9.0 или выше. Поставляется вместе с Node.js.

– Операционная система:

– macOS 12 (Monterey) или новее

– Ubuntu 20.04 / Debian 11 или новее

– Windows 10/11 с WSL2 (Windows Subsystem for Linux)

– Другие дистрибутивы Linux с glibc 2.31+

– Терминал: любой эмулятор терминала. Рекомендуются: iTerm2 (macOS), Windows Terminal (Windows), Alacritty, Kitty или WezTerm (кроссплатформенные).

– Git: версия 2.30 или выше (для работы с контролем версий).

Проверка требований

Перед установкой выполните следующие проверки в терминале:

node –version

npm –version

git –version

Если Node.js не установлен или версия устарела, рекомендуется использовать менеджер версий – nvm (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

nvm install –lts

nvm use –lts

Для Windows рекомендуется nvm-windows:

winget install CoreyButler.NVMforWindows

nvm install lts

nvm use lts

2.2. Установка Claude CodeУстановка через npm (рекомендуемый способ)

Основной и рекомендуемый способ установки Claude Code – через npm, менеджер пакетов Node.js:

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

claude –version

Глобальная установка (-g) делает команду claude доступной из любого каталога в терминале. Это важно, поскольку Claude Code работает в контексте текущего каталога – того проекта, с которым вы хотите работать.

Если вы столкнулись с ошибками прав доступа при глобальной установке на Linux/macOS, есть несколько решений:

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

mkdir -p ~/.npm-global

npm config set prefix '~/.npm-global'

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

source ~/.bashrc

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

npx @anthropic-ai/claude-code

Установка через Homebrew (macOS)

На macOS доступна установка через Homebrew:

brew install claude-code

brew tap anthropic-ai/tap

brew install anthropic-ai/tap/claude-code

Установка на Windows через WSL2

Claude Code официально поддерживает Windows только через WSL2. Вот пошаговая инструкция:

wsl –install

sudo apt update && sudo apt upgrade -y

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

source ~/.bashrc

nvm install –lts

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

Важная деталь: при работе в WSL2 убедитесь, что ваш проект находится внутри файловой системы WSL (например, /home/username/projects/), а не на диске Windows (/mnt/c/…). Работа с файлами на диске Windows через WSL значительно медленнее из-за трансляции файловых систем.

Установка в Docker

Для изолированной среды или CI/CD можно использовать Docker:

FROM node:20-slim

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

WORKDIR /app

COPY . .

CMD ["claude", "–print", "Analyze this project"]

Обновление

Claude Code активно развивается, и новые версии выходят регулярно. Для обновления:

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

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

Рекомендуется обновляться регулярно – как минимум раз в две недели. Каждое обновление может содержать улучшения качества, новые инструменты и исправления ошибок.

2.3. Аутентификация и API-ключи

Claude Code взаимодействует с моделями Anthropic через API, для чего необходим ключ аутентификации. Существует несколько способов настроить доступ.

Способ 1: Прямой вход через Anthropic

При первом запуске Claude Code предложит авторизоваться через веб-браузер:

claude

Откройте предложенную ссылку в браузере, войдите в свой аккаунт Anthropic и подтвердите авторизацию. После этого Claude Code сохранит токен авторизации локально и будет использовать его для последующих сессий.

Этот способ наиболее удобен для индивидуального использования: вам не нужно вручную управлять ключами, а токен автоматически обновляется.

Способ 2: API-ключ через переменную окружения

Для автоматизации, CI/CD или серверного использования удобнее задавать API-ключ через переменную окружения:

export ANTHROPIC_API_KEY="sk-ant-…"

echo 'export ANTHROPIC_API_KEY="sk-ant-…"' >> ~/.bashrc

source ~/.bashrc

Для более безопасного хранения ключей используйте менеджер секретов:

echo 'export ANTHROPIC_API_KEY="sk-ant-…"' > .envrc

direnv allow

export ANTHROPIC_API_KEY=$(op read "op://Development/Anthropic API Key/credential")

aws-vault exec dev – claude

Никогда не храните API-ключи в файлах, которые могут попасть в Git-репозиторий. Добавьте .envrc в .gitignore.

Способ 3: AWS Bedrock

Для организаций, использующих AWS, Claude доступен через Amazon Bedrock:

export CLAUDE_CODE_USE_BEDROCK=1

export AWS_REGION=us-east-1

export AWS_ACCESS_KEY_ID="AKIA…"

export AWS_SECRET_ACCESS_KEY="…"

Преимущества использования Bedrock: единый биллинг через AWS, SLA на корпоративном уровне, соответствие требованиям compliance (SOC2, HIPAA, FedRAMP).

Способ 4: Google Vertex AI

Аналогично, Claude доступен через Google Cloud Vertex AI:

export CLAUDE_CODE_USE_VERTEX=1

export CLOUD_ML_REGION=us-east5

export ANTHROPIC_VERTEX_PROJECT_ID="your-project-id"

Проверка аутентификации

После настройки убедитесь, что всё работает:

claude –print "Hello, world!"

Если возникает ошибка аутентификации, проверьте:

– Правильность API-ключа

– Наличие достаточного баланса на аккаунте

– Доступность серверов API (status.anthropic.com)

– Корректность сетевых настроек (прокси, VPN, файрвол)

2.4. Конфигурационные файлы

Claude Code использует систему конфигурационных файлов для настройки поведения. Понимание этой системы критически важно для эффективной работы.

Иерархия конфигурации

Claude Code применяет иерархическую систему настроек с несколькими уровнями приоритета:

– Аргументы командной строки – высший приоритет

– Переменные окружения

– Проектная конфигурация (.claude/ в каталоге проекта)

– Пользовательская конфигурация (~/.claude/)

– Системные настройки по умолчанию – низший приоритет

Файл CLAUDE.md

Файл CLAUDE.md – один из самых мощных инструментов настройки Claude Code. Это файл в формате Markdown, расположенный в корне проекта (или в любом подкаталоге для более гранулярной настройки). Claude Code автоматически читает его и использует содержимое как постоянные инструкции.

Пример CLAUDE.md для типичного Python-проекта:

## Описание

REST API для приложения управления задачами. Python 3.12, FastAPI, SQLAlchemy, PostgreSQL.

## Архитектура

– `app/` – основной код приложения

– `api/` – маршруты и эндпоинты

– `models/` – SQLAlchemy модели

– `schemas/` – Pydantic схемы

– `services/` – бизнес-логика

– `core/` – конфигурация, безопасность, зависимости

– `tests/` – тесты (pytest)

– `alembic/` – миграции базы данных

## Соглашения по коду

– Используй type hints везде

– Используй async/await для всех эндпоинтов

– Именование: snake_case для функций, PascalCase для классов

– Формат строк: f-strings

– Максимальная длина строки: 100 символов

– Используй ruff для форматирования и линтинга

## Команды

– Запуск: `uvicorn app.main:app –reload`

– Тесты: `pytest -v`

– Линтинг: `ruff check .`

– Миграции: `alembic upgrade head`

## Важно

– Не используй print() – всегда logging

– Все эндпоинты должны иметь описание и теги для OpenAPI

– Бизнес-логика НЕ должна быть в маршрутах – выноси в services

– Пароли хэшировать через bcrypt

– JWT-токены со сроком жизни 30 минут

Claude Code будет следовать этим инструкциям во всех своих действиях. Это как README для вашего AI-напарника – чем подробнее вы опишете проект, тем лучше Claude Code будет с ним работать.

Каталог .claude/

Каталог .claude/ в корне проекта содержит дополнительные конфигурационные файлы:

.claude/

+– settings.json # Настройки проекта

+– commands/ # Пользовательские команды

| +– review.md # /project:review

| +– deploy.md # /project:deploy

+– .cursorrules # Совместимость с Cursor

Файл settings.json управляет поведением Claude Code на уровне проекта:

{

"permissions": {

"allow": [

"Read",

"Write",

"Bash(npm run *)",

"Bash(pytest *)",

"Bash(git *)"

],

"deny": [

"Bash(rm -rf *)",

"Bash(sudo *)",

"Bash(curl * | bash)"

]

},

"model": "claude-sonnet-4-20250514",

"maxTurns": 50

}

Пользовательская конфигурация (~/.claude/)

Домашний каталог содержит глобальные настройки:

~/.claude/

+– settings.json # Глобальные настройки

+– commands/ # Глобальные команды

| +– standup.md # /user:standup

+– credentials.json # Токены авторизации (не редактировать)

+– projects/ # Кэш и состояние проектов

Глобальные настройки применяются ко всем проектам и могут быть переопределены проектными:

{

"theme": "dark",

"verbose": false,

"autoApprove": ["Read"],

"notifications": true,

"defaultModel": "claude-sonnet-4-20250514"

}

Переменные окружения

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

ANTHROPIC_API_KEY # API-ключ Anthropic

CLAUDE_CODE_USE_BEDROCK # Использовать AWS Bedrock

CLAUDE_CODE_USE_VERTEX # Использовать Google Vertex AI

CLAUDE_MODEL # Модель по умолчанию

HTTP_PROXY # HTTP прокси

HTTPS_PROXY # HTTPS прокси

NO_PROXY # Исключения для прокси

CLAUDE_CODE_MAX_TURNS # Максимальное количество шагов

CLAUDE_CODE_DISABLE_TELEMETRY # Отключение телеметрии

2.5. Интеграция с редакторами кода

Хотя Claude Code работает из терминала и не зависит от конкретного редактора, существуют интеграции, которые делают работу более удобной.

Visual Studio Code

VS Code – самый популярный редактор среди разработчиков, и для него доступно расширение Claude Code:

code –install-extension anthropic.claude-code-vscode

Расширение добавляет:

– Панель Claude Code в боковой панели

– Возможность отправлять выделенный код в Claude Code

– Отображение изменений, внесённых Claude Code, в diff-просмотрщике

– Подсветку файла CLAUDE.md

– Статус-бар с информацией о текущей сессии

Альтернативный подход – использовать встроенный терминал VS Code. Откройте терминал (Ctrl+ `или Cmd+` `), перейдите в каталог проекта и запустите claude`. Оба окна – редактор и Claude Code – будут работать бок о бок, и вы сможете видеть изменения в файлах в реальном времени.

Полезные настройки VS Code для работы с Claude Code:

// settings.json

{

"files.autoSave": "afterDelay",

"files.autoSaveDelay": 1000,

"editor.formatOnSave": true,

"git.autofetch": true,

"terminal.integrated.scrollback": 10000

}

JetBrains IDE (IntelliJ IDEA, PyCharm, WebStorm)

Для семейства JetBrains IDE существует плагин Claude Code:

– Откройте Settings -> Plugins -> Marketplace

– Найдите «Claude Code»

– Установите и перезапустите IDE

Плагин интегрируется в панель инструментов и позволяет:

– Отправлять выделенный код или файл в Claude Code

– Просматривать изменения через встроенный diff-просмотрщик JetBrains

– Использовать Claude Code из встроенного терминала

Как и в случае с VS Code, самый простой способ – открыть встроенный терминал и запустить claude из каталога проекта.

Vim / Neovim

Для пользователей Vim/Neovim рекомендуется работать с Claude Code через разделение терминала (tmux, screen или встроенная функция терминального мультиплексора):

tmux new-session -d -s dev

tmux split-window -h

tmux send-keys -t dev:0.0 'vim .' Enter

tmux send-keys -t dev:0.1 'claude' Enter

tmux attach -t dev

Для Neovim существуют плагины интеграции:

-– lazy.nvim

{

"anthropic/claude-code.nvim",

config = function()

require("claude-code").setup({

auto_open = false,

split = "vertical",

})

end,

}

Emacs

Для Emacs доступен пакет claude-code.el:

;; Через use-package

(use-package claude-code

:ensure t

:config

(setq claude-code-auto-approve-reads t))

Или просто используйте M-x shell или M-x vterm для запуска Claude Code в буфере терминала внутри Emacs.

2.6. Настройка рабочего окружения

Для максимально продуктивной работы с Claude Code рекомендуется настроить ряд дополнительных инструментов.

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

tmux или screen позволяют работать с несколькими панелями терминала одновременно:

brew install tmux

sudo apt install tmux

set -g mouse on

set -g history-limit 50000

set -g default-terminal "screen-256color"

bind | split-window -h

bind – split-window -v

Типичная раскладка для работы с Claude Code:

– Левая панель: редактор кода (Vim/Neovim)

– Правая верхняя панель: Claude Code

– Правая нижняя панель: терминал для запуска команд вручную

Инструменты для работы с файлами

Claude Code активно работает с файлами, и полезно иметь инструменты для их просмотра:

brew install bat

sudo apt install bat

brew install fd # или apt install fd-find

brew install ripgrep # или apt install ripgrep

brew install fzf # или apt install fzf

brew install eza # или cargo install eza

brew install git-delta # или cargo install git-delta

Настройка Git для работы с delta:

[core]

pager = delta

[interactive]

diffFilter = delta –color-only

[delta]

navigate = true

side-by-side = true

line-numbers = true

Настройка Shell

Удобная оболочка ускоряет работу:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

plugins=(

git

docker

kubectl

node

npm

python

fzf

zsh-autosuggestions

zsh-syntax-highlighting

)

alias cc='claude'

alias ccp='claude –print'

alias ccr='claude –resume'

alias ccc='claude –continue'

2.7. Первый запуск и ориентация

После установки и настройки давайте выполним первый запуск и познакомимся с интерфейсом.

Запуск

Откройте терминал, перейдите в каталог проекта и запустите Claude Code:

cd ~/projects/my-project

claude

При первом запуске вы увидите приветственное сообщение и приглашение ввести запрос:

+==============================================+

| Welcome to Claude Code! |

| |

| Model: claude-sonnet-4-20250514 |

| Context: 200,000 tokens |

| Working directory: ~/projects/my-project |

+==============================================+

Type your request or /help for commands.

>

Основные команды

Claude Code поддерживает набор слэш-команд для управления:

/help – Справка по командам

/clear – Очистка диалога и сброс контекста

/compact – Сжатие контекста для экономии токенов

/status – Информация о текущей сессии

/cost – Стоимость текущей сессии

/model – Смена модели

/permissions – Управление разрешениями

/config – Настройки

/bug – Отправка отчёта об ошибке

/quit или Ctrl+C – Выход

Проверка работоспособности

Попробуйте простой запрос:

> Покажи список файлов в текущем каталоге и опиши структуру проекта

Claude Code выполнит команду ls или find, прочитает ключевые файлы

(package.json, requirements.txt, README.md и т.п.)

и выдаст описание структуры проекта.

Если Claude Code успешно выводит ответ, значит установка прошла корректно.

2.8. Типичные проблемы при установке и их решениеОшибка «command not found: claude»

Наиболее частая проблема. Причины и решения:

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

echo $PATH

export PATH=$(npm config get prefix)/bin:$PATH

Ошибка «EACCES: permission denied»

mkdir -p ~/.npm-global

npm config set prefix '~/.npm-global'

export PATH=~/.npm-global/bin:$PATH

nvm install –lts

Ошибка аутентификации (401 Unauthorized)

echo $ANTHROPIC_API_KEY

claude logout

claude login

Ошибка «rate limit exceeded»

Anthropic ограничивает количество запросов для защиты от злоупотреблений. Решения:

– Подождать несколько минут и повторить

– Перейти на более высокий тарифный план

– Использовать /compact для уменьшения размера запросов

– Разбить задачу на более мелкие части

Проблемы с прокси/VPN

export HTTP_PROXY=http://proxy.company.com:8080

export HTTPS_PROXY=http://proxy.company.com:8080

export NO_PROXY=localhost,127.0.0.1

export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.crt

Проблемы на Windows/WSL

wsl –list –verbose

wsl –set-version Ubuntu 2

nslookup api.anthropic.com

echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf

2.9. Управление затратами

Claude Code использует API-тарификацию Anthropic, и понимание модели ценообразования поможет контролировать расходы.

Модель ценообразования

Стоимость рассчитывается за количество токенов:

– Входные токены (ваш промпт + контекст): тарифицируются по одной ставке

– Выходные токены (ответ Claude): тарифицируются по более высокой ставке

– Кэшированные токены: тарифицируются со скидкой (если контекст не изменился)

Цены различаются в зависимости от модели:

– Claude Sonnet – оптимальный баланс цены и качества

– Claude Opus – дороже, но лучше для сложных задач

– Claude Haiku – дешевле, подходит для простых задач

Стратегии экономии

– Используйте /compact регулярно. Эта команда сжимает историю диалога, сохраняя ключевую информацию и уменьшая количество входных токенов.

– Начинайте с Sonnet. В большинстве случаев Sonnet обеспечивает достаточное качество. Переключайтесь на Opus только для особо сложных задач.

– Будьте конкретны. Чем точнее ваш промпт, тем меньше итераций потребуется. Вместо «исправь баги» скажите «в файле auth.py функция login_user возвращает 500 при невалидном email, а должна возвращать 422 с подробным описанием ошибки».

– Используйте CLAUDE.md. Предоставление контекста через CLAUDE.md снижает необходимость в повторных объяснениях и уменьшает количество операций чтения файлов.

– Разбивайте задачи. Одна большая задача может потребовать загрузки всей кодовой базы в контекст. Несколько мелких задач работают с меньшим контекстом.

– Мониторьте расходы. Используйте команду /cost для отслеживания расходов текущей сессии и панель управления на console.anthropic.com для общей статистики.

Бюджетирование

Для оценки бюджета учитывайте:

– Активный разработчик тратит в среднем 10-50 долларов в месяц

– Интенсивное использование (целый рабочий день каждый день) может достигать 100-200 долларов

– Для команд удобнее использовать централизованный биллинг через AWS Bedrock или Google Vertex