Встановлення, авторизація, оновлення та діагностика

Встановлення ще не означає готовність

Після інсталяції важливо перевірити весь ланцюжок: shell знаходить CLI, Claude запускається в правильному каталозі, авторизація працює, а команди виконуються в тому самому середовищі, де лежить проєкт.

Найчастіші причини проблем — PATH, різні shell, WSL проти Windows-native, термінал IDE з іншими налаштуваннями або запуск не з кореня репозиторію.

Канал встановлення залежить від середовища

Оберіть один офіційний спосіб і надалі оновлюйте Claude тим самим каналом. Команди нижче — орієнтири; актуальний синтаксис варто звіряти через офіційну документацію та `claude --help`.

brew install --cask claude-code
# або
npm install -g @anthropic-ai/claude-code
# або офіційний інсталятор
curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex
# або
npm install -g @anthropic-ai/claude-code

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

Перший запуск і діагностика

1. Відкрийте новий термінал у середовищі проєкту.
2. Перейдіть до кореня репозиторію.
3. Перевірте версію CLI.
4. Запустіть інтерактивну сесію Claude Code.
5. Виконайте /doctor, а потім /status.
6. Збережіть короткий лог початкового стану.

cd ~/projects/commerce-os
claude --version
claude

/doctor
/status

Авторизація та Gateway

Вигляд входу може залежати від типу облікового доступу. Після авторизації перевірте `/status`, щоб зрозуміти, який акаунт і яке середовище використовує сесія.

Для навчального Gateway конфігурація може зберігатися у глобальному `~/.claude/settings.json`, а локальні параметри — у `.claude/settings.local.json`. Проєктні значення можуть мати вищий пріоритет.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm.javarush.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_COURSE_TOKEN",
    "ANTHROPIC_MODEL": "claude-course-fast[1m]",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Оновлення та типові несправності

• Після оновлення перевірте claude --version, відкрийте нову сесію та повторіть /doctor.
• Якщо команда не знайдена, перезапустіть термінал і перевірте PATH та канал встановлення.
• Якщо CLI працює лише в одному терміналі, порівняйте shell і PATH у звичайному та IDE-терміналі.
• Якщо Claude не бачить проєкт, перевірте поточний каталог, корінь Git і середовище запуску.
• Якщо не працює SSH або контейнер, перевірте інсталяцію саме на сервері чи всередині контейнера.

Дата:
Проєкт:
Каталог:
ОС:
Shell:
Версія Claude CLI:
Авторизація:
Результат /doctor:
Результат /status:
Примітки: