¿Cuánto me cuesta la API de Claude este mes?

Última actualización: 30 de septiembre de 2026

Inicia sesión en la Claude Console y abre la página Cost: elige el mes y verás lo que ha gastado tu organización, por modelo y por espacio de trabajo. Lo que te queda de crédito está en Settings → Billing. Fuera del navegador, la Cost API devuelve las mismas cifras, pero solo a una credencial de administrador como una Admin API key. Un plan de Claude como Pro o Max se factura aparte y no forma parte de esa suma.

Dónde está la cifra

Inicia sesión en la Claude Console y abre la página Cost. Elige el espacio de trabajo, el modelo y el mes; muestra un gráfico de costes diarios y el total, con la búsqueda web y la ejecución de código incluidas.

Página Cost (platform.claude.com/cost): dólares gastados. Elige un espacio de trabajo o «All Workspaces», un modelo o «All Models». Puedes exportar los datos como CSV.
Página Usage (platform.claude.com/usage): tokens, no dólares: entrada y salida por modelo y clave de API, solicitudes detenidas por límites de frecuencia y tu tasa de caché. También con exportación a CSV.
Página Billing (Settings → Billing): tu saldo de crédito, tu consumo de crédito y tu límite de gasto.

Necesitas el rol Developer, Billing o Admin para ver los informes. Ninguna de las dos páginas desglosa los costes por persona; Anthropic lo dice con claridad. Para Claude Code hay una API de analítica aparte con costes estimados por usuario.

Créditos, recarga automática y qué pasa al llegar a cero

Por defecto pagas por adelantado. Compras créditos en Settings → Billing → Buy credits, y cada solicitud los va gastando a los precios vigentes. Claude Code, cuando inicias sesión con una cuenta de la Console, gasta de los mismos créditos.

A cero ya no puedes llamar a la API ni usar el playground hasta que añadas más.
La recarga automática compra créditos por ti. Tú fijas el saldo que activa una compra y el importe hasta el que recargar.
Los créditos caducan un año después de la compra. La fecha no se puede ampliar y las compras no se reembolsan.
Solo se facturan las llamadas correctas; las solicitudes fallidas no cuestan nada.

Algunas organizaciones con contrato comercial reciben una factura mensual en su lugar. Para ellas, la página Cost es el total acumulado hasta que llega la factura.

Mantén separadas dos cifras. El saldo es lo que queda de los créditos que compraste. El coste es lo que gastaste. Si compras créditos a mitad de mes, el saldo salta y el coste no: para el gasto de este mes, mira la página Cost.

Límites de gasto y avisos

Cada nivel de uso lleva un tope mensual: Anthropic indica 500 USD para Start, 1000 USD para Build y 200 000 USD para Scale. Si lo alcanzas, la API se pausa hasta las 00:00 UTC del primer día del mes siguiente, con HTTP 429 y el código de error enforced_spend_limit_reached, salvo que antes pases a un nivel superior.

Tu propio límite para la organización: Settings → Billing → Spend limits → Adjust limit (o Set limit). No puede superar el tope de tu nivel. Una vez alcanzado, las solicitudes devuelven HTTP 400 con un mensaje que empieza por «You have reached your specified API usage limits».
Por espacio de trabajo: Settings → Workspaces, y después la pestaña Spend limits del espacio de trabajo. El límite debe ser inferior al de la organización; sin él, se aplica el de la organización. El Default Workspace no admite un límite.
Avisos: en la misma pestaña, «Add notification» envía un correo electrónico cuando el gasto del espacio de trabajo llega a un importe que fijas. Solo los administradores de la organización pueden cambiar estos ajustes.

El espacio de trabajo Claude Code, que la Console crea en el primer inicio de sesión de Claude Code, es el único que admite límites de gasto mensuales por usuario.

Por qué la cifra va con retraso

Anthropic dice que los datos de uso y coste suelen aparecer en los cinco minutos siguientes a una solicitud, aunque el retraso puede ser a veces mayor.

