Claude Code — это кодовый агент командной строки от Anthropic, который читает вашу кодовую базу, редактирует файлы, запускает команды и подключается к LLM API на бэкенде. Это руководство охватывает установку, флаги, слэш-команды, пользовательские команды и маршрутизацию API-запросов к Novita AI. Для подключения баз данных, браузеров или средств запуска кода используйте отдельное руководство по настройке Claude MCP для настройки CLI и JSON.
Что такое Claude Code?
Claude Code — это инструмент для написания кода на основе агента, доступный в виде CLI, расширения для VS Code, плагина для JetBrains, настольного приложения и веб-интерфейса. Все поверхности используют один и тот же базовый движок: Claude Code подключается к бэкенду LLM API, читает ваш проект и выполняет многошаговые задачи, такие как написание тестов, рефакторинг файлов, создание pull request’ов и управление git.
CLI — это наиболее гибкая поверхность. Он следует соглашениям Unix — вы можете передавать в него логи, запускать в CI с флагом -p или объединять с другими инструментами. Конфигурация хранится в файлах (CLAUDE.md, .claude/settings.json, переменные окружения), поэтому она ведет себя предсказуемо в автоматизированных контекстах.
Под капотом Claude Code отправляет каждый запрос на API-эндпоинт, совместимый с Anthropic. По умолчанию это api.anthropic.com, но вы можете перенаправить его на любого провайдера, совместимого с Anthropic — включая Novita AI — с помощью одной переменной окружения.
Настройка Claude Code
Установка
Рекомендуемый метод на macOS, Linux и WSL — нативный установщик:
curl -fsSL https://claude.ai/install.sh | bash
В Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Нативные установки автоматически обновляются в фоновом режиме.
Если вы предпочитаете npm, требуется Node.js 18 или выше:
node --version # должно быть 18 или выше
npm install -g @anthropic-ai/claude-code
Homebrew (macOS) отслеживает стабильный канал релизов:
brew install --cask claude-code
Homebrew не обновляется автоматически. Запустите brew upgrade claude-code, когда захотите получить последнюю версию.
Первый запуск
Перейдите в каталог проекта и запустите интерактивный сеанс:
cd your-project
claude
При первом использовании Claude Code предложит вам войти в систему. После аутентификации он прочитает ваш проект и будет ожидать инструкций.
Настройка проекта
Запустите /init в любом новом репозитории, чтобы сгенерировать начальный файл CLAUDE.md. Claude Code читает CLAUDE.md в начале каждого сеанса, поэтому это правильное место для стандартов кодирования, предпочитаемых библиотек, заметок по архитектуре и контрольных списков проверки.
/init
После /init используйте /memory для редактирования файла или включения авто-памяти, которая сохраняет наблюдения, сделанные Claude о вашем проекте между сеансами.
Справочник команд CLI
Команды оболочки верхнего уровня Claude Code запускают сеансы, управляют аутентификацией и обрабатывают фоновую работу. Частичный список наиболее полезных:
| Команда | Описание |
|---|---|
claude |
Запустить интерактивный сеанс в текущем каталоге |
claude "запрос" |
Запустить сеанс с начальным запросом |
claude -p "запрос" |
Выполнить запрос и выйти (неинтерактивный / SDK режим) |
cat file | claude -p "запрос" |
Передать содержимое в запрос |
claude -c |
Продолжить последний сеанс в текущем каталоге |
claude -r "имя" "запрос" |
Возобновить сеанс по имени или ID |
claude update |
Обновить до последней версии |
claude install stable |
Установить или переустановить конкретную версию |
claude auth login |
Войти в свою учетную запись Anthropic |
claude auth login --console |
Войти с оплатой через API-ключ вместо подписки |
claude auth status |
Показать статус аутентификации |
claude agents --json |
Открыть представление агентов, вывести активные сеансы в формате JSON |
claude mcp |
Настроить серверы MCP |
claude daemon status |
Проверить состояние супервизора фоновых сеансов |
Если вы ошиблись в подкоманде, Claude Code предлагает ближайшее совпадение: claude udpate выводит Did you mean claude update?.
Справочник флагов CLI
Флаги изменяют поведение Claude Code для сеанса. Передавайте их после claude при любом вызове. Подборка наиболее часто используемых флагов:
| Флаг | Что делает |
|---|---|
-p, --print |
Неинтерактивный режим; вывести ответ и выйти |
-c, --continue |
Загрузить последний разговор |
-r, --resume |
Возобновить сеанс по ID или имени |
--model |
Установить модель для этого сеанса (sonnet, opus, haiku или полный ID модели) |
--permission-mode |
Запустить в режиме разрешений: default, plan, auto, acceptEdits, bypassPermissions |
--add-dir |
Предоставить доступ к файлам в дополнительном каталоге |
--system-prompt |
Полностью заменить системный промпт |
--append-system-prompt |
Добавить к системному промпту по умолчанию |
--max-turns |
Ограничить количество агентских шагов в режиме -p |
--max-budget-usd |
Ограничить расходы на API в режиме -p |
--output-format |
Формат вывода для режима -p: text, json, stream-json |
--bg |
Запустить как фоновый агент, вернуться немедленно |
--worktree, -w |
Запустить в изолированном git worktree |
--bare |
Пропустить автообнаружение хуков, навыков, плагинов, MCP для ускорения скриптовых вызовов |
--verbose |
Показать полный пошаговый вывод |
--mcp-config |
Загрузить серверы MCP из JSON-файла |
--effort |
Установить уровень рассуждений: low, medium, high, xhigh, max |
Комбинация --print + --output-format json — это стандартный шаблон для написания скриптов. Для конвейеров CI с ограничениями бюджета комбинируйте его с --max-budget-usd и --max-turns.
Документация слэш-команд
Слэш-команды выполняются внутри активного сеанса. Введите /, чтобы увидеть все доступные, или / с последующими буквами для фильтрации. Команды работают только в начале сообщения.
Управление сеансом и контекстом
| Команда | Назначение |
|---|---|
/clear |
Начать новый разговор; предыдущий сеанс остается доступным для /resume |
/compact |
Суммировать разговор, чтобы освободить место в контекстном окне |
/context |
Визуализировать использование контекста и увидеть предложения по оптимизации |
/resume |
Открыть предыдущий сеанс по имени или из списка выбора |
/branch |
Разветвить разговор, чтобы попробовать другое направление |
/rewind |
Откатить код и разговор до контрольной точки |
Настройка проекта
| Команда | Назначение |
|---|---|
/init |
Сгенерировать начальный CLAUDE.md для проекта |
/memory |
Редактировать файлы CLAUDE.md и управлять авто-памятью |
/mcp |
Управлять подключениями серверов MCP в интерактивном режиме |
/agents |
Настроить параметры субагентов |
/permissions |
Установить правила разрешить, спросить и запретить для инструментов |
/hooks |
Просмотреть конфигурации хуков |
Рабочий процесс разработки
| Команда | Назначение |
|---|---|
/plan |
Войти в режим планирования перед крупным изменением |
/model |
Переключить активную модель |
/effort |
Настроить уровень усилий при рассуждениях |
/diff |
Открыть интерактивный просмотрщик изменений |
/code-review [--fix] |
Просмотреть текущий diff; --fix применяет находки |
/security-review |
Глубокая проверка безопасности ожидающих изменений |
/batch <инструкция> |
Разбить крупное изменение на части и выполнить их в параллельных worktree |
/background |
Открепить сеанс для выполнения в качестве фонового агента |
Утилиты
| Команда | Назначение |
|---|---|
/help |
Показать доступные команды |
/doctor |
Диагностика проблем с установкой и настройками |
/usage |
Показать стоимость сеанса и использование плана |
/export |
Экспортировать разговор в виде обычного текста |
/config |
Открыть настройки или установить значение напрямую: /config thinking=false |
/skills |
Список доступных навыков |
Пользовательские слэш-команды
Пользовательские слэш-команды — теперь называемые навыками (skills) — позволяют упаковывать повторяемые процедуры, которыми может делиться ваша команда.
Как создать пользовательскую команду
Создайте каталог в .claude/skills/ (на уровне проекта) или ~/.claude/skills/ (личные, доступны во всех проектах):
mkdir -p .claude/skills/review-pr
Создайте файл SKILL.md внутри этого каталога:
---
description: Review an open GitHub PR for security issues and test coverage gaps. Use when the user asks to review a PR or check pull request quality.
---
## Instructions
Review the pull request with these priorities:
1. Identify any security vulnerabilities: injection risks, auth gaps, data exposure.
2. Check test coverage for new code paths.
3. Flag any missing error handling at system boundaries.
Summarize findings in three sections: Security, Coverage, Other. Use ✓ for passing checks and ⚠ for issues.
Это создает команду /review-pr, которую можно вызывать напрямую:
/review-pr
Claude также автоматически загружает навык, когда вы задаете вопрос, соответствующий описанию.
Расположение навыков и приоритет
Навыки следуют порядку приоритета: корпоративные переопределяют личные, личные переопределяют проектные. Проектные навыки находятся в .claude/skills/. Личные навыки (доступны во всех ваших проектах) находятся в ~/.claude/skills/.
~/.claude/skills/ → личные, все проекты
.claude/skills/ → только этот проект
Пользовательские команды в .claude/commands/ по-прежнему работают. Файл .claude/commands/deploy.md и навык .claude/skills/deploy/SKILL.md оба создают /deploy и ведут себя одинаково.
Динамическая вставка контекста
Навыки могут вставлять актуальные данные до того, как Claude увидит промпт. Префикс ! запускает команду оболочки и встраивает её вывод:
---
description: Summarize uncommitted changes and flag risks.
---
## Current diff
!`git diff HEAD`
## Instructions
Summarize the changes in bullet points. Flag any risks: missing error handling, hardcoded values, untested paths.
Когда вы запускаете этот навык, Claude Code выполняет git diff HEAD и заменяет эту строку реальным выводом diff. Claude видит истинное состояние рабочего дерева, а не запрашивает его через вызовы инструментов.
Использование Novita AI в качестве бэкенда LLM
Claude Code маршрутизирует весь трафик API через переменную окружения ANTHROPIC_BASE_URL. Установка её на совместимый с Anthropic эндпоинт Novita AI дает вам доступ к широкому спектру моделей — включая DeepSeek, Kimi, Qwen и GLM — по значительно более низкой стоимости за токен, чем на эндпоинте Anthropic по умолчанию.
Получите свой API-ключ Novita AI
Зарегистрируйте учетную запись Novita AI, чтобы получить бесплатные пробные кредиты. Перейдите на страницу Управление ключами, нажмите Create New Key и сразу скопируйте ключ.
Установите переменные окружения
На Mac и Linux:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Ваш API-ключ Novita>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
В Windows (Командная строка):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Ваш API-ключ Novita>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash
Чтобы сделать их постоянными на Mac/Linux, добавьте строки export в ~/.bashrc или ~/.zshrc.
ANTHROPIC_SMALL_FAST_MODEL управляет легковесной моделью, которую Claude Code использует для быстрых внутренних задач, таких как поиск файлов и краткие сводки. Установка того же ID модели оставляет весь трафик на одном платежном аккаунте.
Запустите Claude Code
После установки переменных окружения запустите Claude Code обычным образом:
cd your-project
claude
Claude Code подключается к эндпоинту Novita AI с указанной вами моделью. Интерактивный сеанс работает идентично — все флаги CLI, слэш-команды и пользовательские навыки ведут себя одинаково независимо от используемого бэкенда.
Для скриптов и CI применяется тот же подход:
cat logs.txt | claude -p "find any error patterns" --output-format json
LLM API Novita AI поддерживает полный формат сообщений Anthropic, включая использование инструментов, структурированные выводы и потоковую передачу, поэтому каждая функция Claude Code работает без изменений.
Agent Sandbox для изолированного выполнения
Если вы создаете автоматизированные конвейеры на основе Claude Code, Agent Sandbox Novita AI предоставляет изолированные среды выполнения на базе firecracker для программного запуска агентов. Это актуально для рабочих процессов CI, фоновых агентов и любых мультиагентных настроек, где требуется изоляция выполнения, а не запуск непосредственно на вашей машине разработчика.
Claude Code как инструмент IDE
Claude Code интегрируется непосредственно с редакторами, и именно это имеют в виду, когда говорят “claude code is an ide” — это не самостоятельная IDE, а кодовый агент, встраиваемый в вашу существующую среду.
VS Code и Cursor
Установите расширение Claude Code из Marketplace VS Code (поищите “Claude Code”) или из маркетплейса Cursor. После установки откройте палитру команд (Cmd+Shift+P / Ctrl+Shift+P), введите “Claude Code” и выберите Open in New Tab.
Интеграция с VS Code добавляет встроенный просмотр изменений, упоминания @-файлов, проверку плана перед редактированием и историю разговоров непосредственно на панели редактора. Вы также можете использовать Claude Code во встроенном терминале вместе с расширением.
JetBrains
Установите плагин Claude Code из JetBrains Marketplace и перезапустите IDE. Плагин требует отдельной установки CLI. Он обеспечивает интерактивный просмотр изменений и общий контекст выделения в IntelliJ IDEA, PyCharm, WebStorm и других IDE JetBrains.
Настольное приложение и веб-интерфейс
Настольное приложение Claude Code (macOS и Windows) позволяет просматривать изменения визуально, запускать несколько сеансов рядом и планировать повторяющиеся задачи. Веб-интерфейс на claude.ai/code запускает сеансы в браузере без локальной настройки, что полезно для репозиториев, которых у вас нет локально, или для запуска длительных задач, которые можно отслеживать удаленно.
Часто задаваемые вопросы
Что такое ANTHROPIC_BASE_URL и почему это важно?
ANTHROPIC_BASE_URL указывает Claude Code, на какой API-эндпоинт отправлять запросы. По умолчанию это api.anthropic.com. Установка его на https://api.novita.ai/anthropic направляет весь трафик на совместимый с Anthropic эндпоинт Novita AI, где вы можете использовать альтернативные модели по другим ценам. Никаких изменений кода или плагинов не требуется — только переменная окружения.
В чем разница между флагами CLI и слэш-командами?
Флаги CLI (например, --model, --permission-mode, --max-turns) устанавливаются при запуске бинарного файла claude из оболочки. Они настраивают сеанс до его начала. Слэш-команды (например, /model, /plan, /compact) выполняются внутри активного сеанса и изменяют поведение по ходу разговора.
Могу ли я использовать Claude Code без подписки Claude?
Да. claude auth login --console выполняет вход с оплатой через API-ключ Anthropic Console, которая использует оплату за токен вместо подписки. Если вы направляете трафик на Novita AI через ANTHROPIC_BASE_URL, вам нужна только учетная запись Novita AI — ваша учетная запись Anthropic не тарифицируется.
Чем пользовательские слэш-команды отличаются от CLAUDE.md?
Содержимое CLAUDE.md загружается в начале каждого сеанса и остается в контексте на протяжении всего сеанса. Навыки (пользовательские команды) загружаются только при вызове, поэтому длинный справочный материал не добавляет затрат на токены, пока он не понадобится. Используйте CLAUDE.md для фактов о проекте, которые Claude должен всегда знать — стандарты кодирования, команды сборки, заметки по архитектуре. Используйте навыки для процедур, которые вы запускаете по требованию — контрольные списки проверки PR, шаги развертывания, рабочие процессы генерации тестов.
Работает ли Claude Code в CI?
Да. Используйте claude -p "запрос" --output-format json для неинтерактивного режима со структурированным выводом. Добавьте --max-budget-usd для ограничения расходов и --max-turns для ограничения времени выполнения. Флаг --bare пропускает автообнаружение хуков, навыков и плагинов для более быстрого запуска в скриптовых контекстах. Claude Code также интегрируется с GitHub Actions и GitLab CI/CD через официальные шаблоны рабочих процессов.
Novita AI — это облачная платформа ИИ, которая предлагает разработчикам простой способ развертывания моделей ИИ с помощью нашего простого API, а также предоставляет доступные и надежные GPU-облака для создания и масштабирования.
