# Руководство по настройке Claude Code

> Установите Claude Code и подключите его к LLMoxy через CC Switch или переменные окружения, чтобы программировать в терминале с моделями Claude.

Claude Code — терминальный агент от Anthropic: он напрямую читает репозиторий, изменяет файлы и запускает команды. По умолчанию он подключается к официальному API, поэтому достаточно направить шлюз на LLMoxy.

Прежде чем начать, подготовьте [токен LLMoxy](https://ru.llmoxy.com/docs/get-started/get-token); рекомендуется группа **auto**.

## Установка

Лучше использовать официальный скрипт (npm больше не рекомендуется):

```bash
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
```

Также можно:

```bash
brew install --cask claude-code          # macOS
winget install Anthropic.ClaudeCode      # Windows
```

Проверка:

```bash
claude --version
```

## Подключение к LLMoxy

Claude Code работает через Anthropic-совместимый интерфейс, адрес указывается **без** `/v1`.

| Переменная | Значение |
| --- | --- |
| `ANTHROPIC_BASE_URL` | `https://llmoxy.com` |
| `ANTHROPIC_AUTH_TOKEN` | ваш LLMoxy API Key |

### Способ 1: CC Switch (рекомендуется)

Поставщиков можно переключать в графическом интерфейсе, не правя переменные окружения вручную. Загрузка и пошаговые скриншоты — в [инструкции по CC Switch](https://ru.llmoxy.com/docs/code-tutorials/cc-switch).

- Название поставщика: LLMoxy
- API Key: токен сайта
- Адрес запроса: `https://llmoxy.com`
- Основная модель: `claude-opus-5-5`

### Способ 2: переменные окружения

**macOS / Linux** (для Zsh — `~/.zshrc`, для Bash — `~/.bashrc`):

```bash
{
echo ''
echo '# LLMoxy'
echo 'export ANTHROPIC_BASE_URL="https://llmoxy.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="Ваш LLMoxy API Key"'
} >> ~/.zshrc
source ~/.zshrc
```

**Windows PowerShell** (после установки обязательно откройте новое окно):

```powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://llmoxy.com","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","Ваш LLMoxy API Key","User")
```

Проверка: `echo "$ANTHROPIC_BASE_URL"` должна вывести `https://llmoxy.com`.

## Запуск

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

```bash
claude
```

Введите `/model` и выберите только что настроенную модель (например, `claude-opus-5-5`). Введите `/`, чтобы увидеть все команды.

![Приветственный экран](https://ru.llmoxy.com/docs-assets/migrated/tutorial-claudecode-runoob/welcome.png)

![Слеш-команды](https://ru.llmoxy.com/docs-assets/migrated/tutorial-claudecode-runoob/slash.png)

По желанию выполните `claude doctor` для проверки окружения.

## Частые вопросы

**`claude: command not found`**
Убедитесь, что `claude --version` выводит результат, затем перезапустите терминал.

**Всё равно требуется вход в аккаунт Claude**
Убедитесь, что `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN` вступили в силу. После настройки собственного шлюза используется API Key, входить в claude.ai не нужно.

**Ошибка прав при глобальной установке через npm**
Не используйте `sudo npm install -g`. Воспользуйтесь официальным скриптом, Homebrew или nvm.

**Не удаётся подключиться**
Проверьте сеть командой `curl -I https://llmoxy.com`; если нужен прокси, задайте `HTTPS_PROXY`.

Это markdown-версия страницы https://ru.llmoxy.com/docs/code-tutorials/claude-code.
