Полное руководство Claude Code

# Установка через npm (рекомендуется)
npm install -g @anthropic-ai/claude-code

# Для пользователей из Китая — ускорение через зеркало Taobao
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# Добавьте в ~/.bashrc или ~/.zshrc
export ANTHROPIC_BASE_URL=https://api.qcode.cc/api
export ANTHROPIC_AUTH_TOKEN=cr_ваш_API_ключ

source ~/.bashrc  # или source ~/.zshrc

# Версия
claude --version
# Должен вывести номер версии (зависит от вашей установки, см. https://github.com/anthropics/claude-code/releases)

# Быстрая проверка
claude -p "Привет, расскажи о себе"

# Bash
claude completion bash >> ~/.bashrc

# Zsh
claude completion zsh >> ~/.zshrc

# Fish
claude completion fish > ~/.config/fish/completions/claude.fish

cd ~/my-project
claude

╭─────────────────────────────────────────╮
│ claude                                   │
│                                          │
│ Проект: my-project                       │
│ Модель: claude-sonnet-5                  │
│ Контекст: 12,345 / 1,000,000 tokens      │
╰─────────────────────────────────────────╯

> _

> Проанализируй архитектуру этого проекта: какие основные модули и как они связаны

Claude хочет выполнить:
  Инструмент: Bash
  Команда: npm test

  [y] разрешить  [n] отклонить  [a] всегда разрешать в этой сессии

# Войти в режим планирования
> /plan

# Либо задать это прямо в запросе
> Сначала проанализируй требования и составь план, код пока не меняй

> /plan
> Хочу добавить в проект аутентификацию пользователей на JWT

Claude: Анализирую текущую структуру проекта и составляю план...

📋 План работ:
1. Создать src/middleware/auth.ts — middleware проверки JWT
2. Создать src/services/auth-service.ts — бизнес-логика аутентификации
3. Изменить src/routes/index.ts — добавить маршруты входа и регистрации
4. Создать src/models/user.ts — модель данных пользователя
5. Добавить зависимости: jsonwebtoken, bcrypt
6. Создать файлы тестов

План подходит? Нужны ли правки?

> Этот баг с конкурентностью я ловлю уже два дня. Разберись с гонкой в src/worker.ts

[Claude выполняет внутреннее рассуждение на тысячи токенов, разбирая пути выполнения, механизмы блокировок и тайминги]

Claude: Нашёл проблему. В worker.ts на строке 127...

> Сделай ревью этого PR и заодно проверь на уязвимости

Claude: Запускаю двух субагентов параллельно:

  - Субагент 1: ревью качества кода
  - Субагент 2: сканирование уязвимостей

# Посмотреть текущий расход контекста
/cost

# Сжать контекст (сохранить главное, освободить место)
/compact

# Начать полностью новую сессию
/clear

# Claude сам проанализирует проект и сгенерирует файл
/init

# MyApp

## Технологический стек

- React 19 + TypeScript 5.x + Vite
- Стили: Tailwind CSS v4
- Управление состоянием: Zustand
- Тесты: Vitest + Testing Library

## Частые команды

- Разработка: `pnpm dev`
- Тесты: `pnpm test`
- Сборка: `pnpm build`
- Lint: `pnpm lint`

## Правила кода

- Компоненты писать функциональными, Props описывать через interface
- Тип any запрещён
- CSS — только utility-классы Tailwind
- Формат коммитов: feat: / fix: / docs:

## Структура проекта

- src/components/ — переиспользуемые компоненты
- src/pages/ — компоненты страниц
- src/hooks/ — собственные хуки
- src/lib/ — вспомогательные функции
- src/api/ — обёртки над API-запросами

## Примечания

- Node.js 22+, пакетный менеджер — pnpm
- Все запросы к API идут через src/api/client.ts

# Переключение в интерактивном режиме
/model opus    # перейти на Opus
/model sonnet  # перейти на Sonnet
/model haiku   # перейти на Haiku

