Настройка Claude Code с AiBuy API

1. Быстрая диагностика

Если вы уже установили Claude Code и столкнулись с ошибкой, проверьте:

2. Правильный формат Base URL

Claude Code автоматически добавляет /v1/messages к указанному Base URL. Поэтому не добавляйте /v1 вручную:

export ANTHROPIC_BASE_URL="https://api.quantadev.pro/v1"

export ANTHROPIC_BASE_URL="https://api.quantadev.pro"

3. Настройка через settings.json (рекомендуется)

Создайте файл ~/.claude/settings.json — настройка действует глобально для всех проектов:

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.quantadev.pro",
    "ANTHROPIC_API_KEY": "sk-ваш-ключ"
  }
}
EOF

Приоритет конфигурации

4. Настройка через переменные окружения

Для быстрой проверки или временного использования выполните в терминале:

export ANTHROPIC_BASE_URL="https://api.quantadev.pro"
export ANTHROPIC_API_KEY="sk-ваш-ключ"
claude

Постоянная настройка (через shell-профиль)

# Для zsh (macOS по умолчанию)
echo 'export ANTHROPIC_BASE_URL="https://api.quantadev.pro"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-ваш-ключ"' >> ~/.zshrc
source ~/.zshrc

# Для bash
echo 'export ANTHROPIC_BASE_URL="https://api.quantadev.pro"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-ваш-ключ"' >> ~/.bashrc
source ~/.bashrc

5. Настройка моделей по умолчанию

Claude Code автоматически определяет модель. Вы можете задать конкретные имена для каждого уровня:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.quantadev.pro",
    "ANTHROPIC_API_KEY": "sk-ваш-ключ",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7"
  }
}

Это гарантирует, что Claude Code не будет пытаться использовать встроенные имена, которые могут отличаться от имён в вашем сервисе-прокси.

6. Доступные модели

Стандартные модели

Модели с расширенным рассуждением (Thinking)

Добавьте суффикс -thinking к имени модели для активации режима глубокого логического анализа:

7. Переключение моделей в Claude Code

В чате Claude Code введите:

/model

Если список пуст или неполный — введите название модели вручную (например, claude-sonnet-4-5).

8. Настройка для разных проектов

Создайте .claude/settings.json в корне проекта — он переопределит глобальные настройки:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.quantadev.pro",
    "ANTHROPIC_API_KEY": "sk-ключ-для-этого-проекта"
  }
}

Добавьте .claude/settings.json в .gitignore, чтобы не закоммитить ключ.

9. Настройка в Windows

Проще всего использовать settings.json:

// Путь: C:\Users\ВашеИмя\.claude\settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.quantadev.pro",
    "ANTHROPIC_API_KEY": "sk-ваш-ключ"
  }
}

В PowerShell для временной настройки:

$env:ANTHROPIC_BASE_URL = "https://api.quantadev.pro"
$env:ANTHROPIC_API_KEY = "sk-ваш-ключ"
claude

10. Чек-лист проверки

# Шаг 1: Проверьте переменные
echo "Base URL: $ANTHROPIC_BASE_URL"
echo "API Key: ${ANTHROPIC_API_KEY:0:10}..."

# Шаг 2: Проверьте доступность API
curl -s https://api.quantadev.pro/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" | head -c 200

# Шаг 3: Запустите Claude Code
claude

# Введите /status для проверки подключения

11. Решение проблем

Claude Code не запускается после настройки

• Проверьте формат JSON — нет ли лишней запятой после последнего поля
• Используйте латинские кавычки "", не «ёлочки»
• Проверьте JSON: cat ~/.claude/settings.json | python3 -m json.tool

Invalid API key

• Проверьте, нет ли пробелов в начале или конце ключа
• Получите новый ключ через @AIBuybuks_bot
• Проверьте приоритет переменных: env | grep ANTHROPIC

Ошибка top_p deprecated

После обновления Claude Code может появиться ошибка top_p is deprecated. Решение — обновиться до последней версии или использовать OpenAI-совместимые инструменты, которые не передают этот параметр.

Странное форматирование ответов

• Проверьте работу прокси через curl: curl -s https://api.quantadev.pro/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer sk-..." -d '{"model":"claude-sonnet-4-5","messages":[{"role":"user","content":"Hi"}]}'
• Используйте /v1/chat/completions (OpenAI-формат) для проверки работоспособности

12. Альтернативы Claude Code

Если Claude Code не работает с нашим API, используйте инструменты с полной поддержкой OpenAI-формата:

• Cline — VS Code-расширение, AI-агент в редакторе
• Roo Code — форк Cline с режимами
• OpenCode — CLI-агент с открытым кодом
• Aider — pair-programming в терминале
• Continue.dev — плагин для VS Code / JetBrains
• Cursor — AI-редактор кода

Подробные инструкции по настройке — на странице Интеграции.