Configuración de Claude Code con DeepSeek
Claude CodeEs un asistente de programación con IA lanzado por Anthropic que se ejecuta en la terminal y admite la configuración de API compatibles de terceros mediante variables de entorno, lo que permite conectarse a modelos como DeepSeek.
Este artículo explica cómo combinar Claude Code conDeepSeekpara obtener potentes capacidades de programación asistida por IA a menor costo.
Puntos clave:
- Claude Code, mediante la variable de entornoANTHROPIC_BASE_URL, apunta a la interfaz compatible de DeepSeek.
- DeepSeek ofrece una interfaz compatible con la API de Anthropic, cuya ruta es
https://api.deepseek.com/anthropic。 - Mediante un conjunto de variables de entorno, los modelos de diferentes niveles (Opus / Sonnet / Haiku) se pueden asignar a los modelos correspondientes de DeepSeek.
- Una vez completada la configuración, ejecute el comando
claudedirectamente en el directorio del proyecto para usarlo.
En resumen:Claude Code + DeepSeek = asistente de programación con IA en la terminal + modelo de gran tamaño con alta relación calidad-precio
- Claude Code: proporciona una experiencia interactiva completa de programación con IA en la terminal, compatible con generación de código, refactorización, depuración, explicación, etc.
- DeepSeek API: proporciona una interfaz compatible con Anthropic, compatible con la invocación de la serie de modelos DeepSeek.
- Puente de variables de entorno: conecta ambos mediante variables de entorno estándar, sin necesidad de modificar el código fuente de Claude Code.
Requisitos previos
Si ya ha instalado Claude Code, puede omitir este paso.
- Tener instaladoNode.js18 o una versión superior.
- Los usuarios de Windows también deben instalarGit for Windows(proporciona el entorno bash).
- Haber registrado una cuenta enDeepSeek Platformy creado una clave API.
Ejecute el siguiente comando en la interfaz de línea de comandos para instalar Claude Code:
curl -fsSL https://claude.ai/install.sh | bash
Una vez instalado, ejecute el siguiente comando para verificar; si se muestra el número de versión correctamente, la instalación se realizó con éxito:
claude --version
Si encuentra problemas de permisos, los usuarios de Linux / macOS pueden anteponer
sudo。Si hay una verificación de inicio de sesión, puede buscar.claude.json:
- macOS/Linux:~/.claude.json
- Windows:C:\Users\TuUsuario\.claude.json
{ "hasCompletedOnboarding": true }
Después de guardar, reinicie la terminal y ejecute de nuevo:
claudeEn este momento ya no aparecerá la ventana / el aviso deinicio de sesión en claude.ai.
Obtener la clave API de DeepSeek
Vaya aDeepSeek PlatformInicie sesión y cree una clave API, guárdela de forma segura, ya que se usará al configurar las variables de entorno.

La clave API tiene permisos de operación de cuenta; no la envíe al repositorio de código ni la comparta con otras personas. Se recomienda utilizar la herramienta de gestión de secretos del sistema operativo o archivos de variables de entorno (por ejemplo,
.env) para gestionarla, y agregue los archivos correspondientes a.gitignore。
Configurar variables de entorno
Claude Code se conecta a la API de DeepSeek mediante las siguientes variables de entorno; el significado de cada variable es:
| Variable de entorno | Descripción |
|---|---|
ANTHROPIC_BASE_URL |
Apunta a la dirección de interfaz compatible con el protocolo Anthropic de DeepSeek |
ANTHROPIC_AUTH_TOKEN |
Su clave API de DeepSeek |
ANTHROPIC_MODEL |
Modelo utilizado por defecto |
ANTHROPIC_DEFAULT_OPUS_MODEL |
Modelo asignado al nivel Opus (tareas de razonamiento complejo) |
ANTHROPIC_DEFAULT_SONNET_MODEL |
Modelo asignado al nivel Sonnet (tareas de programación diarias) |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
Modelo asignado al nivel Haiku (tareas rápidas y ligeras) |
CLAUDE_CODE_SUBAGENT_MODEL |
Modelo utilizado por el agente de subtareas (se recomienda un modelo más rápido) |
CLAUDE_CODE_EFFORT_LEVEL |
Profundidad de razonamiento, opcionallow / medium / max |
Linux / macOS
Ejecute el siguiente comando en la terminal (sustituya<你的 DeepSeek API Key>por su clave real):
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
Los comandos
exportanteriores solo tienen efecto en la sesión actual de la terminal.Para que sean permanentes, puede agregar los comandos anteriores al final del archivo
~/.bashrc(Bash) o~/.zshrc(Zsh), y luego ejecutesource ~/.bashrcpara que surta efecto de inmediato.
Windows(PowerShell)
En PowerShell, ejecute el siguiente comando:
$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"
La asignación de variables en
$env:PowerShell solo tiene efecto en la sesión actual. Para que sea permanente, puede agregar las variables de entorno de usuario correspondientes en «Propiedades del sistema → Variables de entorno», o escribir los comandos anteriores en el archivo de perfil de PowerShell ($PROFILE)。
Verificar si está activo
Después de completar la configuración, inicie Claude Code y ejecute el comando/statuspara verificar:
$ cd 你的项目目录 $ claude /status
Si la configuración es correcta, verá una salida similar a la siguiente:
Base URL: https://api.deepseek.com/anthropic Model: deepseek-v4-pro[1m] Small fast model: deepseek-v4-flash
Ver esta información indica que la configuración se realizó correctamente; Claude Code ya está utilizando DeepSeek V4 para el razonamiento.
Si no se muestra la información anterior, revise cada elemento: si las variables de entorno están configuradas correctamente, si la clave API es válida y si los nombres de las variables tienen errores de ortografía.
Comenzar a usar
Entre en el directorio de su proyecto y ejecute el comandoclaudepara iniciar Claude Code:
cd /path/to/my-project claude
Después de un inicio exitoso, la terminal entrará en la interfaz interactiva de Claude Code, donde podrá describir sus necesidades de programación directamente en lenguaje natural, por ejemplo:

