Блог гайд

Claude Code — установка и первая настройка

Claude Code — терминальный AI-агент от Anthropic. Установка занимает около 30 секунд одной командой, дальше — авторизация через браузер и первый запуск. По данным официальной документации и гайда Morph LLM.

Главное правило 2026 года: npm-установка через npm i -g @anthropic-ai/claude-code помечена как deprecated. Использовать только native binary installer — он стабильнее, обновляется автоматически и не зависит от глобального состояния Node.

Требования

  • macOS 12+ / Linux (любой современный дистрибутив) / Windows 10+
  • Терминал (Terminal.app, iTerm2, PowerShell, Windows Terminal)
  • Учётная запись Anthropic с подпиской Pro / Max или API-кредитами (тарифы)
  • Доступ в интернет

Установка на macOS / Linux

Одна команда в терминале:

curl -fsSL https://claude.ai/install.sh | bash

Установщик:

  1. Определяет ОС и архитектуру
  2. Скачивает native binary
  3. Кладёт в ~/.local/bin/claude (по умолчанию)
  4. Добавляет путь в PATH, если нужно

Через 30 секунд установка готова. Проверка:

claude --version

Установка на Windows

В PowerShell:

irm https://claude.ai/install.ps1 | iex

Логика та же — скачивание binary, добавление в PATH. После установки — проверка в новом окне PowerShell:

claude --version

Альтернатива — установка через WSL с использованием Linux-команды (через curl ... | bash). На WSL2 работает идентично macOS / Linux.

Авторизация

После установки нужно авторизоваться:

claude auth login

Что происходит:

  1. Команда открывает браузер на console.anthropic.com
  2. Авторизация — тем же аккаунтом, что используется для подписки Pro / Max или API
  3. Браузер возвращает one-time код
  4. Код вставляется обратно в терминал
  5. Готово, токен сохранён локально

Проверка авторизации:

claude auth whoami

Покажет email и активный план.

Первый запуск

В любой папке с проектом:

cd ~/my-project
claude

Открывается интерактивная REPL-сессия с агентом. Можно сразу описать задачу на естественном языке:

> найди все TODO в коде и собери список с указанием файла и строки

Claude прочитает проект, найдёт упоминания и выдаст структурированный список.

Базовая настройка проекта

Для лучшей работы агента — два конфигурационных шага.

1. CLAUDE.md в корне проекта

Создать файл CLAUDE.md в корне репозитория. Содержит контекст проекта: стек, конвенции, команды.

# Project Context

Next.js 16 + TypeScript + Prisma + Postgres.
Стиль: функциональные компоненты, без классов.
Тесты: Vitest. Линтер: ESLint.

## Команды
- `npm run dev` — локальный dev на порту 3000
- `npm run build` — продакшен-билд
- `npm run typecheck` — проверка TypeScript
- `npm test` — прогон тестов

## Конвенции
- Импорты через alias `@/`
- API-роуты — в `src/app/api/`
- Без `any`, всё типизировано

Claude читает этот файл на старте каждой сессии, чтобы понимать контекст проекта. Команда для быстрого создания шаблона:

claude /init

2. Permissions через .claude/settings.json

Файл .claude/settings.json в корне проекта (gitignore’ить или коммитить — на ваше усмотрение):

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git status)",
      "Bash(git diff)",
      "Bash(git log)",
      "Read(*)",
      "Edit(*)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force *)"
    ]
  }
}

allow — команды, которые Claude выполняет без подтверждения. deny — запрещённые команды (агент не запросит даже подтверждение).

Базовый дефолтный safe-list уже выставлен после установки. Но для удобства обычно стоит добавить специфичные команды проекта (build, test, lint).

Установка VS Code-расширения (опционально)

Если основная работа в VS Code — можно добавить визуальную интеграцию:

  1. В VS Code Extensions Marketplace — найти «Claude Code»
  2. Установить, перезапустить VS Code
  3. Authorize через ту же учётку Anthropic

Расширение добавляет панель управления Claude Code прямо в IDE: запуск задач, просмотр истории, управление сессиями. Терминальная версия продолжает работать параллельно.

