Что вам нужно
- 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% не ограничивает срок действия ваших средств.
