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 eshttps://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 comandoclaudedirectamente 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 anteponersudo。

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:

claude

En 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 comandosexportanteriores 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 entornoValor¿Obligatoria?Descripción
ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicSíDirección del punto final de API, apunta a la interfaz compatible con Anthropic de DeepSeek
ANTHROPIC_AUTH_TOKENsk-your-api-keySíClave API de DeepSeek, utilizada para autenticación
ANTHROPIC_MODELdeepseek-v4-pro[1m]SíNombre del modelo principal; [1m] indica una ventana de contexto de 1M
ANTHROPIC_SMALL_FAST_MODELdeepseek-v4-flashSíModelo rápido utilizado por el agente de subtareas

Referencia rápida de nombres de modelos

Nombre del modeloCapacidadVentana de contextoEscenarios de uso
deepseek-v4-pro[1m]Razonamiento más potente1M tokensDiseño de arquitectura compleja, revisión profunda de código, depuración de problemas difíciles
deepseek-v4-flashRazonamiento rápido1M tokensGeneración de archivos por lotes, CRUD simple, redacción de documentación

Referencia rápida de rutas de archivos de configuración de Shell

ShellRuta del archivo de configuraciónComando para aplicar
zsh (predeterminado en macOS)~/.zshrcsource ~/.zshrc
bash (predeterminado en Linux)~/.bashrcsource ~/.bashrc
PowerShell (Windows)Configuración de variables de entorno del sistemaReiniciar PowerShell

Referencia rápida de archivos de configuración de Claude Code

ArchivoRutaFunción
CLAUDE.mdDirectorio raíz del proyectoNormas a nivel de proyecto que indican a la IA el stack tecnológico, el estilo de código y las restricciones
.claudeignoreDirectorio raíz del proyectoReglas de ignorado que impiden que la IA lea o modifique archivos específicos
settings.json~/.claude/settings.jsonConfiguració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
Otras extensiones