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

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

Прежде чем приступить к установке 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

Основной и рекомендуемый способ установки 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

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

brew install claude-code

brew tap anthropic-ai/tap

brew install anthropic-ai/tap/claude-code

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 значительно медленнее из-за трансляции файловых систем.

Для изолированной среды или 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

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

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

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

claude

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

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

Для автоматизации, 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.

Для организаций, использующих 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).

Аналогично, 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, файрвол)

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

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

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

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

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

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

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

Файл 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/

+– 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/

+– 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 # Отключение телеметрии

Хотя Claude 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 существует плагин Claude Code:

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

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

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

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

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

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

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

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

Для пользователей 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 доступен пакет 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.

Для максимально продуктивной работы с 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

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

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'

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

Откройте терминал, перейдите в каталог проекта и запустите 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 успешно выводит ответ, значит установка прошла корректно.

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

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

echo $PATH

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

mkdir -p ~/.npm-global

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

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

nvm install –lts

echo $ANTHROPIC_API_KEY

claude logout

claude login

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

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

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

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

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

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

wsl –list –verbose

wsl –set-version Ubuntu 2

nslookup api.anthropic.com

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

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