Документация / Быстрый старт / Переменные окружения

Переменные окружения

Как настроить переменные окружения, чтобы Claude Code, Codex, Gemini и другие AI-инструменты для кодинга подключались к QCode.cc: основные переменные, таблица по инструментам, где их задавать и как проверить

Переменные окружения

⚡ Ещё не настроили? Одна команда: curl -fsSL https://qcode.cc/install/claude-code.sh | bash (Windows: irm https://qcode.cc/install/claude-code.ps1 | iex). См. Скрипт установки в один клик.

Почти все AI-инструменты для кодинга решают, «к какому сервису подключаться и какой ключ использовать», через переменные окружения. Направьте эти две части информации на QCode.cc — и инструмент начнёт отправлять запросы к нам. На этой странице объясняется, какие переменные задавать, где их задавать и как проверить.

📖 Не уверены, должен ли BASE_URL оканчиваться на /api или другой префикс? Какой из доменов доступа выбрать? Сначала прочитайте Точки доступа и форматы API. Ещё не установили инструменты? См. Установку.

1. Две основные переменные (Claude Code и Anthropic SDK)

Для подключения к моделям семейства Claude нужны всего две переменные окружения:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_ваш_ключ"
  • ANTHROPIC_BASE_URL — адрес доступа, до префикса /api включительно. SDK автоматически добавит /v1/messages.
  • ANTHROPIC_AUTH_TOKEN — ваш ключ QCode.cc, начинающийся с cr_, создаётся в панели QCode.cc.

О AUTH_TOKEN: это внутренняя договорённость сервиса — ключ ретранслятора всегда помещается в ANTHROPIC_AUTH_TOKEN (а не в ANTHROPIC_API_KEY, который предназначен для прямого официального доступа). Claude Code отправляет его как Bearer-токен. Если ваш инструмент распознаёт только ANTHROPIC_API_KEY, тот же ключ cr_ можно указать там — он будет работать.

⚠️ Без завершающего слэша: используйте https://api.qcode.cc/api, а не https://api.qcode.cc/api/. SDK добавляет /v1/messages, поэтому лишний слэш превращается в //v1/messages и возвращает 404.

Эти две переменные работают как для Claude Code, так и для официальных SDK Anthropic (Python / TypeScript) — SDK также читает ANTHROPIC_BASE_URL либо принимает base_url= при создании клиента.

2. Таблица по инструментам

Разные инструменты читают разные переменные окружения. Найдите свой:

Инструмент Переменные окружения Значение
Claude Code ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN		 https://api.qcode.cc/api
cr_ваш_ключ
Anthropic SDK (Python/JS) ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN		 https://api.qcode.cc/api
cr_ваш_ключ
Codex CLI base_url в конфигурации ~/.codex https://api.qcode.cc/openai
OpenAI-совместимые инструменты OPENAI_BASE_URL
OPENAI_API_KEY		 https://api.qcode.cc/openai/v1
cr_ваш_ключ
Gemini / Antigravity base URL https://api.qcode.cc/gemini

Несколько замечаний:

  • Codex CLI не использует OPENAI_BASE_URL для определения вышестоящего сервера; он берёт base_url из конфигурационного файла ~/.codex (до /openai, протокол OpenAI Responses). Точный синтаксис см. в Точках доступа и форматах API.
  • OpenAI-совместимые инструменты (официальный OpenAI SDK, LangChain, универсальные клиенты) читают OPENAI_BASE_URL и OPENAI_API_KEY, base оканчивается на /openai/v1.
  • Gemini / Antigravity: base оканчивается на /gemini; SDK сам добавляет /v1beta/. Тот же ключ cr_ работает.

Один ключ для всех трёх протоколов: ваш ключ cr_ не зависит от протокола — /api это Anthropic, /openai/v1 это OpenAI, /gemini это Google Gemini. При смене инструмента меняется только BASE_URL, ключ остаётся прежним.

Доступные модели

