Конфигурация Claude Code DeepSeek

Claude CodeClaude Code — это ИИ-ассистент для программирования, выпущенный Anthropic, который работает в терминале, поддерживает настройку сторонних совместимых API через переменные среды и таким образом может подключаться к таким моделям, как DeepSeek.

В этой статье описывается, как использовать Claude Code вместе сDeepSeekдля получения мощных возможностей программирования с поддержкой ИИ при более низких затратах.

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

  • Claude Code используетANTHROPIC_BASE_URLв качестве переменной среды, чтобы указывать на интерфейс, совместимый с DeepSeek.
  • DeepSeek предоставляет API, совместимый с Anthropic API, с путёмhttps://api.deepseek.com/anthropic。
  • С помощью набора переменных среды можно сопоставить модели разных уровней (Opus / Sonnet / Haiku) с соответствующими моделями DeepSeek.
  • После завершения настройки запустите прямо в каталоге проектаclaudeкоманда для его использования.

Проще говоря:Claude Code + DeepSeek = терминальный AI-ассистент для программирования + большая модель с высоким соотношением цена/качество

  • Claude Code: обеспечивает полноценный опыт терминального AI-программирования, поддерживая генерацию кода, рефакторинг, отладку, объяснение и т. д.
  • DeepSeek API: предоставляет интерфейс, совместимый с Anthropic, поддерживая вызовы моделей серии DeepSeek.
  • Мост переменных среды: связывает эти два компонента через стандартные переменные среды без изменения исходного кода Claude Code.

Предварительные требования

Если вы уже установили Claude Code, можете пропустить этот шаг.

  • УстановленNode.jsверсии 18 или выше.
  • Пользователям Windows также необходимо установитьGit for Windows(предоставляет среду bash).
  • УжеDeepSeek Platformзарегистрировали аккаунт и создали API Key.

Выполните следующую команду в интерфейсе командной строки, чтобы установить Claude Code:

curl -fsSL https://claude.ai/install.sh | bash

После установки выполните следующую команду для проверки. Если номер версии выводится нормально, установка прошла успешно:

claude --version

Если вы столкнулись с проблемами с разрешениями, пользователи Linux / macOS могут добавитьsudo。

Если есть проверка входа, файл можно найти в каталоге пользователя.claude.json:

  • macOS/Linux:~/.claude.json
  • Windows:C:\Users\YourUsername\.claude.json
{
  "hasCompletedOnboarding": true
}

После сохранения перезапустите терминал, а затем выполните:

claude

На этом этапе всплывающее окно / приглашениеВход в claude.aiбольше не появится.

Получение API-ключа DeepSeek

Перейдите наDeepSeek PlatformПосле входа в систему создайте API-ключ и сохраните его надлежащим образом. Он понадобится при настройке переменных окружения.

API-ключ имеет разрешения на операции с аккаунтом. Не добавляйте его в репозиторий кода и не делитесь им с другими. Рекомендуется использовать инструмент управления ключами операционной системы или файл переменных окружения (например,.env) для управления и добавьте соответствующие файлы в.gitignore。


Настройка переменных окружения

Claude Code подключается к DeepSeek API через следующие переменные окружения. Назначение каждой переменной следующее:

Переменная окружения Описание
ANTHROPIC_BASE_URL Указывает на адрес интерфейса DeepSeek, совместимого с протоколом Anthropic
ANTHROPIC_AUTH_TOKEN Ваш ключ API DeepSeek
ANTHROPIC_MODEL Модель, используемая по умолчанию
ANTHROPIC_DEFAULT_OPUS_MODEL Модель, используемая для сопоставления уровня Opus (сложные задачи рассуждения)
ANTHROPIC_DEFAULT_SONNET_MODEL Модель, используемая для сопоставления уровня Sonnet (повседневные задачи программирования)
ANTHROPIC_DEFAULT_HAIKU_MODEL Модель, используемая для сопоставления уровня Haiku (быстрые легковесные задачи)
CLAUDE_CODE_SUBAGENT_MODEL Модель, используемая агентами подзадач (рекомендуется более быстрая модель)
CLAUDE_CODE_EFFORT_LEVEL Глубина мышления, необязательноlow / medium / max

Linux / macOS

