Claude Code — это мощный AI-ассистент для разработчиков, работающий прямо в терминале. Он понимает контекст всего репозитория, а не отдельных файлов, что делает его незаменимым при работе с чужими проектами, в стартапах с маленькими командами и у фрилансеров. В этой статье мы подробно разберем установку, базовые команды, продвинутые workflow и лучшие практики использования.
Установка и первый запуск
Перед началом работы убедитесь, что у вас установлен Node.js (версия 18+). Установка выполняется одной командой:
npm install -g @anthropic-ai/claude-code
После установки перейдите в папку вашего проекта и запустите:
cd my-project
claude
При первом запуске Claude Code просканирует репозиторий, прочитает CLAUDE.md (если есть) и будет готов к работе. Важно: агент отвечает с учётом всего кодовой базы, а не только переданных фрагментов.
Основные slash-команды (Slash Commands)
Slash-команды вводятся прямо в чате с ИИ и начинаются со слеша /. Они позволяют управлять диалогом, памятью, настройками и запускать сложные workflow на лету.
Управление моделью и контекстом
/model— переключение между доступными моделями (Sonnet, Opus, Haiku)/compact— сжатие контекста для экономии токенов (очков). Рекомендуется использовать регулярно, так как длинные контексты требуют больше очков/clear— очистка истории диалога/cost— просмотр текущего расхода токенов за сессию
Работа с кодом и код-ревью
С версии v2.1.154 команды код-ревью были переработаны:
/code-review— базовый анализ кода на предмет багов и проблем/code-review --fix, автоматическое исправление найденных проблем/code-review --comment— добавление комментариев в код без изменений/code-review ultra— глубокий анализ с максимальной детализацией/code-review medium— сбалансированный режим (по умолчанию)
Важно: На ранних версиях /simplify был эквивалентен /code-review --fix. Сейчас /simplify — это отдельный путь для очистки и упрощения кода (cleanup path), а /code-review отвечает за поиск багов.
/simplify src/auth/— упрощение и рефакторинг указанной директории
Навигация и ение файлов
/files— список файлов в текущем контексте/tree, дерево проекта/find <pattern>— поиск файлов по шаблону/grep <pattern>— поиск по содержимому файлов
Git и версионирование
/git status— статус репозитория/git diff— показать изменения/git commit— создать коммит (Claude напишет сообщение)/git log— история коммитов/git branch, управление ветками
Тестирование и запуск
/test— запуск тестов проекта/test --watch— тесты в режиме наблюдения/run <command>— выполнение произвольной команды в терминале/build— сборка проекта
Продвинутые workflow: Spec → Plan → Ship → Evals
Современные методологии работы с Claude Code (по данным claude-code-handbook-ru) включают opinionated циклы:
- Spec (Спецификация) — описание требований, API-контрактов, схем БД
- Plan (Планирование) — разбиение на задачи, выбор архитектуры, оценка рисков
- Ship (Доставка), реализация, тестирование, код-ревью, деплой
- Evals (Оценка качества) — измерение качества агентов и промптов, регрессионное тестирование
Slash-команды могут вызывать сабагентов для планирования, а основной экземпляр Claude занимается исполнением. Это дает структурированные workflow с полным доступом к инструментам.
Кастомные slash-команды (Custom Slash Commands)
Одна из самых недооцененных возможностей — определение повторно используемых workflow как Markdown-файлов. Создайте файл .claude/commands/my-workflow.md:
---
name: my-workflow
description: Мой кастомный workflow для code review
---
Запусти `/code-review ultra` для глубокого анализа
Примени `/simplify` к измененным файлам
Запусти тесты: `/test`
Создай PR с описанием изменений
Теперь команда /my-workflow выполнит всю цепочку. Это позволяет кодифицировать командные процессы (extreme example, gstack factory).
Skills, Hooks и MCP-серверы
Понимание разницы между этими концепциями критично для продвинутого использования:
| Концепция | Расположение | Назначение |
|---|---|---|
| Slash Commands | .claude/commands/ | Точка входа (invocation surface), timing — когда запускать |
| Skills | .claude/skills/ | Упаковка (packaging), что внутри: субагенты, MCP, hooks, supporting files, metadata, dynamic context, tool controls |
| Hooks | .claude/hooks/ | Shell-команды, привязанные к событиям сессии (pre-tool, post-tool, notification, etc.) |
| MCP Servers | .claude/mcp/ | Внешние инструменты и интеграции (БД, API, файловая система, браузер) |
Правило миграции: Мигрируйте slash-команду в Skill только когда workflow требует supporting files, metadata, dynamic context, tool controls или лучшей discoverability. Маленькая старая команда может остаться маленькой старой командой.
CLAUDE.md — конфигурация проекта
Файл CLAUDE.md в корне репозитория — это инструкции для агента. Пример структуры:
# Project Instructions
Stack
- Language: TypeScript
- Framework: Next.js 14
- Database: PostgreSQL + Prisma
- Testing: Vitest + Playwright
Commands
- dev: npm run dev
- test: npm run test
- build: npm run build
- lint: npm run lint
Code Style
- Use functional components
- Prefer type inference
- No any types
- ESLint + Prettier enforced
Workflow
Read specs in /docs/specs
Write tests first (TDD)
Implement feature
Run /code-review before commit
Практические советы от опытных пользователей
- Используйте /compact регулярно — длинные контексты съедают очки. Сжимайте после завершения логических блоков работы.
- Комбинируйте команды —
/code-review --fixзатем/testзатем/git commitсоздает качественный цикл. - Создавайте кастомные команды для рутинных задач — деплой, миграции, генерация компонентов.
- Настройте hooks для автоматизации — например, автоформатирование при сохранении файла или запуск линтера перед коммитом.
- Изучите скрытый рантайм — slash-команды имеют доступ к внутренним API, о которых мало кто знает (50+ скрытых команд по данным Reddit).
Полезные ресурсы
- Claude Code Handbook RU — курируемый гайд на русском: hooks, skills, CLAUDE.md шаблоны, MCP-серверы, кейсы
- explainx.ai Blog — полный справочник slash-команд
- The Complete Claude Code Power User Guide — про slash commands, hooks, skills
- Habr: Claude Code: практический гайд по настройке, автоматизации и работе с контекстом
Claude Code — это не просто чат-бот в терминале, а полноценная платформа для агентной разработки. Ключ к эффективности — в понимании экосистемы: slash-команды для вызова, skills для упаковки, hooks для автоматизации событий, MCP для интеграций. Начните с базовых команд (/code-review, /compact, /model), затем постепенно внедряйте кастомные workflow и skills, подстраивая инструмент под процессы вашей команды.
Статья актуальна на . Claude Code активно развивается — следите за обновлениями в официальной документации и сообществе.