Skip to content

Claude How ToClaude How To

Довідник CLI

Огляд

Claude Code CLI (інтерфейс командного рядка — основний інструмент для роботи з терміналом) — це головний спосіб взаємодії з Claude Code. Він надає потужні опції для виконання запитів, управління сесіями, конфігурації моделей та інтеграції Claude у ваші робочі процеси розробки.

Архітектура

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 як JSONclaude auto-mode defaults
claude remote-controlЗапуск сервера Remote Controlclaude remote-control
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 PRclaude --from-pr 42
--remote "task"Створити веб-сесію на claude.aiclaude --remote "implement API"
--remote-control, --rcІнтерактивна сесія з Remote Controlclaude --rc
--teleportВідновити веб-сесію локальноclaude --teleport
--teammate-modeРежим відображення Agent Teamsclaude --teammate-mode tmux
--bareМінімальний режим (без хуків, навичок, плагінів, MCP, auto memory, CLAUDE.md)claude --bare
--enable-auto-modeРозблокувати auto permission modeclaude --enable-auto-mode
--channelsПідписка на MCP channel pluginsclaude --channels discord,telegram
--chrome / --no-chromeУвімкнути/вимкнути інтеграцію з браузером Chromeclaude --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-режим

Інтерактивний режим (за замовчуванням):

bash
# Запуск інтерактивної сесії
claude

# Запуск з початковим промптом
claude "explain the authentication flow"

Print-режим (неінтерактивний):

bash
# Один запит, потім вихід
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

Приклади вибору моделі

bash
# 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"

Приклади системного промпта

bash
# Повністю кастомна персона
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-toolMCP-інструмент для обробки дозволівclaude -p --permission-prompt-tool mcp_auth "query"
--enable-auto-modeРозблокувати auto permission modeclaude --enable-auto-mode

Приклади дозволів

bash
# Режим тільки для читання — код-рев'ю
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-jsonclaude -p --output-format json "query"
--input-formatФормат вводу (print mode)text, stream-jsonclaude -p --input-format stream-json
--verboseУвімкнути детальне логуванняclaude --verbose
--include-partial-messagesВключити потокові (streaming) подіїПотребує stream-jsonclaude -p --output-format stream-json --include-partial-messages "query"
--json-schemaОтримати валідований JSON за схемоюclaude -p --json-schema '{"type":"object"}' "query"
--max-budget-usdМаксимальні витрати для print modeclaude -p --max-budget-usd 5.00 "query"

Приклади формату виводу

bash
# Звичайний текст (за замовчуванням)
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Завантажити налаштування з файлу або JSONclaude --settings ./settings.json
--plugin-dirЗавантажити плагіни з каталогу (повторюваний)claude --plugin-dir ./my-plugin

Приклад роботи з кількома каталогами

bash
# Робота в кількох каталогах проєкту одночасно
claude --add-dir ../frontend ../backend ../shared "find all API endpoints"

# Завантаження кастомних налаштувань
claude --settings '{"model":"opus","verbose":true}' "complex task"

Конфігурація MCP

ПрапорецьОписПриклад
--mcp-configЗавантажити MCP-сервери з JSONclaude --mcp-config ./mcp.json
--strict-mcp-configВикористовувати тільки вказану MCP-конфігураціюclaude --strict-mcp-config --mcp-config ./mcp.json
--channelsПідписка на MCP channel pluginsclaude --channels discord,telegram

Приклади MCP

bash
# Завантаження 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

Приклади сесій

bash
# Продовжити останню розмову
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"

Форк сесії

Створення відгалуження від існуючої сесії для експериментів:

bash
# Форк сесії для альтернативного підходу
claude --resume abc123 --fork-session "try alternative implementation"

# Форк з кастомним повідомленням
claude -r "feature-auth" --fork-session "test with different architecture"

Випадки використання:

  • Спроба альтернативних реалізацій без втрати оригінальної сесії
  • Паралельне експериментування з різними підходами
  • Створення відгалужень від успішної роботи для варіацій
  • Тестування зламуючих змін (breaking changes) без впливу на основну сесію

