RU ▾

ГлавнаяГайд

Настройка прокси Claude Code через API, совместимый с OpenAI

Настройка прокси claude code занимает пять шагов: получите ключ, напишите конфигурацию LiteLLM, запустите прокси, задайте две переменные окружения и выполните тест. Это займёт около десяти минут.

Пять светящихся ступенек, ведущих от терминала к серверу, показывающих пошаговую настройку прокси

Ключевые моменты

  1. Запустите локальный прокси LiteLLM, который перенаправляет запросы на https://api.claudecodeproxyapi.com/v1
  2. Укажите Claude Code на прокси с помощью ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN
  3. Сопоставьте имя модели, которое отправляет Claude Code, с upstream-моделью uncensored
  4. Протестируйте прокси с помощью curl перед запуском CLI

Что вам нужно

  • API-ключ со страницы ключей. Зарегистрируйтесь через Google или по электронной почте и паролю, затем получите пробный баланс $0.50 в один клик.
  • Python 3.9 или новее для установки прокси.
  • Claude Code установлен и работает на вашем компьютере.

Зачем нужен прокси? Claude Code использует формат Anthropic Messages, а наш API использует формат OpenAI Chat Completions с идентификатором модели uncensored. Прокси переводит между ними. Если вам сначала нужна теория, прочитайте руководство по устранению неполадок прокси. Модель — это модель с открытыми весами, а не Claude, поэтому ожидайте иного поведения на сложных многошаговых задачах.

Шаг 1: установка прокси

Используйте виртуальное окружение, чтобы зависимости прокси не пересекались с вашими проектами:

python3 -m venv ~/litellm-env
source ~/litellm-env/bin/activate
pip install 'litellm[proxy]'

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

Шаг 2: создание конфигурации

Создайте config.yaml. Значение model_name — это имя, которое отправляет клиент. Блок litellm_params указывает, куда перенаправить запрос. Префикс openai/ сообщает LiteLLM обращаться к серверу, совместимому с OpenAI.

cat > config.yaml <<'EOF'
model_list:
  - model_name: claude-sonnet
    litellm_params:
      model: openai/uncensored
      api_base: https://api.claudecodeproxyapi.com/v1
      api_key: os.environ/UPSTREAM_KEY
EOF

Псевдоним claude-sonnet — это пример, а не требование. Claude Code может отправлять несколько разных имён моделей, например основную модель и меньшую для фоновых задач. Добавьте одну запись model_list для каждого имени, которое вы видите в журнале прокси, все они должны указывать на один upstream. Указание всех псевдонимов на uncensored допустимо, поскольку модель одна.

Ключ считывается из переменной окружения, поэтому он никогда не попадёт в файл, который вы можете закоммитить.

Шаг 3: запуск прокси

export UPSTREAM_KEY="YOUR_KEY"
litellm --config config.yaml --port 4000

Оставьте этот терминал открытым. Вы должны увидеть, что сервер прослушивает порт 4000. Теперь проверьте путь к upstream со стороны прокси с помощью тестового запроса в формате Anthropic, который будет отправлять Claude Code:

curl http://localhost:4000/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: sk-local-anything" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet",
    "max_tokens": 200,
    "messages": [{"role": "user", "content": "Reply with the word ready."}]
  }'

Ответ в формате JSON, содержащий слово "ready", означает, что перевод работает от начала до конца: формат Anthropic на входе, формат OpenAI на https://api.claudecodeproxyapi.com/v1 и обратно. Если вы установили мастер-ключ в конфигурации LiteLLM, используйте его вместо sk-local-anything.

Шаг 4: указание Claude Code на прокси

Claude Code считывает адрес API и токен из переменных окружения. Установите их в оболочке, где вы запускаете CLI:

export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="sk-local-anything"
export ANTHROPIC_MODEL="claude-sonnet"
claude

Используйте адрес прокси без суффикса /v1, потому что CLI добавляет свой собственный путь. Токен должен удовлетворять только прокси, поскольку настоящий ключ upstream — это тот, который вы экспортировали как UPSTREAM_KEY. Если вы используете файл настроек CLI для значений переменных окружения вместо оболочки, укажите те же три имени там. Имена переменных окружения для Claude Code могут меняться между выпусками, поэтому проверяйте их по текущей документации Claude Code, если что-то игнорируется.

Шаг 5: запуск первой задачи и наблюдение за журналом

Начните с малого. Попросите CLI объяснить один файл или добавить комментарий к функции. В терминале прокси вы должны увидеть запрос для каждого шага. Запишите каждое имя модели, которое появляется; если одного из них нет в вашем model_list, прокси ответит ошибкой, поэтому добавьте его и перезапустите.

Вызов функций важен здесь, так как CLI читает файлы и редактирует код через инструменты. API поддерживает tools, tool_choice и потоковую передачу tool_calls, и прокси их преобразует. Слабое соблюдение схемы инструмента проявляется в виде неудачного редактирования или повторяющегося шага. В таком случае сократите задачу и попробуйте снова, прежде чем решать, что настройка сломана.

