docs(faq): answer why a Pro/Max subscriber gets billed for API tokens

content/docs/faq.es.mdx

@@ -3,7 +3,7 @@ title: Preguntas frecuentes
 description: Preguntas frecuentes sobre career-ops — coste, privacidad, CLIs de IA compatibles, scan vs scan:full, límites de tokens, configuración en Windows y lo que career-ops nunca hará en tu nombre.
 seoTitle: "FAQ de career-ops — coste, privacidad, CLIs compatibles, Windows y cómo ejecutarlo gratis"
 icon: CircleQuestionMark
-translationHash: 4e601743197dd0b8
+translationHash: 0dc5bb97795f8530
 localized: true
 translatedFrom: /docs/faq
 ---
@@ -24,6 +24,20 @@ career-ops no tiene planes de pago, ni versiones de pago, ni pruebas: es 100% gr
 
 No. career-ops es agnóstico respecto a la IA — Claude Code es un motor entre varios, no un requisito. Puedes ejecutar el pipeline completo gratis con OpenCode más un proveedor gratuito, un modelo local vía Ollama, o el runner integrado de OpenRouter (`npm run or`). Si empezaste con un plan de pago y te quedaste sin tokens a mitad de búsqueda, cambiar a un motor gratuito lleva minutos y deja tus datos intactos — consulta [Configura un motor de IA gratuito](/docs/free-ai-engine).
 
+## Pago Claude Pro o Max. ¿Por qué career-ops me está gastando créditos de la API?
+
+Ejecuta `node doctor.mjs` desde la carpeta `career-ops`. Te dice en una línea cuál de los dos está usando esta sesión, antes de que gastes nada más.
+
+La regla no es nuestra: **la decide tu CLI, y `ANTHROPIC_API_KEY` gana.** Si esa variable está en tu entorno, Claude Code cobra por token aunque estés pagando Pro o Max. career-ops no elige tu fuente de facturación; solo la detecta y te avisa. Con la clave presente, el doctor dice:
+
+> ANTHROPIC_API_KEY is set, so it takes precedence over any Claude subscription: this session bills per token even if you pay for Pro or Max.
+
+Para volver a tu suscripción, quita la línea `export ANTHROPIC_API_KEY=...` de `~/.zshrc`, `~/.bashrc`, `~/.profile` o del `.env` del proyecto, reinicia la terminal y ejecuta `/login`. Las ejecuciones en batch son la excepción: los workers de `claude -p` no usan el login interactivo, así que necesitan `claude setup-token` exportado como `CLAUDE_CODE_OAUTH_TOKEN`.
+
+Si querías usar créditos de la API, no pasa nada y no hay que tocar nada.
+
+Esto aplica a los motores de Anthropic. Los demás CLIs (Codex, OpenCode, Copilot, Gemini, Qwen) fijan cada uno su propia regla de suscripción frente a clave, y career-ops no la comprueba: consulta la documentación de tu CLI.
+
 ## ¿Dónde se guardan mis datos? ¿career-ops es privado?
 
 En tu máquina, en archivos planos que son tuyos — tu CV, tu perfil, tu pipeline y tus informes son Markdown/YAML locales. Nada corre en servidores de career-ops. Las actualizaciones del sistema nunca tocan tu capa de datos (`cv.md`, `config/`, `data/`, `reports/`, `output/`): esa separación es el **Data Contract**, y todas las actualizaciones lo respetan.

content/docs/faq.fr.mdx

@@ -3,7 +3,7 @@ title: FAQ
 description: Questions fréquentes sur career-ops — coût, confidentialité, CLI d'IA pris en charge, scan vs scan:full, limites de tokens, installation sous Windows, et ce que career-ops ne fera jamais à votre place.
 seoTitle: "FAQ career-ops — coût, confidentialité, CLI pris en charge, Windows et utilisation gratuite"
 icon: CircleQuestionMark
-translationHash: 4e601743197dd0b8
+translationHash: 0dc5bb97795f8530
 localized: true
 translatedFrom: /docs/faq
 ---
