Claude Code

Claude Code — терминальный агент для программирования от Anthropic. OdiRouter предоставляет API, совместимый с Anthropic Messages, поэтому Claude Code подключается напрямую без локального proxy.

Зачем использовать OdiRouter с Claude Code?

• Один API key: используйте один ключ OdiRouter в поддерживаемых моделях и инструментах разработчика.
• Управление моделями: назначайте точные ID моделей OdiRouter для ролей Opus, Sonnet, Haiku и sub-agent.
• Единый биллинг: использование Claude Code оплачивается с баланса OdiRouter.

Совместимость моделей

Claude Code оптимизирован для моделей Anthropic. Другие модели OdiRouter могут поддерживать не все функции Claude Code и сценарии tool use.

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

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

Нативная установка

macOS, Linux или WSL:

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

Windows PowerShell:

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

npm

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

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

Проверьте установку:

claude --version

Шаг 2: Получите API key OdiRouter

Войдите в OdiRouter и создайте API key. Настройка аккаунта, ключа и баланса описана в быстром старте.

Шаг 3: Подключите Claude Code к OdiRouter

Claude Code нужны Anthropic-совместимый Base URL OdiRouter и auth token. Явно оставьте ANTHROPIC_API_KEY пустым, чтобы старый ключ Anthropic не получил приоритет.

Профиль shell

Добавьте переменные в ~/.zshrc, ~/.bashrc или профиль используемого shell:

export ODIROUTER_API_KEY="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="https://api.odirouter.ai"
export ANTHROPIC_AUTH_TOKEN="$ODIROUTER_API_KEY"
export ANTHROPIC_API_KEY=""

После сохранения перезапустите терминал.

В Windows PowerShell задайте переменные уровня пользователя, затем откройте PowerShell заново:

[Environment]::SetEnvironmentVariable("ODIROUTER_API_KEY", "YOUR_API_KEY", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.odirouter.ai", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "", "User")

Настройки проекта

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.odirouter.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_API_KEY": ""
  }
}

Не сохраняйте настоящий API key в Git. Для общего репозитория используйте пользовательский файл настроек, менеджер переменных окружения или хранилище секретов.

Не используйте проектный .env

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

Шаг 4: Удалите сохраненный вход Anthropic

Если вы раньше входили в Claude Code через аккаунт Anthropic, запустите Claude Code и один раз выполните /logout:

> /logout

Закройте и снова запустите claude, чтобы загрузились переменные OdiRouter. Если вы никогда не входили через Anthropic, этот шаг можно пропустить.

Шаг 5: Запустите и проверьте

cd /path/to/your/project
claude

В Claude Code выполните:

> /status

В статусе должны отображаться ANTHROPIC_AUTH_TOKEN как источник авторизации и https://api.odirouter.ai как Anthropic Base URL.

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

1. Прямое подключение: Claude Code отправляет нативный протокол Anthropic напрямую в OdiRouter без локального сервиса преобразования.
2. Совместимость Messages: OdiRouter принимает запросы по адресу https://api.odirouter.ai/v1/messages и передает tool use и thinking blocks, если выбранная модель их поддерживает.
3. Биллинг OdiRouter: стоимость запросов списывается с баланса аккаунта OdiRouter.

Настройте модели

Claude Code поддерживает отдельные модели для задач класса Opus, Sonnet, Haiku и sub-agent. Используйте точные ID из GET https://api.odirouter.ai/v1/models.

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6"

Переменная	Назначение
ANTHROPIC_DEFAULT_OPUS_MODEL	Сложные рассуждения и задачи класса Opus
ANTHROPIC_DEFAULT_SONNET_MODEL	Обычные задачи программирования класса Sonnet
ANTHROPIC_DEFAULT_HAIKU_MODEL	Быстрые и легкие задачи класса Haiku
CLAUDE_CODE_SUBAGENT_MODEL	Задачи, делегированные sub-agent Claude Code

Используйте Claude Code GitHub Action

Официальный Claude Code GitHub Action поддерживает тот же endpoint. Сохраните ключ OdiRouter в секрете репозитория ODIROUTER_API_KEY:

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

Диагностика

Симптом	Решение
401 или invalid key	Убедитесь, что ANTHROPIC_AUTH_TOKEN содержит действительный API key OdiRouter
Claude Code все еще обращается к Anthropic	Задайте ANTHROPIC_API_KEY="", выполните /logout, перезапустите терминал и Claude Code
Model not found	Скопируйте точный ID модели из GET https://api.odirouter.ai/v1/models
Ошибка протокола или streaming	Используйте https://api.odirouter.ai как Base URL, а не полный endpoint /v1/messages
Изменения конфигурации не применяются	Проверьте JSON-синтаксис и перезапустите терминал или Claude Code
Ошибка длины контекста	Начните новую сессию, уменьшите задачу или выберите модель с большим контекстом