* docs: sync to Claude Code v2.1.257 Audit against Claude Code v2.1.257 (repo baseline was v2.1.245, 12 releases behind). Facts verified against the official docs and cross-checked against the locally installed 2.1.257 binary. Critical (P0): - lesson-quiz L06 Q9 asked how many hook events exist, offering 16/25/31/40. With the real answer now 33, no option was correct. Option C 31 -> 33; answer letter unchanged. - 03-skills taught SKILL.md `name`/`description` as required. Official docs now state all frontmatter fields are optional and `name` defaults to the directory name. Corrected in all five languages. Hook events 31 -> 33 (PreModelSwitch/PostModelSwitch, v2.1.251) across 30 occurrences in 22 files, including three that read 25. Delta proved by set-diff against the official event table: no phantom events. Both events added to the 06-hooks tables with matcher, blocking behavior and 30s timeout, plus detailed per-event sections. CLI corrections verified against the binary: - `claude plugin tag` takes a path, not a version - `claude plugin init` / `validate` require their arguments - `plugin init` scaffolds at ~/.claude/skills/<name>/, not project-local - `--channels` entries must be tagged plugin:<name>@<marketplace> - `--remote` is a deprecated alias for `--cloud` - no `claude remote-control` subcommand exists, only the --remote-control flag Also: CATALOG summary-table totals recomputed in all five languages (column 4 is a derived total, so the count change invalidated it); stale Opus 4.6/4.7 rosters aligned to canonical; self-assessment Advanced Features rescored 0-3 to stop a real gap being graded as mastery; 9 dangling quiz Review pointers repaired; new features documented (--restricted, Fable 5.1, experimental.cacheTtl, CLAUDE_CODE_SUBAGENT_MODEL_FORCE). Deliberately out of scope: pre-existing translation staleness whose fix is translation authorship rather than correction (ja/uk April-2026 root-doc bodies, zh stubs, vi/README stub, translated CATALOG "New Features"). Claude-Session: https://claude.ai/code/session_01128xfEd8W7c2cMRw6N7uiF * fix(hooks): complete the 31 → 33 hook-event propagation across all languages The v2.1.257 sync bumped the hook-event count in the lesson and catalog summaries but left 14 files still asserting 31, four of which the same commit restamped 2.1.257. It also bumped the prose count in claude_concepts_guide.md without adding the two rows, making that file contradict itself where it had been internally consistent before. Adds PreModelSwitch and PostModelSwitch (v2.1.251) everywhere an exhaustive enumeration exists, and corrects the count wherever a list is deliberately partial: - README.md / INDEX.md in en, ja, zh, uk and vi/INDEX.md — count 31 → 33 and both events added to the lifecycle group - resources.md in all five languages — count only; these lists end in "and more" and are partial by design - claude_concepts_guide.md — the two missing table rows Also brings every hook-event table up to the 33 its own summary row claims. The English CATALOG.md listed 29; the translated catalogs listed 25 and the ja/uk concept guides 27 and 28. Completing them required translating six events that had never reached the mirrors: Setup, UserPromptExpansion, PermissionDenied, PostToolBatch, MessageDisplay and DirectoryAdded. Summary-table arithmetic is untouched — those columns count example scripts, not events. Verified: no stale count survives outside CHANGELOG history, every exhaustive enumeration lists exactly 33, and pre-commit passes 23/23. Claude-Session: https://claude.ai/code/session_01UXmqJZNk1BR4uerJA85NiW
40 KiB
Довідник CLI
Огляд
Claude Code CLI (інтерфейс командного рядка — основний інструмент для роботи з терміналом) — це головний спосіб взаємодії з Claude Code. Він надає потужні опції для виконання запитів, управління сесіями, конфігурації моделей та інтеграції Claude у ваші робочі процеси розробки.
Архітектура
graph TD
A["User Terminal"] -->|"claude [options] [query]"| B["Claude Code CLI"]
B -->|Interactive| C["REPL Mode"]
B -->|"--print"| D["Print Mode (SDK)"]
B -->|"--resume"| E["Session Resume"]
C -->|Conversation| F["Claude API"]
D -->|Single Query| F
E -->|Load Context| F
F -->|Response| G["Output"]
G -->|text/json/stream-json| H["Terminal/Pipe"]
CLI-команди
| Команда | Опис | Приклад |
|---|---|---|
claude |
Запуск інтерактивного REPL (циклу читання-виконання-виводу) | claude |
claude "query" |
Запуск REPL з початковим промптом | claude "explain this project" |
claude -p "query" |
Print-режим — запит і вихід | claude -p "explain this function" |
cat file | claude -p "query" |
Обробка вмісту через pipe (конвеєр) | cat logs.txt | claude -p "explain" |
claude -c |
Продовжити останню розмову | claude -c |
claude -c -p "query" |
Продовжити в print-режимі | claude -c -p "check for type errors" |
claude -r "<session>" "query" |
Відновити сесію за ID або назвою | claude -r "auth-refactor" "finish this PR" |
claude update |
Оновити до останньої версії | claude update |
claude mcp |
Налаштування MCP-серверів | Див. документацію MCP |
claude mcp serve |
Запуск Claude Code як MCP-сервера | claude mcp serve |
claude agents |
Список усіх налаштованих субагентів | claude agents |
claude auto-mode defaults |
Вивести стандартні правила auto mode як JSON | claude auto-mode defaults |
claude --remote-control [name] |
Запуск Remote Control (це прапорець, а не підкоманда; аліас --rc) |
claude --rc |
claude plugin |
Управління плагінами (встановлення, увімкнення, вимкнення) | claude plugin install my-plugin |
claude auth login |
Вхід (підтримує --email, --sso) |
claude auth login --email user@example.com |
claude auth logout |
Вихід з поточного облікового запису | claude auth logout |
claude auth status |
Перевірка статусу авторизації (код виходу 0 = увійшов, 1 = ні) | claude auth status |
Основні прапорці
| Прапорець | Опис | Приклад |
|---|---|---|
-p, --print |
Вивести відповідь без інтерактивного режиму | claude -p "query" |
-c, --continue |
Завантажити останню розмову | claude --continue |
-r, --resume |
Відновити конкретну сесію за ID або назвою | claude --resume auth-refactor |
-v, --version |
Показати номер версії | claude -v |
-w, --worktree |
Запуск в ізольованому git worktree (робочому дереві) | claude -w |
-n, --name |
Відображувана назва сесії | claude -n "auth-refactor" |
--from-pr <number> |
Відновити сесії, привʼязані до GitHub PR | claude --from-pr 42 |
--cloud [description|session_id|url] |
Створити хмарну сесію на claude.ai із заданим описом або приєднатися до наявної за session ID чи URL claude.ai/code | claude --cloud "implement API" |
--remote "task" |
Застарілий аліас для --cloud, включно з формою приєднання до наявної сесії. Використовуйте --cloud |
claude --remote "implement API" |
--remote-control, --rc |
Інтерактивна сесія з Remote Control | claude --rc |
--teleport |
Відновити веб-сесію локально | claude --teleport |
--teammate-mode |
Режим відображення Agent Teams | claude --teammate-mode tmux |
--bare |
Мінімальний режим (без хуків, навичок, плагінів, MCP, auto memory, CLAUDE.md) | claude --bare |
--enable-auto-mode |
Розблокувати auto permission mode | claude --enable-auto-mode |
--channels |
Підписка на MCP channel plugins. Кожен запис має бути позначений як plugin:<name>@<marketplace>; голі імена відхиляються |
claude --channels plugin:discord@my-marketplace |
--chrome / --no-chrome |
Увімкнути/вимкнути інтеграцію з браузером Chrome | claude --chrome |
--effort |
Встановити рівень зусиль мислення | claude --effort high |
--init / --init-only |
Запуск хуків ініціалізації | claude --init |
--maintenance |
Запуск хуків обслуговування та вихід | claude --maintenance |
--disable-slash-commands |
Вимкнути всі навички та слеш-команди | claude --disable-slash-commands |
--no-session-persistence |
Вимкнути збереження сесії (print mode) | claude -p --no-session-persistence "query" |
Інтерактивний vs Print-режим
graph LR
A["claude"] -->|Default| B["Interactive REPL"]
A -->|"-p flag"| C["Print Mode"]
B -->|Features| D["Multi-turn conversation<br>Tab completion<br>History<br>Slash commands"]
C -->|Features| E["Single query<br>Scriptable<br>Pipeable<br>JSON output"]
Інтерактивний режим (за замовчуванням):
# Запуск інтерактивної сесії
claude
# Запуск з початковим промптом
claude "explain the authentication flow"
Print-режим (неінтерактивний):
# Один запит, потім вихід
claude -p "what does this function do?"
# Обробка вмісту файлу
cat error.log | claude -p "explain this error"
# Ланцюжок з іншими інструментами
claude -p "list todos" | grep "URGENT"
Модель та конфігурація
| Прапорець | Опис | Приклад |
|---|---|---|
--model |
Встановити модель (sonnet, opus, haiku або повна назва) | claude --model opus |
--fallback-model |
Автоматичний фолбек (запасна модель) при перевантаженні | claude -p --fallback-model sonnet "query" |
--agent |
Вказати агента для сесії | claude --agent my-custom-agent |
--agents |
Визначити кастомних субагентів через JSON | Див. Конфігурація агентів |
--effort |
Встановити рівень зусиль (low, medium, high, max) | claude --effort high |
Приклади вибору моделі
# Opus 4.6 для складних завдань
claude --model opus "design a caching strategy"
# Haiku 4.5 для швидких завдань
claude --model haiku -p "format this JSON"
# Повна назва моделі
claude --model claude-sonnet-4-6-20250929 "review this code"
# З фолбеком для надійності
claude -p --model opus --fallback-model sonnet "analyze architecture"
# opusplan (Opus планує, Sonnet виконує)
claude --model opusplan "design and implement the caching layer"
Кастомізація системного промпта
| Прапорець | Опис | Приклад |
|---|---|---|
--system-prompt |
Замінити весь стандартний промпт | claude --system-prompt "You are a Python expert" |
--system-prompt-file |
Завантажити промпт з файлу (print mode) | claude -p --system-prompt-file ./prompt.txt "query" |
--append-system-prompt |
Додати до стандартного промпта | claude --append-system-prompt "Always use TypeScript" |
Приклади системного промпта
# Повністю кастомна персона
claude --system-prompt "You are a senior security engineer. Focus on vulnerabilities."
# Додавання конкретних інструкцій
claude --append-system-prompt "Always include unit tests with code examples"
# Завантаження складного промпта з файлу
claude -p --system-prompt-file ./prompts/code-reviewer.txt "review main.py"
Порівняння прапорців системного промпта
| Прапорець | Поведінка | Інтерактивний | |
|---|---|---|---|
--system-prompt |
Замінює весь стандартний системний промпт | ✅ | ✅ |
--system-prompt-file |
Замінює промптом з файлу | ❌ | ✅ |
--append-system-prompt |
Додає до стандартного системного промпта | ✅ | ✅ |
Використовуйте --system-prompt-file лише в print-режимі. Для інтерактивного режиму використовуйте --system-prompt або --append-system-prompt.
Управління інструментами та дозволами
| Прапорець | Опис | Приклад |
|---|---|---|
--tools |
Обмежити доступні вбудовані інструменти | claude -p --tools "Bash,Edit,Read" "query" |
--allowedTools |
Інструменти, що виконуються без запиту дозволу | "Bash(git log:*)" "Read" |
--disallowedTools |
Інструменти, видалені з контексту | "Bash(rm:*)" "Edit" |
--dangerously-skip-permissions |
Пропустити всі запити дозволів | claude --dangerously-skip-permissions |
--permission-mode |
Починати у вказаному режимі дозволів | claude --permission-mode auto |
--permission-prompt-tool |
MCP-інструмент для обробки дозволів | claude -p --permission-prompt-tool mcp_auth "query" |
--enable-auto-mode |
Розблокувати auto permission mode | claude --enable-auto-mode |
Приклади дозволів
# Режим тільки для читання — код-рев'ю
claude --permission-mode plan "review this codebase"
# Обмеження до безпечних інструментів
claude --tools "Read,Grep,Glob" -p "find all TODO comments"
# Дозволити конкретні git-команди без запитів
claude --allowedTools "Bash(git status:*)" "Bash(git log:*)"
# Заблокувати небезпечні операції
claude --disallowedTools "Bash(rm -rf:*)" "Bash(git push --force:*)"
Вивід та формат
| Прапорець | Опис | Опції | Приклад |
|---|---|---|---|
--output-format |
Формат виводу (print mode) | text, json, stream-json |
claude -p --output-format json "query" |
--input-format |
Формат вводу (print mode) | text, stream-json |
claude -p --input-format stream-json |
--verbose |
Увімкнути детальне логування | claude --verbose |
|
--include-partial-messages |
Включити потокові (streaming) події | Потребує stream-json |
claude -p --output-format stream-json --include-partial-messages "query" |
--json-schema |
Отримати валідований JSON за схемою | claude -p --json-schema '{"type":"object"}' "query" |
|
--max-budget-usd |
Максимальні витрати для print mode. Починаючи з v2.1.217, після досягнення ліміту також зупиняються фонові subagent-и, що виконуються, і забороняється запуск нових (раніше фонові агенти продовжували працювати після перевищення ліміту) | claude -p --max-budget-usd 5.00 "query" |
Приклади формату виводу
# Звичайний текст (за замовчуванням)
claude -p "explain this code"
# JSON для програмного використання
claude -p --output-format json "list all functions in main.py"
# Потоковий JSON для обробки в реальному часі
claude -p --output-format stream-json "generate a long report"
# Структурований вивід із валідацією за схемою
claude -p --json-schema '{"type":"object","properties":{"bugs":{"type":"array"}}}' \
"find bugs in this code and return as JSON"
Робочий простір та каталог
| Прапорець | Опис | Приклад |
|---|---|---|
--add-dir |
Додати додаткові робочі каталоги | claude --add-dir ../apps ../lib |
--setting-sources |
Джерела налаштувань через кому | claude --setting-sources user,project |
--settings |
Завантажити налаштування з файлу або JSON | claude --settings ./settings.json |
--plugin-dir |
Завантажити плагіни з каталогу (повторюваний) | claude --plugin-dir ./my-plugin |
Приклад роботи з кількома каталогами
# Робота в кількох каталогах проєкту одночасно
claude --add-dir ../frontend ../backend ../shared "find all API endpoints"
# Завантаження кастомних налаштувань
claude --settings '{"model":"opus","verbose":true}' "complex task"
Конфігурація MCP
| Прапорець | Опис | Приклад |
|---|---|---|
--mcp-config |
Завантажити MCP-сервери з JSON | claude --mcp-config ./mcp.json |
--strict-mcp-config |
Використовувати тільки вказану MCP-конфігурацію | claude --strict-mcp-config --mcp-config ./mcp.json |
--channels |
Підписка на MCP channel plugins. Кожен запис має бути позначений як plugin:<name>@<marketplace>; голі імена відхиляються |
claude --channels plugin:discord@my-marketplace |
Приклади MCP
# Завантаження GitHub MCP-сервера
claude --mcp-config ./github-mcp.json "list open PRs"
# Суворий режим — тільки вказані сервери
claude --strict-mcp-config --mcp-config ./production-mcp.json "deploy to staging"
Управління сесіями
| Прапорець | Опис | Приклад |
|---|---|---|
--session-id |
Використовувати конкретний ID сесії (UUID) | claude --session-id "550e8400-..." |
--fork-session |
Створити нову сесію при відновленні | claude --resume abc123 --fork-session |
Приклади сесій
# Продовжити останню розмову
claude -c
# Відновити іменовану сесію
claude -r "feature-auth" "continue implementing login"
# Форк сесії для експериментів
claude --resume feature-auth --fork-session "try alternative approach"
# Використання конкретного ID сесії
claude --session-id "550e8400-e29b-41d4-a716-446655440000" "continue"
Форк сесії
Створення відгалуження від існуючої сесії для експериментів:
# Форк сесії для альтернативного підходу
claude --resume abc123 --fork-session "try alternative implementation"
# Форк з кастомним повідомленням
claude -r "feature-auth" --fork-session "test with different architecture"
Випадки використання:
- Спроба альтернативних реалізацій без втрати оригінальної сесії
- Паралельне експериментування з різними підходами
- Створення відгалужень від успішної роботи для варіацій
- Тестування зламуючих змін (breaking changes) без впливу на основну сесію
Оригінальна сесія залишається без змін, а форк стає новою незалежною сесією.
Розширені функції
| Прапорець | Опис | Приклад |
|---|---|---|
--chrome |
Увімкнути інтеграцію з браузером Chrome | claude --chrome |
--no-chrome |
Вимкнути інтеграцію з Chrome | claude --no-chrome |
--ide |
Автопідключення до IDE, якщо доступна | claude --ide |
--max-turns |
Обмежити кількість агентних кроків (неінтерактивний режим) | claude -p --max-turns 3 "query" |
--debug |
Увімкнути режим налагодження з фільтрацією | claude --debug "api,mcp" |
--enable-lsp-logging |
Увімкнути детальне логування LSP | claude --enable-lsp-logging |
--betas |
Beta-заголовки для API-запитів | claude --betas interleaved-thinking |
--plugin-dir |
Завантажити плагіни з каталогу (повторюваний) | claude --plugin-dir ./my-plugin |
--enable-auto-mode |
Розблокувати auto permission mode | claude --enable-auto-mode |
--effort |
Встановити рівень зусиль мислення | claude --effort high |
--bare |
Мінімальний режим (без хуків, навичок, плагінів, MCP, auto memory, CLAUDE.md) | claude --bare |
--channels |
Підписка на MCP channel plugins (позначені як plugin:<name>@<marketplace>) |
claude --channels plugin:discord@my-marketplace |
--tmux |
Створити tmux-сесію для worktree | claude --tmux |
--fork-session |
Створити новий ID сесії при відновленні | claude --resume abc --fork-session |
--max-budget-usd |
Максимальні витрати (print mode); також зупиняє фонові subagent-и при досягненні ліміту (v2.1.217) | claude -p --max-budget-usd 5.00 "query" |
--json-schema |
Валідований JSON-вивід | claude -p --json-schema '{"type":"object"}' "q" |
Приклади розширених функцій
# Обмежити автономні дії
claude -p --max-turns 5 "refactor this module"
# Налагодження API-викликів
claude --debug "api" "test query"
# Увімкнути інтеграцію з IDE
claude --ide "help me with this file"
Конфігурація агентів
Прапорець --agents приймає JSON-обʼєкт, що визначає кастомних субагентів для сесії.
Формат JSON для агентів
{
"agent-name": {
"description": "Обовʼязково: коли викликати цього агента",
"prompt": "Обовʼязково: системний промпт для агента",
"tools": ["Необовʼязково", "масив", "інструментів"],
"model": "необовʼязково: sonnet|opus|haiku"
}
}
Обовʼязкові поля:
description— опис природною мовою, коли використовувати цього агентаprompt— системний промпт, що визначає роль та поведінку агента
Необовʼязкові поля:
tools— масив доступних інструментів (якщо не вказано, успадковує всі)- Формат:
["Read", "Grep", "Glob", "Bash"]
- Формат:
model— модель:sonnet,opusабоhaiku
Повний приклад агентів
{
"code-reviewer": {
"description": "Expert code reviewer. Use proactively after code changes.",
"prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
"tools": ["Read", "Grep", "Glob", "Bash"],
"model": "sonnet"
},
"debugger": {
"description": "Debugging specialist for errors and test failures.",
"prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes.",
"tools": ["Read", "Edit", "Bash", "Grep"],
"model": "opus"
},
"documenter": {
"description": "Documentation specialist for generating guides.",
"prompt": "You are a technical writer. Create clear, comprehensive documentation.",
"tools": ["Read", "Write"],
"model": "haiku"
}
}
Приклади команд з агентами
# Визначення кастомних агентів інлайн
claude --agents '{
"security-auditor": {
"description": "Security specialist for vulnerability analysis",
"prompt": "You are a security expert. Find vulnerabilities and suggest fixes.",
"tools": ["Read", "Grep", "Glob"],
"model": "opus"
}
}' "audit this codebase for security issues"
# Завантаження агентів з файлу
claude --agents "$(cat ~/.claude/agents.json)" "review the auth module"
# Комбінація з іншими прапорцями
claude -p --agents "$(cat agents.json)" --model sonnet "analyze performance"
Пріоритет агентів
При наявності кількох визначень агентів вони завантажуються в такому порядку пріоритету:
- CLI-визначені (прапорець
--agents) — для конкретної сесії - Рівень користувача (
~/.claude/agents/) — для всіх проєктів - Рівень проєкту (
.claude/agents/) — для поточного проєкту
CLI-визначені агенти перевизначають агентів рівня користувача та проєкту на час сесії.
Високоцінні сценарії використання
1. Інтеграція CI/CD
Використання Claude Code у CI/CD-пайплайнах (конвеєрах безперервної інтеграції/доставки) для автоматизованого код-рев'ю, тестування та документації.
Приклад GitHub Actions:
name: AI Code Review
on: [pull_request]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Install Claude Code
run: npm install -g @anthropic-ai/claude-code
- name: Run Code Review
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
claude -p --output-format json \
--max-turns 1 \
"Review the changes in this PR for:
- Security vulnerabilities
- Performance issues
- Code quality
Output as JSON with 'issues' array" > review.json
- name: Post Review Comment
uses: actions/github-script@v7
with:
script: |
const fs = require('fs');
const review = JSON.parse(fs.readFileSync('review.json', 'utf8'));
// Обробка та публікація коментарів рев'ю
Пайплайн Jenkins:
pipeline {
agent any
stages {
stage('AI Review') {
steps {
sh '''
claude -p --output-format json \
--max-turns 3 \
"Analyze test coverage and suggest missing tests" \
> coverage-analysis.json
'''
}
}
}
}
2. Pipe-обробка скриптів
Обробка файлів, журналів та даних через Claude для аналізу.
Аналіз журналів:
# Аналіз журналів помилок
tail -1000 /var/log/app/error.log | claude -p "summarize these errors and suggest fixes"
# Пошук патернів у журналах доступу
cat access.log | claude -p "identify suspicious access patterns"
# Аналіз git-історії
git log --oneline -50 | claude -p "summarize recent development activity"
Обробка коду:
# Рев'ю конкретного файлу
cat src/auth.ts | claude -p "review this authentication code for security issues"
# Генерація документації
cat src/api/*.ts | claude -p "generate API documentation in markdown"
# Пошук TODO та пріоритезація
grep -r "TODO" src/ | claude -p "prioritize these TODOs by importance"
3. Мультисесійні робочі процеси
Управління складними проєктами з кількома потоками розмов.
# Запуск сесії для гілки функції
claude -r "feature-auth" "let's implement user authentication"
# Пізніше — продовження сесії
claude -r "feature-auth" "add password reset functionality"
# Форк для альтернативного підходу
claude --resume feature-auth --fork-session "try OAuth instead"
# Переключення між різними сесіями функцій
claude -r "feature-payments" "continue with Stripe integration"
4. Кастомна конфігурація агентів
Визначення спеціалізованих агентів для робочих процесів вашої команди.
# Збереження конфігурації агентів у файл
cat > ~/.claude/agents.json << 'EOF'
{
"reviewer": {
"description": "Code reviewer for PR reviews",
"prompt": "Review code for quality, security, and maintainability.",
"model": "opus"
},
"documenter": {
"description": "Documentation specialist",
"prompt": "Generate clear, comprehensive documentation.",
"model": "sonnet"
},
"refactorer": {
"description": "Code refactoring expert",
"prompt": "Suggest and implement clean code refactoring.",
"tools": ["Read", "Edit", "Glob"]
}
}
EOF
# Використання агентів у сесії
claude --agents "$(cat ~/.claude/agents.json)" "review the auth module"
5. Пакетна обробка
Обробка кількох запитів з однаковими налаштуваннями.
# Обробка кількох файлів
for file in src/*.ts; do
echo "Processing $file..."
claude -p --model haiku "summarize this file: $(cat $file)" >> summaries.md
done
# Пакетне код-рев'ю
find src -name "*.py" -exec sh -c '
echo "## $1" >> review.md
cat "$1" | claude -p "brief code review" >> review.md
' _ {} \;
# Генерація тестів для всіх модулів
for module in $(ls src/modules/); do
claude -p "generate unit tests for src/modules/$module" > "tests/$module.test.ts"
done
6. Безпечна розробка
Використання контролю дозволів для безпечної роботи.
# Аудит безпеки тільки для читання
claude --permission-mode plan \
--tools "Read,Grep,Glob" \
"audit this codebase for security vulnerabilities"
# Блокування небезпечних команд
claude --disallowedTools "Bash(rm:*)" "Bash(curl:*)" "Bash(wget:*)" \
"help me clean up this project"
# Обмежена автоматизація
claude -p --max-turns 2 \
--allowedTools "Read" "Glob" \
"find all hardcoded credentials"
7. JSON API інтеграція
Використання Claude як програмного API для ваших інструментів з парсингом через jq.
# Структурований аналіз
claude -p --output-format json \
--json-schema '{"type":"object","properties":{"functions":{"type":"array"},"complexity":{"type":"string"}}}' \
"analyze main.py and return function list with complexity rating"
# Інтеграція з jq для обробки
claude -p --output-format json "list all API endpoints" | jq '.endpoints[]'
# Використання в скриптах
RESULT=$(claude -p --output-format json "is this code secure? answer with {secure: boolean, issues: []}" < code.py)
if echo "$RESULT" | jq -e '.secure == false' > /dev/null; then
echo "Security issues found!"
echo "$RESULT" | jq '.issues[]'
fi
Приклади парсингу jq
Парсинг та обробка JSON-виводу Claude за допомогою jq:
# Витяг конкретних полів
claude -p --output-format json "analyze this code" | jq '.result'
# Фільтрація елементів масиву
claude -p --output-format json "list issues" | jq -r '.issues[] | select(.severity=="high")'
# Витяг кількох полів
claude -p --output-format json "describe the project" | jq -r '.{name, version, description}'
# Конвертація в CSV
claude -p --output-format json "list functions" | jq -r '.functions[] | [.name, .lineCount] | @csv'
# Умовна обробка
claude -p --output-format json "check security" | jq 'if .vulnerabilities | length > 0 then "UNSAFE" else "SAFE" end'
# Витяг вкладених значень
claude -p --output-format json "analyze performance" | jq '.metrics.cpu.usage'
# Обробка всього масиву
claude -p --output-format json "find todos" | jq '.todos | length'
# Трансформація виводу
claude -p --output-format json "list improvements" | jq 'map({title: .title, priority: .priority})'
Моделі
Claude Code підтримує кілька моделей з різними можливостями:
| Модель | ID | Контекстне вікно | Примітки |
|---|---|---|---|
| Opus 4.6 | claude-opus-4-6 |
1M токенів | Найпотужніша, адаптивні рівні зусиль |
| Sonnet 4.6 | claude-sonnet-4-6 |
1M токенів | Баланс швидкості та можливостей |
| Haiku 4.5 | claude-haiku-4-5 |
1M токенів | Найшвидша, оптимальна для швидких завдань |
Вибір моделі
# Використання коротких назв
claude --model opus "complex architectural review"
claude --model sonnet "implement this feature"
claude --model haiku -p "format this JSON"
# Використання alias opusplan (Opus планує, Sonnet виконує)
claude --model opusplan "design and implement the API"
# Перемикання на швидкий режим під час сесії
/fast
Рівні зусиль (Opus 4.6)
Opus 4.6 підтримує адаптивне міркування з рівнями зусиль:
# Через прапорець CLI
claude --effort high "complex review"
# Через слеш-команду
/effort high
# Через змінну оточення
export CLAUDE_CODE_EFFORT_LEVEL=high # low, medium, high або max (лише Opus 4.6)
Ключове слово "ultrathink" у промптах активує глибоке міркування. Рівень max — ексклюзивний для Opus 4.6.
Ключові змінні оточення
| Змінна | Опис |
|---|---|
ANTHROPIC_API_KEY |
API-ключ для автентифікації |
ANTHROPIC_MODEL |
Перевизначення стандартної моделі |
ANTHROPIC_CUSTOM_MODEL_OPTION |
Кастомна опція моделі для API |
ANTHROPIC_DEFAULT_OPUS_MODEL |
Перевизначення стандартного ID моделі Opus |
ANTHROPIC_DEFAULT_SONNET_MODEL |
Перевизначення стандартного ID моделі Sonnet |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
Перевизначення стандартного ID моделі Haiku |
MAX_THINKING_TOKENS |
Бюджет токенів розширеного мислення |
CLAUDE_CODE_EFFORT_LEVEL |
Рівень зусиль (low/medium/high/max) |
CLAUDE_CODE_SIMPLE |
Мінімальний режим, встановлюється прапорцем --bare |
CLAUDE_CODE_DISABLE_AUTO_MEMORY |
Вимкнути автоматичне оновлення CLAUDE.md |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS |
Вимкнути виконання фонових завдань |
CLAUDE_CODE_DISABLE_CRON |
Вимкнути заплановані/cron-завдання |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS |
Вимкнути git-інструкції |
CLAUDE_CODE_DISABLE_TERMINAL_TITLE |
Вимкнути оновлення заголовка терміналу |
CLAUDE_CODE_DISABLE_1M_CONTEXT |
Вимкнути контекстне вікно 1M токенів |
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK |
Вимкнути фолбек без стрімінгу |
CLAUDE_CODE_ENABLE_TASKS |
Увімкнути функцію списку завдань |
CLAUDE_CODE_TASK_LIST_ID |
Іменований каталог завдань, спільний між сесіями |
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION |
Увімкнути/вимкнути пропозиції промптів (true/false) |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS |
Увімкнути експериментальні Agent Teams |
CLAUDE_CODE_NEW_INIT |
Використовувати новий потік ініціалізації |
CLAUDE_CODE_SUBAGENT_MODEL |
Модель для виконання субагентів |
CLAUDE_CODE_PLUGIN_SEED_DIR |
Каталог для seed-файлів плагінів |
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB |
Змінні оточення для видалення з підпроцесів |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE |
Перевизначити відсоток автокомпакції |
CLAUDE_STREAM_IDLE_TIMEOUT_MS |
Таймаут простою потоку в мілісекундах |
SLASH_COMMAND_TOOL_CHAR_BUDGET |
Бюджет символів для інструментів слеш-команд |
ENABLE_TOOL_SEARCH |
Увімкнути пошук інструментів |
MAX_MCP_OUTPUT_TOKENS |
Максимум токенів для виводу MCP-інструмента |
Швидкий довідник
Найпоширеніші команди
# Інтерактивна сесія
claude
# Швидке питання
claude -p "how do I..."
# Продовжити розмову
claude -c
# Обробити файл
cat file.py | claude -p "review this"
# JSON-вивід для скриптів
claude -p --output-format json "query"
Комбінації прапорців
| Сценарій | Команда |
|---|---|
| Швидке код-рев'ю | cat file | claude -p "review" |
| Структурований вивід | claude -p --output-format json "query" |
| Безпечне дослідження | claude --permission-mode plan |
| Автономність з безпекою | claude --enable-auto-mode --permission-mode auto |
| CI/CD інтеграція | claude -p --max-turns 3 --output-format json |
| Відновлення роботи | claude -r "session-name" |
| Кастомна модель | claude --model opus "complex task" |
| Мінімальний режим | claude --bare "quick query" |
| Ліміт бюджету | claude -p --max-budget-usd 2.00 "analyze code" |
Усунення несправностей
Команда не знайдена
Проблема: claude: command not found
Рішення:
- Встановіть Claude Code:
npm install -g @anthropic-ai/claude-code - Перевірте, що PATH включає глобальний bin-каталог npm
- Спробуйте запуск з повним шляхом:
npx claude
Проблеми з API-ключем
Проблема: Помилка автентифікації
Рішення:
- Встановіть API-ключ:
export ANTHROPIC_API_KEY=your-key - Перевірте валідність ключа та наявність достатнього балансу
- Перевірте дозволи ключа для запитуваної моделі
Сесія не знайдена
Проблема: Неможливо відновити сесію
Рішення:
- Перегляньте доступні сесії, щоб знайти правильну назву/ID
- Сесії можуть закінчуватися після періоду неактивності
- Використовуйте
-cдля продовження останньої сесії
Проблеми з форматом виводу
Проблема: JSON-вивід пошкоджений
Рішення:
- Використовуйте
--json-schemaдля примусового дотримання структури - Додайте явні інструкції щодо JSON у промпті
- Використовуйте
--output-format json(а не просто просіть JSON у промпті)
Відмова в дозволі
Проблема: Виконання інструменту заблоковане
Рішення:
- Перевірте налаштування
--permission-mode - Перегляньте прапорці
--allowedToolsта--disallowedTools - Використовуйте
--dangerously-skip-permissionsдля автоматизації (з обережністю)
Додаткові ресурси
- Офіційний довідник CLI — повний довідник команд
- Документація Headless Mode — автоматизоване виконання
- Слеш-команди — кастомні ярлики в Claude
- Посібник з памʼяті — постійний контекст через CLAUDE.md
- Протокол MCP — інтеграція зовнішніх інструментів
- Розширені функції — режим планування, розширене мислення
- Посібник субагентів — делеговане виконання завдань
Частина серії посібників Claude How To
Останнє оновлення: 2 вересня 2026 Версія Claude Code: 2.1.257 Джерела:
- https://code.claude.com/docs/en/cli-reference Сумісні моделі: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5