Nota del autor: escribe el comando de ejecución de escenarios de Apidog en CLAUDE.md para que Claude Code ejecute pruebas automatizadas de API con escenarios ya preparados y determine el resultado a partir del código de salida; además, tomando como ejemplo la API de video Seedance, diseña aserciones relacionadas con facturación y moderación.
Si ya usas Claude Code para escribir código de API, lo más probable es que te haya pasado esto: después de cambiar un campo, tienes que ir a Apidog, ejecutar manualmente un escenario y luego volver para contarle el resultado a Claude Code. La idea que presenta este artículo es escribir el comando de ejecución de escenarios de Apidog CLI en CLAUDE.md para que Claude Code ejecute las pruebas y lea el código de salida por sí mismo, convirtiendo así las pruebas automatizadas de API con Claude Code en un ciclo cerrado.
Este no es otro artículo introductorio sobre Claude Code. Los pasos de Apidog que aparecen aquí provienen del tutorial oficial que publica Apidog; las reglas de facturación y moderación de Seedance provienen del texto original de la documentación de APIYI. Ambas fuentes se citarán de forma explícita en el cuerpo del artículo para que puedas comprobarlas por tu cuenta.
Valor clave: después de leer este artículo, sabrás cómo dejar fijado el comando de ejecución en CLAUDE.md, por qué conviene decidir si una prueba pasa según el código de salida y no según la conclusión verbal del modelo, dónde deben guardarse los tokens y qué aserciones verdaderamente significativas escribir para una API de video asíncrona.

Pruebas automatizadas de API con Claude Code: puntos clave de Apidog
Antes de ponernos manos a la obra, conviene dividir todo el plan en varios puntos de decisión clave. La siguiente tabla resume las restricciones centrales de los tutoriales del proveedor y de la documentación de APIYI relacionadas con este plan; cada una influye directamente en si las pruebas pueden reproducirse de forma estable.
| Punto clave | Descripción | Valor |
|---|---|---|
| Escribir el comando de ejecución en CLAUDE.md | Claude Code lee el CLAUDE.md de la raíz del repositorio; la forma del comando es apidog run -t 场景ID -e 环境ID -r cli |
Cada sesión se ejecuta con el mismo comando, sin depender de la memoria |
| Determinar el resultado por el código de salida | El código de salida 0 indica que todas las aserciones pasaron; uno distinto de 0 indica que hay fallos | Evita que el modelo «diga que pasó» cuando en realidad no pasó |
| Copiar los ID desde la página CI/CD | Los ID de escenario y de entorno se obtienen en la página CI/CD de ese escenario en Apidog | Evita que el modelo invente ID sobre la marcha y que luego no se encuentre el escenario |
| El token no va en el archivo | En local se inicia sesión con apidog login; no se escribe --access-token en CLAUDE.md |
Evita que el token se filtre al confirmar cambios en el repositorio |
| Separar los dos tipos de endpoint | El modelo de texto que impulsa Claude Code y la interfaz de video bajo prueba no son el mismo endpoint | Configuración clara y facturación rastreable |
Cómo Claude Code lee CLAUDE.md
Según el tutorial del proveedor de Apidog, la herramienta en sí es el paquete npm apidog-cli, y Claude Code lee el CLAUDE.md de la raíz del repositorio como descripción del proyecto al iniciarse. Es decir, los comandos de ejecución, las reglas de decisión y las prohibiciones que escribas en este archivo se convierten en el contexto de cada sesión de Claude Code. Si no estás seguro de qué archivos de instrucciones se cargaron en esta sesión, puedes ejecutar /memory en Claude Code para consultarlo.
Esto determina la estabilidad del plan. En lugar de repetir «por favor, ejecuta el escenario de Apidog» en cada conversación, conviene fijar el comando de una vez. Después de modificar el código, Claude Code invoca apidog run según las instrucciones de CLAUDE.md y decide, a partir de la salida de la terminal, si sigue corrigiendo o termina la tarea.
Detalle de los códigos de salida y el formato de informe de Apidog CLI
El tutorial del proveedor insiste en que se debe conservar el formato de informe -r cli, porque Claude Code se apoya en la salida de la terminal para decidir el siguiente paso. Si además quieres un informe que se pueda abrir en el navegador, puedes añadir html al parámetro -r; el archivo generado se encuentra en el directorio ./apidog-reports. Ojo: es «añadir», no «reemplazar»; si quitas el informe cli, Claude Code se queda sin base para leer el resultado.
El código de salida es el árbitro de todo el plan. Vale la pena copiar el orden de verificación que propone el tutorial: primero confirma que en la terminal realmente apareció el comando apidog run; luego revisa el código de salida; cuando el código de salida no coincide con la conclusión verbal del modelo, prevalece el código de salida; si aparece un mensaje de que no se encuentra el escenario, vuelve a CLAUDE.md y comprueba si los ID son correctos.

