Руководство пользователя Claude Code

Полное руководство по CLI-инструменту Claude Code — от установки до мастерства. Начните работу с AI-программированием и повысьте эффективность разработки.

#Учебник Claude Code #CLI-инструмент #AI-кодинг #Руководство по установке

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

Три шага для начала работы с Claude Code

1

Получите API-ключ

Создайте API-ключ в консоли QCode (начинается с cr_); Claude Code использует его для вызова моделей

2

Установите CLI-инструмент

Скачайте и установите инструмент командной строки Claude Code

3

Начните кодить

Настройте переменные окружения и начните путь в AI-программировании

Подробное руководство

1

Установка и настройка

Быстро установить и настроить Claude Code CLI

Скачайте CLI-инструмент Claude Code
Настройте переменные окружения
Укажите ключ API
Проверьте результат установки

Пример установки

# Установка Claude Code через npm
npm install -g @anthropic-ai/claude-code

# Настройка API-эндпоинта (через прокси QCode)
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"

# Настройка API-ключа
export ANTHROPIC_AUTH_TOKEN="cr_ваш-ключ"

# Запуск Claude Code
claude
2

Основы использования

Освоить ключевые функции Claude Code

Команды генерации кода
Команды работы с файлами
Управление контекстом проекта
Работа в интерактивном режиме

Примеры базовых команд

# Запуск Claude Code в директории проекта
cd your-project && claude

# Прямой запрос
claude "explain what this function does"

# Продолжение предыдущей сессии
claude --continue
3

Продвинутые функции

Полноценно использовать мощные возможности Claude Code

Пользовательские шаблоны промптов
Пакетная обработка файлов
Функции рефакторинга кода
Интегрированная среда разработки
4

Устранение неполадок

Решить частые проблемы при использовании

Диагностика проблем с подключением
Управление квотами API
Рекомендации по оптимизации производительности
Разбор кодов ошибок

Продвинутые функции Claude Code

Освойте новейшие возможности для повышения эффективности разработки

Claude Fable 5.1

Anthropic позиционирует его как интеллект следующего поколения для сложных рассуждений и долгих агентных задач; контекст — 1M

Фоновые агенты

Отправляйте фоновые сессии командой claude agents: они работают без подключённого терминала. По официальной документации каждая сессия отдельно расходует квоту подписки claude.ai; agent view пока в статусе research preview

Автоматизация с хуками

Автоматически выполняйте команды по событиям: PreToolUse и PostToolUse покрывают каждый вызов инструмента в агентном цикле

Параллельные субагенты

Делегируйте задачи субагентам: каждый работает в своём контекстном окне, возвращает только сводку, а его запросы учитываются в тех же лимитах использования

Советы и лучшие практики

Советы по повышению эффективности

Используйте файл CLAUDE.md

Опишите соглашения проекта в CLAUDE.md в корне репозитория; если в репозитории есть AGENTS.md, Claude читает его; эти файлы читаются в начале каждой сессии

Используйте хуки

Настройте события хуков: SessionStart и SessionEnd срабатывают один раз за сессию, UserPromptSubmit и Stop — один раз за ход, а PreToolUse и PostToolUse — на каждый вызов инструмента в агентном цикле

Используйте фоновых агентов

Откройте agent view командой claude agents и отправляйте фоновые сессии: каждая продолжает работать без подключённого терминала. По официальной документации каждая сессия отдельно расходует квоту подписки claude.ai

Устранение неполадок

Недействительный API-ключ

Проверьте, что переменная окружения и ключ совпадают: ключ QCode cr_ задаётся в ANTHROPIC_AUTH_TOKEN, и Claude Code отправляет его как Bearer-токен

Тайм-аут подключения

Проверьте сетевое подключение и убедитесь, что ANTHROPIC_BASE_URL равен https://api.qcode.cc/api; из материкового Китая рекомендуется https://asia.qcode.cc/api

Низкое качество кода

Предоставьте более детальные требования, используйте CLAUDE.md для определения спецификаций проекта

Один тариф, три платформы

QCode также поддерживает OpenAI Codex / GPT-5.6

Баланс плана QCode единый для Claude Code и OpenAI Codex CLI — без двойной оплаты.

Начните использовать Claude Code

Зарегистрируйтесь на QCode.cc и включите сервис Claude Code API. Оплата по токенам, цены моделей — на /models. Чтобы Claude Code долго работал на сервере или у команды была своя постоянная среда, подойдут облачные серверы QCode: у каждого выделенный публичный IPv4 и полные права root, поэтому после выдачи выполните curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --lang en и Claude Code установится. Обращения к моделям по-прежнему идут через подключение QCode и ваш ключ QCode, а AI-сервисы и облачные серверы используют один баланс. Начальные цены смотрите в таблице линий на qcode.cc/en/cloud. Панель облачных серверов сейчас доступна на китайском и английском языках.

Не знаете, с чего начать?

Попробовать неделю

Пакет «Малый» — $4: квота $30 на 7 дней

Работаете каждый день

«Стартовый» — $9.00 в месяц, за $1 квоты примерно вдвое дешевле пакета «Средний» ($5 квоты в день)