DeepSeek setup guide

DeepSeek для кода

Используйте DeepSeek в Claude Code, Codex, IDE, терминальных агентах, MCP или через SDK. Один ключ поддерживает Responses, OpenAI-compatible и Anthropic Messages.

Открыть статистику Claude Code · официальный сценарий OpenAI + Anthropic

API URL

Ваш API-ключ

Модель

Input $0.435 / 1M Output $0.87 / 1M Контекст 1M Запрос пойдёт на …/v1/chat/completions

Claude Code в терминале

У DeepSeek нет отдельного официального CLI для программирования. В официальной документации DeepSeek первым терминальным клиентом указан Claude Code; наш bridge принимает тот же Anthropic Messages протокол.

Установите Claude Code

Нужен Node.js 18 или новее. В Windows также установите Git for Windows.

Terminal

npm install -g @anthropic-ai/claude-code
claude --version

Задайте переменные окружения

Для Claude Code используется адрес bridge без /v1. Opus и Sonnet направляются на Pro, Haiku и субагенты — на Flash.

Windows installer

Invoke-WebRequest https://docs.gptclaudegemini.xyz/install-claude.ps1 -OutFile .\ccg-claude-install.ps1
powershell -ExecutionPolicy Bypass -File .\ccg-claude-install.ps1 -DeepSeek

macOS / Linux / WSL installer

curl -fsSL https://docs.gptclaudegemini.xyz/install-claude.sh -o ccg-claude-install.sh
bash ccg-claude-install.sh --deepseek

Установщик сохраняет остальные настройки Claude Code и создаёт резервную копию. Ниже оставлена ручная настройка для тех, кому она нужна.

Windows PowerShell

macOS / Linux / WSL

Запустите в папке проекта

Выполните claude и отправьте тест: «Ответь ровно словом hi». Затем попросите прочитать небольшой файл, чтобы проверить инструменты.

OpenCode — независимый терминальный клиент

Если не хочется использовать клиент Anthropic, OpenCode — самый естественный отдельный CLI. Для нашего ключа добавьте собственный OpenAI-compatible provider, чтобы OpenCode не подставил официальный DeepSeek URL.

Установите OpenCode

Используйте актуальный установщик с opencode.ai и проверьте версию.

macOS / Linux / WSL

curl -fsSL https://opencode.ai/install | bash
opencode --version

Добавьте provider

Сохраните ключ в auth.json, а описание DeepSeek-моделей — в opencode.json. Не удаляйте уже существующие provider-записи.

~/.local/share/opencode/auth.json

~/.config/opencode/opencode.json

Запустите OpenCode

В папке проекта выполните opencode и выберите модель ccg/deepseek-v4-pro или ccg/deepseek-v4-flash.

Roo Code в VS Code — рекомендуемый способ

Roo Code умеет работать с произвольным OpenAI-compatible endpoint и использует native tool calls. Мы отдельно проверили tool calls через обе доступные модели.

Установите расширение

Откройте Extensions в VS Code, найдите Roo Code и установите расширение. Затем откройте его боковую панель.

Создайте API Configuration Profile

Нажмите шестерёнку и выберите API Provider → OpenAI Compatible. Перенесите значения ниже в соответствующие поля.

Roo Code profile

Цены в профиле нужны только для локальной оценки расходов Roo Code. Реальное списание и статистика считаются на bridge.

Сохраните профиль и запустите задачу

Выберите созданный профиль, откройте папку проекта и отправьте: «Ответь ровно словом hi». После обычного ответа можно дать задачу, для которой требуется чтение файла — так вы проверите tool calls.

Cline в VS Code или Cursor

Cline также имеет провайдер OpenAI Compatible. Используйте его, а не встроенный пункт DeepSeek: встроенный пункт может подставлять официальный URL вместо нашего bridge.

Установите Cline

Установите расширение из каталога VS Code. В Cursor это работает, если ваша сборка разрешает установку расширения Cline.

Выберите OpenAI Compatible

Откройте Settings → API Provider → OpenAI Compatible и заполните профиль этими значениями.

Cline profile

Нажмите Verify

После успешной проверки откройте проект и отправьте короткий тестовый запрос. Если Cline предлагает отдельное поле Model ID, вводите имя модели полностью.

Aider в терминале

Aider принимает OpenAI-compatible URL через переменные окружения. Команды ниже действуют только в текущем окне терминала и не записывают ключ в файл проекта.

Windows PowerShell

macOS / Linux / WSL

Если команда aider ещё не установлена, сначала используйте актуальную инструкцию установки с официального сайта Aider. Не добавляйте второй /v1 в OPENAI_API_BASE.

Проверка через OpenAI SDK

Подойдёт любой клиент, который позволяет задать OpenAI-compatible base URL. Ниже — минимальный тест для Python.

Python · pip install openai

Ожидаемый результат: текстовый ответ без ошибки авторизации. Финальный endpoint должен быть /v1/chat/completions.

Codex и остальные клиенты

DeepSeek работает через Responses, Chat Completions и Anthropic Messages. Ниже собраны остальные способы подключения из общего портала.

Codex CLI / App / IDE

Установщик создаст Responses provider и выберет deepseek-v4-pro. Один и тот же config.toml читают CLI, приложение и IDE.

Windows PowerShell

Invoke-WebRequest https://docs.gptclaudegemini.xyz/install.ps1 -OutFile .\ccg-codex-install.ps1
powershell -ExecutionPolicy Bypass -File .\ccg-codex-install.ps1 -Model deepseek-v4-pro

macOS / Linux / WSL

curl -fsSL https://docs.gptclaudegemini.xyz/install.sh -o ccg-codex-install.sh
bash ccg-codex-install.sh --model deepseek-v4-pro

Другие клиенты

OpenAI Compatible остаётся самым простым вариантом: Base URL с одним /v1 и точный DeepSeek model ID.

Kilo CodeOpenAI Compatible · /v1 CursorOverride OpenAI Base URL · /v1 Droidgeneric-chat-completion-api · /v1/ Grok CLIOpenAI-compatible provider · /v1 OpenClawopenai-completions · /v1 OpenHandsopenai/deepseek-v4-pro · /v1 MCP serverchat + list_models

Roo Code, Cline и Kilo Code можно подключить и через Anthropic provider: custom Base URL без /v1, модель deepseek-v4-pro или deepseek-v4-flash. Bridge поддерживает /v1/messages и локально отвечает на /v1/messages/count_tokens.

Что важно и где искать ошибку

404 · /v1/v1/chat/completions

В URL два раза добавлен /v1. Вставьте в Base URL ровно значение из верхнего поля этой страницы.

Anthropic · /v1/messages/count_tokens

Maolao не предоставляет отдельный count_tokens endpoint. Bridge возвращает локальную приблизительную оценку; запрос не уходит в модель и не списывает токены.

Model not found

Проверьте точное имя: deepseek-v4-pro или deepseek-v4-flash. Не используйте deepseek-chat, deepseek-reasoner или название Claude.

В статистике пока $0.00

DeepSeek очень дешёвый, а интерфейс округляет крупный показатель до центов. Несколько коротких запросов могут отображаться как $0.00, хотя точная сумма уже записана.

Roo Code · OpenAI Compatibleофициальная документация Cline · OpenAI Compatibleофициальная документация Aider · OpenAI-compatible APIsофициальная документация DeepSeek · Claude Code, OpenCode, OpenClawофициальная документация DeepSeek · Anthropic APIофициальная документация DeepSeek · Models & Pricingофициальная документация