Настройка Claude Code: использование в Китае, прокси и адрес API, основные переменные окружения

Использование в Китае: подключение к шлюзу без VPN

# ~/.zshrc / ~/.bashrc / PowerShell 配置文件
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=你的网关密钥
claude

Claude Code, как и официальный SDK, читает эти две переменные. Запросы отправляются на шлюз, а не на api.anthropic.com, поэтому из Китая можно подключаться напрямую. Укажите только домен, без /v1. После настройки откройте терминал заново и в сеансе используйте /status для проверки. Расширение VS Code и настольное приложение читают окружение той оболочки, из которой они запущены. После изменения конфигурации полностью закройте редактор и запустите его из нового терминала.

Когда нужен прокси

Только если ваша сеть не обеспечивает стабильное соединение даже с самим шлюзом. Настройка такая же, как у других инструментов командной строки:

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

Если /login не удаётся войти через OAuth из-за тайм-аута («timeout of 15000ms exceeded»), скорее всего, проблема в прокси или DNS; вход с помощью ключа API позволяет полностью обойти OAuth.

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

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

Claude Code использует уровни моделей (Sonnet / Opus / Haiku), а эти три переменные определяют, какая конкретная модель соответствует каждому уровню. Уровень Haiku важнее, чем кажется: Claude Code использует его для небольших задач в каждом сеансе, и выбор недорогой модели позволяет заметно сэкономить. Сейчас шлюз предоставляет 33 идентификаторов моделей Claude; выбрать их можно в/model .

Где находятся файлы конфигурации

• CLAUDE.md(в корне проекта) — память проекта: команды сборки и тестирования, соглашения;CLAUDE.local.md — личные заметки, которые не добавляются в репозиторий.
• .claude/settings.json(для проекта) / ~/.claude/settings.json(глобально) — разрешения, хуки, переменные окружения, statusLine.
• .claude/agents/ — определения субагентов;.claude/skills/ и ~/.claude/skills/ — навыки.
• .mcp.json — общая для проекта конфигурация серверов MCP.

Устранение ошибок конфигурации

• 404, а в журнале появляется /v1/v1/messages → в BASE_URL лишний фрагмент /v1。
• 401 / недействительный ключ → ключ не соответствует адресу: для адреса шлюза нужен ключ шлюза.
• Вы вошли в Max, но оплата списывается за токены → в окружении осталась переменная ANTHROPIC_API_KEY; ключ имеет приоритет перед входом в аккаунт. Если он не нужен, удалите переменную командой unset.
• Модель не существует → этого идентификатора нет в списке /v1/models текущей конечной точки.
• После изменения settings.json приложение сразу закрывается при запуске → ошибка синтаксиса JSON (лишняя запятая); проверьте файл валидатором.

Стоимость

После подключения к шлюзу меняется и тарификация: средства на балансе продаются с коэффициентом 7.69231 к номиналу — за $13 вы получаете $100 на балансе; для интенсивного использования доступны безлимитные тарифы от $0.80. Подробности — на странице цен.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Частые вопросы

AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.