Coding Plan: Planes de Suscripción y Facturación
📚 Navegación de la serie: El artículo anterior 05 Conexión a modelos de terceros / nacionales te enseñó a conectar DeepSeek, Kimi, GLM a Claude Code. Este artículo aclara las cuentas: qué plan deberías suscribir, cómo se gasta el dinero, cómo consultar el uso y cómo ahorrar.
Hay un número en la documentación oficial que podría sorprenderte a primera vista: en implementaciones empresariales, cada desarrollador quema en promedio unos $13 al día en días activos, y entre $150–250 al mes (Fuente: documentación oficial sobre costs). $13 al día, unos cuantos cientos de yuanes/pesos, ¡casi dos mil al mes! Y eso es solo el "promedio".
Yo mismo lo sufrí cuando conecté Claude Code a la API oficial (pago por uso) por primera vez: sin ninguna alerta de uso instalada, trabajé sin parar durante una semana. Al abrir la Console el fin de semana, vi una factura de poco más de $40; no es una fortuna, pero no tenía idea de en qué se había gastado: ¿Qué conversación consumió más? ¿Elegí mal el modelo o sobrecargué el contexto? Una cuenta confusa.
Este artículo está aquí para aclarar esas cuentas. Entender la lógica de facturación es mucho más importante que buscar ciegamente un plan barato: con el mismo plan, alguien que sabe usarlo lo hace durar un mes, alguien que no sabe lo agota en tres días.
Después de leer este artículo, obtendrás:
- Una tabla de comparación: "Pago por uso vs Suscripción oficial vs Coding Plan Nacional", para que sepas qué camino elegir.
- Entender la unidad de facturación de Claude Code (token) y saber exactamente en qué se gasta el dinero.
- Varios comandos (
/usagepara ver uso,/usage-creditspara establecer límite,/statuspara verificar configuración) para vigilar tus gastos por ti mismo. - Un conjunto de hábitos para ahorrar dinero probados en la práctica: para el mismo trabajo, podrás quemar muchos menos tokens.
01 Primero entiende: ¿Por qué estás pagando?
Primero la conclusión: Claude Code en sí mismo es gratuito, por lo que pagas es por el "poder de cómputo del modelo".
Claude Code es solo una herramienta de línea de comandos que se ejecuta en tu terminal; descargarlo no cuesta dinero. Lo que realmente cuesta dinero es el gran modelo detrás de él: tus preguntas, cuando lee archivos, cuando escribe código, todo debe enviarse al modelo para ser procesado, y este volumen de procesamiento es la unidad de facturación.
Analogía: Claude Code es el taxi, el modelo es el kilometraje. Subir al taxi y sentarse es gratis, pero una vez que arranca, cada kilómetro recorrido se suma al taxímetro: cuanto más preguntes, cuanto más grandes sean los archivos que le pidas leer, cuanto más tiempo "piense", más "kilometraje" será.
La unidad de medida de este "kilometraje" se llama token. Analogía: un token es la "palabra facturable" de los textos. El modelo corta el texto en pequeñas partes para contarlas: según el glosario de la plataforma oficial de Anthropic, para Claude, 1 token representa aproximadamente 3.5 caracteres en inglés, el número exacto varía según el idioma (no se da una proporción fija para chino); lo que tú envías se cuenta como "tokens de entrada", y lo que él devuelve como "tokens de salida", se cobran por separado y la salida suele ser más cara.
Veamos un par de escenarios que te encontrarás todos los días, para sentir cómo se acumulan los tokens:
- Si le pides: "Lee este archivo de 2000 líneas y luego modifícalo": todo el archivo se convierte en tokens de entrada y se envía.
- En una conversación que llega a su 50º mensaje: los 49 mensajes anteriores, actuando como contexto, se reenvían cada vez (este es el mayor gasto; el hábito de usar
/clearmencionado en la sección 05 va directamente enfocado a esto). - Si usas el pensamiento extendido (extended thinking), y "piensa" un gran párrafo antes de actuar: todo ese proceso de pensamiento cuenta como tokens de salida.
Así que cuánto dinero gastas no tiene mucha relación con "cuántas preguntas haces", pero tiene muchísima relación con "cuánto contexto le metes en cada ocasión": este es el concepto central para ahorrar dinero más adelante.
💡 Resumen en una frase: La herramienta es gratuita, por lo que pagas es por la tarifa de cómputo del modelo basada en tokens: entrada + salida + pensamiento, todo se cobra.
02 Cómo elegir entre tres caminos: Pago por uso / Suscripción oficial / Coding Plan nacional (chino)
Ahora que sabemos que pagamos por tokens, la siguiente pregunta es: ¿A través de qué canal se paga este dinero? Principalmente hay tres vías, primero veamos la tabla y luego hablemos claro.
| Plan | Cómo se cobra | Costo mensual (Ref.) | Para quién es | Principales riesgos / contras |
|---|---|---|---|---|
| Pago por uso oficial (API / Console) | Por token consumido, pagas lo que usas | Variable, uso intensivo $150–250+ | Quieren usar modelos nativos oficiales, uso estable | Factura variable, riesgo de excederse; requiere vincular tarjeta (USD) |
| Suscripción oficial (Pro / Max / Team) | Tarifa mensual fija, incluye cierta cuota | Fijo (según precios oficiales) | Uso frecuente, buscan gasto fijo, quieren modelo oficial | Pago internacional, necesita VPN; la cuota tiene límite |
| Coding Plan nacional (Fangzhou / Bailian, etc.) | Tarifa mensual fija, cuota compartida | Bajo, frecuentes promociones el primer mes | Usuarios en China, sensibles al costo, aceptan modelos nacionales | El modelo no es Claude; cuotas según fabricante; precios cambian |
Estos tres caminos no se tratan de "cuál es el mejor", sino de "quién eres tú". Añadamos un par de puntos fuera de la tabla:
Las dos rutas oficiales: El pago por uso emplea los modelos Claude nativos (nivel top en programación), es la más flexible pero la factura varía (los $40 confusos de antes salieron de aquí); la suscripción tiene la menor carga psicológica, Max es ideal para usuarios intensivos, pero requiere pago en el extranjero + VPN. Los precios y planes exactos se deben consultar siempre en claude.com/pricing, no los dejaremos fijos aquí.
El Coding Plan nacional es actualmente la opción más práctica para los desarrolladores en China. Plataformas como Volcengine (Fangzhou), Alibaba Cloud (Bailian) y iFlytek (Xingchen) han lanzado un "Coding Plan": servicios de suscripción diseñados específicamente para herramientas de programación de IA, con tarifas mensuales fijas, mucho más bajas que el pago por uso, y compatibles con Claude Code. Integran modelos como Qianwen, Kimi, GLM, DeepSeek, Doubao, MiniMax, y permiten compartir una misma cuota entre múltiples herramientas (Cursor, Cline, etc.).
⚠️ Las promociones de precios de los Coding Plan nacionales son extremadamente frecuentes, los "9.9 / 49.9 el primer mes" que circulan en línea son precios de actividades temporales, pueden cambiar o retirarse en cualquier momento. Este artículo no cita cantidades específicas, dirígete directamente a las páginas de eventos de los fabricantes para ver el precio actual.
El método de conexión (Base URL, ANTHROPIC_MODEL) ya se explicó en detalle en el artículo anterior, así que no lo repetiremos. Pero hay una gran trampa de facturación que debe destacarse de forma independiente en la siguiente sección.
💡 Resumen en una frase: Para lo nativo oficial, elige suscripción o pago por uso; para ahorrar en China, elige Coding Plan. Decide primero quién eres y luego escoge tu camino; no te fijes solo en el precio.
03 La trampa de facturación de los Coding Plan: Base URL equivocada, dinero tirado
Se destaca de forma independiente porque demasiadas personas caen aquí: compran un Coding Plan, pero a fin de mes reciben una factura adicional. La raíz es: Un mismo proveedor a menudo tiene dos conjuntos de Base URL, uno para la cuota de la suscripción y otro para el pago por uso, y se ven muy parecidos. Tomando a Volcengine (Fangzhou) como ejemplo:
| Base URL | De qué bolsillo sale | Propósito |
|---|---|---|
https://ark.cn-beijing.volces.com/api/coding | ✅ Consume la cuota del Coding Plan | Al conectar Claude Code, debes usar esta |
https://ark.cn-beijing.volces.com/api/v3 | ❌ No usa el plan, te cobra extra por uso | Llamadas normales a la API |
¿Notaste la diferencia? Es solo una palabra: coding frente a v3. Compras un plan pensando que el pago mensual fijo es tu límite, pero al configurar la herramienta, tu mano resbala y pones /api/v3. La cuota de tu plan no se mueve en absoluto, y todas tus llamadas pasan a cobrarse por uso; a final de mes tendrás que pagar de tu bolsillo. En Alibaba (Bailian) pasa algo similar: su Key exclusiva de Coding Plan (empieza con sk-sp-) y la Key de pago por uso (empieza con sk-) no se pueden intercambiar, mezclarlas te causará el mismo problema.
Por lo tanto, al conectarte a un Coding Plan nacional, recuerda dos reglas de oro: la Base URL debe contener la palabra coding; usa la API Key exclusiva para el plan, no uses la de pago por uso. Estas direcciones específicas y prefijos de Key son reglas privadas de los proveedores externos y cambian según el fabricante; antes de actuar, confía en la documentación oficial o la consola del proveedor correspondiente en ese momento.
Si configuras por error a v3 en Fangzhou, si te acostumbras a ejecutar /usage esa noche para ver tu consumo, notarás: "¿Por qué no se ha movido mi cuota, pero hay números en el pago por uso en mi Console?" y podrás corregirlo rápidamente de nuevo a coding. Estas trampas son difíciles de detectar a simple vista en la configuración, debes monitorear tu uso para atraparlas.
💡 Resumen en una frase: Comprar un plan ≠ usar el plan. Base URL con
coding, Key exclusiva del plan, revisa esto en cuanto termines de configurar, de lo contrario, el dinero se te escapará silenciosamente por otro agujero.
04 Cómo comprobar el consumo: Tres comandos para vigilar tu cartera
Pagar sin mirar cuánto consumes es como conducir con los ojos vendados. Claude Code tiene incorporados algunos comandos para que sepas en todo momento en qué te gastas el dinero. Vamos uno a uno.
/usage: El panel de consumo más completo (el más utilizado)
Escribe directamente en el cuadro de chat:
/usageEl bloque de la Sesión (Session) en la parte superior muestra el uso detallado de tokens de la conversación actual, y se ve así (fuente: documentación oficial sobre costs):
Total cost: $0.55
Total duration (API): 6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes: 0 lines added, 0 lines removedLas cuatro líneas son: costo total estimado, tiempo de procesamiento real de la API, tiempo de reloj (tiempo con la ventana abierta), líneas de código modificadas. Haz costumbre ejecutar esto después de terminar cada tarea para tener una idea del costo de esa sesión. Sin embargo, hay un aviso importante del equipo oficial:
La cifra en dólares en el bloque de Sesión se calcula localmente a partir del conteo de tokens y puede diferir de la factura real. Para conocer la facturación oficial y definitiva, consulta la página de uso en la Claude Console. (Fuente: doc. de costs)
Si estás usando las suscripciones oficiales Pro / Max / Team / Enterprise, /usage también tendrá un bloque adicional de desglose de cuota (credits): muestra el consumo reciente desglosado por skills, subagents, plugins y servidores MCP, y permite cambiar con d / w entre "últimas 24 horas / 7 días". Ten en cuenta que esto es una estimación aproximada calculada a partir del historial de la sesión local, y no incluye el consumo de otros dispositivos o de claude.ai. (Fuente: doc. de costs)
/usage-credits: Establece un límite mensual (el salvavidas contra sobregiros)
Esta es una función exclusiva de los planes oficiales Pro / Max (Fuente: doc. de costs):
/usage-creditsTe permite establecer un límite de gasto mensual en tu cuota de uso. Una vez que alcances esa cifra, Claude Code te avisará preguntando si quieres "aumentar el límite o eliminar la restricción", dándote la opción de decidir directamente desde la línea de comandos (CLI). Cambiar esta restricción requiere permisos de acceso a la facturación (billing access) de la cuenta.
Para los principiantes, se recomienda encarecidamente usar esto desde el primer día para poner un tope: por ejemplo, un presupuesto de 10 dólares al mes; que te detenga al alcanzarlo es mucho mejor que llevarse un susto con la factura a fin de mes. Mis inexplicables $40 se debieron precisamente a que, en aquel entonces, no sabía que existía este comando.
Y también está /status, abre la pestaña de Status en el panel de configuración, que, según la doc. de commands oficial, te mostrará version, model, account, connectivity (versión, modelo, cuenta, conectividad). El equipo oficial aconseja en su documentación de integración con terceros "usar /status para verificar si las configuraciones de proxy o pasarela se aplicaron correctamente". Esta es exactamente la herramienta del capítulo anterior para revisar tus configuraciones de acceso; teclea esto después de configurar un plan, comprueba que el modelo y la conectividad estén bien antes de empezar a trabajar.
| Comando | Para qué sirve | A tener en cuenta |
|---|---|---|
/usage | Consultar consumo de tokens y estimación de gasto en la sesión actual | El precio es una estimación local, mira la Console para la factura real |
/usage-credits | Fijar límite de uso mensual, evitar sobregiros | Solo disponible para los planes oficiales Pro / Max |
/status | Comprobar version, model, account, conectividad | Primer paso para comprobar si la configuración se ha aplicado |
💡 Resumen en una frase:
/usagepara ver el desglose,/usage-creditspara fijar límites,/statuspara revisar la configuración: tres comandos para sellar tu cartera a cal y canto.
05 La verdadera destreza del ahorro: Hacer el mismo trabajo quemando menos tokens
Cambiar a planes baratos no es la mejor estrategia; saber usar las herramientas sí lo es. Volviendo a la frase de la sección 01: lo que gastas está extremadamente correlacionado con cuánto contexto le envías, así que la esencia del ahorro se reduce a una oración: No dejes que el modelo lea basura ni que se pierda pensando sin rumbo. Lo siguiente proviene de la doc. oficial (costs), seleccionando lo que da resultados más rápidos para los novatos.
Primero, usa /clear para limpiar entre tareas. Este es el hábito con mayor retorno de inversión.
/clearAntes, yo solía dejar una sola ventana abierta de la mañana a la noche, depurando errores y añadiendo nuevas funciones, todo mezclado en una sesión, por pura pereza de cambiar. El problema es la acumulación de contexto: cada pregunta de la tarde enviaba de nuevo las conversaciones de la mañana que ya no servían, duplicando los tokens. Solo al vigilar con /usage me di cuenta de que cada mensaje de la tarde me costaba significativamente más que los de la mañana; así es como se quemaba el dinero. El equipo oficial dice textualmente:
Utiliza
/clearpara empezar de cero al cambiar a una tarea no relacionada. El contexto obsoleto desperdiciará tokens en cada mensaje posterior.
Fórmate un hábito: en cuanto termines una tarea aislada, lanza un /clear. Nunca encadenes trabajo que no esté relacionado en una sesión antigua. Solo con este movimiento, reducirás los enormes gastos de las sesiones largas de golpe.
Segundo, elige el modelo adecuado; no mates moscas a cañonazos. El principio oficial es que "Sonnet maneja la mayoría de las tareas de programación fantásticamente y cuesta menos que Opus; reserva Opus para arquitecturas complejas y razonamiento multipaso" (Fuente: doc. de costs). En cristiano: para cambios de código del día a día, escribir funciones o ajustar pequeños errores, con Sonnet basta y sobra; solo acude al /model para cambiar a Opus ante un "hueso duro de roer" como refactorizar un módulo completo. Las tareas de subagents, al ser más simples, incluso pueden especificarse en la configuración del subagent para correr con Haiku y costar aún menos. Por defecto, usa Sonnet, con dos o tres cambios a la semana es suficiente.
Tercero, para tareas complejas usa el plan mode (modo de planificación) primero. Pulsa Shift+Tab para entrar, dejando que explore la base de código y proponga un plan para que lo apruebes antes de meterle mano. Rehacer trabajo por equivocarse de rumbo es lo que más dinero quema. Una trampa común: le pides que cambie un requerimiento poco claro, se enfrasca a cambiar siete u ocho archivos, se equivoca de dirección y todo ese gasto en tokens se va por el sumidero.
Cuarto, sé más concreto en los prompts. Cuanto más impreciso seas, más va a tener que rebuscar por todos los archivos adivinando qué quieres; cada archivo que mira cuesta tokens. Comparación textual oficial: decirle "Mejora este proyecto" provoca un escaneo masivo; pero "Añade validación de entrada a la función de login en auth.ts" lo hace trabajar de forma eficiente tocando el mínimo número de archivos.
Usa esta tabla como "referencia rápida de ahorro" para pegarla junto a tu pantalla:
| Malos hábitos ❌ | Buenos hábitos ✅ | Dónde está el ahorro |
|---|---|---|
| Usar la misma sesión de sol a sol | /clear entre tareas | No se reenvía contexto viejo |
| Mantener Opus todo el rato | Sonnet por defecto, Opus solo si hay lío | El precio unitario es menor |
| Dar órdenes a ciegas | Modo plan para tareas difíciles | Menos rodeos y menos escaneos a ciegas |
| "Mejórame el código" | "Mete validación al login en auth.ts" | Menos archivos irrelevantes que leer |
Dato curioso (Fuente: doc. de costs): Incluso inactivo, Claude Code gastará un poquito de tokens, por ejemplo, para resumir charlas antiguas de fondo al usar claude --resume. Pero es una cantidad insignificante; usualmente supone menos de $0.04 por sesión, no te preocupes.
💡 Resumen en una frase: Ahorrar no es cambiar de tarifa, es usar
/cleara menudo, tener a Sonnet de base, planificar si es complejo y hablarle claro. A menor contexto, más fina será la factura.
06 Práctica: Tres pasos para tener a raya tus gastos de la semana
Tanto hablar y nada de práctica no sirve de nada. Sigue ahora mismo estos tres pasos; en cinco minutos crearás un "sentido del consumo".
Requisito previo: Tienes Claude Code instalado y configurado (ya sea con suscripción oficial o un Coding Plan local), como vimos en los artículos anteriores. Inicia la aplicación en el directorio del proyecto:
cd ruta/a/tu_proyecto
claudePaso uno: Verifica que no te equivocaste en la configuración de la conexión.
/statusSe abrirá la pestaña de Status en la interfaz de configuración; de acuerdo con la doc. de commands oficial, verás version, model, account, connectivity (versión, modelo, cuenta, conectividad). Asegúrate sobre todo de que el modelo es el que quieres usar y la conectividad es normal; de lo contrario, la conexión no se ha hecho bien.
La URL Base en sí misma no está en la salida del comando /status, deberás revisar las variables de entorno que escribiste. Si usas un Coding Plan nacional, verifica que ANTHROPIC_BASE_URL incluya la palabra coding (p.ej. .../api/coding), y no sea una dirección de pago por uso como /api/v3. Si te equivocaste, regresa a modificar las variables de entorno como vimos en el artículo 05, cierra y vuelve a abrir tu terminal antes de reiniciar.
Paso dos: Hazle cualquier pregunta a ver cuánto gasta. Pídele que haga un pequeño trabajo:
Dime qué archivos hay en este directorio y explícame por encima para qué sirve este proyecto.Cuando termine de contestar, teclea:
/usageEl bloque superior de Sesión (Session) se verá así:
Total cost: $0.0X
Total duration (API): Xs
Total duration (wall): Xs
Total code changes: 0 lines added, 0 lines removedGrábate ese número. Este es el costo de "hacer una pregunta fácil + leer el directorio". Cuando tengas esto como referencia, la próxima vez que una charla queme dinero inusualmente rápido te darás cuenta al instante.
Paso tres: Configura un límite mensual (solo usuarios de los planes oficiales Pro / Max).
/usage-creditsPon un límite que estés dispuesto a asumir siguiendo las instrucciones. Al alcanzarlo, la aplicación te frenará e interrogará si deseas subirlo; es decir, le habrás puesto un seguro a tu monedero.
Usuarios de Coding Plan nacionales:
/usage-creditsestá enfocado a las cuotas de uso oficiales, podría no valer para el servicio de tu proveedor. Confía en el uso y cuotas de la consola de tu proveedor en su lugar, pero sigue usando diligentemente los comandos/usagey/clear.
Después de repasar estos tres pasos, has subido de nivel, pasando de "gastar a ciegas" a "saber constantemente cuánto has gastado, además de tener una compuerta instalada".
💡 Resumen en una frase:
/statusrevisa la conexión →/usageestablece una base de referencia →/usage-creditsconfigura un techo de gasto. Cinco minutos para retomar el control de tus finanzas.
07 Resumen
En este artículo hemos desgranado todo lo referente al "dinero" en Claude Code, céntimo a céntimo.
| Lo que aprendiste | Puntos clave |
|---|---|
| Por qué estás pagando | La herramienta es gratis, pagas por el cómputo del modelo según el conteo de tokens |
| Cómo elegir entre las tres opciones | Nativo oficial → Suscripción / Pago por uso; Ahorro local (China) → Coding Plan |
| La trampa de los planes nacionales | Selecciona la Base URL con coding y usa una API key exclusiva |
| Cómo ver tu consumo | /usage para el desglose, /usage-credits para el límite mensual, /status para chequear la configuración |
| Cómo ahorrar | /clear frecuentemente, usa Sonnet por defecto, primero planea en tareas complejas, y dale órdenes explícitas |
Si te tienes que llevar una sola cosa: El gasto está muchísimo más relacionado con "cuánto contexto le estás metiendo" que con "cuántas preguntas le has hecho". Al comprender esto en su totalidad serás capaz de inventarte nuevas tácticas de ahorro: saber leer los recibos de las facturas, monitorear los desembolsos actuales en la sesión, colocar un tope al presupuesto mensual, logrando trabajar con mayor eficiencia; teniendo esto en cuenta ya has dominado este apartado.
⚠️ Te recodamos acerca de la precisión una última vez: La información mencionada en este artículo sobre precios de suscripción, eventos promocionales, y normativas sobre cuotas cambiará con el tiempo; rígete estrictamente por las cifras aportadas oficialmente en claude.com/pricing o las páginas de los proveedores locales del momento. El comportamiento de comandos como /usage-credits debe seguir siempre la documentación sobre costos oficial, que podría verse alterada a través de actualizaciones a nuevas versiones (verifica con claude --version).
Teniendo las cuentas al corriente y una vez seleccionado tu plan; en el siguiente capítulo iremos a la acción en nuestro capítulo 07 "Primera Vez de Uso: Ejecutando tu primer ejemplo" — para poner Claude Code en marcha oficialmente. Despegando desde un auténtico aunque diminuto proyecto para llevar a cabo de propia mano el ciclo de la agente: "Piensa → Actúa → Observa". Nos preparamos hasta acá lo suficientemente bien como para ensuciarnos las manos verdaderamente por primera vez.