En el ámbito del desarrollo de software asistido por inteligencia artificial, la elección del modelo lingüístico adecuado puede marcar una diferencia significativa, tanto en la eficiencia del trabajo como en los costes operativos. Si utilizas Codex como tu agente de codificación, te interesará saber que puedes configurarlo para usar DeepSeek-Flash como modelo predeterminado. Esta integración no solo te permite acceder a un potente modelo de IA, sino que también optimiza tus gastos, ya que pasas de una suscripción mensual fija a un modelo de pago por uso basado en el consumo de la API de DeepSeek.

Preparando tu clave API de DeepSeek

El primer paso para esta configuración es obtener y asegurar tu clave de API de DeepSeek. Sin ella, Codex no podrá comunicarse con los servicios de DeepSeek. Aquí te explicamos cómo hacerlo:

  • Genera tu clave: Accede a la plataforma de DeepSeek y genera una clave API desde tu panel de desarrollador.
  • Configura la variable de entorno: Para garantizar la seguridad y evitar codificar la clave directamente en tus archivos de configuración, es fundamental que la establezcas como una variable de entorno. Abre tu archivo de configuración de shell (~/.zshrc o ~/.bashrc, dependiendo de tu sistema) y añade la siguiente línea, reemplazando your-deepseek-api-key con tu clave real:

export DEEPSEEK_API_KEY=your-deepseek-api-key

  • Carga la variable: Después de guardar el archivo, ejecuta source ~/.zshrc (o ~/.bashrc) en tu terminal para cargar la nueva variable de entorno.

Este método asegura que tu clave API esté disponible para Codex sin exponerla directamente en tus configuraciones.

Actualizando la configuración principal de Codex

Una vez que tu clave API está configurada, el siguiente paso es indicarle a Codex que utilice DeepSeek como su proveedor de modelos. Para ello, necesitas modificar el archivo de configuración principal de Codex, generalmente ubicado en ~/.codex/config.toml:

  • Abre el archivo: Utiliza tu editor de texto preferido para abrir ~/.codex/config.toml.
  • Añade la configuración de DeepSeek: Incorpora las siguientes líneas al archivo. Estas líneas le dicen a Codex qué modelo usar, qué proveedor y dónde encontrar el catálogo de modelos personalizado.
# ~/.codex/config.toml
model = "deepseek-flash"
model_provider = "deepseek"
model_catalog_json = "~/.codex/models.json"
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com"
env_key = "DEEPSEEK_API_KEY"
wire_api = "responses"

Esta configuración es crucial, ya que establece la conexión entre Codex y la API de DeepSeek, utilizando la variable de entorno que definiste previamente.

Definiendo el catálogo de modelos

Finalmente, necesitas crear o modificar un archivo models.json que detallará las capacidades específicas de DeepSeek-Flash para Codex. Este archivo informa a Codex sobre las características del modelo, como el tamaño de la ventana de contexto o las herramientas soportadas:

  • Crea o edita ~/.codex/models.json: Si el archivo no existe, créalo en la ruta especificada. Si ya existe, asegúrate de añadir o integrar la siguiente estructura JSON.
{
  "models": [
    {
      "slug": "deepseek-flash",
      "display_name": "DeepSeek-Flash",
      "description": "Latest frontier agentic coding model with image input.",
      "input_modalities": ["text", "image"],
      "context_window": 1048576,
      "max_context_window": 1048576,
      "default_reasoning_level": "high",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "high",
          "description": "Extra high reasoning depth for complex problems"
        },
        {
          "effort": "max",
          "description": "Maximum reasoning depth for the hardest problems"
        }
      ],
      "truncation_policy": {
        "mode": "tokens",
        "limit": 10000
      },
      "supports_parallel_tool_calls": true,
      "supports_search_tool": true,
      "supported_in_api": true,
      "support_verbosity": true,
      "experimental_supported_tools": [],
      "priority": 1,
      "visibility": "list",
      "shell_type": "shell_command",
      "model_messages": {
        "instructions_template": "You are Codex, an agent based on DeepSeek-Flash. You are a coding agent working with the user in their workspace. Inspect the repository before editing files, use available tools carefully, make minimal changes, run relevant tests, and clearly report what changed."
      },
      "base_instructions": "You are Codex, an agent based on DeepSeek-Flash. You are a coding agent working with the user in their workspace. Inspect the repository before editing files, use available tools carefully, make minimal changes, run relevant tests, and clearly report what changed."
    }
  ]
}

Este fragmento JSON detalla las capacidades de DeepSeek-Flash, incluyendo su soporte para entradas de texto e imagen, una impresionante ventana de contexto de más de un millón de tokens, y la capacidad de realizar llamadas a herramientas en paralelo. También define los niveles de razonamiento que el modelo puede aplicar, desde respuestas rápidas hasta una profundidad máxima para problemas complejos.

Aplicando los cambios

Una vez que hayas guardado ambos archivos (config.toml y models.json), los cambios se aplicarán. Ahora, tu agente de codificación Codex utilizará DeepSeek-Flash por defecto, permitiéndote aprovechar sus avanzadas capacidades de codificación y, al mismo tiempo, gestionar tus gastos de forma más eficiente al pagar solo por el uso real de la API. Esta configuración es un paso adelante para optimizar tu flujo de trabajo de desarrollo con IA.