Claude Code

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

Требования

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

Установка Claude Code

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

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

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

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

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

macOS / Linux / WSL
Windows (нативно)

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

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

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

export ANTHROPIC_BASE_URL="https://speshu.ai/api"
export ANTHROPIC_AUTH_TOKEN="ваш-api-ключ"
export ANTHROPIC_API_KEY=""  # Важно: оставьте пустым

Замените ваш-api-ключ на ключ из личного кабинета.

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

source ~/.zshrc

Запустите Claude Code

cd /path/to/your/project
claude

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

Через settings.json (рекомендуется)
Через системные переменные (cmd.exe)
Через PowerShell

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

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

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

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

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

setx ANTHROPIC_BASE_URL "https://speshu.ai/api"
setx ANTHROPIC_AUTH_TOKEN "ваш-api-ключ"
setx ANTHROPIC_API_KEY ""

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

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

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

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

notepad $PROFILE

Вставьте:

$env:ANTHROPIC_BASE_URL = "https://speshu.ai/api"
$env:ANTHROPIC_AUTH_TOKEN = "ваш-api-ключ"
$env:ANTHROPIC_API_KEY = ""

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

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

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

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

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

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

macOS / Linux / WSL
Windows (cmd.exe)
Windows (settings.json)

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"

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"

{
    "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"
}
}

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

Полный список доступных моделей — в каталоге.

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

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

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

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

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

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

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

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

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

Ошибка аутентификации (401)

Убедитесь что ANTHROPIC_AUTH_TOKEN содержит ваш ключ SpeShu.AI
Проверьте что ANTHROPIC_API_KEY явно установлен в пустую строку ("")
Если ранее выполняли вход через Anthropic — выполните /logout внутри Claude Code

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)

Проблемы с интерфейсом на Windows (цвета, ввод, артефакты)

Claude Code лучше работает в cmd.exe, чем в PowerShell. Если интерфейс отображается с артефактами или не реагирует на клавиши:

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

Ошибка модели (model not found)

Убедитесь что модель доступна в каталоге SpeShu.AI
Проверьте правильность написания ID модели (например, anthropic/claude-sonnet-4.6)

Начало работы

Продвинутые настройки

Генерация медиа

Интеграции

Требования

Установка Claude Code

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

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

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

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

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

Начало работы

Продвинутые настройки

Генерация медиа

Интеграции

Documentation Index

​Требования

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

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

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

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

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

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

Требования

Установка Claude Code

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

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

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

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

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