Claude Code — это терминальный кодовый агент от Anthropic. Он читает вашу кодовую базу, редактирует файлы, запускает команды и может подключаться к бэкендам, совместимым с Anthropic, вместо использования только API Anthropic по умолчанию. Это руководство охватывает настройку Claude Code CLI, слеш-команды, пользовательские навыки и то, как маршрутизировать запросы через Novita AI.
Если вам нужны базы данных, браузеры или другие внешние инструменты, используйте это вместе с руководством по настройке MCP для Claude.
Основные выводы
- Claude Code — это агент командной строки, а не просто поле для ввода запросов.
/compact,/resume,/permissionsи/model— это сессионные команды, а-pи--resume— флаги CLI.- Пользовательские слеш-команды теперь реализованы как навыки, поэтому имеют значение как
.claude/skills/, так и.claude/commands/. - Novita AI может выступать в качестве бэкенда, совместимого с Anthropic, через
ANTHROPIC_BASE_URL. - Claude Code подходит как для рабочих процессов в стиле IDE, так и для автоматизированных запусков агентов.
Что такое Claude Code?
Claude Code — это агентный инструмент для написания кода от Anthropic. CLI работает в вашем терминале, но тот же агент доступен и в десктопном приложении, браузерном интерфейсе и интеграциях с редакторами.
CLI — это наиболее гибкий интерфейс. Он следует соглашениям Unix, поэтому вы можете перенаправлять в него файлы через конвейер, запускать в неинтерактивном режиме с -p и встраивать в скрипты или CI. Конфигурация хранится в CLAUDE.md, .claude/settings.json и переменных окружения, что делает его отличным выбором для повторяемых рабочих процессов.
Под капотом Claude Code отправляет запросы к конечной точке API, совместимой с Anthropic. По умолчанию это собственный сервис Anthropic, но вы можете перенаправить его на LLM API Novita AI с помощью одной переменной окружения.
Настройка Claude Code
Установка
Установите CLI с помощью Node.js 18 или новее:
npm install -g @anthropic-ai/claude-code
Первый запуск
Запустите Claude Code в директории проекта:
cd your-project
claude
При первом использовании Claude Code предложит вам войти в систему. После аутентификации он прочитает ваш проект и будет ожидать инструкции.
Настройка проекта
Выполните /init в любом новом репозитории, чтобы создать начальный файл CLAUDE.md. Claude Code читает CLAUDE.md в начале каждой сессии, поэтому это подходящее место для стандартов кодирования, предпочитаемых библиотек, заметок об архитектуре и контрольных списков для ревью.
/init
После /init используйте /memory для редактирования файла или включения автоматической памяти, которая сохраняет наблюдения Claude о вашем проекте между сессиями.
Справочник по командам CLI
| Команда | Описание |
|---|---|
claude |
Запустить интерактивную сессию в текущей директории |
claude "запрос" |
Запустить сессию с начальным запросом |
claude -p "запрос" |
Выполнить запрос и выйти |
cat файл | 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 mcp |
Настроить MCP-серверы |
claude doctor |
Показать диагностику установки и настроек |
Справочник по флагам CLI
| Флаг | Назначение |
|---|---|
-p, --print |
Неинтерактивный режим; вывести ответ и выйти |
-c, --continue |
Загрузить последний разговор |
-r, --resume |
Возобновить сессию по ID или имени |
--model |
Установить модель для этой сессии |
--permission-mode |
Запустить в режиме разрешений |
--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 |
Установить уровень усилий при рассуждении |
Комбинация --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] |
Просмотреть текущий дифф; --fix применяет найденные проблемы |
/security-review |
Глубокая проверка безопасности ожидающих изменений |
/batch <инструкция> |
Разбить большое изменение и выполнить его в параллельных worktree |
/background |
Открепить сессию для выполнения в фоновом режиме |
Утилиты
| Команда | Назначение |
|---|---|
/help |
Показать доступные команды |
/doctor |
Диагностировать проблемы установки и настроек |
/usage |
Показать стоимость сессии и использование плана |
/export |
Экспортировать разговор в виде обычного текста |
/config |
Открыть настройки или установить значение напрямую |
/skills |
Список доступных навыков |
Пользовательские слеш-команды
Пользовательские слеш-команды теперь реализованы как навыки. Существующие файлы .claude/commands/ по-прежнему работают, но .claude/skills/ — предпочтительный формат.
Как создать пользовательскую команду
Создайте директорию в .claude/skills/ (на уровне проекта) или ~/.claude/skills/ (личная):
mkdir -p .claude/skills/review-pr
Создайте внутри этой директории файл SKILL.md:
---
description: Проверить открытый PR на GitHub на наличие проблем безопасности и пробелов в тестовом покрытии.
---
## Инструкции
Проверьте пул-реквест с учетом следующих приоритетов:
1. Выявить уязвимости безопасности.
2. Проверить тестовое покрытие новых путей выполнения кода.
3. Отметить отсутствие обработки ошибок на границах системы.
Это создаст команду /review-pr, которую можно вызывать напрямую:
/review-pr
Claude также автоматически загружает навык, когда вы задаёте вопрос, соответствующий описанию.
Расположение навыков и приоритет
~/.claude/skills/ → личные, для всех проектов
.claude/skills/ → только для этого проекта
Пользовательские команды в .claude/commands/ по-прежнему работают. Файл .claude/commands/deploy.md и навык .claude/skills/deploy/SKILL.md оба создают команду /deploy.
Использование Novita AI в качестве LLM-бэкенда
Claude Code маршрутизирует API-трафик через ANTHROPIC_BASE_URL. Установка этого значения на конечную точку Novita AI, совместимую с Anthropic, даёт вам доступ к моделям Novita без изменения рабочего процесса Claude Code.
Получите 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="moonshotai/kimi-k2-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instruct"
На Windows (Command Prompt):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Ваш API-ключ Novita>
set ANTHROPIC_MODEL=moonshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/kimi-k2-instruct
ANTHROPIC_SMALL_FAST_MODEL управляет лёгкой моделью, которую Claude Code использует для быстрых внутренних задач, таких как поиск файлов и быстрые сводки.
Запустите Claude Code
cd your-project
claude
Для написания скриптов и CI применяется тот же подход:
cat logs.txt | claude -p "найди любые шаблоны ошибок" --output-format json
LLM API Novita AI поддерживает формат сообщений Anthropic, включая использование инструментов, структурированные выходные данные и потоковую передачу, поэтому Claude Code работает без изменений.
Agent Sandbox для изолированного выполнения
Если вы создаёте автоматизированные пайплайны на основе Claude Code, Agent Sandbox Novita AI предоставляет изолированное выполнение для запусков агентов, что полезно для CI-рабочих процессов и многошаговых задач по кодингу.
Claude Code как инструмент IDE
Claude Code часто описывают как “IDE”, потому что он встраивается в ваш существующий рабочий процесс, а не заменяет его. Точнее говоря, это уровень агента, который работает с вашим терминалом, редактором и контекстом проекта.
VS Code и Cursor
Установите расширение Claude Code из маркетплейса VS Code или из маркетплейса Cursor. После установки откройте палитру команд, введите “Claude Code” и выберите Open in New Tab.
Интеграция с VS Code добавляет интерактивный просмотр изменений, упоминания файлов, ревью плана перед редактированием и историю разговоров непосредственно на панели редактора. Вы также можете использовать Claude Code во встроенном терминале вместе с расширением.
JetBrains
Установите плагин Claude Code из маркетплейса JetBrains и перезапустите IDE. Он предоставляет интерактивный просмотр изменений и общий доступ к контексту выделения в IntelliJ IDEA, PyCharm, WebStorm и других IDE JetBrains.
Десктопное приложение и веб
Десктопное приложение Claude Code позволяет визуально просматривать изменения и запускать несколько сессий бок о бок. Веб-интерфейс на claude.ai/code запускает сессии в браузере без локальной настройки.
FAQ
Что такое ANTHROPIC_BASE_URL и почему это важно?
ANTHROPIC_BASE_URL указывает Claude Code, какую конечную точку API использовать для отправки запросов. По умолчанию это API Anthropic. Установка значения https://api.novita.ai/anthropic перенаправляет трафик на конечную точку Novita AI, совместимую с Anthropic.
В чем разница между флагами CLI и слеш-командами?
Флаги CLI задаются при запуске claude из оболочки. Слеш-команды выполняются внутри активной сессии и изменяют поведение в середине разговора.
Можно ли использовать Claude Code без подписки Claude?
Да. claude auth login --console выполняет вход с оплатой через API-ключ консоли Anthropic. Если вы перенаправляете трафик на Novita AI через ANTHROPIC_BASE_URL, вам нужен только аккаунт Novita AI.
Чем пользовательские слеш-команды отличаются от CLAUDE.md?
CLAUDE.md загружается в начале каждой сессии и остаётся в контексте. Навыки загружаются только при вызове, поэтому используйте CLAUDE.md для постоянно используемых фактов о проекте, а навыки — для повторяемых процедур.
Работает ли Claude Code в CI?
Да. Используйте claude -p "запрос" --output-format json для неинтерактивного режима. Добавьте --max-budget-usd для ограничения расходов и --max-turns для ограничения времени выполнения.
Novita AI — это облачная платформа искусственного интеллекта, которая предлагает разработчикам простой способ развертывания AI-моделей с помощью нашего простого API, а также предоставляет доступные и надежные GPU-облака для создания и масштабирования.
