Claude Code

Claude Code - официальный CLI-инструмент от Anthropic для работы с кодом прямо из терминала. Он умеет читать и редактировать файлы, запускать команды, работать с git и решать сложные задачи в несколько шагов.

Требования

• macOS, Linux, Windows (WSL) или Windows (нативно)
• Node.js 18 или новее
• API-ключ usellm

Установка Claude Code

npm install -g @anthropic-ai/claude-code

Или через официальный установщик (только macOS / Linux / WSL):

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

Подключение к usellm

Claude Code использует стандартный Anthropic API. Достаточно указать URL usellm в качестве базового адреса.

macOS / Linux / WSL

1. Откройте профиль оболочки:

nano ~/.zshrc   # zsh (macOS по умолчанию)
# или
nano ~/.bashrc  # bash

2. Добавьте переменные окружения:

export ANTHROPIC_BASE_URL="https://api.usellm.ru"
export ANTHROPIC_AUTH_TOKEN="ваш-api-ключ"
export ANTHROPIC_API_KEY=""  # Важно: оставьте пустым
export ANTHROPIC_MODEL="anthropic/claude-fable-5.1"  # Модель, на которой пойдёт сессия

Замените ваш-api-ключ на ключ из личного кабинета, а anthropic/claude-fable-5.1 - на любую модель из каталога usellm.

3. Перезапустите терминал:

source ~/.zshrc

4. Запустите Claude Code:

cd /path/to/your/project
claude

Windows (нативно)

На Windows Claude Code работает без WSL, через cmd.exe или PowerShell. Рекомендуем задавать переменные окружения через settings.json (проще и надёжнее) или через системные переменные Windows.

Через settings.json (рекомендуется)

Создайте или откройте файл %USERPROFILE%\.claude\settings.json и добавьте:

{
  "model": "anthropic/claude-fable-5.1",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.usellm.ru",
    "ANTHROPIC_AUTH_TOKEN": "ваш-api-ключ",
    "ANTHROPIC_API_KEY": ""
  }
}

Замените ваш-api-ключ на ключ из личного кабинета, а anthropic/claude-fable-5.1 - на любую модель из каталога usellm.

Обратите внимание на уровни вложенности: model - поле верхнего уровня, рядом с env, а не внутри него.

Это самый простой способ: ничего больше настраивать не нужно. Запустите проект:

cd C:\path\to\your\project
claude

Через системные переменные (cmd.exe)

Откройте cmd.exe и выполните:

setx ANTHROPIC_BASE_URL "https://api.usellm.ru"
setx ANTHROPIC_AUTH_TOKEN "ваш-api-ключ"
setx ANTHROPIC_API_KEY ""
setx ANTHROPIC_MODEL "anthropic/claude-fable-5.1"

После перезапуска cmd.exe:

cd C:\path\to\your\project
claude

Через PowerShell

Добавьте строки в профиль PowerShell ($PROFILE):

notepad $PROFILE

Вставьте:

$env:ANTHROPIC_BASE_URL = "https://api.usellm.ru"
$env:ANTHROPIC_AUTH_TOKEN = "ваш-api-ключ"
$env:ANTHROPIC_API_KEY = ""
$env:ANTHROPIC_MODEL = "anthropic/claude-fable-5.1"

Перезапустите PowerShell, затем:

cd C:\path\to\your\project
claude

Настройка моделей

Модель в Claude Code задаётся на трёх независимых уровнях, их легко перепутать:

• Основная модель сессии - то, чем вы работаете по умолчанию. Задаётся полем model в settings.json или переменной ANTHROPIC_MODEL.
• Раскрытие алиасов opus, sonnet, haiku - переменные ANTHROPIC_DEFAULT_*_MODEL. Они срабатывают только там, где модель выбрана именно алиасом: /model opus, режим планирования, определения субагентов.
• Модель субагентов - CLAUDE_CODE_SUBAGENT_MODEL.

macOS / Linux / WSL

export ANTHROPIC_MODEL="anthropic/claude-fable-5.1"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-fable-5.1"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-sonnet-5"
export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-sonnet-5"

Windows (cmd.exe)

setx ANTHROPIC_MODEL "anthropic/claude-fable-5.1"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "anthropic/claude-sonnet-5"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "anthropic/claude-fable-5.1"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "anthropic/claude-sonnet-5"
setx CLAUDE_CODE_SUBAGENT_MODEL "anthropic/claude-sonnet-5"

Windows (settings.json)

{
  "model": "anthropic/claude-fable-5.1",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.usellm.ru",
    "ANTHROPIC_AUTH_TOKEN": "ваш-api-ключ",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-fable-5.1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-sonnet-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "anthropic/claude-sonnet-5"
  }
}

Приоритет выбора модели

Если модель задана несколькими способами сразу, побеждает тот, что выше в списке:

1. /model <слаг> внутри сессии
2. флаг claude --model <слаг> при запуске
3. переменная ANTHROPIC_MODEL
4. поле model в settings.json
5. модель по умолчанию: переменная ANTHROPIC_DEFAULT_MODEL, а если её нет, то модель аккаунта

Настройка через settings.json

Можно настроить подключение и через файл конфигурации: это работает на всех платформах без изменения переменных окружения.

{
  "model": "anthropic/claude-fable-5.1",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.usellm.ru",
    "ANTHROPIC_AUTH_TOKEN": "ваш-api-ключ",
    "ANTHROPIC_API_KEY": ""
  }
}

После правки конфига полностью закройте и заново запустите claude: переменные окружения и settings.json читаются один раз, при старте.

Проверка подключения

После запуска выполните команду /status внутри сессии:

> /status
Auth token:          ANTHROPIC_AUTH_TOKEN
Anthropic base URL:  https://api.usellm.ru
Model:               anthropic/claude-fable-5.1

В строке Model должен стоять слаг usellm: значит, сессия действительно идёт на выбранной модели, а не только авторизация.

Решение проблем

Следующие шаги