Claude Code CLI: Повний технічний довідник
Оновлено 12 грудня 2025 року
Оновлення за грудень 2025: Claude Code тепер забезпечує корпоративні інженерні робочі процеси з агентним багатофайловим редагуванням, інтеграцією протоколу MCP з понад 300 зовнішніми сервісами, спеціалізованими субагентами для складних завдань та системою хуків для автоматизації CI/CD. Система дозволів забезпечує детальний контроль безпеки. Перемикання між моделями Haiku (швидка/дешева) та Opus (потужна) оптимізує співвідношення вартості та продуктивності.
Я провів місяці, тестуючи Claude Code на межі можливостей у продакшн-кодових базах, CI/CD конвеєрах та корпоративних розгортаннях. Цей посібник узагальнює цей досвід у вичерпний довідник, який я хотів би мати, коли починав. Він охоплює все — від першого встановлення до просунутих патернів, які більшість користувачів ніколи не відкривають.
Claude Code — це не чат-інтерфейс, який випадково знає про програмування. Це агентна система, яка читає вашу кодову базу, виконує команди, модифікує файли, керує git-робочими процесами, підключається до зовнішніх сервісів та делегує складні завдання спеціалізованим субагентам — все через інтерфейс командного рядка, який інтегрується у реальний робочий процес розробників.
Різниця між випадковим та ефективним використанням Claude Code полягає в розумінні його архітектури: ієрархії конфігурацій, що контролює поведінку, системи дозволів, що регулює операції, системи хуків, що забезпечує детерміністичну автоматизацію, протоколу MCP, що розширює можливості, та системи субагентів, що обробляє складні багатокрокові завдання. Опануйте ці системи — і Claude Code стане мультиплікатором сили. Пропустіть їх — і ви втратите більшу частину цінності.
Цей посібник припускає, що ви комфортно працюєте з інструментами командного рядка і хочете отримати повну картину. Кожна функція задокументована з реальним синтаксисом, справжніми прикладами конфігурацій та граничними випадками, які спотикають досвідчених користувачів. Незалежно від того, чи налаштовуєте ви свій перший проект, чи розгортаєте систему для всієї інженерної організації підприємства — інформація тут.
Як працює Claude Code: Ментальна модель
Перш ніж занурюватися у функції, зрозумійте, як архітектура Claude Code формує все, що ви з ним робите. Система працює у трьох шарах:
┌─────────────────────────────────────────────────────────┐
│ ШАРИ CLAUDE CODE │
├─────────────────────────────────────────────────────────┤
│ ШАР РОЗШИРЕНЬ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ MCP │ │ Хуки │ │ Навички │ │ Плагіни │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ Зовнішні інструменти, детерміністична автоматизація, │
│ доменна експертиза, упаковані розширення │
├─────────────────────────────────────────────────────────┤
│ ШАР ДЕЛЕГУВАННЯ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Субагенти (до 10 паралельно) │ │
│ │ Explore | Plan | General-purpose | Custom │ │
│ └─────────────────────────────────────────────────┘ │
│ Ізольовані контексти для фокусованої роботи, │
│ повертають підсумки │
├─────────────────────────────────────────────────────────┤
│ БАЗОВИЙ ШАР │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Основний контекст розмови │ │
│ │ Інструменти: Read, Edit, Bash, Glob, Grep тощо│ │
│ └─────────────────────────────────────────────────┘ │
│ Ваша основна взаємодія; обмежений контекст; коштує │
└─────────────────────────────────────────────────────────┘
Базовий шар: Ваша основна розмова. Кожне повідомлення, читання файлу та вивід інструменту споживає контекст із спільного вікна у 200K токенів (1M з преміум-підпискою). Коли контекст заповнюється, Claude втрачає відстеження попередніх рішень і якість погіршується. Цей шар коштує грошей за токен.
Шар делегування: Субагенти запускаються з чистими контекстами, виконують фокусовану роботу та повертають підсумки. Результати дослідження не роздувають вашу основну розмову — повертаються лише висновки. Використовуйте субагенти Haiku для дослідження (дешево, швидко) та Sonnet для імплементації.
Шар розширень: MCP підключає зовнішні сервіси (бази даних, GitHub, Sentry). Хуки гарантують виконання shell-команд незалежно від поведінки моделі. Навички кодують доменну експертизу, яку Claude застосовує автоматично. Плагіни пакують все це для розповсюдження.
Ключовий інсайт: Більшість користувачів працюють виключно в базовому шарі, спостерігаючи, як роздувається контекст і зростають витрати. Досвідчені користувачі переносять дослідження та спеціалізовану роботу на шар делегування, тримають шар розширень налаштованим під свій робочий процес і використовують базовий шар лише для оркестрації та фінальних рішень.
Зміст
- Встановлення та автентифікація
- Основні режими взаємодії
- Глибоке занурення в систему конфігурації
- Вибір та перемикання моделей
- Система дозволів та безпека
- Система хуків
- MCP (Model Context Protocol)
- Субагенти та делегування завдань
- Режим розширеного мислення
- Стилі виводу
- Слеш-команди
- Навички
- Система плагінів
- Управління пам'яттю та контекстом
- Зображення та мультимодальний ввід
- Інтеграція з Git та робочі процеси
- Інтеграція з IDE
- Просунуті патерни використання
- Claude Code Remote
- Фонові агенти (грудень 2025)
- Управління витратами та білінг
- Оптимізація продуктивності
- Усунення несправностей та налагодження
- Корпоративне розгортання
- Довідник клавіатурних скорочень
- Найкращі практики
Встановлення та автентифікація
Системні вимоги
Claude Code працює на macOS 10.15+, Ubuntu 20.04+/Debian 10+ та Windows 10+ через WSL або Git Bash. Система вимагає мінімум 4 ГБ оперативної пам'яті та активне інтернет-з'єднання. Сумісність оболонок найкраще працює з Bash, Zsh або Fish.
Для Windows працюють як WSL 1, так і WSL 2. Git Bash також працює, якщо ви віддаєте перевагу нативній Windows. Alpine Linux та інші системи на базі musl вимагають додаткових пакетів:
apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0
Методи встановлення
Нативне встановлення (рекомендовано)
Нативний бінарний файл забезпечує найчистіший досвід без залежності від Node.js:
# macOS та Linux
curl -fsSL https://claude.ai/install.sh | bash
# Альтернатива через Homebrew
brew install --cask claude-code
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Для встановлення конкретної версії:
# Встановити конкретну версію
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
# Явно встановити останню версію
curl -fsSL https://claude.ai/install.sh | bash -s latest
# Windows PowerShell - конкретна версія
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
Встановлення через NPM
Для середовищ, де npm є переважним:
npm install -g @anthropic-ai/claude-code
Ніколи не використовуйте sudo при встановленні через npm — це створює проблеми з дозволами, які все ускладнюють надалі.
Міграція з існуючого встановлення
Якщо у вас є старіше встановлення на базі npm, мігруйте на нативний бінарник:
claude install
Опції автентифікації
Claude Code підтримує три шляхи автентифікації, кожен з різними компромісами:
Claude Console (білінг API)
Підключіться до API Anthropic напряму через console.anthropic.com. Створіть обліковий запис, налаштуйте білінг та автентифікуйтесь через CLI. Це забезпечує білінг на основі використання з повним доступом до API. Окремий робочий простір "Claude Code" створюється автоматично — ви не можете створювати API-ключі для цього робочого простору, але можете відстежувати використання.
Підписка Claude Pro або Max
Використовуйте облікові дані свого акаунта claude.ai. Підписка покриває як веб-інтерфейс, так і використання CLI за єдиним місячним планом. Це спрощує білінг для індивідуальних користувачів, які хочуть передбачуваних витрат.
Корпоративні платформи
AWS Bedrock, Google Vertex AI та Microsoft Foundry забезпечують доступ корпоративного рівня з існуючими відносинами білінгу з хмарними провайдерами:
# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile
# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project
# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# Опціонально: автентифікація через API-ключ (інакше використовується Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key
Для корпоративних розгортань за проксі або через LLM-шлюзи:
# Корпоративний проксі
export HTTPS_PROXY='https://proxy.example.com:8080'
# LLM-шлюз (пропустити нативну автентифікацію)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
Перевірка
claude doctor
Це повідомляє тип встановлення, версію, конфігурацію системи та будь-які виявлені проблеми.
Оновлення
Claude Code автоматично оновлюється за замовчуванням, перевіряючи при запуску та періодично під час сеансів. Оновлення завантажуються у фоновому режимі та застосовуються при наступному запуску.
Вимкнути автооновлення:
export DISABLE_AUTOUPDATER=1
Або в settings.json:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
Ручне оновлення:
claude update
Видалення
Нативне встановлення (macOS/Linux/WSL):
rm -f ~/.local/bin/claude
rm -rf ~/.claude-code
Нативне встановлення (Windows PowerShell):
Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force
Очистка конфігурації (видаляє всі налаштування):
rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json
Основні режими взаємодії
Інтерактивний REPL
Запустіть Claude Code без аргументів, щоб увійти в інтерактивний цикл читання-виконання-виводу:
cd your-project
claude
REPL зберігає контекст розмови між запитами. Введіть запити напряму, отримайте відповіді та продовжуйте, поки не вийдете через /exit або Ctrl+D.
Почніть з початкового запиту, щоб сфокусувати сеанс:
claude "поясни потік автентифікації в цьому проекті"
Порада експерта: REPL зберігає стан між подіями компактування. Коли контекст стає занадто великим, Claude автоматично підсумовує старішу розмову, зберігаючи ключові рішення та фрагменти коду. Ви можете запустити це вручну через /compact або додати власні інструкції щодо того, що зберігати.
Неінтерактивний режим
Режим друку (-p) виконує один запит і завершується:
# Прямий запит
claude -p "перерахуй всі коментарі TODO в цьому проекті"
# Обробка переданого вводу
cat error.log | claude -p "визнач кореневу причину цих помилок"
# Ланцюг з іншими інструментами
claude -p "згенеруй README" > README.md
Для структурованого виводу, придатного для парсингу в скриптах:
claude -p "підрахуй рядки за типом файлу" --output-format json
JSON-вивід включає все необхідне для автоматизації:
{
"type": "result",
"subtype": "success",
"total_cost_usd": 0.0034,
"is_error": false,
"duration_ms": 2847,
"duration_api_ms": 1923,
"num_turns": 4,
"result": "Текст відповіді тут...",
"session_id": "abc-123-d
[Контент скорочено для перекладу]
