Интеграция Claude Code

Узнайте, как использовать Claude Code с AITUNNEL для доступа к различным моделям.

Мощный инструмент

Claude Code - это мощный агентный инструмент. Хотя вы можете использовать любую модель через AITUNNEL, мы рекомендуем использовать высокопроизводительные модели (такие как Claude Opus 4.5, GPT 5.2 и т.д.) для лучшего опыта, так как сложные задачи программирования требуют сильных рассуждений.

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

Это руководство поможет вам запустить Claude Code на базе AITUNNEL всего за несколько минут.

Шаг 1: Установка Claude Code

macOS, Linux, WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

npm

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

Требования для npm

Требуется Node.js 18 или новее.

Шаг 2: Подключение Claude к AITUNNEL

Вместо прямого входа через Anthropic, подключите Claude Code к AITUNNEL. Это требует настройки нескольких переменных окружения.

Требования:

1. Используйте https://api.aitunnel.ru в качестве базового URL
2. Предоставьте ваш API ключ AITUNNEL в качестве токена авторизации
3. Важно: Явно очистите API ключ Anthropic, чтобы предотвратить конфликты

Настройка через профиль оболочки

Добавьте эти переменные окружения в ваш профиль оболочки:

# Установите эти переменные в вашей оболочке (например, ~/.bashrc, ~/.zshrc)
export ANTHROPIC_BASE_URL="https://api.aitunnel.ru"
export ANTHROPIC_AUTH_TOKEN="$AITUNNEL_API_KEY"
export ANTHROPIC_API_KEY="" # Важно: Должен быть явно пустым

Постоянство

Мы рекомендуем добавить эти строки в ваш профиль оболочки (~/.bashrc, ~/.zshrc, или ~/.config/fish/config.fish).

Настройка через файл проекта

Альтернативно, вы можете настроить Claude Code используя файл настроек на уровне проекта .claude/settings.local.json в корне вашего проекта:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aitunnel.ru",
    "ANTHROPIC_AUTH_TOKEN": "<ваш-api-ключ-aitunnel>",
    "ANTHROPIC_API_KEY": ""
  }
}

Замените <ваш-api-ключ-aitunnel> на ваш реальный API ключ AITUNNEL.

Примечание

Этот метод сохраняет вашу конфигурацию в рамках проекта, что упрощает совместное использование настроек AITUNNEL с вашей командой через систему контроля версий (просто будьте осторожны, чтобы не закоммитить ваш API ключ).

Не используйте .env файлы

Не помещайте эти переменные в файл .env на уровне проекта. Нативный установщик Claude Code не читает стандартные файлы .env.

Шаг 3: Запуск сессии

Перейдите в директорию вашего проекта и запустите Claude Code:

cd /path/to/your/project
claude

Теперь вы подключены! Любой запрос будет маршрутизироваться через AITUNNEL.

Шаг 4: Проверка

Вы можете подтвердить ваше подключение, выполнив команду /status внутри Claude Code.

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://api.aitunnel.ru

Вы также можете проверить Панель активности AITUNNEL чтобы видеть ваши запросы в реальном времени.

Изменение моделей

По умолчанию Claude Code использует специфические псевдонимы моделей Anthropic (такие как "Sonnet", "Opus", "Haiku"). AITUNNEL автоматически сопоставляет их с правильными моделями Anthropic.

Переопределение моделей по умолчанию

Вы можете настроить Claude Code для использования любой модели на AITUNNEL (включая модели OpenAI, Google или Llama), переопределив псевдонимы моделей по умолчанию используя переменные окружения.

Например, чтобы заменить псевдоним "Sonnet" по умолчанию на GPT-5.1 Codex Max:

export ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.1-codex-max"

Вы также можете переопределить другие уровни:

export ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.2-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="gemini-2.0-flash-exp"

Совет

Хотя вы можете использовать любую модель, Claude Code глубоко полагается на агентное поведение (использование инструментов, точное форматирование). Для лучших результатов мы рекомендуем использовать высокопроизводительные модели с сильными возможностями использования инструментов.

Как это работает

AITUNNEL предоставляет интерфейс, совместимый с Anthropic Messages API.

1. Прямое подключение: Когда вы устанавливаете ANTHROPIC_BASE_URL на https://api.aitunnel.ru, Claude Code общается со своим нативным протоколом напрямую с AITUNNEL. Локальный прокси-сервер не требуется.
2. Совместимость с Anthropic: AITUNNEL ведет себя точно так же, как API Anthropic. Он обрабатывает сопоставление моделей и передает продвинутые функции, такие как блоки "Thinking" и нативное использование инструментов.
3. Биллинг: Вы оплачиваете используя кредиты AITUNNEL. Использование (включая токены рассуждений) отображается в вашей панели AITUNNEL.

GitHub Action

Вы можете использовать AITUNNEL с официальным Claude Code GitHub Action. Чтобы адаптировать пример workflow для AITUNNEL, внесите два изменения в шаг действия:

1. Передайте ваш API ключ AITUNNEL через anthropic_api_key (сохраните его как GitHub secret с именем AITUNNEL_API_KEY)
2. Установите переменную окружения ANTHROPIC_BASE_URL на https://api.aitunnel.ru

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.AITUNNEL_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://api.aitunnel.ru

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

Ошибки использования инструментов

Если вы видите ошибки о том, что использование инструментов не поддерживается, выбранная вами модель не поддерживает возможности использования инструментов. Claude Code требует использования инструментов для чтения файлов, выполнения команд и редактирования кода. Переключитесь на модель, которая поддерживает использование инструментов.

Ошибки авторизации

Убедитесь, что ANTHROPIC_API_KEY установлен в пустую строку (""). Если он не установлен (null), Claude Code может вернуться к поведению по умолчанию и попытаться аутентифицироваться на серверах Anthropic.

Ошибки длины контекста

Если вы переключаете задачи глубокого рассуждения на меньшие модели, вы можете столкнуться с лимитами контекста. Используйте модели с окном контекста не менее 128k для лучших результатов.

Приватность

AITUNNEL не логирует ваши промпты исходного кода.

Примеры использования

Базовое использование

# Установите переменные окружения
export ANTHROPIC_BASE_URL="https://api.aitunnel.ru"
export ANTHROPIC_AUTH_TOKEN="sk-aitunnel-xxx"
export ANTHROPIC_API_KEY=""

# Запустите Claude Code
cd /path/to/your/project
claude

Использование конкретной модели

# Используйте GPT-5.2 Pro вместо Sonnet
export ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.2-pro"
export ANTHROPIC_BASE_URL="https://api.aitunnel.ru"
export ANTHROPIC_AUTH_TOKEN="sk-aitunnel-xxx"
export ANTHROPIC_API_KEY=""

claude

Настройка через файл проекта

Создайте .claude/settings.local.json в корне вашего проекта:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aitunnel.ru",
    "ANTHROPIC_AUTH_TOKEN": "sk-aitunnel-xxx",
    "ANTHROPIC_API_KEY": ""
  }
}

Лучшие практики

1. Выбирайте подходящие модели: Используйте модели с сильными возможностями рассуждения для сложных задач программирования
2. Проверяйте поддержку инструментов: Убедитесь, что выбранная модель поддерживает использование инструментов
3. Управляйте контекстом: Используйте модели с большим окном контекста для больших проектов
4. Безопасность ключей: Никогда не коммитьте API ключи в систему контроля версий
5. Мониторинг использования: Регулярно проверяйте панель AITUNNEL для отслеживания использования

Дополнительные ресурсы

• Документация Claude Code
• Список моделей AITUNNEL
• Панель управления AITUNNEL