Контекстное окно составляет 100 000 токенов, промпт и ответ вместе. Длинные сессии, превышающие это значение, завершатся ошибкой, поэтому начните новую сессию для новой задачи. Стоимость мала: $0.15 за 1M входных токенов и $0.50 за 1M выходных токенов: запрос с 20 000 входными токенами и 800 выходными стоит $0.003 + $0.0004 = $0.0034. См. страницу цен для пополнения, которое на этом сайте доступно криптовалютой (USDT на TRC20, USDC на Base).

Устранение неполадок

Что вы видитеПричинаИсправление
Соединение отклоненоПрокси не запущен или порт отличаетсяЗапустите его и укажите порт в ANTHROPIC_BASE_URL
Ошибка 404 прокси или "модель не найдена"Имя модели, отправленное CLI, отсутствует в конфигурацииДобавьте это имя в model_list
Ошибка 401 upstreamНеверный или пустой UPSTREAM_KEYПовторно экспортируйте ключ в оболочке прокси и перезапустите
429 с concurrencyБолее 8 параллельных запросов (2 в пробном периоде)Уменьшите количество параллельных агентов
429 с rate_limitedБолее 300 запросов в минуту (60 в пробном периоде)Сделайте паузу и повторите запрос
429 с Retry-After: 5Временная перегрузкаПовторите попытку через пять секунд
Зависший потокПотоковый запрос удерживает слот до завершенияОтмените его в CLI, чтобы освободить слот

По любому вопросу, не охваченному здесь, включите заголовок ответа X-Request-Id при обращении в поддержку. В документации перечислены все поддерживаемые параметры.

Сделать постоянным

Ввод экспортов каждый раз утомляет. Поместите запуск прокси в небольшой скрипт, а переменные клиента — в алиас, чтобы одна команда запускала всё:

cat > ~/start-proxy.sh <<'EOF'
. ~/litellm-env/bin/activate
export UPSTREAM_KEY="YOUR_KEY"
exec litellm --config ~/config.yaml --port 4000
EOF
chmod +x ~/start-proxy.sh

alias claude-uncensored='ANTHROPIC_BASE_URL=http://localhost:4000 ANTHROPIC_AUTH_TOKEN=sk-local-anything ANTHROPIC_MODEL=claude-sonnet claude'

Поскольку переменные устанавливаются только для этой одной команды, ваша обычная команда claude продолжает работать с настройками по умолчанию. Добавьте алиас в профиль оболочки. Защитите скрипт правами доступа, например chmod 700, так как он содержит ваш ключ.

Возврат к исходным настройкам

Если вы экспортировали переменные в текущей оболочке, выполните unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL и запустите CLI снова. На стороне API ничего не изменилось, поэтому отменять нечего.

Отслеживание баланса и расходов

Каждый ответ API содержит заголовок X-Balance-USD, показывающий остаток средств на вашем ключе. LiteLLM может передавать заголовки вышестоящего сервиса в некоторых конфигурациях, но самый надёжный способ проверить баланс — периодически обращаться к вышестоящему API напрямую:

curl -i https://api.claudecodeproxyapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY" | grep -i x-balance-usd

Сессии агентов растут незаметно. Каждый шаг повторно отправляет рабочий контекст, поэтому длительная сессия обходится дороже за запрос, чем короткая. Запуск новой сессии для каждой задачи держит объём входных данных небольшим, а счёт — низким. При опубликованных ценах ($0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов) запрос с 50 000 входными и 1 000 выходными токенами стоит 50 000 × $0,15 / 1 млн = $0,0075 плюс $0,0005, что составляет $0,008. Двадцать таких запросов обойдутся в $0,16.

Пополнения от $20 до $500 целыми суммами принимаются в криптовалюте USDT по сети TRC20 или USDC по сети Base на этом сайте. Баланс не сгорает, поэтому крупное пополнение с бонусом +5%, +10% или +15% не ограничивает срок действия ваших средств.

Вопросы и ответы

Какие переменные окружения нужны Claude Code для работы с прокси?

ANTHROPIC_BASE_URL для адреса прокси и ANTHROPIC_AUTH_TOKEN для токена, который принимает прокси. ANTHROPIC_MODEL может указывать на псевдоним, который вы определили. Проверьте текущую документацию Claude Code на предмет изменений.

Нужно ли добавлять /v1 к ANTHROPIC_BASE_URL?

Нет. Используйте адрес прокси, например http://localhost:4000, так как CLI добавляет свой собственный путь. Путь /v1 нужен только для upstream api_base в конфигурации прокси.

Можно ли использовать прокси, отличный от LiteLLM?

Да. Любой прокси, преобразующий запросы Anthropic Messages в OpenAI Chat Completions, подойдёт, например claude-code-router. Укажите его upstream на https://api.claudecodeproxyapi.com/v1 с моделью uncensored.

Безопасен ли мой ключ вышестоящего сервиса в конфигурации?

Храните его в переменной окружения, а не в файле, как показано в конфигурации выше. Не фиксируйте ключ в репозитории.

Ваш ключ — всего в одной форме от вас

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.