Claude Code Руководство по настройке
Claude Code использует протокол Anthropic Messages. При подключении к ai2save в поле адреса указывайте корневой адрес сайта https://ai2save.com, не добавляйте /v1 вручную; ключ используйте тот, который создан в консоли ai2save как sk-....
1. Подготовка API Key
- Откройте https://ai2save.com/keys.
- Нажмите «Создать ключ», укажите имя и выберите группу, включающую модель Claude.
- После создания сразу скопируйте полный 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
После входа в интерактивный интерфейс:
- Введите короткий вопрос, например «Привет, расскажи немного о себе».
- Если отображается нормальный ответ, это означает, что адрес, ключ и группа моделей подключены.
- При необходимости переключения модели используйте
/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 и откройте заново.