# Быстрый старт

> ⚡ Ещё не настроили? Одна команда: `curl -fsSL https://qcode.cc/install/claude-code.sh | bash` (Windows: `irm https://qcode.cc/install/claude-code.ps1 | iex`). См. [Скрипт установки в один клик](/docs/getting-started/one-click-install).

После завершения установки и настройки переменных окружения давайте за 5 минут освоим основные возможности Claude Code.

## Запуск Claude Code

В терминале перейдите в директорию вашего проекта и выполните:

```bash
cd /path/to/your/project
claude
```

Перед вами появится интерактивный интерфейс Claude Code, и вы можете начать диалог.

## Основные способы взаимодействия

### 1. Понимание кода

```
> Какова архитектура этого проекта?
> Объясни, как работает src/auth/login.ts
> Найди все места, где происходит обращение к базе данных
```

### 2. Генерация кода

```
> Напиши API-эндпоинт для регистрации пользователя
> Добавь модульные тесты для класса UserService
> Создай компонент формы входа на React
```

### 3. Редактирование существующего кода

```
> Отрефактори utils.js для улучшения читаемости
> Исправь утечку памяти в функции handleSubmit
> Добавь типы TypeScript для всех публичных функций
```

### 4. Отладка

```
> Почему после входа пользователя происходит редирект на 404?
> Проанализируй эту ошибку: TypeError: Cannot read property 'id' of undefined
> Проверь причину медленного ответа API
```

### 5. Операции с Git

```
> Покажи, какие файлы я изменил
> Помоги закоммитить эти изменения с хорошим commit message
> Создай описание для PR
```

## Ссылки на файлы через @

Используйте символ `@` для точного указания файлов, чтобы Claude напрямую прочитал их содержимое:

```
> Посмотри @src/components/Header.tsx и оптимизируй производительность
> Сравни @src/v1/api.js и @src/v2/api.js
> Проанализируй зависимости проекта на основе @package.json
```

**Совет**: после ввода `@` нажмите `Tab` для автодополнения пути к файлу.

## Конвейерный ввод

Можно передать вывод других команд в Claude Code для анализа:

```bash
# Объяснение изменений в git
git diff | claude "Объясни эти изменения в коде"

# Анализ ошибок в логах
cat error.log | claude "Проанализируй эти ошибки и предложи решения"

# Ревью изменений PR
gh pr diff 123 | claude "Проведи ревью качества кода этого PR"
```

## Основные слэш-команды

В сессии используйте команды, начинающиеся с `/`:

| Команда | Описание |
|---------|----------|
| `/help` | Показать справку и все доступные команды |
| `/clear` | Очистить историю текущего диалога |
| `/compact` | Сжать историю диалога для экономии токенов |
| `/model` | Просмотр или переключение модели (например, opus, sonnet) |
| `/memory` | Редактирование файла памяти проекта CLAUDE.md |
| `/init` | Автоматическая генерация конфигурации проекта |
| `/commit` | Интеллектуальная генерация и выполнение коммита |
| `/review` | Ревью кода |
| `/cost` | Просмотр стоимости и использования токенов текущей сессии |
| `/doctor` | Диагностика проблем конфигурации |
| `/config` | Открыть настройки |
| `/mcp` | Управление подключениями к MCP-серверам |
| `/loop` | Автономное циклическое выполнение задач |
| `/bug` | Сообщить о проблеме |

## Горячие клавиши

| Сочетание | Функция |
|-----------|---------|
| `Tab` | Автодополнение пути к файлу |
| `Esc` | Прервать текущий вывод |
| `Ctrl+C` | Отменить текущую операцию |
| `Up` / `Down` | Навигация по истории команд |

## Инициализация конфигурации проекта

При первом использовании выполните `/init`, чтобы Claude автоматически проанализировал проект и сгенерировал конфигурацию:

```
> /init
```

Будет создан файл `CLAUDE.md`, содержащий:

- Описание технологического стека и архитектуры проекта

- Часто используемые команды сборки и тестирования

- Стандарты оформления кода

- Специфические соглашения проекта

**Роль CLAUDE.md**: этот файл автоматически читается при каждом запуске Claude Code, что позволяет ИИ лучше понимать контекст вашего проекта.

## Практические примеры

### Пример 1: Добавление новой функциональности

```
> Мне нужно добавить загрузку аватара пользователя с требованиями:
  1. Поддержка форматов JPG/PNG
  2. Ограничение размера файла 2 МБ
  3. Автоматическая обрезка до 200x200 после загрузки
  4. Хранение в S3
```

### Пример 2: Исправление бага

```
> Пользователи сообщают: после нажатия кнопки "Сохранить" страница зависает
> Помоги разобраться с проблемой в @src/pages/EditProfile.tsx
```

### Пример 3: Ревью кода

```
> /review
> Обрати особое внимание на проблемы безопасности и узкие места производительности
```

### Пример 4: Интеллектуальный коммит

```
> /commit
```

Claude автоматически:

1. Проанализирует все изменения

2. Сгенерирует корректный commit message

3. Выполнит коммит

## Советы для эффективной работы

1. **Чёткое описание намерений**: опишите, что именно вы хотите, включая ограничения

2. **Пошаговое выполнение**: разбивайте сложные задачи на мелкие шаги

3. **Своевременное прерывание**: если вывод не соответствует ожиданиям, сразу нажмите `Esc`

4. **Используйте ссылки**: указывайте файлы через `@`, чтобы ИИ не угадывал

5. **Сохраняйте контекст**: в рамках одной сессии Claude помнит предыдущий диалог

## Следующие шаги

Поздравляем, вы освоили основные возможности Claude Code! Далее:

1. Изучите [советы для командной строки](/docs/usage/cli-tips) — 34 практических совета

2. Ознакомьтесь с [советами по рабочему процессу](/docs/usage/workflow-tips) для повышения эффективности разработки

3. Посмотрите [интеграцию с Codex](/docs/ide/codex) для использования другого ИИ-инструмента