Pruebas automatizadas de API con Claude Code: guía de inicio rápido
Esta sección sigue el orden «preparar el entorno → escribir CLAUDE.md → configurar permisos → ejecutar la primera vez». Como se trata de un tutorial en línea, todos los comandos aparecen como código en línea para que puedas copiarlos uno a uno en la terminal.
Paso 1: configurar la dirección de acceso al modelo de Claude Code
Ejecutar Claude Code ya consume tokens, y luego llamar a la interfaz de video bajo prueba gastará otro tanto, así que primero conviene distinguir bien los dos tipos de direcciones de acceso. Cuando te conectas a través de APIYI, Claude Code usa el protocolo nativo de Anthropic y la dirección es https://api.apiyi.com; no añadas /v1 al final, porque de lo contrario se compondría como /v1/v1/messages y la solicitud fallaría. Solo los clientes con protocolo compatible con OpenAI usan la dirección https://api.apiyi.com/v1.
En concreto, se trata de definir variables de entorno en la shell desde la que se lanza Claude Code: ANTHROPIC_BASE_URL con la dirección nativa de Anthropic, y ANTHROPIC_AUTH_TOKEN con el token que hayas creado en la plataforma. Para los modelos de la familia Claude se recomienda colocar el token en el grupo ClaudeCode, gestionándolo por separado del token que usará más adelante la interfaz de video.
🚀 Inicio rápido: la práctica recomendada oficialmente es crear tokens distintos en la consola de APIYI apiyi.com, uno para Claude Code y otro para la interfaz bajo prueba. Los nuevos usuarios disponen de crédito de prueba gratuito, suficiente para completar el primer escenario antes de decidir qué modelo usar a largo plazo.
Segundo paso: escribir las instrucciones de prueba en CLAUDE.md
Según el tutorial del fabricante, el contenido relacionado con las pruebas en CLAUDE.md debería incluir los siguientes puntos, cada uno redactado en una frase clara:
- Comando de ejecución: las pruebas de regresión usan
apidog run -t <场景ID> -e <环境ID> -r cli, donde los dos ID se rellenan directamente con los valores reales copiados de la página CI/CD de Apidog. - Regla de evaluación: el resultado se determina por el código de salida del comando; 0 significa que todo pasó, un valor distinto de 0 significa que hubo fallos. No se toma un resumen en lenguaje natural como conclusión.
- Prohibiciones: no inventes ni modifiques por tu cuenta los ID de escenario o de entorno; tampoco añadas
--access-tokenal comando. - Requisitos del informe: mantén
-r cli; si necesitas un informe para el navegador, puedes añadirhtml. El resultado se genera en./apidog-reports. - Nota sobre la región: si el proyecto está desplegado en la región europea de Apidog, hay que añadir
--api-base-url api.eu.apidog.comal comando. Es la dirección regional propia de Apidog y no tiene nada que ver con la dirección de acceso al modelo.
Tercer paso: inicio de sesión y configuración de permisos
La gestión de tokens es el punto donde más fácilmente surgen problemas. El tutorial del fabricante recomienda ejecutar apidog login una vez en la máquina local para completar el inicio de sesión, y deja claro que no se debe escribir el token en CLAUDE.md ni hacer que aparezca --access-token en ese archivo. CLAUDE.md normalmente se sube al repositorio junto con el código, así que en cuanto escribas ahí un token, equivale a hacerlo público.
Claude Code, por defecto, pregunta antes de ejecutar comandos Bash. Si quieres que ejecute las pruebas automáticamente, puedes añadir Bash(apidog run *) a la lista de permisos allow en .claude/settings.json, dando luz verde solo a este tipo de comando. El tutorial también advierte que --dangerously-skip-permissions solo encaja en entornos desechables como CI, no en una máquina local que está siempre encendida.
| Elemento de configuración | Práctica recomendada | Práctica no recomendada | Fuente |
|---|---|---|---|
| Inicio de sesión en Apidog | apidog login en la máquina local |
Escribir --access-token en CLAUDE.md |
Tutorial del fabricante |
| Permiso de comando | allow Bash(apidog run *) |
--dangerously-skip-permissions activado siempre en local |
Tutorial del fabricante |
| ID de escenario | Copiarlo de la página CI/CD | Dejar que el modelo lo deduzca o lo genere | Tutorial del fabricante |
| Dirección de Claude Code | ANTHROPIC_BASE_URL sin /v1 |
Con /v1, lo que provoca duplicación de rutas |
Documentación de APIYI |
| Agrupación de tokens | ClaudeCode para Claude, SeeDance2 para vídeo |
Un solo token mezclando todos los grupos | Documentación de APIYI |
Cuarto paso: ejecutar la primera vez y verificar
Una vez completada la configuración, haz que Claude Code ejecute una prueba de regresión. Siguiendo el orden de verificación del tutorial del proveedor, necesitas confirmar con tus propios ojos tres cosas: que en el terminal aparezca el comando completo apidog run; que el comando devuelva un código de salida claro; y que, si hay fallos, la salida del terminal muestre qué aserción específica no pasó. Solo cuando se cumplan esas tres cosas se puede considerar que este ciclo cerrado está realmente establecido.
💡 Consejo técnico: La primera vez que lo ejecutes, puedes equivocar deliberadamente el valor esperado de alguna aserción para confirmar que el código de salida cambia a un valor distinto de 0 y que Claude Code continúa investigando a partir de eso. Este paso verifica que la regla de «basarse en el código de salida» realmente está funcionando.
Práctica de pruebas automatizadas de API con Claude Code: diseño de aserciones para la interfaz de video Seedance
Probar interfaces de texto es bastante directo, pero las interfaces de video asíncronas realmente ponen a prueba el diseño de aserciones. Esta sección toma como ejemplo la serie Seedance ya publicada en APIYI para explicar qué conviene asertar y qué no conviene asertar en el escenario de Apidog.
Modelos, grupos y precios de Seedance
Según la documentación de APIYI, los ID de modelo disponibles para Seedance son doubao-seedance-2-5-260628, doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128 y doubao-seedance-2-0-mini-260615. El token utilizado para invocar estos modelos debe pertenecer al grupo SeeDance2; de lo contrario, se devolverá el mensaje «no hay canales disponibles para este modelo». La interfaz de video bajo prueba y el modelo de texto que impulsa Claude Code son dos endpoints diferentes; no basta con cambiar el campo model para que sean intercambiables. En el escenario de Apidog, las solicitudes de envío y consulta deben configurarse por separado conforme a la documentación de Seedance.
La siguiente tabla muestra los precios por uso incluidos en la tabla general de precios (actualizada el 2026-11-16), en USD / 1 millón de tokens. Tanto los modelos como los precios se rigen por la lista de modelos de la plataforma.
| Modelo | Entrada | Salida | Lectura de caché | Plataforma disponible |
|---|---|---|---|---|
doubao-seedance-2-5-260628 |
70 | 70 | No | APIYI apiyi.com |
doubao-seedance-2-0-260128 |
46 | 46 | No | APIYI |
doubao-seedance-2-0-fast-260128 |
37 | 37 | No | APIYI |
doubao-seedance-2-0-mini-260615 |
23 | 23 | No | APIYI |
La documentación también ofrece ejemplos de cálculo para videos de 720p y 5 segundos: el modelo 2.5 cuesta aproximadamente 1.3721 USD y el 2.0 estándar, alrededor de 0.9074 USD. Cabe subrayar que se trata solo de ejemplos que convierten el precio por millón de tokens en el costo de un solo video; no son dos listas de precios distintas.
Cinco aserciones recomendadas
Las cinco aserciones que siguen se basan en el texto original de la documentación y se pueden trasladar directamente a los escenarios de Apidog:
- La tarea tiene un ID: cuando la solicitud de envío se completa correctamente, la respuesta debe incluir un ID de tarea; el sondeo posterior depende de él y, sin ID, se considera un fallo.
- La duración se pasa de forma explícita: el texto original indica que el valor predeterminado de
durationen 2.5 es -1, así que la solicitud de prueba debe pasar la duración de forma explícita; de lo contrario, no se pueden comparar los costes entre distintas ejecuciones. - Un error de parámetros no genera cobro: la documentación especifica que un HTTP 400 por error de parámetros no se factura; se puede construir una solicitud a la que falte un campo obligatorio, afirmar que el código de estado es 400 y confirmar en el log que no hubo cargo.
- Una intercepción de moderación no genera cobro: la documentación indica que los errores con prefijo
PUBLIC_son interceptaciones de moderación de contenido del proveedor y tampoco se facturan. La aserción solo debe identificar este tipo de código de error y distinguirlo del error de parámetros como dos tipos de fallo diferentes. - Solo la suma de los dos registros de log da el precio total: la documentación indica que un video genera dos registros de cargo en el log: una pre-deducción al enviar y una liquidación al finalizar, con devolución o cobro de la diferencia. El coste total es la suma de ambos.
En cuanto al importe de la pre-deducción, el texto original indica que la serie 2.0 cuesta aproximadamente 0.09 USD/segundo y la 2.5 unos 0.135 USD/segundo, liquidándose al finalizar según los tokens reales. Por eso, la aserción de coste no puede mirar solo el primer registro de log, porque ese es únicamente el valor pre-deducido.

