Claude API Nuevo en 0.9.18

El proveedor Claude API ejecuta chats de Claude con una clave de API de Claude Console en lugar de tu suscripción de Claude. El agente es el mismo: Claude Code en la máquina del relay, con las mismas herramientas, modos, tarjetas de pregunta, subagents, corrección del rumbo y tareas en segundo plano. Solo cambia la factura. Los turns se facturan a la organización de Console a la que pertenece la clave.

Claude API está junto a tu suscripción, no en su lugar. Puedes iniciar un chat con la clave, iniciar otro con la suscripción y mover un chat de Claude de una a otra entre turns, conservando su sesión. Un límite mensual opcional detiene el gasto con la clave en cuanto la estimación de este relay lo alcanza. La tabla de todos los proveedores está en Los proveedores de un vistazo.

La clave de API #

Necesitas una clave de API de Claude Console, disponible en la página API keys (Claves de API) de platform.claude.com. Créala dentro de un workspace; consulta Límites. Abre Settings → Providers → Claude API (Ajustes → Proveedores → Claude API), la subpestaña que sigue a Claude.

La línea bajo los campos dice en qué punto estás:

Después inicia una conversación como siempre: en New Chat, elige Claude API. Consulta Iniciar una conversación. Un chat de Claude API lleva una etiqueta dorada Claude API, y la nota de bloqueo del área de redacción dice 🔒 Session locked to Claude API models.

Qué claves se aceptan #

• Una clave de API de Console, es decir, una clave que empieza por sk-ant-, de 8 a 512 caracteres sin espacios.
• Los inicios de sesión y tokens de sesión de Claude, y las claves Admin, se rechazan al guardar, con un mensaje que nombra lo que se pegó, por ejemplo This is an Anthropic Admin API key (it manages an organisation and cannot run models), not an API key. Una clave de otro proveedor recibe This does not look like a Claude API key. Ningún mensaje cita la clave.
• Si Anthropic acepta la clave se ve cuando el relay pide sus modelos (consulta Modelos). Una clave rechazada sigue guardada, y la línea de estado dice por qué.

Guardar, cambiar y quitar la clave #

• Guardar una clave distinta borra la lista de modelos de la clave y detiene los workers de Claude API que estén en ejecución, incluido uno que esté a mitad de un turn, así que cambia la clave entre turns. El siguiente mensaje los inicia con la clave nueva.
• Quitar la clave se rechaza mientras algún chat de Claude API haya enviado un mensaje o tenga uno en cola: Cannot remove the Claude API key while N Claude API conversation(s) still exist. Switch Claude API off for new conversations instead. También se rechaza mientras un worker siga ejecutándose con la clave.
• Quitar la clave, o desactivar Claude API, devuelve a Copilot los chats de Claude API que aún no han enviado ningún mensaje. Un chat con la clave que ya ha empezado conserva su selector de facturación, así que puedes moverlo a la suscripción; sus turns con la clave no se ejecutan mientras Claude API esté desactivado.

Pasar un chat entre la suscripción y la clave #

Un chat de Claude, con cualquiera de las dos facturaciones, tiene un selector bajo la nota de bloqueo: Subscription | API key (Suscripción | clave de API). Se muestra mientras Claude API está activado con una clave guardada. Un chat que está con la clave la conserva después de desactivar Claude API, para que pueda volver.

