Skip to main content
Claude Code utiliza la API de Anthropic Messages. Ejecutamos esa API en POST /v1/messages, por lo que una URL base y una clave son toda la integración. Claude Code no ofrece un lugar para configurar start_within, por lo que el plazo se establece en la clave. Cree una primero (consulte claves de agente). Una duración compite con el nivel más económico de Claude en claves gestionadas, sin streaming, dentro de una ventana de tres a diez minutos. Una sesión interactiva transmite (en streaming), así que elija un nivel aquí. Una duración de clave sigue funcionando de cualquier manera, porque recurre a un nivel en lugar de fallar. Consulte Las duraciones de Claude necesitan una ventana más larga. Su organización debe poder ejecutar Anthropic antes de empezar. Con sus propias claves, esto significa una clave de proveedor de Anthropic en la pestaña Provider keys, ya que no revendemos inferencia. Con Managed Keys, significa que Anthropic está activado y financiado.

​
Configúrelo con un agente

Abra el bloque siguiente y cópielo en cualquier agente de codificación. El prompt nunca le pedirá su clave de API: el agente configura todo lo demás y luego imprime la línea de exportación para que la ejecute usted mismo.

​
Configurar Claude Code

  1. Cree o abra ~/.claude/settings.json. Un archivo por proyecto en .claude/settings.json funciona de la misma manera.
  2. Agregue un bloque env que nombre el enrutador, su clave y ambos modelos.
  1. Inicie Claude Code.
Exporte las mismas variables en su shell en su lugar, para mantener el secreto fuera de un archivo.
Cuatro reglas hacen que esto funcione. Omita el sufijo /v1. Claude Code añade /v1/messages a la URL base por sí mismo. Use ANTHROPIC_AUTH_TOKEN, nunca ANTHROPIC_API_KEY. El primero envía Authorization: Bearer, que requerimos. El segundo envía x-api-key, que rechazamos. Establezca CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS en 1. De lo contrario, Claude Code envía campos beta experimentales como context_management. No reenviamos los encabezados anthropic-beta que esos campos necesitan, por lo que cada solicitud falla. Establezca ambas variables de modelo. Claude Code ejecuta un modelo grande de bucle principal y un modelo pequeño en segundo plano con una sola clave. Ambos deben ser slugs claude-*.

​
Confirme que la clave se aplicó

Cada respuesta viene con x-flexinference-defaults-applied. Claude Code no muestra los encabezados de respuesta, así que consulte la solicitud en el panel de control, en Logs, en su lugar.

​
Solución de problemas

400 context_management: Extra inputs are not permitted. Claude Code envió un campo beta experimental y no reenviamos el encabezado anthropic-beta que necesita. Establezca CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 e inicie una nueva sesión. La misma bandera elimina cualquier otro rechazo de Extra inputs are not permitted que nombre un campo beta. 401 missing_api_key. Ha configurado ANTHROPIC_API_KEY, por lo que el cliente envió x-api-key, que no leemos. Configure ANTHROPIC_AUTH_TOKEN en su lugar y desconfigure ANTHROPIC_API_KEY. 400 unsupported_parameter nombrando output_config. Una variable de modelo apunta a un slug que no es de Claude, y Claude Code envía campos nativos de Anthropic que nos negamos a traducir incorrectamente. Establezca ambas variables de modelo en slugs claude-*. 404 unknown_url nombrando /v1/messages/count_tokens. No enrutamos esa ruta. Una ejecución de claude -p nunca la llama, aunque una sesión interactiva podría hacerlo. Cada solicitud agota un presupuesto completo de reintentos. Claude Code reintenta por sí mismo, y una política de retry de la clave se acumula con ella. Deje retry sin configurar en una clave que use este cliente. Consulte errors para ver cada rechazo que devolvemos, y agent keys para aquellos que no son específicos de Claude Code.