Зачем читать эту статью?

Вы слышали восторженные отзывы о Claude Code, но при попытке разобраться столкнулись с упоминаниями OpenRouter, переменными окружения и скриншотами терминала? Чувствуете, что все пропустили какой-то шаг и сразу перешли к жаргону? Эта статья — тот самый пропущенный шаг. Мы разберём всё медленно и подробно, чтобы вы не просто копировали команды, а понимали, что происходит.

Что такое Claude Code и OpenRouter?

Claude Code — это терминальный ИИ-агент от Anthropic. Он читает ваши файлы, редактирует код и выполняет команды. По умолчанию он общается напрямую с серверами Anthropic.

OpenRouter — это коммутатор для ИИ-моделей. Вместо того чтобы каждому приложению настраивать отдельное подключение к каждому провайдеру ИИ, OpenRouter находится посередине и позволяет направлять запросы к разным моделям через один аккаунт, одну панель управления и одно место для контроля расходов. Там есть даже бесплатные и открытые модели!

Важное предупреждение: в документации OpenRouter сказано, что эта связка гарантированно работает только с моделями Anthropic. Вы не заменяете мозг Клода, а лишь перенаправляете канал, по которому он общается.

Краткий словарь: «OpenAI-совместимый»

Claude Code отправляет запросы в формате Anthropic. Некоторые серверы понимают только формат OpenAI. Если вы по ошибке укажете такой сервер, получите непонятные ошибки — как если бы отправили письмо на французском тому, кто читает только по-испански. У OpenRouter есть эндпоинт, который нативно говорит на языке Anthropic, поэтому перевод и отдельный прокси не нужны.

Как узнать, какой у вас шелл: zsh или bash?

Этот вопрос останавливает новичков чаще всего. Проверка займёт десять секунд. Откройте терминал и выполните:

echo $SHELL

Вы получите один из ответов:

Если путь заканчивается на /zsh (например, /bin/zsh) — у вас zsh (стандарт для современных Mac).
Если путь заканчивается на /bash (например, /bin/bash) — у вас bash (часто на старых Mac, многих Linux-системах и в WSL).

В зависимости от результата вы будете редактировать файл:

Для zsh — ~/.zshrc
Для bash — ~/.bashrc

Пошаговая настройка

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

Выполните в терминале:

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

Шаг 2. Получите API-ключ OpenRouter

Зарегистрируйтесь на openrouter.ai, создайте ключ и пополните баланс.

Шаг 3. Добавьте переменные окружения

Откройте файл, который вы определили ранее (~/.zshrc или ~/.bashrc), и добавьте в конец:

export OPENROUTER_API_KEY="ваш-openrouter-api-ключ"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""

Последняя строка — не опечатка. Старое значение может вызывать путаницу в авторизации. Также разместите эти строки в конце файла, иначе если OPENROUTER_API_KEY будет переопределён позже, токен молча станет пустым.

Если вы предпочитаете хранить настройки в проекте, используйте файл настроек:

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

Шаг 4. Очистите старый вход

Выполните в терминале:

/logout

Затем полностью перезапустите Claude Code.

Шаг 5. Запустите Claude Code

cd /путь/к/вашему/проекту
claude

Шаг 6. Проверьте, что всё работает

Введите:

/status

Должны отобразиться ANTHROPIC_AUTH_TOKEN и базовый URL OpenRouter. Также загляните в панель активности OpenRouter — наблюдать за запросами довольно увлекательно.

Практический вывод

Установите Claude Code, получите ключ OpenRouter, пропишите четыре переменные окружения в нужный файл, выполните /logout, перезапустите и проверьте через /status. На всё уйдёт десять минут. Сначала используйте модели Claude, а когда поймёте, как выглядит рабочая конфигурация, можете экспериментировать с другими.

Claude Code + OpenRouter: настройка за 10 минут