Встановлення Claude Code
Інсталяція через npm, brew та winget, автентифікація та базове налаштування
📎ОФІЦІЙНА ДОКУМЕНТАЦІЯ
Системні вимоги
Перед встановленням переконайтесь, що ваша система відповідає вимогам:
- Node.js 18 або новіший
- Операційна система: macOS 12+, Ubuntu 20.04+ / Debian 10+, Windows (через WSL2)
- Оперативна пам'ять: мінімум 4 ГБ
На Windows Claude Code офіційно підтримується лише через WSL2 (Windows Subsystem for Linux). Нативна підтримка Windows обмежена.
Встановлення
npm (рекомендовано)
Найпростіший спосіб встановити Claude Code:
npm install -g @anthropic-ai/claude-code
Перевірка встановлення:
claude --version
Homebrew (macOS / Linux)
brew install claude-code
Оновлення
Для оновлення до останньої версії:
npm update -g @anthropic-ai/claude-code
Автентифікація
Anthropic API Key
Найпоширеніший спосіб — використання API-ключа:
# Встановити ключ через змінну середовища
export ANTHROPIC_API_KEY="sk-ant-..."
# Або Claude Code запитає ключ при першому запуску
claude
Ніколи не зберігайте API-ключ у коді або комітах. Використовуйте змінні середовища або менеджери секретів.
Claude Max підписка
Якщо у вас є підписка Claude Max, Claude Code може використовувати OAuth автентифікацію:
claude login
Це відкриє браузер для авторизації через ваш Anthropic акаунт.
Amazon Bedrock
Для використання Claude через AWS Bedrock:
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_ACCESS_KEY_ID="..."
export AWS_SECRET_ACCESS_KEY="..."
Google Vertex AI
Для використання через Google Cloud:
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID="your-project-id"
Перший запуск
Після встановлення та автентифікації запустіть Claude Code у кореневій директорії вашого проєкту:
cd my-project
claude
При першому запуску Claude Code:
- Проіндексує структуру проєкту
- Знайде та прочитає файли
CLAUDE.mdдля контексту - Відкриє інтерактивний REPL для введення команд
╭──────────────────────────────────────╮
│ Claude Code v1.x │
│ Model: claude-sonnet-4-20250514 │
│ Context: 200K tokens │
╰──────────────────────────────────────╯
> _
Конфігурація
Файл settings.json
Глобальні налаштування зберігаються у ~/.claude/settings.json:
{
"permissions": {
"allow": [
"Bash(npm run *)",
"Bash(git *)",
"Read",
"Write",
"Edit"
],
"deny": [
"Bash(rm -rf *)",
"Bash(sudo *)"
]
},
"model": "claude-sonnet-4-20250514",
"verbose": false
}
Проєктні налаштування
Налаштування для конкретного проєкту зберігаються у .claude/settings.json у корені проєкту:
{
"permissions": {
"allow": [
"Bash(npm run test)",
"Bash(npm run build)",
"Bash(npm run lint)"
]
}
}
Основні параметри CLI
| Прапорець | Опис |
|---|---|
--model, -m | Вибір моделі (sonnet, opus) |
--print, -p | Одноразове виконання без REPL |
--output-format | Формат виводу (text, json, stream-json) |
--verbose | Детальний вивід |
--max-turns | Максимальна кількість кроків агента |
--allowedTools | Список дозволених інструментів |
--resume, -r | Відновити попередню сесію |
Приклади використання CLI
# Використати модель Opus
claude -m opus
# Одноразовий запит з JSON-виводом
claude -p "Порахуй кількість TODO в проєкті" --output-format json
# Обмежити інструменти
claude --allowedTools Read,Grep,Glob
# Відновити останню сесію
claude -r
Створіть alias у вашому shell-профілі для часто використовуваних конфігурацій:
alias cc="claude"
alias cco="claude -m opus"
Наступні кроки
Налаштуйте контекст проєкту через файли CLAUDE.md
Дізнайтесь, як ефективно використовувати Claude Code