# Указание при запуске
claude --model claude-opus-5

Распределение моделей за день:
├── Sonnet 5 (70%) — повседневная разработка, багфиксы, тесты
├── Opus 5  (15%) — архитектурные решения, сложные задачи
└── Haiku 4.5 (15%) — форматирование, простые вопросы, массовые операции

# Сначала строим план на Opus
/model opus
> Проанализируй архитектуру этого модуля и составь план рефакторинга

# После утверждения плана переходим на Sonnet и выполняем
/model sonnet
> Выполни первый шаг плана

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

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  }
}

# Посмотреть доступные skills
/skills

# Использовать конкретный skill
> /commit    # сгенерировать коммит через commit skill
> /review    # проверить код через review skill

claude --bare -p "Перечисли все комментарии TODO" --output-format json

cd ~/unfamiliar-project
claude

> Проанализируй этот проект:
> 1. какой технологический стек используется
> 2. основные модули и их зона ответственности
> 3. направление потоков данных
> 4. нарисуй простую схему архитектуры (ASCII)

> /plan
> Нужно добавить в API ограничение частоты запросов. Требования:
> - не более 60 запросов в минуту на пользователя
> - счётчики хранить в Redis
> - при превышении возвращать 429 и заголовок Retry-After

Claude:
📋 План работ:
1. Установить зависимость: ioredis
2. Создать src/middleware/rate-limiter.ts
3. Создать src/config/rate-limit.ts (параметры)
4. Изменить src/app.ts (зарегистрировать middleware)
5. Создать tests/rate-limiter.test.ts
6. Обновить docker-compose.yml (добавить сервис Redis)

Подтвердите, и я приступаю.

> План подходит, выполняй

/model opus
> Пользователи сообщают, что «при одновременных заказах остаток на складе иногда уходит в минус».
> Проанализируй src/services/order-service.ts и src/services/inventory-service.ts,
> найди баг с конкурентностью и исправь его.

[Opus включает Extended Thinking и разбирает пути выполнения, механизмы блокировок и уровни изоляции транзакций]

Claude: Нашёл проблему. В inventory-service.ts на строке 45 проверка остатка и его списание выполняются не в одной транзакции —
это состояние гонки типа TOCTOU. Исправление: использовать SELECT FOR UPDATE...

> Все class-компоненты в проекте нужно переписать на функциональные компоненты + Hooks.
> Обработай по очереди все файлы .tsx в src/components/.

Claude сделает следующее:
1. Найдёт все class-компоненты
2. По очереди преобразует их в функциональные
3. Переведёт методы жизненного цикла в useEffect
4. Переведёт this.state в useState
5. Запустит тесты и убедится, что ничего не сломано

> Напиши полный набор модульных тестов для src/services/user-service.ts:
> - покрыть все публичные методы
> - включить нормальные и исключительные сценарии
> - замокать внешние зависимости (базу данных, кэш)
> - целевое покрытие 90%+

# Использование в GitHub Actions
claude -p "Проверь изменения кода в этом PR, обрати внимание на безопасность и производительность" \
  --output-format json \
  --max-turns 3 \
  --allowedTools Read,Glob,Grep

# 1. Claude Code составляет план
claude
> /plan
> Спроектируй план внедрения системы прав пользователей

# 2. Codex выполняет по плану
codex "По плану из PLAN.md реализуй шаги 1-3"

# Способ 1: через sudo
sudo npm install -g @anthropic-ai/claude-code

# Способ 2: управлять Node.js через nvm (рекомендуется)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code

# Проверить корректность настроек
echo $ANTHROPIC_BASE_URL    # должно быть https://api.qcode.cc/api
echo $ANTHROPIC_AUTH_TOKEN  # должно начинаться с cr_

# Проверить доступность
curl -I https://api.qcode.cc/api/health