@@ -24,6 +24,20 @@ career-ops n'a ni formule payante, ni paliers, ni période d'essai — il est 10
 
 Non. career-ops est agnostique en matière d'IA — Claude Code est un moteur parmi d'autres, pas une exigence. Vous pouvez exécuter l'ensemble du pipeline gratuitement avec OpenCode et un fournisseur gratuit, un modèle local via Ollama, ou le runner OpenRouter intégré (`npm run or`). Si vous avez commencé avec une formule payante et épuisé vos tokens en pleine recherche, passer à un moteur gratuit prend quelques minutes et laisse vos données intactes — voir [Configurer un moteur d'IA gratuit](/docs/free-ai-engine).
 
+## Je paie Claude Pro ou Max. Pourquoi career-ops consomme-t-il mes crédits API ?
+
+Lancez `node doctor.mjs` depuis le dossier `career-ops`. Il vous dit en une ligne lequel des deux cette session utilise, avant que vous ne dépensiez quoi que ce soit d'autre.
+
+La règle n'est pas la nôtre : **c'est votre CLI qui décide, et `ANTHROPIC_API_KEY` l'emporte.** Si cette variable est définie dans votre environnement, Claude Code facture au token même si vous payez Pro ou Max. career-ops ne choisit pas votre source de facturation ; il la détecte et vous avertit. Lorsque la clé est présente, le doctor affiche :
+
+> ANTHROPIC_API_KEY is set, so it takes precedence over any Claude subscription: this session bills per token even if you pay for Pro or Max.
+
+Pour revenir à votre abonnement, supprimez la ligne `export ANTHROPIC_API_KEY=...` de `~/.zshrc`, `~/.bashrc`, `~/.profile` ou du `.env` du projet, redémarrez votre terminal, puis lancez `/login`. Les exécutions par lot font exception : les workers `claude -p` n'utilisent pas la connexion interactive, il leur faut donc `claude setup-token` exporté sous `CLAUDE_CODE_OAUTH_TOKEN`.
+
+Si vous vouliez utiliser des crédits API, tout va bien et il n'y a rien à faire.
+
+Ceci concerne les moteurs Anthropic. Les autres CLI (Codex, OpenCode, Copilot, Gemini, Qwen) définissent chacun leur propre règle abonnement-contre-clé, et career-ops ne la vérifie pas : consultez la documentation de votre CLI.
+
 ## Mes données restent-elles sur mon ordinateur ? career-ops est-il privé ?
 
 Sur votre machine, dans des fichiers en clair qui vous appartiennent — votre CV, votre profil, votre pipeline et vos rapports sont des fichiers Markdown/YAML locaux. Rien ne s'exécute sur des serveurs career-ops. Les mises à jour du système ne touchent jamais votre couche de données (`cv.md`, `config/`, `data/`, `reports/`, `output/`) : cette séparation est le **Data Contract**, et chaque mise à jour la respecte.

content/docs/faq.mdx

@@ -21,6 +21,20 @@ career-ops has no paid plans, no tiers, no trials — it is 100% free and MIT-li
 
 No. career-ops is AI-agnostic — Claude Code is one engine among several, not a requirement. You can run the whole pipeline for free with OpenCode plus a free provider, a local model via Ollama, or the built-in OpenRouter runner (`npm run or`). If you started on a paid plan and ran out of tokens mid-search, switching to a free engine takes minutes and leaves your data untouched — see [Set up a free AI engine](/docs/free-ai-engine).
 
