Skip to main content
Это руководство посвящено Claude Code CLI. Вы настроите адрес сервиса, API-ключ и доступную модель Claude, а затем проверите первый диалог в терминале.

​
Перед началом

​
Настройка Claude Code

1

Установите Claude Code

В терминале macOS, Linux или WSL выполните официальную команду установки:
В Windows PowerShell:
Затем выполните claude --version. Если команда не найдена, откройте терминал заново и проверьте PATH по подсказкам установщика.
2

Проверьте настройки для ключа

Войдите на aibal.ai, в списке API-ключей откройте Использовать ключ, выберите Claude Code и свою операционную систему. Проверьте адрес и полный идентификатор поддерживаемой модели Claude. Замените YOUR_AVAILABLE_CLAUDE_MODEL_ID в примерах ниже.
3

Укажите адрес, ключ и модель

В Bash или Zsh выполните команды и вставьте ключ по запросу скрытого ввода:
В Windows PowerShell:
Не добавляйте /v1/messages к базовому адресу. Если Использовать ключ показывает отдельный путь для группы, сохраните указанный там полный базовый адрес.
4

Запустите клиент и проверьте подключение

В том же терминале перейдите в папку проекта и выполните claude. Завершите начальную настройку, затем введите /status. Убедитесь, что Anthropic base URL указывает на aibal.ai, а источник учётных данных — ANTHROPIC_AUTH_TOKEN.
5

Отправьте первое сообщение

Введите:
Получив ответ, проверьте модель, время и стоимость в Истории использования aibal.ai. Проверочный запрос может быть платным; до начала работы уточните баланс и лимит ключа.

​
Назначение трёх переменных

Эти временные переменные действуют в текущем терминале. В новом терминале задайте их повторно. Для сохранения и переключения настроек через графический интерфейс используйте cc-switch. Не помещайте настоящий ключ в настройки проекта, которые попадут в Git.

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

​
Клиент по-прежнему предлагает войти в прежний аккаунт

Проверьте адрес и источник учётных данных через /status. Одного адреса без ключа недостаточно. Проверьте, не конфликтуют ли ANTHROPIC_API_KEY, apiKeyHelper или значения в файлах настроек. Оставьте нужный источник и перезапустите клиент.

​
Переменные не действуют в VS Code или приложении для компьютера

Переменные терминала передаются только запущенным из него дочерним процессам. Это руководство относится к CLI. У расширения VS Code и приложения для компьютера свои настройки; используйте официальную инструкцию подключения к шлюзу.

​
Основная модель работает, а другая модель или подзадача — нет

Разным моделям могут требоваться разные права группы. Не считайте стандартные псевдонимы Sonnet, Opus и Haiku автоматически доступными. Используйте точные идентификаторы из консоли; при необходимости сопоставления моделей следуйте разделу Использовать ключ.

​
Ошибка 401, 404, 429 или недостаточно квоты

Проверьте соответственно ключ, лишний /v1 в адресе, ограничения параллельных запросов и частоты, а также баланс или квоту ключа. Не повторяйте многократно задачи, которые могут оплачиваться. Подробнее — в обзоре интеграций.

​
Безопасность ключей и дальнейшие действия

Не отправляйте модели настоящие ключи и не делитесь скриншотами терминала или настроек с ключами. При утечке отключите старый ключ в консоли, создайте новый и обновите настройки. После подключения поручите Claude Code небольшую понятную задачу, например объяснить файл. Перед изменениями убедитесь, что у проекта есть резервная копия или система контроля версий. Источники: официальная установка, официальное подключение к шлюзу.