Настройка Claude Code

Подготовка

Перед началом убедитесь, что у вас есть:

Установленный 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 для получения актуальных инструкций.
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_URL	`https://toapis.com`

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

Запустите следующую команду для проверки установки:

claude --version

Затем запустите Claude Code:

claude

Если всё настроено верно, Claude Code подключится через 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`	Самая быстрая, лучше всего для лёгких задач

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

`Authentication error` или `401 Unauthorized`?

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

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

Убедитесь, что ANTHROPIC_BASE_URL установлен как https://toapis.com
Проверьте сетевое подключение и доступность 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)

Обзор

Быстрый старт

API чата

API изображений

API видео

Управление задачами

Загрузка файлов

Аккаунт

Часто задаваемые вопросы

Подготовка

Настройка

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

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

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

macOS / Linux

Windows

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

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

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

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

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

`Authentication error` или `401 Unauthorized`?

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

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

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

Советы

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

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

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

Поддержка

​Подготовка

​Настройка

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

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

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

​macOS / Linux

​Windows

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

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

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

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

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

​Authentication error или 401 Unauthorized?

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

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

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

​Советы

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

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

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

​Поддержка

Подготовка

Настройка

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

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

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

macOS / Linux

Windows

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

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

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

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

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

`Authentication error` или `401 Unauthorized`?

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

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

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

Советы

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

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

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

Поддержка