Qué no debería convertirse en un caso de prueba
El bloqueo por moderación es un límite de cumplimiento, no un caso de prueba que haya que “sortear”. La documentación recomienda explícitamente no reintentar una y otra vez con la misma indicación después de un fallo de moderación, así que tampoco deberíamos diseñar pasos de reintento en bucle ni de sondeo de las reglas de moderación dentro de los escenarios. Del mismo modo, las imágenes de referencia con rostros reales serán rechazadas por el upstream: primero hay que subirlas al almacén y luego referenciarlas mediante asset://. Esta es una condición previa de cumplimiento y debería figurar en la descripción de preparación de los datos de prueba, no como un caso de prueba.
📊 Nota sobre los datos: las reglas de facturación y moderación de Seedance anteriores proceden textualmente de la documentación de APIYI. Puedes verificarlas en la página de Seedance del centro de documentación de apiyi.com y, una vez confirmada la descripción más reciente, fijarlas en las aserciones.
Selección y coste del modelo que impulsa Claude Code
El propio Claude Code también consume tokens al ejecutar pruebas, y elegir qué modelo usar afecta directamente el coste diario. La siguiente tabla muestra los precios de los tres modelos Claude incluidos en la tabla general de precios; la unidad también es dólares por 1 millón de tokens y todos admiten los endpoints chat y messages.
| Modelo | Entrada | Salida | Lectura de caché | Grupo |
|---|---|---|---|---|
claude-opus-5-5 |
4 | 20 | 0.2 | ClaudeCode, Claude_Reverse, Claude_Enterprise, Default, SVIP |
claude-sonnet-5-5 |
2 | 10 | 0.1 | Los mismos |
claude-haiku-5-5 |
0-100 000 tokens: 0.1; por encima: 0.5 | 0.5 | 0.01 | ClaudeCode, Claude_Enterprise, Default, SVIP |
Ojo: la fila de Haiku no incluye el grupo Claude_Reverse; si tu token solo está en ese grupo, al cambiar a Haiku te quedarás sin canales disponibles. Una idea habitual es usar un modelo más ligero para las tareas estructuradas del día a día, como ejecutar regresiones y leer códigos de salida con Claude Code, y cambiar a un modelo más potente cuando haya fallos complejos que requieran un diagnóstico más profundo.
💰 Optimización de costes: como se factura tanto el modelo que impulsa Claude Code como la interfaz bajo prueba, te recomendamos revisar los registros de uso por token en la consola de APIYI, contabilizar por separado el consumo de Claude Code y el de Seedance, y determinar así en qué lado se concentra principalmente el coste de las pruebas.
Preguntas frecuentes (FAQ)
Q1: ¿Qué es la solución Apidog para las pruebas automatizadas de API con Claude Code?
Consiste en escribir los comandos de ejecución de escenarios del Apidog CLI en el CLAUDE.md de la raíz del repositorio, para que Claude Code, una vez terminado de modificar el código, ejecute por su cuenta `apidog run` y determine si las pruebas pasaron según el código de salida, ahorrándote así el clic manual en «ejecutar».
Q2: ¿Por qué guiarse por el código de salida y no por la conclusión de Claude Code?
El resumen en lenguaje natural del modelo puede desviarse, mientras que el código de salida es el resultado determinista que entrega la herramienta de pruebas. El tutorial del proveedor lo dice claramente: cuando ambos no coinciden, manda el código de salida; 0 significa que todo pasó, distinto de 0 significa que hay fallos.
Q3: ¿Hay que añadir /v1 a la dirección de acceso de Claude Code?
No. Claude Code usa el protocolo nativo de Anthropic y la dirección es `https://api.apiyi.com`; añadir `/v1` acabaría formando `/v1/v1/messages`. Solo los clientes compatibles con OpenAI usan la dirección con `/v1`.
Q4: ¿Dónde debería colocarse el token de Apidog?
En local basta con iniciar sesión mediante `apidog login`. El tutorial del proveedor pide expresamente no escribir `–access-token` en CLAUDE.md, ni tampoco el token en ese archivo, para evitar que se filtre junto con el repositorio de código.
Q5: ¿Cómo empiezo a invocar Seedance para probar la interfaz de video?
Después de registrarte en APIYI apiyi.com, crea un token que pertenezca al grupo `SeeDance2`, configura las solicitudes de envío y consulta según la documentación de Seedance, y en el escenario de Apidog añade aserciones como el ID de tarea, la duración explícita, la clasificación de códigos de error y los dos registros de cobro. La cuota de pruebas gratuita para usuarios nuevos te sirve para ejecutar el primer escenario de principio a fin.
Q6: ¿Qué hago si Claude Code indica que no encuentra el escenario?
Primero confirma el comando que realmente se ejecuta en la terminal, luego vuelve a CLAUDE.md y revisa el ID del escenario y el ID del entorno; asegúrate de copiarlos de nuevo desde la página CI/CD de ese escenario en Apidog y no dejes que el modelo los deduzca. En proyectos de la región europea también hay que comprobar si se añadió `–api-base-url api.eu.apidog.com`.
Q7: ¿Qué limitaciones tiene esta solución?
Primero, el doble cobro: tanto Claude Code como la interfaz bajo prueba consumen tokens. Segundo, hay que ser prudente con los permisos: en local solo se permite `Bash(apidog run *)`. Tercero, la intercepción por revisión y las imágenes de referencia con caras reales forman parte de los límites de cumplimiento normativo: solo se pueden identificar y preprocesar, no diseñar como casos de uso destinados a eludirlos.
Claude Code Pruebas automatizadas de API: puntos clave (Key Takeaways)
- Comando fijo: escribe
apidog run -t -e -r clien CLAUDE.md y usa el mismo comando en cada sesión. - El código de salida manda: 0 significa aprobado y distinto de 0 significa fallido; cuando entre en conflicto con una conclusión verbal, prevalece el código de salida.
- Aislamiento del token: inicia sesión con
apidog loginen tu máquina local; ni el token ni--access-tokendeben quedar en CLAUDE.md. - Permisos mínimos: permite solo
Bash(apidog run *); los parámetros para omitir permisos se usan solo en CI. - Distingue las URL: Claude Code usa la URL nativa sin
/v1; solo la compatibilidad con OpenAI lleva/v1. - Aserciones de video: ID de la tarea, duración explícita, el 400 y la clasificación
PUBLIC_, y el precio total sumando los dos registros de log. - Cómo empezar: crea en APIYI tokens de grupo
ClaudeCodeySeeDance2por separado, y valida el primer escenario con la cuota gratuita.
Resumen
La clave para combinar las pruebas automatizadas de API de Claude Code con Apidog está en tres puntos:
- Haz que los comandos y las reglas vivan en el archivo: CLAUDE.md alberga los comandos de ejecución, las reglas de decisión y las prohibiciones; el token, a su vez, se deja a cargo de
apidog login. - Deja que el código de salida tenga la última palabra: conserva la salida de
-r cliy verifica el comando, el código de salida y el ID en el orden que indica el tutorial del proveedor. - Haz que las aserciones se ajusten a la facturación real: en las API de video asíncronas hay que verificar el estado de la tarea, distinguir los errores de parámetros del bloqueo por moderación, sumar los dos registros de cobro y pasar la duración de forma explícita.
Se recomienda validar primero el ciclo completo con el escenario más sencillo de una API de texto y, después, ir incorporando aserciones para API asíncronas como Seedance. Conviene usar APIYI apiyi.com para gestionar con la misma cuenta los tokens y el consumo de Claude Code y del modelo bajo prueba; así los costos de ambos lados quedan claros de un vistazo y resulta más fácil optimizar continuamente el gasto en pruebas.
📚 Materiales de referencia
- Tutorial del fabricante Apidog: uso de Apidog CLI dentro de Claude Code: autoría de INEZA Felin-Michel, la fecha de versión se muestra según el sitio
- Enlace:
apidog.com/blog/apidog-cli-in-claude-code -
Descripción: fuente sobre cómo escribir CLAUDE.md, reglas de códigos de salida, configuración de permisos y orden de verificación
-
Presentación oficial de Apidog CLI: posicionamiento de la CLI frente a agentes y CI, además de los parámetros regionales
- Enlace:
docs.apidog.com/en/introduction-to-apidog-cli-605134m0 -
Descripción: incluye la explicación del
--api-base-urlpara la región europea -
Documentación de APIYI Seedance 2: ID de modelo, agrupación, facturación y reglas de revisión
- Enlace:
docs.apiyi.com/api-capabilities/seedance2/overview -
Descripción: base para el diseño de las aserciones sobre video en este artículo
-
Tabla general de precios de modelos de APIYI: precio por uso y agrupación de cada modelo
- Enlace:
docs.apiyi.com/models -
Descripción: los modelos y precios se rigen por el contenido más reciente de esta página
-
Explicación del protocolo de APIYI: diferencias entre las direcciones nativas de Anthropic y las compatibles con OpenAI
- Enlace:
docs.apiyi.com/llms.txt - Descripción: explica por qué la dirección de Claude Code no puede incluir
/v1
Autor: Equipo técnico de APIYI
Intercambio técnico: contáctenos en la página principal del sitio de APIYI; más materiales están disponibles en el centro de documentación docs.apiyi.com