• A partir del siguiente turn. Un turn en curso termina con la facturación con la que empezó. Los mensajes que ya están en cola se ejecutan con la nueva.
• La sesión se mantiene. El relay reinicia el Claude Code del chat entre turns y reanuda la misma sesión. Espera al turn en curso, a una pregunta abierta, a una compactación o a las tareas en segundo plano, y el selector dice a cuál, por ejemplo Moves to the API key after the running turn.
• El primer turn con la clave cuesta más. No tiene caché de prompts. El selector lo dice: The first turn on the API key has no prompt cache and costs more.
• La transcripción anota cada cambio, por ejemplo 💳 Billing: this chat runs on the Claude API key from the next turn., con (switched by an agent) o (switched at the usage limit) cuando corresponde.
• Cuando no se puede elegir un lado, su botón aparece en gris y su tooltip dice por qué. El cambio se rechaza cuando Claude API no tiene clave o está desactivado, cuando se ha alcanzado el límite de este mes (el selector dice entonces This month's Claude API cap is reached: the chat stays on the subscription.), cuando Claude está desactivado para volver a la suscripción (CLAUDE_NOT_CONFIGURED), o cuando el modelo del chat no está en la lista de modelos del otro lado.
• Una página desactualizada. Un mensaje enviado desde una página que aún mostraba la facturación anterior no se envía con la nueva: su texto vuelve al borrador.

Nada más cambia un chat. Hay tres formas de hacerlo: el selector, el banner del límite de uso y el send de un agente:

• En el límite de uso. Cuando un chat con suscripción está en pausa por el límite de uso de Claude, el banner ofrece Switch this chat to API key (Pasar este chat a la clave de API) si el chat puede moverse. El turn en pausa continúa entonces con la clave de inmediato. En el límite mensual el banner dice No switch to the API key: this month's Claude API cap is reached.
• Por un agente. El send de relay_tool acepta provider (claude o claude-api) para una sesión de Claude y la cambia junto con el mensaje. La tarjeta de aprobación dice entonces Switches billing to API key.

No hay ningún ajuste por carpeta para la facturación: cada chat tiene la suya, elegida en New Chat y cambiada con el selector. Lo que fija una carpeta, su atribución de commits, se aplica con ambas facturaciones.

El límite mensual #

Monthly cap in US dollars (optional) limita lo que este relay gasta con la clave en un mes natural, según su propia estimación. Importes mayores que 0, hasta 1.000.000, con dos decimales como máximo; déjalo vacío para no tener límite.

En cuanto la estimación de este mes alcanza el límite:

• Un turn nuevo con la clave no se ejecuta. El chat recibe una nota que termina en Error code: relay.claude-api-cap-reached. y los botones Claude API settings (Ajustes de Claude API; abre la pestaña en el campo del límite) y Switch to subscription (Cambiar a la suscripción).
• Se rechaza un cambio a la clave, desde el selector, el banner del límite de uso o un agente.
• New Chat rechaza un chat de Claude API. El cuadro de diálogo sigue abierto con el motivo, Claude API settings y Start on subscription (Iniciar con la suscripción), que inicia el mismo chat en Claude (se ofrece mientras Claude está activado). En un teléfono el cuadro de diálogo se desplaza hasta él.
• También se rechaza a los agentes. El send de un agente a una sesión con la clave, y su create_session para un chat de Claude API, se rechazan: el relay responde 409 CLAUDE_API_CAP_REACHED, y no se pone nada en cola ni se crea nada.
• Un turn que Claude Code inicia por sí mismo con la clave, cuando una tarea en segundo plano informa, recibe la nota, y las tareas en segundo plano del chat se detienen, ya que cada informe iniciaría otro turn así. Su primera solicitud puede estar ya facturada. La nota llega una vez por chat hasta que el límite se libera, se guarda un ajuste de Claude API o un turn del chat vuelve a ejecutarse con la clave.

Un turn que ya está en curso termina. El coste de un turn se contabiliza cuando termina, así que los turns que estaban en curso pueden llevar el mes por encima del límite. El límite cuenta solo la parte de la estimación que tiene precio (consulta Límites). Mientras haya un límite fijado y no se pueda leer el gasto, el límite cuenta como alcanzado. El mes es el del relay: vuelve a empezar a medianoche del día 1 en la zona horaria del relay. Los límites de gasto fijados en Console se aplican además.

La misma nota y los mismos botones aparecen cuando Claude API no tiene clave (relay.claude-api-not-configured) o está desactivado: el turn no se ejecuta. New Chat también rechaza entonces un chat de Claude API, con CLAUDE_API_NOT_CONFIGURED.

La tarjeta de consumo #

📊 Check Usage (Ver consumo) tiene una pestaña Claude API mientras haya una clave guardada, también con Claude API desactivado, para que el gasto del mes siga a la vista. Muestra lo que se estima que han costado los turns de este relay con la clave:

La barra cambia de color al 50 % y al 75 % del límite y se vuelve roja al 90 %, como todas las barras; consulta Leer una tarjeta. La tarjeta enlaza a Console billing (Facturación de Console) y Console limits (Límites de Console).

De dónde salen las cifras. Son la propia estimación de Claude Code a partir de su tabla de precios, para los turns con la clave guardada en este relay, así que incluyen subagents, compactación y búsqueda web. OAR no tiene tabla de precios propia. Los días y el mes siguen el reloj y la zona horaria del relay. También se cuentan los turns pagados con el crédito de API que viene con un plan Max o Team; OAR no puede ver ese crédito, ni el saldo de Console. La página de facturación de Console tiene las cifras reales y el saldo.

Tokens sin precio. Un modelo para el que Claude Code no tiene precio muestra no price known en lugar de un importe, nunca 0 $. Un total que deja fuera esos tokens dice (estimate incomplete).

Un agente puede leer la misma tarjeta con la acción usage de relay_tool.

Modelos #

El relay pregunta a Anthropic qué modelos puede usar la clave (GET /v1/models) cuando guardas una clave, cuando vuelves a activar Claude API y con Refresh models, en la pestaña o como Refresh (Actualizar) en 🤗 Select Models. Una solicitud se abandona a los 10 segundos.

• Hasta la primera respuesta la pestaña ofrece los modelos de la pestaña Claude, con la nota Not listed by Anthropic yet: these are the Claude tab's models until the key's list is read.
• Una solicitud fallida conserva la lista que tenía el relay; Refresh models dice Claude API model discovery failed. The stored models were kept: ….
• Contexto largo. Un modelo con una ventana de 1M tokens o más, o uno cuya variante de 1M lista la pestaña Claude, también recibe su variante [1m], que se ofrece en el desplegable Context window (Ventana de contexto) como en Claude.
• Cuáles se muestran. 🤗 Select Models → Claude API (Seleccionar modelos → Claude API) elige qué modelos ofrece el área de redacción. El Default model siempre se ofrece.
• Por mensaje. Un chat puede cambiar de modelo entre turns, como en Claude.

Reasoning effort #

El selector de effort funciona como en Claude. Los niveles vienen de la lista de modelos de Anthropic: none y los niveles que informa el modelo, más Ultracode en un modelo que tiene xhigh. Un modelo que no informa de soporte de effort solo ofrece none. Antes de leer la lista de la clave, un modelo tiene los niveles que le da la pestaña Claude. El cuadro de diálogo 🧠 tiene los mismos controles de Thinking (Razonamiento) que en Claude.

Compartido con Claude #

La atribución de commits, el límite de comandos en segundo plano, los niveles de effort y la ventana de compactación son los de la pestaña Claude, así que un cambio solo cambia quién paga:

• la atribución de commits, con la elección de una carpeta desde el cuadro de diálogo 🧠;
• el límite de comandos en segundo plano;
• la ventana de compactación automática.

Una sola carpeta de configuración de Claude. Los chats de Claude API usan la misma carpeta de Claude Code que los chats con suscripción (~/.claude, o CLAUDE_CONFIG_DIR): las mismas skills, plugins, servidores MCP y transcripciones. Eso es lo que permite a un chat conservar su sesión cuando cambia. Los ajustes de esa carpeta o de la .claude/ de la carpeta del chat no pueden desviar la clave: el relay fija la dirección de Anthropic y la clave por encima de ellos.

Lo que no se aplica con la clave. Los medidores del plan de Claude y la pausa por límite de uso no se aplican: un turn que Anthropic rechaza falla con una nota. Los chats de Claude API se ejecutan con todos los hooks y la línea de estado desactivados; consulta Seguridad.

Para todo lo demás, lee Claude. Donde otras páginas describen lo que hacen los chats de Claude, como los subagents, las tareas en segundo plano, la compactación, el tablero del plan, las tarjetas de pregunta o el botón de enviar durante un turn, un chat de Claude API hace lo mismo.

Límites #

• Una clave fuera de un workspace recibe HTTP 400. Anthropic responde con HTTP 400 a una clave que no está vinculada a un workspace, y la pestaña dice API key saved, but Anthropic refused it: …. Crea la clave dentro de un workspace en Claude Console y guarda esa. Está previsto poder indicar el workspace en OAR.
• Modelos sin precio. Un modelo para el que Claude Code no tiene precio, actualmente Claude Haiku 5.5, muestra no price known en la tarjeta. Sus tokens quedan fuera de la estimación y del límite.
• La estimación es la de este relay. No incluye otros usos de la clave; Console tiene todas las solicitudes.
• Sin saldo. OAR no lee el saldo de Console ni el crédito de API del plan.
• Sin URL base. La clave va solo a https://api.anthropic.com. No hay ningún ajuste para otro endpoint.
• El agente puede leer la clave. Consulta Seguridad.

Códigos de error #

Una respuesta fallida de Claude API termina con Error code: relay.<code>. y, para algunos códigos, con botones que llevan directamente a la solución:

Claude API settings abre Settings → Providers → Claude API. Add funds y Console billing abren la página de facturación de Console, Console limits su página de límites. Switch to subscription mueve el chat a tu suscripción a partir de su siguiente turn; vuelve a enviar el mensaje.

Los rechazos propios del relay también tienen códigos:

Solución de problemas #

Seguridad #

Dónde se guarda la clave. La clave se almacena en la base de datos del relay en la máquina del relay y nunca se envía a un navegador: la pestaña solo dice que hay una guardada. El relay la usa él mismo para una única solicitud, la lista de modelos, y la envía a https://api.anthropic.com y a ningún otro sitio. Solo llega a los workers de los chats de Claude API, donde las sesiones se ejecutan bajo tmux a través de un archivo que solo puede leer el usuario del relay. Dentro del worker llega a Claude Code en su entorno y en ajustes entregados por su entrada estándar, nunca en su línea de comandos, que pueden leer otros usuarios de la máquina. Una clave en el entorno propio del relay (ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN) no llega a ningún chat.

Lo que puede ver el agente. Los propios comandos del agente pueden leer la clave de su entorno, como con cualquier clave que tenga una CLI. El relay sustituye la clave por [redacted] en todo lo que publica un worker y en el registro del worker, desde el momento en que se guarda, como en DeepSeek. Eso la mantiene fuera de lo que OAR almacena y muestra; no es ninguna barrera frente al agente.

La credencial se comprueba, y una solicitud de modelo puede adelantarse. Un chat de Claude API comparte la carpeta de Claude Code donde vive tu inicio de sesión de Claude. El relay fija la clave guardada por encima de cualquier credencial de los ajustes de esa carpeta o de la carpeta del chat, y cuando el informe de arranque de Claude Code nombra otra fuente para su clave, el relay detiene el turn de inmediato (relay.claude-api-key-source). Claude Code no espera a esa comprobación: envía su primera solicitud de modelo unos 50 a 90 ms después del informe, así que una solicitud de modelo puede haber salido ya con la otra credencial, por ejemplo tu inicio de sesión de Claude, antes de que llegue la detención. La comprobación limita una credencial equivocada a esa única solicitud de modelo; no la impide. La misma comprobación funciona en sentido contrario en un chat con tu suscripción; consulta Claude.

Sin hooks. Claude Code en un chat de Claude API arranca con todos los hooks desactivados: no se ejecutan ni los tuyos (~/.claude) ni los de la carpeta del chat (.claude/settings.json, settings.local.json) ni los de un plugin, y tampoco ningún comando de línea de estado. Se ejecutarían como el usuario del relay con la clave en su entorno. El ajuste está en la línea de comandos de Claude Code, así que un archivo de ajustes no puede volver a activarlos. Los hooks de los ajustes gestionados, los del administrador de la máquina, sí se ejecutan. Los chats con tu suscripción conservan sus hooks y su línea de estado.

Lo que va a Anthropic. Todo lo que el agente lee y escribe durante un turn, como en un chat con suscripción.

Más en Seguridad.