Claude Code API: ключ, Base URL и полное подключение (2026)

Claude Code — консольный инструмент программирования от Anthropic, предназначенный для чтения кода, правок, запуска тестов и рефакторинга прямо в терминале. По умолчанию он обращается к API Anthropic, поэтому разработчики в Китае часто сталкиваются с тремя проблемами: нестабильный доступ к официальному интерфейсу, ограниченные способы оплаты и сложность управления командными квотами и расходами.

ZSQH AI Gateway предоставляет единый вход API: достаточно одного API-ключа, чтобы через совместимый интерфейс вызывать Claude и другие распространённые модели. Ниже — полный путь от регистрации и создания ключа до настройки Base URL и первого запуска.

Примечание: версии Claude Code обновляются быстро, имена переменных окружения и пунктов меню могут меняться. Примеры отражают распространённую версию на октябрь 2026 года; сверяйтесь с claude --help и официальной документацией.

1. Какой интерфейс использует Claude Code

По умолчанию Claude Code работает через Anthropic Messages API, а не через OpenAI Chat Completions. Для подключения к стороннему шлюзу нужно подготовить три вещи:

Base URL: адрес интерфейса, например https://ai.zhongshangqihang.com.
API Key: токен, созданный в консоли ZSQH, обычно начинается с sk-.
Имя модели: например claude-sonnet-4-5 или claude-opus-4-1; ориентируйтесь на имена, показанные на странице цен.

Если вы используете OpenAI SDK или другой OpenAI-совместимый инструмент, Base URL обычно указывается как https://ai.zhongshangqihang.com/v1. Claude Code при работе по протоколу Anthropic обычно получает корневой адрес и сам добавляет /v1/messages.

2. Подготовка аккаунта и API-ключа

1. Регистрация и вход

Откройте ZSQH AI Gateway, зарегистрируйте аккаунт и войдите в консоль.

2. Создание API-ключа

Перейдите на страницу «API-ключи» в консоли и создайте новый ключ. Рекомендуется:

Указать назначение в имени, например claude-code-work-pc.
Задать лимит расходов, чтобы утечка ключа не привела к большому списанию.
Задать срок действия, чтобы неиспользуемый ключ автоматически отключался.
Сразу скопировать и сохранить ключ: обычно полное значение показывается только один раз.

3. Проверка баланса

Убедитесь в наличии средств на странице «Кошелёк» или «Пополнение». Модели тарифицируются по-разному; конкретные цены смотрите на странице цены на модели.

3. Настройка Claude Code

Вариант A: переменные окружения macOS / Linux

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

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-ваш-ключ"
claude

Если нужно, чтобы настройки применялись при каждом открытии терминала, добавьте эти две строки в ~/.zshrc или ~/.bashrc, затем выполните source ~/.zshrc.

Вариант B: Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
$env:ANTHROPIC_API_KEY="sk-ваш-ключ"
claude

Вариант C: клиент требует AUTH_TOKEN

Некоторые сторонние клиенты и конфигурации прокси используют ANTHROPIC_AUTH_TOKEN вместо ANTHROPIC_API_KEY:

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_AUTH_TOKEN="sk-ваш-ключ"

Если присутствуют обе переменные, оставьте одну согласно документации клиента, чтобы избежать конфликта заголовков аутентификации. Разные версии Claude Code поддерживают имена переменных неодинаково; при 401 проверяйте это в первую очередь.

Вариант D: настройка на уровне проекта

Если не хочется менять глобальное окружение, можно передавать переменные через .env или скрипт запуска в каталоге проекта. Не коммитьте .env в Git:

# .env.local (не коммитить)
ANTHROPIC_BASE_URL=https://ai.zhongshangqihang.com
ANTHROPIC_API_KEY=sk-ваш-ключ

Затем загрузите файл перед запуском Claude Code. Способ загрузки зависит от оболочки; действуйте по правилам проекта.

4. Выбор модели

Линейка Claude обычно делится на три уровня: Opus, Sonnet и Haiku:

Уровень	Подходящие задачи	Особенности
Opus	Сложный рефакторинг, длинные агентные цепочки, трудные рассуждения	Наибольшие возможности, обычно самая высокая цена
Sonnet	Повседневное написание кода, исправление ошибок, ревью	Баланс возможностей и стоимости
Haiku	Простое дополнение, пакетные задачи, недорогие вызовы	Высокая скорость, обычно ниже цена

В Claude Code модель задаётся параметром или переменной окружения. Фактически доступные имена смотрите на странице цены на модели; при несуществующем имени обычно возвращается model not found.

5. Первый вызов и диагностика

После настройки запустите в каталоге проекта:

claude

Затем дайте простую задачу, например «объясни структуру каталогов этого проекта». Если ответ приходит нормально, значит Base URL, ключ и модель настроены верно.

Типичные ошибки:

Ошибка	Возможная причина	Что делать
`401 Unauthorized`	Неверный или просроченный ключ, не то имя переменной	Скопируйте ключ заново; проверьте `ANTHROPIC_API_KEY` / `ANTHROPIC_AUTH_TOKEN`
`404 Not Found`	В Base URL лишний или отсутствующий `/v1`	Claude Code использует корневой адрес; OpenAI SDK — `/v1`
`model not found`	Модель не существует или не открыта	Скопируйте актуальное имя со страницы цен
`429 Too Many Requests`	Превышен параллелизм или частота	Снизьте нагрузку, повторите позже; проверьте лимит ключа
`insufficient quota`	Недостаточно средств	Пополните баланс и повторите
Зависание или тайм-аут	Проблемы сети или прокси	Проверьте сеть, DNS и настройки прокси

6. Как контролировать расходы и квоты

Расходы Claude Code складываются из входных и выходных токенов, а также длинного контекста и кэширования. Начать стоит с нескольких действий:

Создавайте отдельный ключ для каждого проекта, задавайте лимит и срок действия.
Простые задачи выполняйте на Sonnet или Haiku, Opus подключайте для сложных.
Не отправляйте весь большой репозиторий в контекст сразу: сначала попросите Claude Code прочитать нужные файлы.
Регулярно просматривайте журнал расходов, находите самые затратные проекты и модели.
В команде используйте единый шлюз, чтобы раздельно управлять участниками, ключами, лимитами и счетами.

Конкретные цены и правила тарификации смотрите на странице цены на модели. Цены меняются вместе с версиями моделей и политикой вышестоящих поставщиков; в статье намеренно нет фиксированных цифр, чтобы она не устарела.

7. Рекомендации по безопасности

Не встраивайте API-ключ в код, скриншоты, Git-репозиторий или публичную документацию.
Задавайте ключу лимит расходов и срок действия.
При подозрении на утечку сразу удаляйте старый ключ и создавайте новый.
В команде — один ключ на человека, так проще аудит и отключение.
Для производства и тестов используйте разные ключи.

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

Claude Code и Claude API — это одно и то же?

Нет. Claude Code — инструмент программирования, Claude API — интерфейс модели. Claude Code вызывает модель через API; на Claude API можно также строить собственные приложения.

Можно ли использовать ключ ZSQH напрямую в Claude Code?

Да, при условии, что клиент использует Anthropic-совместимый протокол, а Base URL, ключ и имя модели настроены правильно. Точные требования смотрите в инструкции на сайте и в документации текущей версии клиента.

Почему рекомендуется шлюз, а не прямое официальное подключение?

Ценность шлюза — единый вход, единый биллинг, управление лимитами, прозрачный расход и переключение моделей. Для команд и работы из Китая это обычно удобнее, чем отдельные официальные аккаунты для каждого участника.

Нужно ли устанавливать Node.js?

Claude Code обычно устанавливается через npm и требует окружения Node.js. Способ установки смотрите в официальной документации.

Что дальше

Если аккаунта ещё нет, зарегистрируйтесь в ZSQH AI Gateway, создайте тестовый ключ и настройте первый запуск по этой статье. При вопросах к имени модели или тарификации сначала откройте цены на модели, затем проверьте журнал расходов в консоли.