Подготовка
Перед началом убедитесь, что у вас есть:-
Установленный Claude Code
Установите Claude Code CLI через npm или pnpm:
Или посетите официальную документацию Claude Code для получения актуальных инструкций.
-
API-ключ ToAPIs
Войдите в консоль ToAPIs для получения API-ключа (начинается с
sk-).
Настройка
Claude Code поддерживает несколько способов настройки пользовательского API-эндпоинта. Вы можете указать ToAPIs в качестве альтернативного бэкенда для Anthropic API. Claude Code использует два отдельных JSON-файла: состояние onboarding и переменные окружения должны находиться в соответствующем файле, чтобы настройки вступили в силу.Убедитесь, что onboarding завершён
В домашнем каталоге создайте или отредактируйте файл~/.claude.json:
settings.json ниже.
Способ 1: settings.json (рекомендуется)
Настройте переменные окружения в ~/.claude/settings.json (глобально) или .claude/settings.json (уровень проекта). Изменять конфигурацию оболочки не требуется:
~/.claude/settings.json.
Настройка уровня проекта (применяется только к текущему проекту):
Создайте .claude/settings.json в корне проекта. Не включайте API-ключ в конфигурацию уровня проекта: храните ANTHROPIC_AUTH_TOKEN в глобальной конфигурации, на уровне проекта задавайте только ANTHROPIC_BASE_URL:
Примечание: ПолеhasCompletedOnboardingуказывайте в~/.claude.json, блокenv— в~/.claude/settings.jsonили.claude/settings.json. Не смешивайте их в одном файле.
Способ 2: Переменные окружения
Подходит для временного использования или CI/CD-сред.macOS / Linux
Временная настройка для текущей сессии:~/.bashrc или ~/.zshrc:
Windows
Временная настройка в PowerShell:Способ 3: Файл .env
Создайте файл .env в корне вашего проекта:
.env в .gitignore, чтобы не допустить утечки API-ключа.
Справочник по настройке
| Переменная | Значение |
|---|---|
| ANTHROPIC_AUTH_TOKEN | Ваш API-ключ ToAPIs (sk-xxxxxxxxxxxx) |
| ANTHROPIC_BASE_URL | https://toapis.com |
Проверка настройки
Запустите следующую команду для проверки установки:Рекомендуемые модели
Следующие модели Claude доступны через ToAPIs:| Название модели | ID модели | Описание |
|---|---|---|
| Claude Opus 4.6 | claude-opus-4-6 | Наиболее мощная, лучше всего для сложных задач |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | Баланс производительности и скорости — рекомендуется для ежедневного использования |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 | Самая быстрая, лучше всего для лёгких задач |
/model внутри Claude Code или параметр --model при запуске:
Устранение неполадок
Authentication error или 401 Unauthorized?
- Убедитесь, что
ANTHROPIC_AUTH_TOKENзадан корректно и начинается сsk- - Проверьте активность ключа в консоли ToAPIs
- Убедитесь, что на вашем счету достаточно средств
Connection refused или невозможно подключиться?
- Убедитесь, что
ANTHROPIC_BASE_URLустановлен какhttps://toapis.com - Проверьте сетевое подключение и доступность
https://toapis.com
Проверка текущих переменных окружения
Распространённые коды ошибок
| Ошибка | Причина | Решение |
|---|---|---|
401 Unauthorized | Недействительный или просроченный API-токен | Создайте новый API-ключ |
429 Too Many Requests | Превышен лимит запросов | Подождите немного и повторите |
500 Internal Server Error | Временная проблема на сервере | Повторите через несколько минут |
insufficient_quota | Недостаточно средств на счету | Пополните баланс в консоли |
Советы
1. Запуск в директории проекта
Перейдите в папку проекта и запустите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)