После подключения выберите имя модели согласно протоколу вашего инструмента (подробнее в Точках доступа и форматах API):

  • Модели Claude: claude-opus-4-8, claude-opus-4-7 (оба 1M контекст), claude-sonnet-5 (1M, новое поколение), claude-sonnet-4-6 (1M), claude-fable-5 (1M, топовый флагман), claude-haiku-4-5 (200K)
  • Семейство GPT: gpt-5.6-terra (рекомендуется), gpt-5.6-sol, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.6-mini, gpt-5.6-nano
  • Семейство Gemini: gemini-2.5-pro, gemini-3.5-flash, gemini-2.5-flash
  • Изображения: gpt-image-2 (точка доступа https://api.qcode.cc/qcode-img/v1)

Длина контекста Claude Code: по умолчанию окно 200K; опциональный контекст 1M поддерживают claude-opus-4-8, claude-sonnet-4-6, claude-sonnet-5 и claude-fable-5.

3. Где задавать

Место установки переменной окружения определяет её область действия. Три распространённых способа:

① Файл конфигурации шелла (постоянно, глобально) — впишите её в ~/.zshrc (macOS / zsh) или ~/.bashrc (Linux / bash), чтобы каждый новый терминал подхватывал её автоматически:

echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="cr_ваш_ключ"' >> ~/.zshrc
source ~/.zshrc

Пользователи bash заменяют ~/.zshrc на ~/.bashrc.

② Файл .env проекта (постоянно, по проекту) — положите файл .env в корень проекта; он применяется только к этому проекту, что удобно для разных ключей в разных проектах:

ANTHROPIC_BASE_URL=https://api.qcode.cc/api
ANTHROPIC_AUTH_TOKEN=cr_ваш_ключ

.env содержит ваш ключ — не забудьте добавить его в .gitignore и никогда не коммитить в репозиторий.

③ Собственные настройки инструмента (по инструменту) — у некоторых инструментов есть свой конфигурационный файл или интерфейс, например ~/.codex у Codex CLI или панель настроек плагина редактора. Такие настройки применяются только к этому инструменту.

Постоянно vs на сессию: все три способа выше — постоянные. Если нужно просто что-то попробовать в текущей сессии терминала, используйте export (macOS/Linux) или $env: (Windows PowerShell) — оно исчезнет при закрытии терминала:

# macOS / Linux, на сессию
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_ваш_ключ"

# Windows PowerShell, на сессию
$env:ANTHROPIC_BASE_URL = "https://api.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "cr_ваш_ключ"

Замечание о приоритете: переменные окружения, считанные при запуске процесса, имеют приоритет над файлами конфигурации. После редактирования файла шелла выполните source или откройте новый терминал; если одна и та же переменная задана в нескольких местах, побеждает та, которую процесс фактически унаследовал.

4. 🇨🇳 Примечание для пользователей из КНР

Пользователям из материкового Китая рекомендуется заменить хост в BASE_URL с api.qcode.cc на asia.qcode.cc (узел в Гонконге, географически ближайший, минимальная задержка):

export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_ваш_ключ"

То же касается других протоколов: OpenAI-совместимые инструменты используют https://asia.qcode.cc/openai/v1, Codex — https://asia.qcode.cc/openai, Gemini — https://asia.qcode.cc/gemini. Все четыре домена доступа обладают идентичными возможностями; один и тот же ключ работает на всех, поэтому при нестабильности asia вернитесь к api.qcode.cc (глобальная маршрутизация Route 53). См. Точки доступа и форматы API.

5. Проверка

После установки переменных сначала убедитесь, что значения корректны:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Затем проверьте доступность адреса с помощью curl (без ключа — проверяется только путь и сеть):

curl -s -o /dev/null -w '%{http_code}' \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  https://api.qcode.cc/v1/models
# → 200 = сеть, путь и ключ в порядке

Пояснение: 200 — сеть, endpoint и ключ полностью готовы. 401 — ключ недействителен или не передан (проверьте, что префикс cr_ скопирован целиком); 404 — обычно неверный префикс пути. Важно: запрос без ключа вернёт HTML-страницу-заглушку (HTTP 200), а не ошибку — если вы её видите, ключ не был передан. Полные curl-тесты: Endpoints & API Paths.

Выполните end-to-end тест с настоящим ключом:

curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

Нормальный JSON-ответ означает, что переменные окружения настроены и можно приступать к работе.

Хотите видеть модель, длину контекста и расход для каждого запроса? Запросы со всех доменов доступа отправляются в probe.qcode.cc — введите свой ключ cr_, чтобы их просмотреть.

💡 Ещё нет ключа или хотите разобраться в тарификации по моделям? Загляните на страницу цен QCode.cc и выберите подходящий план.

← Предыдущая
Скрипт установки в один клик
Следующая →
Быстрый старт

Похожие документы

Точки доступа и форматы API
Три API-протокола QCode.cc (Anthropic / OpenAI / Google Gemini), четыре точки доступа и правильное заполнение BASE_URL
Быстрый старт Codex
Установите и настройте Codex CLI за 5 минут — начните AI-программирование через QCode.cc
Быстрый старт
Освойте основные возможности Claude Code за 5 минут
🚀
Начните с QCode — Claude Code & Codex
Один тариф для Claude Code и Codex, низкая задержка в Азии
Посмотреть тарифы → Создать аккаунт
Команда 3+?
Enterprise: выделенный домен + управление ключами + защита от бана, от ¥250/чел/мес
Enterprise →