# 让 Claude Code 解释当前项目结构 > 帮我梳理一下这个项目的目录结构和主要模块的作用 # 生成代码 > 给 user.go 新增一个根据邮箱查询用户的方法,并补充单元测试 # 调试问题 > 运行 npm test 后报错,帮我分析原因并修复
Configuración de referencia
Variables de entorno completas
| Variable de entorno | Valor | ¿Obligatoria? | Descripción |
|---|---|---|---|
| ANTHROPIC_BASE_URL | https://api.deepseek.com/anthropic | Sí | Dirección del punto final de API, apunta a la interfaz compatible con Anthropic de DeepSeek |
| ANTHROPIC_AUTH_TOKEN | sk-your-api-key | Sí | Clave API de DeepSeek, utilizada para autenticación |
| ANTHROPIC_MODEL | deepseek-v4-pro[1m] | Sí | Nombre del modelo principal; [1m] indica una ventana de contexto de 1M |
| ANTHROPIC_SMALL_FAST_MODEL | deepseek-v4-flash | Sí | Modelo rápido utilizado por el agente de subtareas |
Referencia rápida de nombres de modelos
| Nombre del modelo | Capacidad | Ventana de contexto | Escenarios de uso |
|---|---|---|---|
| deepseek-v4-pro[1m] | Razonamiento más potente | 1M tokens | Diseño de arquitectura compleja, revisión profunda de código, depuración de problemas difíciles |
| deepseek-v4-flash | Razonamiento rápido | 1M tokens | Generación de archivos por lotes, CRUD simple, redacción de documentación |
Referencia rápida de rutas de archivos de configuración de Shell
| Shell | Ruta del archivo de configuración | Comando para aplicar |
|---|---|---|
| zsh (predeterminado en macOS) | ~/.zshrc | source ~/.zshrc |
| bash (predeterminado en Linux) | ~/.bashrc | source ~/.bashrc |
| PowerShell (Windows) | Configuración de variables de entorno del sistema | Reiniciar PowerShell |
Referencia rápida de archivos de configuración de Claude Code
| Archivo | Ruta | Función |
|---|---|---|
| CLAUDE.md | Directorio raíz del proyecto | Normas a nivel de proyecto que indican a la IA el stack tecnológico, el estilo de código y las restricciones |
| .claudeignore | Directorio raíz del proyecto | Reglas de ignorado que impiden que la IA lea o modifique archivos específicos |
| settings.json | ~/.claude/settings.json | Configuración global, incluye servidores MCP, permisos, etc. |
Recomendaciones de selección de modelos
Los diferentes modelos de DeepSeek ofrecen distintas compensaciones entre rendimiento y costo; a continuación se presentan las configuraciones recomendadas para escenarios comunes:
| Escenario | Modelo recomendado | Descripción |
|---|---|---|
| Diseño de arquitectura compleja, refactorización profunda de código | deepseek-v4-pro[1m] |
Gran capacidad de razonamiento, adecuado para tareas que requieren comprensión global |
| Desarrollo de funciones diarias, autocompletado de código | deepseek-v4-pro[1m] |
Buen rendimiento general, cubre la mayoría de los escenarios de programación |
| Preguntas rápidas, modificaciones simples, subtareas | deepseek-v4-flash |
Respuesta rápida, bajo costo, adecuado para tareas ligeras de alta frecuencia |