Для JetBrains-семейства (IntelliJ, WebStorm, PyCharm и т.д.) есть аналогичный плагин.

Частые ошибки и решения

claude: command not found

После установки команда не найдена. Решение:

# Перезапустите терминал — путь добавляется в shell-профиль и нужен новый сеанс
# Либо вручную загрузите профиль
source ~/.bashrc    # bash
source ~/.zshrc     # zsh

Если не помогло — проверьте путь:

ls -la ~/.local/bin/claude
echo $PATH | grep -o "[^:]*/\.local/bin"

Если ~/.local/bin не в PATH — добавьте:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

claude auth login не открывает браузер

Иногда на Linux / WSL браузер не открывается автоматически. Скопируйте URL, который вывела команда, и откройте вручную. После авторизации код возвращается прямо в окно браузера — скопируйте и вставьте в терминал.

«Authentication failed» при авторизации

Проверить, что:

  • Авторизуетесь тем же аккаунтом, на котором куплена подписка
  • Подписка активна (не закончился annual период)
  • Если используете API — кредиты не нулевые

Лимиты исчерпаны

Если упёрлись в rate limits — варианты:

  • Подождать сброса (обычно несколько часов)
  • Апгрейдить план: Pro → Max 5x → Max 20x (детали)
  • Переключиться на pay-per-token API

Обновление

Native installer автоматически проверяет обновления. Принудительный апгрейд:

curl -fsSL https://claude.ai/install.sh | bash

Та же команда — она обновит binary до последней версии.

Удаление

Полное удаление:

# Удалить binary
rm ~/.local/bin/claude

# Удалить кэш и конфиги
rm -rf ~/.claude

# Очистить shell-профиль от добавленного PATH (если устанавливали в нестандартный путь)

После установки — что дальше

  1. Создать CLAUDE.md через claude /init или вручную
  2. Настроить .claude/settings.json под команды проекта
  3. Прочитать про Skills — кастомизация поведения агента
  4. Изучить slash-команды: /help, /clear, /review, /security-review
  5. Подключить MCP-серверы, если нужны внешние tool’ы (базы данных, API)

Главное — попробовать на реальной задаче: дать агенту нетривиальную работу («найди все случаи устаревшего API и замени на новый, прогони тесты, сделай commit») и посмотреть как он справится. Большинство выводов о тарифе и workflow становятся понятны после первой такой сессии.

FAQ

Как установить Claude Code на macOS? curl -fsSL https://claude.ai/install.sh | bash в Terminal. Установка ~30 секунд, затем claude auth login для авторизации через браузер.

Как установить Claude Code на Windows? irm https://claude.ai/install.ps1 | iex в PowerShell. После установки — claude auth login в новом окне PowerShell.

Можно ли установить через npm? Можно, но npm-метод официально deprecated. Анципация: использовать native binary через curl ... | bash или irm ... | iex. Более стабильный и автообновляемый путь.

Что делать если claude: command not found? Перезапустить терминал — путь добавляется в shell-профиль, нужен новый сеанс. Если не помогло — проверить $PATH на наличие ~/.local/bin и добавить вручную при необходимости.

Куда устанавливается Claude Code по умолчанию? В ~/.local/bin/claude (macOS / Linux). Конфиги — в ~/.claude/. На Windows — стандартный path для пользовательских binaries.

Нужен ли VPN? Для установки и работы — нет, серверы Anthropic доступны без VPN. Для оплаты подписки из России — да, нужна зарубежная карта.

Как обновить Claude Code до последней версии? Перезапустить installer: curl -fsSL https://claude.ai/install.sh | bash или irm https://claude.ai/install.ps1 | iex. Та же команда апгрейдит binary.

Можно ли использовать Claude Code без подписки? Нет. Free-план Claude не включает Claude Code. Нужен Pro ($20/мес) или выше, либо API-кредиты.

Как полностью удалить Claude Code? rm ~/.local/bin/claude (binary) + rm -rf ~/.claude (кэш и конфиги).

Связанные статьи