Оригінальна сесія залишається без змін, а форк стає новою незалежною сесією.

Розширені функції

ПрапорецьОписПриклад
--chromeУвімкнути інтеграцію з браузером Chromeclaude --chrome
--no-chromeВимкнути інтеграцію з Chromeclaude --no-chrome
--ideАвтопідключення до IDE, якщо доступнаclaude --ide
--max-turnsОбмежити кількість агентних кроків (неінтерактивний режим)claude -p --max-turns 3 "query"
--debugУвімкнути режим налагодження з фільтрацієюclaude --debug "api,mcp"
--enable-lsp-loggingУвімкнути детальне логування LSPclaude --enable-lsp-logging
--betasBeta-заголовки для API-запитівclaude --betas interleaved-thinking
--plugin-dirЗавантажити плагіни з каталогу (повторюваний)claude --plugin-dir ./my-plugin
--enable-auto-modeРозблокувати auto permission modeclaude --enable-auto-mode
--effortВстановити рівень зусиль мисленняclaude --effort high
--bareМінімальний режим (без хуків, навичок, плагінів, MCP, auto memory, CLAUDE.md)claude --bare
--channelsПідписка на MCP channel pluginsclaude --channels discord
--tmuxСтворити tmux-сесію для worktreeclaude --tmux
--fork-sessionСтворити новий ID сесії при відновленніclaude --resume abc --fork-session
--max-budget-usdМаксимальні витрати (print mode)claude -p --max-budget-usd 5.00 "query"
--json-schemaВалідований JSON-вивідclaude -p --json-schema '{"type":"object"}' "q"

Приклади розширених функцій

bash
# Обмежити автономні дії
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 для агентів

json
{
  "agent-name": {
    "description": "Обовʼязково: коли викликати цього агента",
    "prompt": "Обовʼязково: системний промпт для агента",
    "tools": ["Необовʼязково", "масив", "інструментів"],
    "model": "необовʼязково: sonnet|opus|haiku"
  }
}

Обовʼязкові поля:

  • description — опис природною мовою, коли використовувати цього агента
  • prompt — системний промпт, що визначає роль та поведінку агента

Необовʼязкові поля:

  • tools — масив доступних інструментів (якщо не вказано, успадковує всі)
    • Формат: ["Read", "Grep", "Glob", "Bash"]
  • model — модель: sonnet, opus або haiku

Повний приклад агентів

json
{
  "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"
  }
}

Приклади команд з агентами

bash
# Визначення кастомних агентів інлайн
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:

yaml
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:

groovy
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 для аналізу.

Аналіз журналів:

bash
# Аналіз журналів помилок
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"

Обробка коду:

bash
# Рев'ю конкретного файлу
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. Мультисесійні робочі процеси

Управління складними проєктами з кількома потоками розмов.

bash
# Запуск сесії для гілки функції
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. Кастомна конфігурація агентів

Визначення спеціалізованих агентів для робочих процесів вашої команди.

bash
# Збереження конфігурації агентів у файл
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. Пакетна обробка

Обробка кількох запитів з однаковими налаштуваннями.

bash
# Обробка кількох файлів
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. Безпечна розробка

Використання контролю дозволів для безпечної роботи.

bash
# Аудит безпеки тільки для читання
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.

bash
# Структурований аналіз
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:

bash
# Витяг конкретних полів
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.6claude-opus-4-61M токенівНайпотужніша, адаптивні рівні зусиль
Sonnet 4.6claude-sonnet-4-61M токенівБаланс швидкості та можливостей
Haiku 4.5claude-haiku-4-51M токенівНайшвидша, оптимальна для швидких завдань

Вибір моделі

bash
# Використання коротких назв
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 підтримує адаптивне міркування з рівнями зусиль:

bash
# Через прапорець 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_KEYAPI-ключ для автентифікації
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-інструмента

Швидкий довідник

Найпоширеніші команди

bash
# Інтерактивна сесія
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


Останнє оновлення: 9 квітня 2026 Версія Claude Code: 2.1.97 Сумісні моделі: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5