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

Освойте основные возможности Claude Code за 5 минут

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

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

Ещё нет ключа? Сначала выберите вариант и получите ключ: ключ используется одинаково при любом варианте, поэтому шаги ниже не меняются.

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

Запуск Claude Code¶

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

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 для анализа:

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

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

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

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

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

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

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

При первом использовании выполните /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: Интеллектуальный коммит¶

> Закоммить эти изменения и напиши хорошее сообщение коммита

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

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

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

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

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

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

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

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

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

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

Ключевые параметры¶

Для быстрого старта достаточно запомнить четыре места, остальное смотрите по мере необходимости:

Полный список переменных — в разделе Переменные окружения, настройка в одну команду — в Скрипте быстрой настройки.

Управление сессиями: несколько официальных команд¶

По состоянию на 2026-10-15, согласно документации Claude Code:

• /usage показывает стоимость и расход токенов сессии, /cost — его псевдоним;
• claude --continue продолжает последнюю сессию в текущем каталоге, claude --resume показывает список сессий для выбора, а внутри сессии работает /resume;
• чтобы сначала посмотреть план и не давать правок файлов, нажимайте Shift+Tab для переключения режимов разрешений; когда в строке состояния появится ⏸ plan mode on, включён режим плана и правок не будет, пока вы не одобрите план.

Частые ошибки и диагностика¶

Если непонятно, на каком уровне сбой, выполните тест curl из раздела 5 страницы Эндпоинты и форматы API: ответ 400 или 401 означает, что путь доступен.

Часто задаваемые вопросы¶

Как убедиться, что запросы действительно идут через QCode?¶

Введите свой API Key на probe.qcode.cc — там видны модель и токены последних запросов. Если ничего нет, запросы не дошли до QCode; перепроверьте переменные окружения.

Где посмотреть, сколько стоила сессия?¶

Внутри сессии /usage (или /cost) показывает расход текущей сессии. Расход по аккаунту — в консоли QCode. QCode тарифицирует по токенам, цены по моделям указаны на qcode.cc/models.

Можно ли продолжить вчерашний диалог после закрытия терминала?¶

Да. В том же каталоге проекта выполните claude --continue, чтобы вернуться к последней сессии, или claude --resume, чтобы выбрать из списка.

Какую модель выбрать для начала?¶

Для повседневного кода берите claude-sonnet-5, а для сложных задач переключайтесь командой /model на более сильную; сравнение — в Выборе модели.

Что делать, если нужны GPT или китайские модели?¶

Сам Claude Code работает через интерфейс Anthropic, поэтому китайские модели можно выбирать сразу. Для GPT используйте Codex CLI; настройка описана в полном руководстве по Codex.

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

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

1. Изучите советы для командной строки — 34 практических совета

2. Ознакомьтесь с советами по рабочему процессу для повышения эффективности разработки

3. Посмотрите интеграцию с Codex для использования другого ИИ-инструмента

Enterprise →