Выполните следующую команду в терминале (замените<你的 DeepSeek API Key>Замените на ваш фактический ключ):

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Вышеуказанноеexportкоманда действует только в текущем сеансе терминала.

Для постоянного действия добавьте приведённую выше команду в конец~/.bashrc(Bash) или~/.zshrc(Zsh) файла, затем выполнитеsource ~/.bashrcчтобы это вступило в силу немедленно.

Windows(PowerShell)

Выполните следующую команду в PowerShell:

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

В PowerShell$env:присваивание действует только в текущем сеансе. Для постоянного действия добавьте соответствующую пользовательскую переменную среды в разделе «Свойства системы → Переменные среды» или запишите приведённую выше команду в файл профиля PowerShell ($PROFILE)。

Проверьте, вступило ли это в силу

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

$ cd 你的项目目录
$ claude
/status

Если конфигурация верна, вы увидите примерно такой вывод:

Base URL: https://api.deepseek.com/anthropic
Model: deepseek-v4-pro[1m]
Small fast model: deepseek-v4-flash

Если отображается эта информация, значит конфигурация успешна, и Claude Code теперь использует DeepSeek V4 для рассуждений.

Если отображаемая информация не совпадает с вышеуказанной, проверьте по пунктам: правильно ли заданы переменные окружения, действителен ли API Key и нет ли опечаток в именах переменных.


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

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

cd /path/to/my-project
claude

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

# 让 Claude Code 解释当前项目结构
> 帮我梳理一下这个项目的目录结构和主要模块的作用

# 生成代码
> 给 user.go 新增一个根据邮箱查询用户的方法,并补充单元测试

# 调试问题
> 运行 npm test 后报错,帮我分析原因并修复

Справочная конфигурация

Полные переменные окружения

Переменная окруженияЗначениеОбязательныйОписание
ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicДаАдрес конечной точки API, указывающий на Anthropic-совместимый интерфейс DeepSeek
ANTHROPIC_AUTH_TOKENsk-your-api-keyДаКлюч API DeepSeek, используемый для аутентификации личности
ANTHROPIC_MODELdeepseek-v4-pro[1m]ДаНазвание основной модели, [1m] указывает на контекстное окно 1M
ANTHROPIC_SMALL_FAST_MODELdeepseek-v4-flashДаБыстрая модель, используемая субагентами

Краткий справочник по названиям моделей

Название моделиСпособностьКонтекстное окноПрименимые сценарии
deepseek-v4-pro[1m]Самое мощное рассуждение1M токеновСложное проектирование архитектуры, глубокий анализ кода, сложная отладка
deepseek-v4-flashБыстрое рассуждение1M токеновГенерация пакетных файлов, простой CRUD, написание документации

Краткий справочник по путям к файлам конфигурации оболочки

ШеллаПуть к файлу конфигурацииКоманда для применения
zsh (по умолчанию в macOS)~/.zshrcsource ~/.zshrc
bash (по умолчанию в Linux)~/.bashrcsource ~/.bashrc
PowerShell (Windows)Настройки системных переменных средыПерезапустите PowerShell

Краткий справочник по файлам конфигурации Claude Code

ФайлПутьНазначение
CLAUDE.mdКорневой каталог проектаСпецификации уровня проекта, сообщающие ИИ о технологическом стеке, стиле кода и ограничениях
.claudeignoreКорневой каталог проектаПравила игнорирования, не позволяющие ИИ читать или изменять указанные файлы
settings.json~/.claude/settings.jsonГлобальные настройки, включая MCP-серверы, разрешения и т. д.

Рекомендации по выбору модели

Разные модели DeepSeek имеют разные компромиссы между производительностью и стоимостью. Ниже приведены рекомендуемые конфигурации для типичных сценариев:

Сценарий Рекомендуемая модель Описание
Проектирование сложной архитектуры, глубокий рефакторинг кода deepseek-v4-pro[1m] Сильные способности к рассуждению, подходит для задач, требующих целостного понимания
Ежедневная разработка функций, автодополнение кода deepseek-v4-pro[1m] Хорошая общая производительность, охватывает большинство сценариев программирования
Быстрые вопросы и ответы, простые изменения, подзадачи deepseek-v4-flash Быстрый отклик, низкая стоимость, подходит для высокочастотных лёгких задач
Другие расширения