Перейти к основному содержанию

Подготовка

Перед началом убедитесь, что у вас есть:
  1. Установленный Claude Code Установите Claude Code CLI через npm или pnpm:
    # npm
    npm install -g @anthropic-ai/claude-code
    
    # pnpm
    pnpm install -g @anthropic-ai/claude-code
    
    Или посетите официальную документацию Claude Code для получения актуальных инструкций.
  2. API-ключ ToAPIs Войдите в консоль ToAPIs для получения API-ключа (начинается с sk-).
Примечание: Если у вас ещё нет аккаунта ToAPIs, сначала зарегистрируйтесь на ToAPIs.

Настройка

Claude Code поддерживает несколько способов настройки пользовательского API-эндпоинта. Вы можете указать ToAPIs в качестве альтернативного бэкенда для Anthropic API. Claude Code использует два отдельных JSON-файла: состояние onboarding и переменные окружения должны находиться в соответствующем файле, чтобы настройки вступили в силу.

Убедитесь, что onboarding завершён

В домашнем каталоге создайте или отредактируйте файл ~/.claude.json:
{
  "hasCompletedOnboarding": true
}
Этот файл используется только для состояния CLI. API-токен и base URL задавайте в settings.json ниже.

Способ 1: settings.json (рекомендуется)

Настройте переменные окружения в ~/.claude/settings.json (глобально) или .claude/settings.json (уровень проекта). Изменять конфигурацию оболочки не требуется:
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://toapis.com"
  }
}
Глобальная настройка (применяется ко всем проектам — рекомендуется):
mkdir -p ~/.claude
Затем запишите приведённый выше JSON в ~/.claude/settings.json. Настройка уровня проекта (применяется только к текущему проекту): Создайте .claude/settings.json в корне проекта. Не включайте API-ключ в конфигурацию уровня проекта: храните ANTHROPIC_AUTH_TOKEN в глобальной конфигурации, на уровне проекта задавайте только ANTHROPIC_BASE_URL:
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://toapis.com"
  }
}
Примечание: Поле hasCompletedOnboarding указывайте в ~/.claude.json, блок env — в ~/.claude/settings.json или .claude/settings.json. Не смешивайте их в одном файле.

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

Подходит для временного использования или CI/CD-сред.

macOS / Linux

Временная настройка для текущей сессии:
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://toapis.com"
claude
Постоянная настройка — добавьте в ~/.bashrc или ~/.zshrc:
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://toapis.com"
Затем перезагрузите оболочку:
source ~/.zshrc  # или source ~/.bashrc

Windows

Временная настройка в PowerShell:
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxx"
$env:ANTHROPIC_BASE_URL = "https://toapis.com"
claude
Постоянная настройка (уровень пользователя):
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxxxxxx", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://toapis.com", "User")

Способ 3: Файл .env

Создайте файл .env в корне вашего проекта:
ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxx
ANTHROPIC_BASE_URL=https://toapis.com
Важно: Добавьте .env в .gitignore, чтобы не допустить утечки API-ключа.

Справочник по настройке

ПеременнаяЗначение
ANTHROPIC_AUTH_TOKENВаш API-ключ ToAPIs (sk-xxxxxxxxxxxx)
ANTHROPIC_BASE_URLhttps://toapis.com

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

Запустите следующую команду для проверки установки:
claude --version
Затем запустите Claude Code:
claude
Если всё настроено верно, Claude Code подключится через ToAPIs и будет отвечать в штатном режиме.

Рекомендуемые модели

Следующие модели Claude доступны через ToAPIs:
Название моделиID моделиОписание
Claude Opus 4.6claude-opus-4-6Наиболее мощная, лучше всего для сложных задач
Claude Sonnet 4.6claude-sonnet-4-6Баланс производительности и скорости — рекомендуется для ежедневного использования
Claude Haiku 4.5claude-haiku-4-5-20251001Самая быстрая, лучше всего для лёгких задач
Для смены модели используйте команду /model внутри Claude Code или параметр --model при запуске:
claude --model claude-sonnet-4-6

Устранение неполадок

Authentication error или 401 Unauthorized?

  1. Убедитесь, что ANTHROPIC_AUTH_TOKEN задан корректно и начинается с sk-
  2. Проверьте активность ключа в консоли ToAPIs
  3. Убедитесь, что на вашем счету достаточно средств

Connection refused или невозможно подключиться?

  1. Убедитесь, что ANTHROPIC_BASE_URL установлен как https://toapis.com
  2. Проверьте сетевое подключение и доступность https://toapis.com

Проверка текущих переменных окружения

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

Распространённые коды ошибок

ОшибкаПричинаРешение
401 UnauthorizedНедействительный или просроченный API-токенСоздайте новый API-ключ
429 Too Many RequestsПревышен лимит запросовПодождите немного и повторите
500 Internal Server ErrorВременная проблема на сервереПовторите через несколько минут
insufficient_quotaНедостаточно средств на счетуПополните баланс в консоли

Советы

1. Запуск в директории проекта

Перейдите в папку проекта и запустите claude — он автоматически подхватит контекст проекта:
cd /your/project
claude

2. Полезные команды

КомандаОписание
/helpПоказать справку
/modelСменить модель
/clearОчистить текущий диалог
/exit или Ctrl+CВыйти из Claude Code

3. Работа с кодом

Claude Code умеет читать и изменять файлы проекта. Основные сценарии использования:
  • Код-ревью — попросите Claude Code проверить ваш код и предложить улучшения
  • Генерация кода — опишите задачу, Claude Code напишет код напрямую в файлы
  • Отладка — вставьте сообщение об ошибке и получите конкретные рекомендации
  • Рефакторинг — попросите Claude Code улучшить структуру кода

Поддержка

Если у вас возникли проблемы:
[## Начните работу с ToAPIs Зарегистрируйтесь в ToAPIs, получите API-ключ и ускорьте разработку с Claude Code!](https://toapis.com)