Главная → Руководства → Base URL Anthropic для Claude Code: правильная настройка ANTHROPIC_BASE_URL

Base URL Anthropic для Claude Code: правильная настройка ANTHROPIC_BASE_URL

Claude Code подключается к адресу, на который указывает ANTHROPIC_BASE_URL. Единственное правило, на котором спотыкаются: нужен голый хост без /v1 — ровно наоборот, чем почти во всех инструментах в стиле OpenAI.

Короткий ответ

Перед запуском Claude Code задайте две переменные окружения:

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

Официальный адрес Anthropic — https://api.anthropic.com; для ретранслятора достаточно заменить его. Claude Code сам дописывает /v1/messages, поэтому base URL заканчивается на хосте. На этом шлюзе 88% всего трафика Claude за последние 30 дней пришло от Claude Code, настроенного именно так.

Где задать

macOS / Linux — в оболочке, из которой вы его запускаете:

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell — для текущего окна:

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json — чтобы каждая сессия подхватывала значение независимо от оболочки:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Значение читается при запуске Claude Code. Если вы его поменяли, выйдите и начните новую сессию: открытая сессия продолжит использовать старый адрес. ANTHROPIC_AUTH_TOKEN передаётся как Authorization: Bearer, ANTHROPIC_API_KEY — как x-api-key. Шлюз принимает оба варианта — используйте один, а не оба.

Проверка одной командой

Прежде чем подозревать Claude Code, проверьте адрес и ключ напрямую:

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

Ответ в JSON значит, что всё верно. text/html или 404 — неверный адрес; 401 в JSON — адрес верный, ключ нет.

Когда добавлять /v1, а когда нет

Два семейства SDK режут адрес в разных местах. Клиенты в стиле Anthropic сами дописывают /v1/messages; клиенты в стиле OpenAI ждут /v1 в base URL и дописывают только /chat/completions:

Клиент	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

С /v1 в Claude Code запросы уходят на /v1/v1/messages и возвращают 404. Без /v1 в Cursor — на /chat/completions, тоже 404. Ни один не доходит до API.

Ошибка адреса или ключа?

• Ошибка, а в журнале использования пусто → неверный путь. 404 отвечается на границе сети и до биллинга не доходит. Сначала проверьте /v1.
• 401 с записью в журнале → ключ неверный, отозван или баланс пуст.
• Одна модель даёт 404, а остальные на том же ключе работают → модель относится к другой группе. Каждый ключ привязан к одной группе; создайте второй для нужной.
• Изменение будто не действует → переменная задана в другой оболочке или сессия запущена раньше.

Выбор модели

Имена моделей — точные строки с дефисами, а не точками: claude-fable-5-1, а не claude-fable-5.1. Задайте при запуске или командой /model внутри сессии:

claude --model claude-opus-5-5

Актуальные имена и цены — в прайсе. Настройка других клиентов — в быстром старте, приложение Claude Desktop — в руководстве по десктопным приложениям.

Начните пользоваться

Без подписки, без ежемесячного минимума, без звонков с продавцами. Пополните баланс в USDT и платите только за использованное — 1 USDT даёт 2 кредита баланса API.

Прочитать быстрый старт за 30 секунд

Язык: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Цены на этой странице подставляются автоматически из реальных данных биллинга. Условия третьих сторон процитированы из их документации.