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.md.
Под капотом Claude Code отправляет запросы в конечную точку API, совместимую с Anthropic. По умолчанию это сервис Anthropic, но вы можете перенаправить его на LLM API от Novita AI с помощью одной переменной окружения. Сравнение цен — в статье стоимость Claude API и подписки.
Установка 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 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 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 |
Задать правила allow, ask и deny для инструментов |
/hooks |
Просмотреть конфигурации хуков |
Рабочий процесс разработки
| Команда | Назначение |
|---|---|
/plan |
Войти в режим планирования перед крупным изменением |
/model |
Переключить активную модель |
/effort |
Изменить уровень усилий рассуждения |
/diff |
Открыть интерактивный просмотрщик изменений |
/code-review [--fix] |
Проверить текущий diff; --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: Review an open GitHub PR for security issues and test coverage gaps.
---
## Instructions
Review the pull request with these priorities:
1. Identify security vulnerabilities.
2. Check test coverage for new code paths.
3. Flag missing error handling at system boundaries.
Это создаст команду /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. Установив его в совместимую с Anthropic конечную точку Novita AI, вы получите доступ к моделям 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 (командная строка):
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 "find any error patterns" --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 направляет трафик в совместимую с Anthropic конечную точку Novita AI.
В чём разница между флагами CLI и слэш-командами?
Флаги CLI задаются при запуске claude из оболочки. Слэш-команды выполняются внутри активного сеанса и изменяют поведение в середине разговора.
Можно ли использовать Claude Code без подписки Claude?
Да. claude auth login --console выполняет вход с оплатой через API-ключ Anthropic Console. Если вы направляете запросы через 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-платформа, которая предоставляет разработчикам простой способ развёртывания AI-моделей через простой API, а также доступные и надёжные GPU-облака для создания и масштабирования.
Рекомендуемые статьи
- Как использовать агентов Claude Code: настройка, инструменты, разрешения и workflow в Sandbox
- Плагины Claude Code: как инструменты MCP расширяют Claude Code внешними возможностями
- Правила Claude Code: как писать CLAUDE.md и управлять контекстом агентного кодинга
- Claude MCP: как настроить серверы MCP в Claude Code и Claude Desktop
- Как использовать DeepSeek V4 Flash в Claude Code через Novita AI
- Как получить доступ к GLM-4.6 в Claude Code: полное руководство по настройке для разработчиков
