21 августа 2026 г.
Claude Code: CLI и API - руководство для разработчика
Claude Code - это агент Anthropic, который живёт прямо в терминале: читает твой проект целиком, пишет и правит код, запускает команды и ведёт git. Ставится одной строкой через официальный установщик, а работает либо по подписке Claude Pro/Max, либо по API-ключу с оплатой за токены. Ниже - весь путь от установки до первых команд и работы через Anthropic API.
Это не плагин к редактору и не чат в браузере. Claude Code CLI запускается в консоли, видит файлы рабочей директории и действует сам: ищет причину бага, вносит правку, прогоняет тесты. Дальше по шагам - как поставить, чем авторизоваться и какие команды нужны в первый день.
Что такое Claude Code
Обычный чат с моделью не видит твой код и ничего не может сделать руками - ты копируешь куски туда-обратно. Claude Code снимает этот разрыв: он работает в терминале внутри проекта, читает и меняет файлы, выполняет команды оболочки и коммитит через git по твоей команде на естественном языке.
По сути это агент, а не автодополнение. Ему можно сказать «разберись, почему падает этот тест, и почини» - и он сам прочитает нужные файлы, найдёт причину, внесёт правку и покажет дифф на подтверждение. Работает на моделях семейства Claude, которые заточены под длинные агентные сессии с кодом.
Установка Claude Code
Официальный и рекомендованный способ - нативный установщик, одна строка в терминале. Для macOS, Linux и WSL:
- macOS / Linux / WSL:
curl -fsSL https://claude.ai/install.sh | bash - macOS через Homebrew:
brew install --cask claude-code - npm (устаревший путь):
npm install -g @anthropic-ai/claude-code, нужен Node.js 18 или новее.
После установки проверь, что всё встало: claude --version. Для Windows подойдёт нативный установщик или запуск через WSL - так меньше проблем с путями и правами.
Авторизация: подписка или API-ключ
При первом запуске команда claude попросит войти. Есть два пути, и это ключевая развилка по деньгам.
Первый - подписка. Claude Pro за 20 долларов в месяц или Claude Max за 100-200 подключаются через /login: открывается браузер, подтверждаешь вход, и лимиты списываются с подписки. Для ежедневного кодинга это почти всегда выгоднее поштучной оплаты.
Второй - API-ключ. Заводишь ключ в консоли Anthropic (console.anthropic.com, раздел API Keys), кладёшь его в переменную окружения ANTHROPIC_API_KEY, и Claude Code считает токены по тарифам API с оплатой по факту. Это путь для автоматизации, серверов и запусков в CI, где нет интерактивного входа.
Базовые команды в терминале
Самое важное на старте - несколько команд запуска и слэш-команды внутри сессии.
claude- запустить интерактивную сессию в текущей папке.claude "почини баг в auth.py"- сразу с задачей.claude -p "составь changelog по последним коммитам"- режим печати без интерактива, для скриптов.claude -c- продолжить прошлый разговор.claude update- обновить до свежей версии.
Внутри сессии работают слэш-команды: /init соберёт файл с описанием проекта, /model переключит модель, /mcp покажет подключённые серверы, /clear очистит контекст, /help выведет всё остальное. Полный список всегда под рукой в claude --help.
Модели, цены и лимиты
Claude Code работает на моделях Claude, и выбор модели - это баланс между мощностью и расходом токенов. Переключение - командой /model.
| Модель | ID для API | Вход, $/1М | Выход, $/1М | Когда брать |
|---|---|---|---|---|
| Claude Opus 5 | claude-opus-5 |
5 | 25 | сложная архитектура, тяжёлые задачи |
| Claude Sonnet 5 | claude-sonnet-5 |
3 | 15 | ежедневная работа, лучший баланс |
| Claude Haiku 4.5 | claude-haiku-4-5 |
1 | 5 | быстрые лёгкие правки |
На практике большая часть работы отлично идёт на Sonnet - он быстрее и дольше живёт по лимитам токенов, а на Opus стоит переходить только на действительно сложных задачах вроде проектирования или тонкой интеграции. Если сидишь на подписке, лимиты считаются по её тарифу, а не по цене за токен из таблицы - таблица важна для тех, кто платит через API.
MCP: подключаем внешние сервисы
Claude Code умеет не только код. Через MCP (Model Context Protocol) к нему подключаются внешние инструменты: базы данных, трекеры задач, браузер, свои сервисы. Модель начинает видеть их как доступные команды и дёргать сама.
Добавить сервер можно одной командой вида claude mcp add <имя> -- <команда запуска>, после чего инструмент появляется в сессии. Так Claude Code из редактора кода превращается в агента, который ходит в твою инфраструктуру - читает задачи из трекера, проверяет данные в базе, собирает отчёт.
Claude Code в скриптах и через Anthropic API
Флаг -p превращает Claude Code в кирпичик для автоматизации. claude -p "прогони линтер и опиши, что починил" отработает без интерактива и вернёт результат в стандартный вывод - такое удобно ставить в git-хуки или в шаги CI. С API-ключом в переменной окружения запуск на сервере не требует ручного входа.
Если же ты строишь собственный продукт поверх модели, а не пользуешься готовым CLI, тебе нужен не Claude Code, а прямой Anthropic API - эндпоинт /v1/messages и официальные SDK. Для агентов с файловыми операциями и своими инструментами есть отдельная библиотека Claude Agent SDK: это тот же движок, что под Claude Code, но как пакет для встраивания в свой код. Модели в API адресуются теми же ID из таблицы выше.
Итог
Для повседневного кодинга схема простая: поставь Claude Code нативным установщиком, войди по подписке через /login, работай на Sonnet и переключайся на Opus под сложное. Для автоматизации и серверов - API-ключ в переменной окружения и режим -p. А если делаешь свой продукт - смотри в сторону Anthropic API и Claude Agent SDK.
Claude Code силён именно тем, что живёт в терминале и действует руками, а не советует со стороны. Поставь, дай ему разобраться с одним реальным багом в своём проекте - и дальше уже сам увидишь, где он экономит тебе часы.
