Files
claude-howto/uk/10-cli/README.md
T
Luong NGUYEN 1e16914a8d docs: sync to Claude Code v2.1.257 (#180)
* 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
2026-09-02 10:35:08 +02:00

40 KiB
Raw Blame History

Claude How To

Довідник 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"

Порівняння прапорців системного промпта

Прапорець Поведінка Інтерактивний Print
--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"

Пріоритет агентів

При наявності кількох визначень агентів вони завантажуються в такому порядку пріоритету:

  1. CLI-визначені (прапорець --agents) — для конкретної сесії
  2. Рівень користувача (~/.claude/agents/) — для всіх проєктів
  3. Рівень проєкту (.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 для автоматизації (з обережністю)

Додаткові ресурси


Частина серії посібників Claude How To


Останнє оновлення: 2 вересня 2026 Версія Claude Code: 2.1.257 Джерела: