Если вы пишете код в 2026 году, с Claude Code вы, скорее всего, уже знакомы. Это официальный CLI от Anthropic, который превращает Claude в напарника для программиста: он живёт в терминале, читает репозиторий, запускает тесты и правит файлы. За два года итераций он стал для большой части индустрии агентным инструментом по умолчанию и оставил позади IDE-ассистентов начала 2020-х.
Шероховатость у него одна: оплата. Прямой API Anthropic требует корпоративную карту США или Европы, помесячный счёт и аккаунт в Console. Такой аккаунт неудобно делить на команду, а из стран, где форма с картой просто не отправляется, он вообще не открывается. codexkey убирает это трение. Модели Claude те же, Anthropic-совместимый эндпоинт тот же, а платить можно по факту: криптой, картой или через СБП. Настройка занимает 5 минут, контракта нет, минимального ежемесячного платежа тоже.
Гайд проводит через полную настройку на macOS, Linux и Windows. В нём есть GUI-установщик, постоянная конфигурация через settings.json, выбор модели, учёт расходов и короткий список ошибок, которые встречаются при первом запуске.
Зачем гонять Claude Code через codexkey
Три причины, начиная с самой частой:
- Аккаунт Anthropic с биллингом не нужен. Ни корпоративная карта США, ни подписка на Console не требуются. Пополните баланс codexkey тем способом оплаты, который работает в вашей стране, и пользуйтесь Claude Code в ту же минуту.
- Понятная цена за токен. codexkey повторяет ставки Anthropic один к одному по каждой модели. Вы платите ровно за использованные токены, в дашборде виден каждый запрос с разбивкой input/output/cache, и в счёте нет ничего лишнего.
- Один ключ на весь стек. Ключ
sk_cdx_...подходит для Claude Code, для Python- и TypeScript-SDK от Anthropic, для Claude Agent SDK и для любого OpenAI-совместимого клиента, который говорит на/v1/messagesили/v1/chat/completions. Одно пополнение, один журнал расходов, все инструменты.
Если аккаунт Anthropic у вас уже есть и устраивает, пользуйтесь им дальше. codexkey нужен разработчикам и командам, которым Claude Code требуется без бюрократических обходных путей.
Шаг 1: Установить Claude Code
Claude Code распространяется как отдельный бинарник и как npm-пакет. Берите то, что ближе к вашему workflow.
npm (везде, где есть Node ≥ 18):
npm install -g @anthropic-ai/claude-code
Установщик для macOS / Linux (Node не нужен):
curl -fsSL https://claude.ai/install.sh | sh
GUI-установщик для Windows: скачайте claude-code-setup.exe на официальной странице Claude Code и запустите. Он добавит claude в PATH и создаст ярлык в меню «Пуск».
Проверьте установку:
claude --version
Ответ будет примерно такой: claude-code 2.x.x. Команда не найдена? Перезапустите шелл, чтобы подхватился новый PATH.
Шаг 2: Направить Claude Code на codexkey
Куда слать запросы и какие модели брать, Claude Code узнаёт из переменных окружения:
ANTHROPIC_BASE_URL: хост API. По умолчанию это боевой эндпоинт Anthropic. Чтобы работать через codexkey, укажитеhttps://api.codexkey.ru.ANTHROPIC_AUTH_TOKEN: ваш ключ. Любое значениеsk-ant-...замените ключомsk_cdx_...из дашборда codexkey.ANTHROPIC_DEFAULT_OPUS_MODEL,ANTHROPIC_DEFAULT_SONNET_MODEL,ANTHROPIC_DEFAULT_HAIKU_MODEL: модели для алиасовopus,sonnetиhaiku. Без них Claude Code запрашивает собственные модели по умолчанию и отвечает «There's an issue with the selected model».
macOS / Linux (zsh или bash):
export ANTHROPIC_BASE_URL="https://api.codexkey.ru"
export ANTHROPIC_AUTH_TOKEN="sk_cdx_yourkeyhere"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-sonnet-5"
Чтобы настройки стали постоянными, добавьте эти строки в ~/.zshrc, ~/.bashrc или ~/.config/fish/config.fish.
Windows PowerShell (текущая сессия):
$env:ANTHROPIC_BASE_URL = "https://api.codexkey.ru"
$env:ANTHROPIC_AUTH_TOKEN = "sk_cdx_yourkeyhere"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-sonnet-5"
Windows PowerShell (постоянно, переживёт перезагрузку):
setx ANTHROPIC_BASE_URL "https://api.codexkey.ru"
setx ANTHROPIC_AUTH_TOKEN "sk_cdx_yourkeyhere"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-5-5[1m]"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-5[1m]"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-sonnet-5"
setx пишет в окружение пользователя, поэтому закройте терминал и откройте заново, иначе новые значения не подхватятся. Если удобнее GUI, зайдите в Свойства системы → Дополнительно → Переменные среды и добавьте записи в Переменные пользователя. Так обычно делают коллеги без технического бэкграунда, результат тот же.
Шаг 3: Проверить соединение
Откройте новый терминал, чтобы переменные загрузились, и выполните:
claude --version
claude /status
claude /status делает реальный запрос к настроенному базовому URL и печатает активную модель, аккаунт и префикс ключа. Видите в выводе api.codexkey.ru и ненулевой баланс? Значит, всё готово.
Чтобы проверить всю цепочку целиком, отправьте разовый промпт:
claude -p "Суммируй diff в этом репо с момента main."
Подход через settings.json (рекомендуется для команд)
Переменных окружения хватает одному разработчику на одной машине. Командам и машинам, где настройка должна пережить смену шелла, лучше подойдёт settings.json Claude Code. На macOS и Linux файл лежит в ~/.claude/settings.json, на Windows в %USERPROFILE%\.claude\settings.json.
{
"apiBaseUrl": "https://api.codexkey.ru",
"apiKey": "sk_cdx_yourkeyhere",
"defaultModel": "claude-sonnet-5",
"telemetry": false
}
CLI читает settings.json при каждом запуске, поэтому модель можно сменить, а ключ перевыпустить, не трогая профиль шелла. На общих рабочих станциях поставьте файлу права 600, чтобы другие пользователи машины не прочли ваш ключ.
Выбор модели
По умолчанию Claude Code работает на Sonnet 4.6. Для примерно 90% задач это верный выбор: рефакторинг, генерация тестов, ревью кода, правки сразу в нескольких файлах, отладка. Sonnet достаточно быстр, чтобы работа ощущалась интерактивной, и достаточно дёшев, чтобы длинные сессии не пугали.
Для действительно сложного, будь то архитектурный дизайн, охота за запутанным багом в большой кодовой базе или случай, когда один вызов Opus заменяет пять повторов Sonnet, переключайтесь на Opus по требованию:
claude --model claude-opus-4.8 -p "Спроектируй стратегию шардинга для этой таблицы."
Haiku у нас есть: в каталоге claude-haiku-5.5 и claude-haiku-4.5, цены на странице моделей. Они работают в канале Premium, в канале Cheap Haiku нет.
Для частой работы с низкими ставками (правки линта, переписывание документации, генерация коммит-сообщений) опуститесь до gpt-5.6-luna:
claude --model gpt-5.6-luna -p "Перепиши это коммит-сообщение."
Модель можно менять и в интерактивной сессии: введите /model и выберите из списка.
Отслеживание расходов
Каждый запрос к api.codexkey.ru через несколько секунд появляется в дашборде codexkey. В записи видно:
- timestamp и request ID,
- использованную модель,
- input-токены, output-токены и кэшированные input-токены,
- точную долларовую стоимость вызова,
- API-ключ, с которого сделан вызов (удобно, когда на разные машины или разным людям из команды выданы разные ключи).
Записи можно фильтровать по диапазону дат, модели и ключу, а журнал выгружать в CSV для бухгалтерии. Ежемесячных счетов нет, минимума нет, неожиданных списаний тоже. Когда баланс доходит до нуля, следующий запрос возвращает 402, и вы пополняете счёт.
Траблшутинг
Ошибки, которые чаще всего встречаются в первый день:
401 Unauthorized: ключ неверный или просрочен. Убедитесь, чтоANTHROPIC_AUTH_TOKENначинается сsk_cdx_и совпадает со значением в дашборде. Если ключ недавно перевыпускали, старый уже не работает.429 Too Many Requests: вы упёрлись в лимит запросов в минуту. Подождите несколько секунд и повторите. Тяжёлые параллельные агенты должны учитывать заголовокRetry-After.402 Payment Required: баланс исчерпан. Пополните его в дашборде.502 Bad Gatewayи сетевые таймауты: временная проблема на стороне апстрима. Прежде чем отлаживать свой код, загляните на страницу статуса.- Команда
claudeне найдена после установки: перезапустите шелл, чтобы подхватить новыйPATH. На Windows после GUI-установщика перелогиньтесь.
Итог
От npm install до первого claude /status через codexkey проходит пять минут. Две переменные окружения или один settings.json, и Claude Code работает с оплатой, которая вам действительно подходит.
Полный справочник со всеми флагами, полями конфига и поддерживаемыми моделями: документация codexkey по Claude Code.