> ## Documentation Index
> Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Подключение Claude Code к SpeShu.AI — полноценный AI-ассистент для разработчиков с отслеживанием расходов

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

## Требования

* macOS, Linux, Windows (WSL) или Windows (нативно)
* Node.js 18 или новее
* API-ключ [speshu.ai](https://speshu.ai/profile)

## Установка Claude Code

```bash theme={null} theme={null}
npm install -g @anthropic-ai/claude-code
```

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

```bash theme={null} theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

## Подключение к SpeShu.AI

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

<Tabs>
  <Tab title="macOS / Linux / WSL">
    <Steps>
      <Step title="Откройте профиль оболочки">
        ```bash theme={null} theme={null}
        nano ~/.zshrc   # zsh (macOS по умолчанию)
        # или
        nano ~/.bashrc  # bash
        ```
      </Step>

      <Step title="Добавьте переменные окружения">
        ```bash theme={null} theme={null}
        export ANTHROPIC_BASE_URL="https://speshu.ai/api"
        export ANTHROPIC_AUTH_TOKEN="ваш-api-ключ"
        export ANTHROPIC_API_KEY=""  # Важно: оставьте пустым
        ```

        Замените `ваш-api-ключ` на ключ из [личного кабинета](https://speshu.ai/profile).
      </Step>

      <Step title="Перезапустите терминал">
        ```bash theme={null} theme={null}
        source ~/.zshrc
        ```
      </Step>

      <Step title="Запустите Claude Code">
        ```bash theme={null} theme={null}
        cd /path/to/your/project
        claude
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windows (нативно)">
    На Windows Claude Code работает без WSL — через **cmd.exe** или PowerShell. Рекомендуем задавать переменные окружения через `settings.json` (проще и надёжнее) или через системные переменные Windows.

    <Tabs>
      <Tab title="Через settings.json (рекомендуется)">
        Создайте или откройте файл `%USERPROFILE%\.claude\settings.json` и добавьте:

        ```json theme={null} theme={null}
        {
            "env": {
            "ANTHROPIC_BASE_URL": "https://speshu.ai/api",
            "ANTHROPIC_AUTH_TOKEN": "ваш-api-ключ",
            "ANTHROPIC_API_KEY": ""
        }
        }
        ```

        Замените `ваш-api-ключ` на ключ из [личного кабинета](https://speshu.ai/profile).

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

        ```cmd theme={null} theme={null}
        cd C:\path\to\your\project
        claude
        ```
      </Tab>

      <Tab title="Через системные переменные (cmd.exe)">
        Откройте **cmd.exe** и выполните:

        ```cmd theme={null} theme={null}
        setx ANTHROPIC_BASE_URL "https://speshu.ai/api"
        setx ANTHROPIC_AUTH_TOKEN "ваш-api-ключ"
        setx ANTHROPIC_API_KEY ""
        ```

        <Warning>
          `setx` записывает переменные постоянно, но они применяются только в **новом** окне cmd.exe. Текущую сессию нужно перезапустить.
        </Warning>

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

        ```cmd theme={null} theme={null}
        cd C:\path\to\your\project
        claude
        ```
      </Tab>

      <Tab title="Через PowerShell">
        Добавьте строки в профиль PowerShell (`$PROFILE`):

        ```powershell theme={null} theme={null}
        notepad $PROFILE
        ```

        Вставьте:

        ```powershell theme={null} theme={null}
        $env:ANTHROPIC_BASE_URL = "https://speshu.ai/api"
        $env:ANTHROPIC_AUTH_TOKEN = "ваш-api-ключ"
        $env:ANTHROPIC_API_KEY = ""
        ```

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

        ```powershell theme={null} theme={null}
        cd C:\path\to\your\project
        claude
        ```

        <Note>
          Некоторые функции Claude Code (интерактивный ввод, цвета терминала) работают лучше в **cmd.exe**, чем в PowerShell. Если возникают проблемы с интерфейсом — запускайте через cmd.exe.
        </Note>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

<Warning>
  Переменная `ANTHROPIC_API_KEY=""` должна быть явно пустой строкой. Если она не установлена, Claude Code попытается подключиться к серверам Anthropic напрямую.
</Warning>

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

По умолчанию Claude Code использует семейство моделей Claude. Вы можете переключить любую роль на любую модель из каталога SpeShu.AI.

<Tabs>
  <Tab title="macOS / Linux / WSL">
    ```bash theme={null} theme={null}
    export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.6"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"
    export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-sonnet-4.6"
    ```
  </Tab>

  <Tab title="Windows (cmd.exe)">
    ```cmd theme={null} theme={null}
    setx ANTHROPIC_DEFAULT_SONNET_MODEL "anthropic/claude-sonnet-4.6"
    setx ANTHROPIC_DEFAULT_OPUS_MODEL "anthropic/claude-opus-4.6"
    setx ANTHROPIC_DEFAULT_HAIKU_MODEL "anthropic/claude-haiku-4.5"
    setx CLAUDE_CODE_SUBAGENT_MODEL "anthropic/claude-sonnet-4.6"
    ```
  </Tab>

  <Tab title="Windows (settings.json)">
    ```json theme={null} theme={null}
    {
        "env": {
        "ANTHROPIC_BASE_URL": "https://speshu.ai/api",
        "ANTHROPIC_AUTH_TOKEN": "ваш-api-ключ",
        "ANTHROPIC_API_KEY": "",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
        "CLAUDE_CODE_SUBAGENT_MODEL": "anthropic/claude-sonnet-4.6"
    }
    }
    ```
  </Tab>
</Tabs>

| Переменная                       | Применяется для                   |
| -------------------------------- | --------------------------------- |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Основные задачи (код, анализ)     |
| `ANTHROPIC_DEFAULT_OPUS_MODEL`   | Сложные и ресурсоёмкие задачи     |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL`  | Быстрые операции и автодополнение |
| `CLAUDE_CODE_SUBAGENT_MODEL`     | Субагенты внутри сессии           |

Полный список доступных моделей — в [каталоге](/api-reference/models/list).

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

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

| Платформа       | Путь к файлу                          |
| --------------- | ------------------------------------- |
| macOS / Linux   | `~/.claude/settings.json`             |
| Windows         | `%USERPROFILE%\.claude\settings.json` |
| Проект (все ОС) | `.claude/settings.local.json`         |

```json theme={null} theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://speshu.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "ваш-api-ключ",
    "ANTHROPIC_API_KEY": ""
  }
}
```

<Warning>
  Не добавляйте `settings.local.json` с API-ключом в git-репозиторий. Добавьте файл в `.gitignore`.
</Warning>

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

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

```
> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://speshu.ai/api
```

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

<AccordionGroup>
  <Accordion title="Ошибка аутентификации (401)">
    * Убедитесь что `ANTHROPIC_AUTH_TOKEN` содержит ваш ключ SpeShu.AI
    * Проверьте что `ANTHROPIC_API_KEY` явно установлен в пустую строку (`""`)
    * Если ранее выполняли вход через Anthropic — выполните `/logout` внутри Claude Code
  </Accordion>

  <Accordion title="Claude Code не видит переменные окружения">
    * **macOS / Linux:** перезапустите терминал после изменения профиля оболочки, проверьте: `echo $ANTHROPIC_BASE_URL`
    * **Windows (setx):** `setx` применяется только в **новом** окне cmd.exe — текущую сессию нужно закрыть и открыть заново
    * **Windows (PowerShell):** переменные могут не передаваться в дочерние процессы — используйте `settings.json` вместо профиля PowerShell
    * Самый надёжный способ на любой платформе — прописать переменные в `~/.claude/settings.json` (macOS/Linux) или `%USERPROFILE%\.claude\settings.json` (Windows)
  </Accordion>

  <Accordion title="Проблемы с интерфейсом на Windows (цвета, ввод, артефакты)">
    Claude Code лучше работает в **cmd.exe**, чем в PowerShell. Если интерфейс отображается с артефактами или не реагирует на клавиши:

    * Запускайте `claude` из **cmd.exe**, а не из PowerShell или Windows Terminal с PowerShell-профилем
    * В Windows Terminal можно добавить профиль cmd.exe и запускать сессии через него
    * Как альтернатива — использовать WSL с bash/zsh
  </Accordion>

  <Accordion title="Ошибка модели (model not found)">
    * Убедитесь что модель доступна в [каталоге SpeShu.AI](/api-reference/models/list)
    * Проверьте правильность написания ID модели (например, `anthropic/claude-sonnet-4.6`)
  </Accordion>
</AccordionGroup>