La Cost API cuenta en días enteros en UTC. En Suiza, un mes nuevo empieza a la 01:00 o a las 02:00 hora local, no a medianoche. Y la cifra de hoy sigue creciendo hasta que se cierra el día.

Consultar la API tú mismo

La Cost API forma parte de la Admin API. Una clave de API normal no sirve. El informe de costes necesita una clave de API de administrador (Admin API key), que empieza por sk-ant-admin01- y que solo pueden crear los administradores de la organización. Las cuentas individuales no tienen acceso a la Admin API.

Creas la clave en Settings → Admin keys (platform.claude.com/settings/admin-keys). Solo se muestra una vez. Una clave limitada a un espacio de trabajo es rechazada. Si tu cuenta de la Console aún no tiene una organización, créala antes en Settings → Organization.

curl "https://api.anthropic.com/v1/organizations/cost_report?\
starting_at=2026-09-01T00:00:00Z&\
limit=31&\
group_by[]=description" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Los intervalos (buckets) siempre abarcan un día. Sin limit obtienes siete días; el máximo es 31.
Suma amount de todos los results en data. Ojo: el importe es una cadena decimal en centavos. "123.45" en USD significa 1,23 USD, así que divide entre 100.
group_by[]=description añade el modelo y el tipo de token a cada línea; workspace_id desglosa por espacio de trabajo. El Default Workspace aparece como null.
Si has_more es true, vuelve a preguntar con page igual a next_page.

Los costes de Priority Tier se facturan por otra vía y no aparecen en este informe. Los recuentos de tokens vienen de /v1/organizations/usage_report/messages, en tramos de un minuto, una hora o un día. Anthropic permite consultarlo una vez por minuto.

¿Un plan de Claude cubre los costes de la API?

No. Un plan de pago de Claude no incluye la API ni la Console. La API se factura aparte, mediante créditos que compras en la Console.

Eso vale igual para Pro, Max, Team y Enterprise. ¿Quieres usar los dos? Entonces pagas un plan en claude.ai y configuras además la facturación en la Console. Cómo funcionan los límites del propio plan lo explica Cómo vigilar los límites de uso de Claude. La misma pregunta para OpenAI se responde en ¿Cuánto me está costando la API de OpenAI este mes?

En AI Cockpit

La tarjeta de la API de Anthropic lee el informe de costes citado arriba, con una clave de administrador que introduces tú, y solo lee. Sin esa clave se queda vacía; si el informe rechaza la clave, avisa de que hace falta una clave de administrador de una organización. Es una tarjeta para el gasto de la API, no para el plan de Claude.

Barra de menús del Mac: hoy, el mes en curso y el total desde el primer día con costes. Debajo, las cinco partidas de coste más altas con mes y total, una curva de los últimos 30 días (activada por defecto) y un aviso cuando hoy va a 1,8 veces o más tu día mediano.
iPhone y iPad: hoy, el mes en curso y el total. El mes cuenta también en la línea de coste total que hay sobre las tarjetas.
Apple Watch (a través de la app del iPhone): una línea con hoy y el mes.

Se actualiza cada 15 minutos por defecto; puedes elegir de 5 a 60 minutos. Lo que no hace: mostrar tu saldo de crédito, tus límites de gasto ni tokens, ni comprar créditos. Como la tarjeta no tiene ningún tope con el que comparar, tampoco tiene umbrales de aviso en porcentaje. Para un tope propio, Mac 6.8 e iOS 2.9 añaden un presupuesto mensual para todos los costes de API juntos, con aviso al 75 % y al 100 %. Desde Mac 6.8 e iOS 2.8 la tarjeta convierte bien a dólares los céntimos del informe.

Qué servicios lee la app y por qué cada uno necesita su clave: Los costes de las API de IA de un vistazo. Respuestas breves sobre claves de administrador y tarjetas vacías hay en la página de FAQ.