Конфигурация 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_URL | https://api.deepseek.com/anthropic | Да | Адрес конечной точки API, указывающий на Anthropic-совместимый интерфейс DeepSeek |
| ANTHROPIC_AUTH_TOKEN | sk-your-api-key | Да | Ключ API DeepSeek, используемый для аутентификации личности |
| ANTHROPIC_MODEL | deepseek-v4-pro[1m] | Да | Название основной модели, [1m] указывает на контекстное окно 1M |
| ANTHROPIC_SMALL_FAST_MODEL | deepseek-v4-flash | Да | Быстрая модель, используемая субагентами |
Краткий справочник по названиям моделей
| Название модели | Способность | Контекстное окно | Применимые сценарии |
|---|---|---|---|
| deepseek-v4-pro[1m] | Самое мощное рассуждение | 1M токенов | Сложное проектирование архитектуры, глубокий анализ кода, сложная отладка |
| deepseek-v4-flash | Быстрое рассуждение | 1M токенов | Генерация пакетных файлов, простой CRUD, написание документации |
Краткий справочник по путям к файлам конфигурации оболочки
| Шелла | Путь к файлу конфигурации | Команда для применения |
|---|---|---|
| zsh (по умолчанию в macOS) | ~/.zshrc | source ~/.zshrc |
| bash (по умолчанию в Linux) | ~/.bashrc | source ~/.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 |
Быстрый отклик, низкая стоимость, подходит для высокочастотных лёгких задач |
