Claude Code — это консольный агент для написания кода от Anthropic, который читает вашу кодовую базу, редактирует файлы, запускает команды и подключается к LLM API в бэкенде. Это руководство охватывает полную документацию CLI: как настроить, какие флаги и слеш-команды доступны, как писать пользовательские слеш-команды и как направлять его API-вызовы к Novita AI вместо стандартного эндпоинта Anthropic.
Что такое Claude Code?
Claude Code — это инструмент для написания кода на основе ИИ-агента, доступный в виде CLI, расширения для VS Code, плагина для JetBrains, настольного приложения и веб-интерфейса. Все поверхности используют один и тот же базовый движок: Claude Code подключается к бэкенду LLM API, читает ваш проект и выполняет многошаговые задачи, такие как написание тестов, рефакторинг в нескольких файлах, создание pull-запросов и управление git.
CLI — самая гибкая поверхность. Он следует Unix-соглашениям — вы можете передавать в него логи, запускать в CI с флагом -p или объединять с другими инструментами. Конфигурация хранится в файлах (CLAUDE.md, .claude/settings.json, переменных окружения), поэтому CLI ведет себя предсказуемо в автоматизированных контекстах.
Под капотом Claude Code отправляет каждый запрос на совместимый с Anthropic API эндпоинт. По умолчанию это 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 выведет Возможно, вы имели в виду 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: Проанализировать открытый GitHub PR на предмет проблем безопасности и пробелов в тестовом покрытии. Используйте, когда пользователь просит проверить PR или оценить качество pull-запроса.
---
## Инструкции
Проанализируйте pull-запрос с этими приоритетами:
1. Выявите любые уязвимости безопасности: риски инъекций, пробелы в аутентификации, утечку данных.
2. Проверьте тестовое покрытие для новых путей кода.
3. Отметьте любую отсутствующую обработку ошибок на границах системы.
Суммируйте результаты в трех разделах: Безопасность, Покрытие, Прочее. Используйте ✓ для пройденных проверок и ⚠ для проблем.
Это создает команду /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 увидит промпт. Префикс ! запускает shell-команду и встраивает ее вывод:
---
description: Суммировать незакоммиченные изменения и отметить риски.
---
## Текущий diff
!`git diff HEAD`
## Инструкции
Суммируйте изменения в виде маркированного списка. Отметьте любые риски: отсутствие обработки ошибок, жестко закодированные значения, непроверенные пути.
Когда вы запускаете этот навык, 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, чтобы получить бесплатные пробные кредиты. Перейдите на страницу Key Management, нажмите 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 (Command Prompt):
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 "найди любые шаблоны ошибок" --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 — это ide” — это не самостоятельная IDE, а агент для кодирования, встраиваемый в вашу существующую среду.
VS Code и Cursor
Установите расширение Claude Code из VS Code Marketplace (найдите “Claude Code”) или из Cursor marketplace. После установки откройте Palette команд (Cmd+Shift+P / Ctrl+Shift+P), введите “Claude Code” и выберите Open in New Tab.
Интеграция с VS Code добавляет встроенное ревью diff, упоминания файлов через @, просмотр плана перед редактированием и историю разговоров непосредственно на панели редактора. Вы также можете использовать Claude Code во встроенном терминале вместе с расширением.
JetBrains
Установите плагин Claude Code из JetBrains Marketplace и перезапустите IDE. Плагин требует отдельной установки CLI. Он предоставляет интерактивный просмотр diff и общий доступ к контексту выделения в IntelliJ IDEA, PyCharm, WebStorm и других IDE JetBrains.
Настольное приложение и веб
Настольное приложение Claude Code (macOS и Windows) позволяет визуально просматривать diff, запускать несколько сессий бок о бок и планировать повторяющиеся задачи. Веб-интерфейс на claude.ai/code запускает сессии в браузере без локальной установки, что полезно для репозиториев, которых у вас нет локально, или для запуска долгих задач, которые можно отслеживать удаленно.
FAQ
Что такое 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 — это облачная AI-платформа, которая предлагает разработчикам простой способ развертывания AI-моделей с помощью нашего простого API, а также предоставляет доступные и надежные GPU-облака для создания и масштабирования.
