ai2saveai2save

Claude Code Руководство по настройке

Claude Code использует протокол Anthropic Messages. При подключении к ai2save в поле адреса указывайте корневой адрес сайта https://ai2save.com, не добавляйте /v1 вручную; ключ используйте тот, который создан в консоли ai2save как sk-....

1. Подготовка API Key

  1. Откройте https://ai2save.com/keys.
  2. Нажмите «Создать ключ», укажите имя и выберите группу, включающую модель Claude.
  3. После создания сразу скопируйте полный Key. Полный Key отображается только один раз.

2. Установка Claude Code

Сначала выполните установку среды Node.js, затем выполните:

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

Если версия ниже требований шлюза, обновите согласно инструкциям:

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

3. Временное включение для текущего терминала

macOS / Linux / WSL:

export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-ваш-api-ключ"
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-ваш-api-ключ"
claude

ANTHROPIC_AUTH_TOKEN является специальной переменной для ключа промежуточной станции. Не устанавливайте ANTHROPIC_API_KEY как другой официальный ключ одновременно, чтобы избежать считывания Claude Code неверных учетных данных.

4. Запись конфигурационного файла Claude Code (рекомендуется)

Редактируйте ~/.claude/settings.json (в Windows обычно в %USERPROFILE%\.claude\settings.json):

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai2save.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-ваш-api-ключ"
  }
}

После сохранения закройте и снова откройте терминал, затем запустите claude. Если хотите, чтобы это действовало только для одного проекта, запишите тот же самый контент в .claude/settings.local.json внутри проекта, не отправляйте реальный ключ в Git.

5. Выберите модель и подтвердите

claude --model claude-sonnet-4-6

После входа в интерактивный интерфейс:

  1. Введите короткий вопрос, например «Привет, расскажи немного о себе».
  2. Если отображается нормальный ответ, это означает, что адрес, ключ и группа моделей подключены.
  3. При необходимости переключения модели используйте /model, ID модели должен совпадать с ID, открытым в консоли.

Также можно сначала использовать встроенную диагностику Claude Code, чтобы проверить состояние конфигурации:

/status
/doctor

6. Множественные конфигурации и очистка старых настроек

Если раньше вы входили в официального Claude или другие промежуточные станции:

  • Предпочтительно использовать CC Switch для управления несколькими поставщиками, чтобы избежать ручного ввода неправильной конфигурации.
  • При ручной настройке убедитесь, что старые ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY не переопределяют текущие значения.
  • WSL и Windows — это две разные среды; после настройки в Windows на терминале, WSL также требует отдельной конфигурации.

Временная очистка в macOS / Linux:

unset ANTHROPIC_API_KEY

Частые ошибки

  • 401 / invalid_api_key: ключ не скопирован полностью, отозван или группа ключей не содержит текущую модель.
  • 404 / model not found: неверный ID модели или для этой группы ключей модель не доступна.
  • Сбой соединения: Base URL написан как https://ai2save.com/v1 вызовет ошибку; Claude Code нужно заменить на https://ai2save.com.
  • Все еще обращается к официальному адресу: проверьте, нет ли старого адреса в ~/.claude/settings.json, проекте .claude/settings.local.json и переменных окружения терминала.
  • Не работает после открытия в Windows: полностью закройте терминал, VS Code или Claude Desktop и откройте заново.