Как использовать API DeepSeek в Claude Code: реальные варианты
Если вы размышляете, как использовать API DeepSeek в Claude Code, первое, что нужно знать: Claude Code общается с эндпоинтами в стиле Anthropic, а этот сервис использует формат OpenAI. Небольшой прокси-сервер устраняет это различие, и на этой странице показано, как его настроить.
Обновлено
Ключевые моменты
- Claude Code ожидает API Anthropic Messages; этот сервис предлагает совместимый с OpenAI /v1/chat/completions.
- Локальный прокси, такой как LiteLLM, может переводить между двумя форматами.
- Aider, Continue и Cline принимают базовый URL, совместимый с OpenAI, напрямую, без прокси.
- Это не официальный API DeepSeek: это одна независимая модель с открытыми весами с идентификатором
uncensored.

Начните с того, что будет и не будет работать
Два уточнения сэкономят вам час времени. Во-первых, этот сервис — не официальный API DeepSeek, и это не роутер для DeepSeek или любого другого вендора. Он предоставляет одну модель с открытыми весами, запущенную независимым провайдером, под идентификатором модели uncensored. Если вам нужны собственные модели DeepSeek, обращайтесь напрямую к DeepSeek. Во-вторых, Claude Code построен вокруг Messages API от Anthropic. Вы можете изменить адрес, куда он отправляет запросы, но отправляемые данные по-прежнему имеют формат JSON от Anthropic.
Этот сервис предоставляет эндпоинты POST /v1/chat/completions и GET /v1/models в формате OpenAI. Подключение Claude Code напрямую не сработает из-за различий в путях и полезной нагрузке. Решение — слой трансляции. Вы запускаете небольшой прокси на своём компьютере, который принимает вызовы в формате Anthropic от Claude Code и пересылает их как вызовы в формате OpenAI на https://api.getdeepseekapi.com/v1. Для этого существуют готовые инструменты, и в следующем разделе показана их настройка.
Перед началом проверьте одно ожидание. Claude Code сильно полагается на вызов функций для чтения файлов, их редактирования и выполнения команд. Этот API поддерживает вызов функций, включая потоковую передачу tool_calls, но то, насколько хорошо любая конкретная модель управляет длинным циклом агента, нужно тестировать на своем собственном репозитории, а не предполагать.
Получите ключ и подтвердите эндпоинт
Создайте аккаунт через Google или с помощью email и пароля, затем откройте страницу API-ключ. Новые пользователи могут одним кликом получить $0,50 пробного баланса. Он действует 7 дней, не требует данных для оплаты и достаточен для проверки всего, что описано ниже. Обратите внимание: пробный ключ позволяет выполнять 2 параллельных запроса и 60 запросов в минуту, что важно для инструментов агентов, которые выполняют несколько вызовов одновременно.
export UNCENSORED_API_KEY="paste-your-key-here"
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
Если в ответе вы получите completion, значит, upstream-сторона завершила работу. Всё остальное — подключение прокси.
Вариант 1: прокси LiteLLM перед Claude Code
LiteLLM — это проект с открытым исходным кодом, сервер прокси которого может предоставлять эндпоинт, совместимый с Anthropic, и маршрутизировать запросы к бэкендам, совместимым с OpenAI. Проверьте его документацию, чтобы узнать текущий набор функций, так как эта часть экосистемы быстро развивается.
Установка и настройка
pip install 'litellm[proxy]'
cat > litellm-config.yaml <<'EOF'
model_list:
- model_name: uncensored
litellm_params:
model: openai/uncensored
api_base: https://api.getdeepseekapi.com/v1
api_key: os.environ/UNCENSORED_API_KEY
EOF
litellm --config litellm-config.yaml --port 4000
Префикс openai/ сообщает LiteLLM использовать адаптер, совместимый с OpenAI; имя, следующее за ним, отправляется на upstream в качестве модели. Оставьте терминал запущенным.
Направьте Claude Code на прокси
Claude Code считывает свой эндпоинт и учетные данные из переменных окружения. Во втором терминале:
export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="any-local-string"
export ANTHROPIC_MODEL="uncensored"
export ANTHROPIC_SMALL_FAST_MODEL="uncensored"
claude
Токен аутентификации здесь — это просто то, что ожидает ваш локальный прокси; настоящий ключ остаётся в окружении прокси. Настройка малой быстрой модели также важна, потому что Claude Code использует вторую модель для лёгких фоновых задач. Если не задать его, он может попытаться вызвать имя модели Anthropic, которое прокси не знает. В более новых версиях этот параметр может называться иначе, поэтому выполните claude --help или прочитайте документацию по текущим настройкам Claude Code, если переменная кажется проигнорированной.
Вариант 2: инструменты, принимающие базовый URL OpenAI напрямую
Если ваша цель — помощник для программирования на базе ИИ, а не сам Claude Code, несколько инструментов пропускают прокси, так как они уже понимают формат OpenAI. Каждый из них позволяет задать пользовательский базовый URL и имя модели.
- Aider — это терминальный ассистент для парного программирования. Он считывает
OPENAI_API_BASEиOPENAI_API_KEY, и вы добавляете префиксopenai/к имени модели. - Continue — это расширение редактора, где запись модели может содержать
apiBaseи провайдер в стиле OpenAI. - Cline предлагает провайдер OpenAI Compatible в своих настройках с полями для базового URL, ключа и идентификатора модели.
С Aider вся настройка занимает три строки:
export OPENAI_API_BASE="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="$UNCENSORED_API_KEY"
aider --model openai/uncensored
Эти инструменты часто меняют свои меню, поэтому относитесь к указанным именам полей как к руководству и следуйте текущей документации каждого проекта. Значения, которые вам нужны, не меняются: базовый URL https://api.getdeepseekapi.com/v1, ваш ключ и идентификатор модели uncensored.
Напишите свой собственный лёгкий цикл агента
Когда полноценный ассистент для программирования избыточен, короткий скрипт с вызовом функций решает множество задач. Этот скрипт позволяет модели запросить чтение файла, а затем возвращает содержимое файла в сообщении role: "tool".
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key=os.environ["UNCENSORED_API_KEY"],
)
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Read a text file from the project",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "What does main.py do? Read it first."}]
for _ in range(5):
r = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = r.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"]) as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
Ограничение цикла в пять итераций предотвращает бесконечную работу запутавшейся модели. В реальном инструменте вы также должны проверять пути, чтобы модель не могла читать файлы за пределами проекта.
Лимиты запросов, стоимость и исправление ошибок 429
Инструменты агентов отправляют очень много запросов. Одна задача может запустить десятки запросов, каждый из которых повторно отправляет растущий контекст. На полном ключе вы получаете 8 параллельных запросов и 300 запросов в минуту. Ошибка 429 с concurrency означает, что слишком много вызовов происходит одновременно, а 429 с rate_limited — что превышен лимит в минуту. При кратковременной перегрузке вы увидите 429 с Retry-After: 5. LiteLLM может автоматически повторять запросы, если вы добавите настройку retry; ознакомьтесь с его документацией.
Стоимость умеренная, так как цена составляет $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Предположим, сессия агента выполняет 40 вызовов, каждый из которых отправляет 30 000 токенов контекста и получает 600 токенов. Входные данные составляют 1 200 000 токенов, что стоит 1,2 x $0,15 = $0,18. Выходные данные составляют 24 000 токенов, что стоит 0,024 x $0,50 = $0,012. Вся сессия обходится в $0,192. Контекстное окно составляет 100 000 токенов, поэтому загружайте сфокусированные файлы.
Когда пробный баланс иссякнет, пополните его любой целой суммой от $20 до $500 криптовалютой (USDT в сети TRC20, USDC в сети Base). Бонусы: +5% от $50, +10% от $100 и +15% от $200. Подробности см. на странице тарифов и в документации.
Устранение неполадок настройки прокси
| Симптом | Причина | Что попробовать |
|---|---|---|
| Claude Code сообщает о неизвестной модели | Имя фоновой модели не сопоставлено | Установите переменную малой быстрой модели в значение uncensored |
| Соединение отклонено | Прокси не запущен или порт отличается | Запустите LiteLLM и сопоставьте порт в ANTHROPIC_BASE_URL |
| 401 от upstream | Неверный ключ в окружении прокси | Повторно экспортируйте UNCENSORED_API_KEY и перезапустите прокси |
| Вызовы функций завершаются ошибкой или зацикливаются | Модели сложно работать с форматом агента | Снизьте температуру, сократите промпт или используйте Aider |
| Частые 429 | Ограничение параллельных запросов для пробного ключа: 2 | Пополните баланс, чтобы получить полный ключ с 8 параллельными слотами |
Две привычки обеспечат безопасность. Запускайте прокси только на localhost, чтобы никто другой в вашей сети не мог потратить ваш баланс, и храните настоящий ключ в переменных окружения прокси, а не в файле проекта, который попадает в систему контроля версий. Также следите за заголовком ответа X-Balance-USD во время первой длительной сессии, потому что циклы агентов могут использовать больше токенов, чем вы ожидаете. Если баланс уменьшается быстрее, чем указано выше, сократите файлы, которые вы подаете на вход, или ограничьте количество шагов.
Неудачные запросы не тарифицируются, поэтому эксперименты обходятся недорого. Промпты не используются для обучения. Для сравнения с другими шлюзами прочитайте обзор наших API-ключей.
Дополнительные руководства
Вопросы и ответы
Может ли Claude Code подключаться напрямую к этому API?
Нет. Claude Code использует формат сообщений Anthropic, а это API использует формат chat completions от OpenAI. Поместите между ними прокси-сервер для преобразования, например LiteLLM.
Это официальный API DeepSeek?
Нет. Он хостит одну независимую модель с открытыми весами под идентификатором uncensored и не связан с DeepSeek или любым другим поставщиком.
Какие инструменты работают без прокси?
Инструменты с настройкой провайдера, совместимой с OpenAI, такие как Aider, Continue и Cline. Укажите базовый URL, ключ и идентификатор модели uncensored.
Работает ли вызов функций?
Да, включая потоковую передачу tool_calls и результатов, возвращаемых в виде сообщений с ролью tool. Протестируйте свой собственный рабочий процесс агента, чтобы увидеть, как модель с этим справляется.
Ваш ключ — всего в одной форме
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.