+## I pay for Claude Pro or Max. Why is career-ops billing my API credits?
+
+Run `node doctor.mjs` from the `career-ops` folder. It tells you which one this session is using, in one line, before you spend anything else.
+
+The rule is not ours: **your CLI decides, and `ANTHROPIC_API_KEY` wins.** If that variable is set in your environment, Claude Code bills per token even while you are paying for Pro or Max. career-ops does not choose your billing source; it only detects it and warns you. When the key is present, the doctor says:
+
+> ANTHROPIC_API_KEY is set, so it takes precedence over any Claude subscription: this session bills per token even if you pay for Pro or Max.
+
+To go back to your subscription, remove the `export ANTHROPIC_API_KEY=...` line from `~/.zshrc`, `~/.bashrc`, `~/.profile` or a project `.env`, restart your terminal, and run `/login`. Batch runs are the exception: `claude -p` workers do not use the interactive login, so they need `claude setup-token` exported as `CLAUDE_CODE_OAUTH_TOKEN`.
+
+If you meant to use API credits, nothing is wrong and there is nothing to do.
+
+This applies to Anthropic engines. The other CLIs (Codex, OpenCode, Copilot, Gemini, Qwen) each set their own subscription-versus-key rule, and career-ops does not check those — see your CLI's own documentation.
+
 ## How much does career-ops cost to run per month?
 
 Only evaluation costs anything, and it can be $0. Scanning for jobs consumes zero AI tokens, so discovering roles is always free; only evaluating a listing calls the model. Three ways run the whole pipeline for nothing: a local model via Ollama, OpenRouter's free models (`npm run or`), or the Antigravity free tier. On a cheap paid model like DeepSeek V3 (with prompt caching) an evaluation costs well under a cent, so a few cents covers dozens of listings. If you already have a Claude subscription the marginal cost is effectively $0; on the raw API, budget roughly $0.05 to $0.10 per evaluation (an estimate that varies with listing length). career-ops itself is free forever, MIT-licensed with no fee and no tier — you only ever pay your AI provider, if at all. The [Set up a free AI engine](/docs/free-ai-engine) guide walks through the $0 paths.

content/docs/index.es.mdx

@@ -3,7 +3,7 @@ title: Guía rápida
 description: "Empieza con career-ops en cinco minutos: instala el sistema open source de búsqueda de empleo con IA, abre tu CLI de IA y evalúa tu primera oferta. Sin necesidad de programar."
 seoTitle: "career-ops Guía rápida — instala y ejecuta tu primer análisis de ofertas con IA en minutos"
 icon: Rocket
-translationHash: 38326ebbdfbb6602
+translationHash: d61257fcec228488
 localized: true
 translatedFrom: /docs
 ---
@@ -124,6 +124,14 @@ Desde dentro de la carpeta `career-ops`, lanza el CLI de programación con IA qu
   Algunos CLIs (Claude Code, por ejemplo) preguntan si confías en los archivos de una carpeta nueva la primera vez que la abres. Ese aviso viene del propio CLI, no de career-ops — di que sí para continuar. El onboarding de career-ops empieza justo después.
 </Callout>
 
+<Callout type="warn" title="¿Pagas Claude Pro o Max? Comprueba qué está facturando esta sesión">
+  Ejecuta `node doctor.mjs` desde la carpeta `career-ops` antes de tu primera evaluación. Te informa de tu fuente de facturación en una línea.
+
+  Si `ANTHROPIC_API_KEY` está en tu entorno, **tu CLI la usa y cobra por token, aunque estés pagando Pro o Max.** Esa precedencia es de Claude Code, no de career-ops: el doctor solo la detecta y te lo dice. Para usar tu suscripción, quita la línea `export ANTHROPIC_API_KEY=...` de `~/.zshrc`, `~/.bashrc`, `~/.profile` o del `.env` del proyecto, reinicia la terminal y ejecuta `/login`. Si querías usar créditos de la API, no pasa nada.
+
+  Los demás CLIs fijan cada uno su propia regla de suscripción frente a clave, que career-ops no comprueba. Tienes la respuesta completa en [las preguntas frecuentes](/es/docs/faq).
+</Callout>
+
 ## Paso 3: Ejecuta tu primera evaluación
 
 Una vez que el agente te haya hecho el onboarding, estás listo para evaluar una oferta real. Copia la URL de cualquier anuncio de empleo y pégala en el chat. Con Claude Code, ponle delante el comando explícito; con los demás CLIs, pega la URL y pídele al agente que ejecute el auto-pipeline:
@@ -212,6 +220,7 @@ Abre el archivo de informe en `reports/`. El nombre sigue el patrón `{número}-
 - **Block E** — notas de personalización para tu candidatura.
 - **Block F** — preparación de entrevista con historias STAR adaptadas a esta oferta.
 - **Block G** — legitimidad del anuncio: comprueba que la oferta es real y no una estafa ni un puesto fantasma.
+- **Block H** — borradores de respuesta para el formulario de candidatura, solo cuando la puntuación supera 4.5.
 
 Tu PDF de CV adaptado está en la carpeta `output/`. Revísalo antes de enviarlo a ningún sitio — career-ops nunca envía nada sin tu aprobación.
 

content/docs/index.fr.mdx

@@ -3,7 +3,7 @@ title: Démarrage rapide
 description: "Démarrez avec career-ops en cinq minutes : installez le système open source de recherche d'emploi par IA, ouvrez votre CLI d'IA et évaluez votre première offre. Aucune connaissance en code requise."
 seoTitle: "career-ops Démarrage rapide — installez et lancez votre premier scan d'offres par IA en quelques minutes"
 icon: Rocket
-translationHash: 38326ebbdfbb6602
+translationHash: d61257fcec228488
 localized: true
 translatedFrom: /docs
 ---
@@ -124,6 +124,14 @@ Depuis l'intérieur du dossier `career-ops`, lancez le CLI de codage IA que vous
   Certains CLI (Claude Code, par exemple) vous demandent si vous faites confiance aux fichiers d'un nouveau dossier la première fois que vous l'ouvrez. Cette question vient du CLI lui-même, pas de career-ops — répondez oui pour continuer. L'onboarding de career-ops démarre juste après.
 </Callout>
 
+<Callout type="warn" title="Vous payez Claude Pro ou Max ? Vérifiez ce que cette session facture">
+  Lancez `node doctor.mjs` depuis le dossier `career-ops` avant votre première évaluation. Il indique votre source de facturation en une ligne.
+
+  Si `ANTHROPIC_API_KEY` est définie dans votre environnement, **votre CLI l'utilise et facture au token, même si vous payez Pro ou Max.** Cette précédence est celle de Claude Code, pas celle de career-ops : le doctor se contente de la détecter et de vous le dire. Pour utiliser votre abonnement, supprimez la ligne `export ANTHROPIC_API_KEY=...` de `~/.zshrc`, `~/.bashrc`, `~/.profile` ou du `.env` du projet, redémarrez votre terminal et lancez `/login`. Si vous vouliez utiliser des crédits API, tout va bien.
+
+  Les autres CLI définissent chacun leur propre règle abonnement-contre-clé, que career-ops ne vérifie pas. La réponse complète est dans [la FAQ](/fr/docs/faq).
+</Callout>
+
 ## Étape 3 : lancer votre première évaluation
 
 Une fois l'onboarding terminé, vous êtes prêt à évaluer une vraie offre d'emploi. Copiez l'URL de n'importe quelle annonce et collez-la dans le chat. Avec Claude Code, préfixez-la avec la commande explicite ; avec les autres CLI, collez l'URL et demandez à l'agent de lancer l'auto-pipeline :
@@ -212,6 +220,7 @@ Ouvrez le fichier de rapport dans `reports/`. Le nom du fichier suit le motif `{
 - **Bloc E** — des notes de personnalisation pour votre candidature.
 - **Bloc F** — une préparation à l'entretien avec des histoires STAR adaptées à cette offre.
 - **Bloc G** — légitimité de l'annonce : une vérification que l'offre est réelle et n'est ni une arnaque ni un « ghost job ».
+- **Bloc H** — des brouillons de réponses pour le formulaire de candidature, rédigés uniquement lorsque le score dépasse 4.5.
 
 Votre CV PDF sur mesure se trouve dans le dossier `output/`. Relisez-le avant de l'envoyer où que ce soit — career-ops ne soumet jamais rien sans votre accord.
 

content/docs/index.mdx

@@ -121,6 +121,14 @@ From inside the `career-ops` folder, launch the AI coding CLI you installed.
   Some CLIs (Claude Code, for example) ask whether you trust the files in a new folder the first time you open it. That prompt comes from the CLI itself, not from career-ops — say yes to continue. The career-ops onboarding starts right after.
 </Callout>
 
+<Callout type="warn" title="Paying for Claude Pro or Max? Check what this session is billing">
+  Run `node doctor.mjs` from the `career-ops` folder before your first evaluation. It reports your billing source in one line.
+
+  If `ANTHROPIC_API_KEY` is set in your environment, **your CLI uses it and bills per token, even while you pay for Pro or Max.** That precedence is Claude Code's, not career-ops': the doctor only detects it and tells you. To use your subscription instead, remove the `export ANTHROPIC_API_KEY=...` line from `~/.zshrc`, `~/.bashrc`, `~/.profile` or a project `.env`, restart your terminal, and run `/login`. If you meant to use API credits, nothing is wrong.
+
+  The other CLIs each set their own subscription-versus-key rule, which career-ops does not check. See [the FAQ](/docs/faq) for the full answer.
+</Callout>
+
 ## Step 3: Run your first evaluation
 
 Once the agent has onboarded you, you are ready to evaluate a real job posting. Copy the URL of any job ad and paste it into the chat. With Claude Code, prefix it with the explicit command; with the other CLIs, paste the URL and ask the agent to run the auto-pipeline:
@@ -209,6 +217,7 @@ Open the report file in `reports/`. The filename follows the pattern `{number}-{
 - **Block E** — personalization notes for your application.
 - **Block F** — interview preparation with STAR stories tailored to this job.
 - **Block G** — posting legitimacy: a check that the listing is real and not a scam or ghost job.
+- **Block H** — draft answers for the application form, written only when the score clears 4.5.
 
 Your tailored PDF resume is in the `output/` folder. Review it before sending it anywhere — career-ops never submits anything without your approval.
 

content/docs/reference/modes/auto-pipeline.es.mdx

@@ -1,6 +1,6 @@
 ---
 title: auto-pipeline
-description: "Flujo por defecto cuando pegas la URL de una descripción de puesto o su texto sin formato. Ejecuta la evaluación A–G, genera el informe, exporta un PDF adaptado y escribe una entrada en el tracker — sin intervención manual entre pasos."
+description: "Flujo por defecto cuando pegas la URL de una descripción de puesto o su texto sin formato. Ejecuta la evaluación A–H, genera el informe, exporta un PDF adaptado y escribe una entrada en el tracker — sin intervención manual entre pasos."
 seoTitle: "auto-pipeline de career-ops — evalúa una oferta y construye CV + tracker desde una sola URL"
 icon: Zap
 date: "2026-05-18"

content/docs/reference/modes/auto-pipeline.fr.mdx

@@ -1,6 +1,6 @@
 ---
 title: auto-pipeline
-description: "Flux par défaut lorsque vous collez l'URL d'une description de poste ou son texte brut. Exécute l'évaluation A–G, génère le rapport, exporte un PDF personnalisé et écrit une entrée dans le tracker — sans intervention manuelle entre les étapes."
+description: "Flux par défaut lorsque vous collez l'URL d'une description de poste ou son texte brut. Exécute l'évaluation A–H, génère le rapport, exporte un PDF personnalisé et écrit une entrée dans le tracker — sans intervention manuelle entre les étapes."
 seoTitle: "career-ops auto-pipeline — évaluer une offre et générer CV + tracker à partir d'une seule URL"
 icon: Zap
 date: "2026-05-18"

content/docs/reference/modes/auto-pipeline.mdx

@@ -1,6 +1,6 @@
 ---
 title: auto-pipeline
-description: "Default flow when you paste a job description URL or raw text. Runs the A–G evaluation, generates the report, exports a tailored PDF, and writes a tracker entry — without manual intervention between steps."
+description: "Default flow when you paste a job description URL or raw text. Runs the A–H evaluation, generates the report, exports a tailored PDF, and writes a tracker entry — without manual intervention between steps."
 seoTitle: "career-ops auto-pipeline — evaluate a job and build CV + tracker from one URL"
 icon: Zap
 date: "2026-05-18"