Documentation 2026-10-14 22:58 UTC to 2026-10-15 23:58 UTC

636| Limitación | Descripción |636| Limitación | Descripción |

637| - | - |637| - | - |

638| Solo herramientas Write/Edit/NotebookEdit | Los cambios realizados a través de comandos Bash no se rastrean |638| Solo herramientas Write/Edit/NotebookEdit | Los cambios realizados a través de comandos Bash no se rastrean |

639| Ediciones de subagentes | Las ediciones que aplica un [subagente](/docs/es/agent-sdk/subagents) no se rastrean ni se restauran, excepto una skill con `context: fork` ejecutándose en primer plano; use git para revertir ediciones no rastreadas |639| Ediciones de subagentes | Las ediciones que aplica un [subagente](/docs/es/agent-sdk/subagents) no se rastrean, excepto un skill con `context: fork` ejecutándose en primer plano. Al revertir, esas ediciones solo se deshacen en los archivos que la conversación principal ya había editado; usa git para revertir el resto |

640| Misma sesión | Los checkpoints están vinculados a la sesión que los creó |640| Misma sesión | Los checkpoints están vinculados a la sesión que los creó |

641| Solo contenido de archivo | Crear, mover o eliminar directorios no se deshace al revertir |641| Solo contenido de archivo | Crear, mover o eliminar directorios no se deshace al revertir |

642| Archivos locales | Los archivos remotos o de red no se rastrean |642| Archivos locales | Los archivos remotos o de red no se rastrean |

205 205 

206**Comportamiento actual:** Omitir `settingSources` en `query()` carga la configuración del usuario, proyecto y sistema de archivos local, coincidiendo con la CLI. Esto incluye `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, archivos CLAUDE.md y comandos personalizados.206**Comportamiento actual:** Omitir `settingSources` en `query()` carga la configuración del usuario, proyecto y sistema de archivos local, coincidiendo con la CLI. Esto incluye `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, archivos CLAUDE.md y comandos personalizados.

207 207 

208Para ejecutarse aislado de la configuración del sistema de archivos, pase `settingSources: []`, o `setting_sources=[]` en Python. Consulte [Control filesystem settings with settingSources](/docs/es/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) para ver qué carga cada fuente.208Para ejecutarse aislado de la configuración del sistema de archivos, pase `settingSources: []`, o `setting_sources=[]` en Python. Consulte [Controlar la configuración del sistema de archivos con settingSources](/docs/es/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) para ver qué carga cada fuente.

209 209 

210El aislamiento es especialmente importante para canalizaciones de CI/CD, aplicaciones implementadas, entornos de prueba y sistemas multiinquilino donde las personalizaciones locales no deben filtrarse.210El aislamiento es especialmente importante para canalizaciones de CI/CD, aplicaciones implementadas, entornos de prueba y sistemas multiinquilino donde las personalizaciones locales no deben filtrarse.

211 211 

212<Note>212<Note>

213 Python SDK 0.1.59 y anteriores trataban una lista vacía igual que omitir la opción, así que actualice antes de confiar en `setting_sources=[]`. Consulte [What settingSources does not control](/docs/es/agent-sdk/claude-code-features#what-settingsources-does-not-control) para ver las entradas que se leen incluso cuando `settingSources` es `[]`.213 Python SDK 0.1.59 y anteriores trataban una lista vacía igual que omitir la opción, así que actualice antes de confiar en `setting_sources=[]`. Consulte [Qué settingSources no controla](/docs/es/agent-sdk/claude-code-features#what-settingsources-does-not-control) para ver las entradas que se leen incluso cuando `settingSources` es `[]`.

214</Note>214</Note>

215 215 

216<h2 id="next-steps">216<h2 id="next-steps">

17 17 

18Esta guía explica cómo el SDK emite telemetría, cómo configurar la exportación y cómo etiquetar y filtrar los datos una vez que llegan a su backend. Para leer el uso de tokens y el costo directamente desde el flujo de respuesta del SDK en lugar de exportar a un backend, consulte [Rastrear costo y uso](/docs/es/agent-sdk/cost-tracking).18Esta guía explica cómo el SDK emite telemetría, cómo configurar la exportación y cómo etiquetar y filtrar los datos una vez que llegan a su backend. Para leer el uso de tokens y el costo directamente desde el flujo de respuesta del SDK en lugar de exportar a un backend, consulte [Rastrear costo y uso](/docs/es/agent-sdk/cost-tracking).

19 19 

20<Note>

21 Para la Claude API o Managed Agents, consulta [OpenTelemetry para la Claude API](https://platform.claude.com/docs/en/manage-claude/opentelemetry).

22</Note>

23 

20<h2 id="how-telemetry-flows-from-the-sdk">24<h2 id="how-telemetry-flows-from-the-sdk">

21 Cómo fluye la telemetría desde el SDK25 Cómo fluye la telemetría desde el SDK

22</h2>26</h2>

500 Qué se conserva al enviar al segundo plano500 Qué se conserva al enviar al segundo plano

501</h4>501</h4>

502 502 

503Enviar al segundo plano inicia un proceso nuevo que se reanuda desde la conversación guardada, y el trabajo en curso pasa a él: los comandos de shell en segundo plano en ejecución, los subagentes en segundo plano, los flujos de trabajo dinámicos, las tareas programadas que creaste con [`/loop`](/docs/es/scheduled-tasks) y las [respuestas automáticas de Claude a comentarios de artefactos](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own) se conservan y siguen ejecutándose allí. Un subagente se mueve junto con todo lo que inició, por lo que solo se conserva cuando todo ese trabajo también puede moverse. Para detener el trabajo en curso en lugar de conservarlo, establece la variable de entorno [`CLAUDE_DISABLE_ADOPT=1`](/docs/es/env-vars#variables); Claude Code entonces te pide que confirmes antes de enviar al segundo plano.503Enviar al segundo plano inicia un proceso nuevo que se reanuda desde la conversación guardada, y el trabajo en segundo plano en curso pasa a él: los comandos de shell en segundo plano en ejecución, los subagentes en segundo plano, los flujos de trabajo dinámicos, las tareas programadas que creaste con [`/loop`](/docs/es/scheduled-tasks) y las [respuestas automáticas de Claude a comentarios de artefactos](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own) se conservan y siguen ejecutándose allí. Un subagente se mueve junto con todo lo que inició, por lo que solo se conserva cuando todo ese trabajo también puede moverse. Para detener el trabajo en segundo plano en curso en lugar de conservarlo, establece la variable de entorno [`CLAUDE_DISABLE_ADOPT=1`](/docs/es/env-vars#variables); Claude Code entonces te pide que confirmes antes de enviar al segundo plano.

504 504 

505Cuando un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución, Claude Code pregunta antes de enviar al segundo plano con el diálogo `Background this session?`, que indica cuántos subagentes se reiniciarían. Elige `Stay` para dejar que terminen primero. Si confirmas, Claude Code reproduce la ejecución en la sesión en segundo plano: los subagentes que aún se estaban ejecutando comienzan de nuevo desde el principio, por lo que los tokens que usaron hasta ese momento se gastan otra vez. Consulta [Reanudar después de una pausa](/docs/es/workflows#resume-after-a-pause) para ver qué subagentes completados devuelven sus resultados guardados y cuáles se ejecutan de nuevo.505Cuando un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución, Claude Code pregunta antes de enviar al segundo plano con el diálogo `Background this session?`, que indica cuántos subagentes se reiniciarían. Elige `Stay` para dejar que terminen primero. Si confirmas, Claude Code reproduce la ejecución en la sesión en segundo plano: los subagentes que aún se estaban ejecutando comienzan de nuevo desde el principio, por lo que los tokens que usaron hasta ese momento se gastan otra vez. Consulta [Reanudar después de una pausa](/docs/es/workflows#resume-after-a-pause) para ver qué subagentes completados devuelven sus resultados guardados y cuáles se ejecutan de nuevo.

506 506 

507Claude Code detiene el trabajo que no se puede conservar, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución, y detiene también un subagente en segundo plano que posee un monitor. Cuando hay trabajo de este tipo en ejecución, Claude Code muestra el diálogo `Background this session?` para que puedas confirmar antes de que detenga el trabajo.507Claude Code detiene el trabajo en segundo plano que no se puede conservar, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución, y detiene también un subagente en segundo plano que posee un monitor. Cuando hay trabajo de este tipo en ejecución, Claude Code muestra el diálogo `Background this session?` para que puedas confirmar antes de que detenga el trabajo.

508 508 

509Una vez en segundo plano, la sesión puede iniciar nuevos subagentes, monitores y comandos en segundo plano, y estos siguen ejecutándose tras desasociaciones y nuevas conexiones posteriores.509Una vez en segundo plano, la sesión puede iniciar nuevos subagentes, monitores y comandos en segundo plano, y estos siguen ejecutándose tras desasociaciones y nuevas conexiones posteriores.

510 510 

949 Enviar al segundo plano muestra un diálogo `Background this session?`949 Enviar al segundo plano muestra un diálogo `Background this session?`

950</h3>950</h3>

951 951 

952Si presionas `←` para enviar al segundo plano la sesión actual y Claude Code muestra un diálogo `Background this session?`, la sesión tiene trabajo en curso que enviarla al segundo plano detendría, reiniciaría o dejaría ejecutándose sin supervisión, y Claude Code pregunta antes de hacer cualquiera de esas cosas:952Si presionas `←` para enviar al segundo plano la sesión actual y Claude Code muestra un diálogo `Background this session?`, la sesión tiene trabajo en segundo plano en curso que enviarla al segundo plano detendría, reiniciaría o dejaría ejecutándose sin supervisión, y Claude Code pregunta antes de hacer cualquiera de esas cosas:

953 953 

954* **Trabajo que no se puede mover**: la sesión tiene trabajo que no se puede mover a la sesión en segundo plano, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución. El diálogo nombra el trabajo que Claude Code detendría y, por separado, cuenta las tareas que se trasladan.954* **Trabajo que no se puede mover**: la sesión tiene trabajo que no se puede mover a la sesión en segundo plano, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución. El diálogo nombra el trabajo en segundo plano que Claude Code detendría y, por separado, cuenta las tareas que se trasladan.

955* **Un flujo de trabajo con subagentes en ejecución**: un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución. El flujo de trabajo en sí se traslada, pero sus subagentes en ejecución se reinician desde el principio, y el diálogo dice cuántos.955* **Un flujo de trabajo con subagentes en ejecución**: un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución. El flujo de trabajo en sí se traslada, pero sus subagentes en ejecución se reinician desde el principio, y el diálogo dice cuántos.

956* **Respuestas automáticas de artefactos**: Claude está [respondiendo a comentarios en un artefacto por su cuenta](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own). Esas respuestas continúan en la sesión en segundo plano, y el diálogo lo indica.956* **Respuestas automáticas de artefactos**: Claude está [respondiendo a comentarios en un artefacto por su cuenta](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own). Esas respuestas continúan en la sesión en segundo plano, y el diálogo lo indica.

957 957 

1175| v2.1.199 | Una sesión en segundo plano cuyo proceso sale antes de terminar de iniciarse en un host con poca memoria muestra `possibly low memory — free some up and retry` en el estado de su fila en lugar de solo la razón de salida sin más. Enviar al segundo plano una sesión con `←` o `/background` lleva su `/color` a la nueva fila. |1175| v2.1.199 | Una sesión en segundo plano cuyo proceso sale antes de terminar de iniciarse en un host con poca memoria muestra `possibly low memory — free some up and retry` en el estado de su fila en lugar de solo la razón de salida sin más. Enviar al segundo plano una sesión con `←` o `/background` lleva su `/color` a la nueva fila. |

1176| v2.1.198 | La vista de agentes envía una notificación a través de `preferredNotifChannel` cuando una sesión en segundo plano necesita entrada, finaliza o falla, y dispara el hook `Notification` con el tipo `agent_needs_input` o `agent_completed`. `←` y `/exit` dentro de `claude attach <id>` regresan a la vista de agentes en lugar de salir al shell; `Ctrl+Z` regresa al shell. Una sesión en segundo plano que aisló su trabajo en un worktree hace commit, hace push de su propia rama aislada, nunca de `main` ni de `master`, y abre un pull request en borrador cuando finaliza en lugar de preguntar primero. `/login` se ejecuta en la vista de agentes y abre el diálogo de inicio de sesión. El diálogo de salida `Background work is running` ofrece `Move to background and exit`. El traspaso al salir también cubre los subagentes en segundo plano, que se reanudan desde su transcripción en el siguiente despertar en lugar de informarse como fallidos. `claude --bg` combinado con `-p` o `--print` se rechaza con un error. El host de sesiones en segundo plano solicita el permiso de Red Local de macOS en el primer acceso a la LAN en lugar de fallar con `connect: no route to host`. |1176| v2.1.198 | La vista de agentes envía una notificación a través de `preferredNotifChannel` cuando una sesión en segundo plano necesita entrada, finaliza o falla, y dispara el hook `Notification` con el tipo `agent_needs_input` o `agent_completed`. `←` y `/exit` dentro de `claude attach <id>` regresan a la vista de agentes en lugar de salir al shell; `Ctrl+Z` regresa al shell. Una sesión en segundo plano que aisló su trabajo en un worktree hace commit, hace push de su propia rama aislada, nunca de `main` ni de `master`, y abre un pull request en borrador cuando finaliza en lugar de preguntar primero. `/login` se ejecuta en la vista de agentes y abre el diálogo de inicio de sesión. El diálogo de salida `Background work is running` ofrece `Move to background and exit`. El traspaso al salir también cubre los subagentes en segundo plano, que se reanudan desde su transcripción en el siguiente despertar en lugar de informarse como fallidos. `claude --bg` combinado con `-p` o `--print` se rechaza con un error. El host de sesiones en segundo plano solicita el permiso de Red Local de macOS en el primer acceso a la LAN en lugar de fallar con `connect: no route to host`. |

1177| v2.1.196 | Una sola pulsación de `←` envía al segundo plano una sesión en primer plano; las versiones anteriores requerían dos pulsaciones, con una sugerencia en el pie de página y una confirmación. `--dangerously-skip-permissions` pasado a `claude agents` muestra el aviso de bypass en lugar de descartarse silenciosamente. Las sesiones interactivas que nunca nombraste llevan un nombre predeterminado como `my-app-3f` en los listados de sesiones y en `claude agents --json`. Los comandos de shell en segundo plano y los flujos de trabajo dinámicos sobreviven a que el proceso de la sesión se detenga, se reinicie o se actualice, incluso en Windows; establece `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desactivar el traspaso. Una transcripción leída erróneamente como vacía al reiniciar se renombra con un sufijo `.orphaned-` en lugar de eliminarse. |1177| v2.1.196 | Una sola pulsación de `←` envía al segundo plano una sesión en primer plano; las versiones anteriores requerían dos pulsaciones, con una sugerencia en el pie de página y una confirmación. `--dangerously-skip-permissions` pasado a `claude agents` muestra el aviso de bypass en lugar de descartarse silenciosamente. Las sesiones interactivas que nunca nombraste llevan un nombre predeterminado como `my-app-3f` en los listados de sesiones y en `claude agents --json`. Los comandos de shell en segundo plano y los flujos de trabajo dinámicos sobreviven a que el proceso de la sesión se detenga, se reinicie o se actualice, incluso en Windows; establece `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desactivar el traspaso. Una transcripción leída erróneamente como vacía al reiniciar se renombra con un sufijo `.orphaned-` en lugar de eliminarse. |

1178| v2.1.195 | El trabajo en curso también se traslada cuando envías una sesión al segundo plano en Windows; establece `CLAUDE_DISABLE_ADOPT=1` para detenerlo en su lugar. El grupo `Completed` llena el espacio vertical restante y el encabezado se compacta en terminales de poca altura. Una versión anterior de Claude Code ya no descarta campos de `state.json` de sesiones más nuevas ni oculta esas sesiones de `claude agents`. Adjuntarse a una sesión detenida cambia inmediatamente en lugar de mostrar una pantalla en blanco durante hasta cinco segundos. Un supervisor que no puede aceptar conexiones sale y libera su bloqueo por sí solo. |1178| v2.1.195 | El trabajo en segundo plano en curso también se traslada cuando envías una sesión al segundo plano en Windows; establece `CLAUDE_DISABLE_ADOPT=1` para detenerlo en su lugar. El grupo `Completed` llena el espacio vertical restante y el encabezado se compacta en terminales de poca altura. Una versión anterior de Claude Code ya no descarta campos de `state.json` de sesiones más nuevas ni oculta esas sesiones de `claude agents`. Adjuntarse a una sesión detenida cambia inmediatamente en lugar de mostrar una pantalla en blanco durante hasta cinco segundos. Un supervisor que no puede aceptar conexiones sale y libera su bloqueo por sí solo. |

1179| v2.1.191 | `claude --bg` con un nombre de `--agent` que no coincide con ninguno de tus subagentes hace fallar el lanzamiento: la sesión sale inmediatamente con un error `--agent '<name>' not found` en lugar de ejecutarse con el agente predeterminado. |1179| v2.1.191 | `claude --bg` con un nombre de `--agent` que no coincide con ninguno de tus subagentes hace fallar el lanzamiento: la sesión sale inmediatamente con un error `--agent '<name>' not found` en lugar de ejecutarse con el agente predeterminado. |

1180| v2.1.174 | Las sesiones en segundo plano ya no heredan variables de endpoint de gateway como `ANTHROPIC_BASE_URL` del shell desde el que se lanzó el supervisor; el supervisor proporciona una instantánea de credenciales nueva a los workers precalentados, lo que corrige errores espurios de `Could not resolve authentication method`. |1180| v2.1.174 | Las sesiones en segundo plano ya no heredan variables de endpoint de gateway como `ANTHROPIC_BASE_URL` del shell desde el que se lanzó el supervisor; el supervisor proporciona una instantánea de credenciales nueva a los workers precalentados, lo que corrige errores espurios de `Could not resolve authentication method`. |

1181| v2.1.172 | `/model` en la entrada de distribución establece una sobrescritura del modelo de distribución con alcance de sesión. |1181| v2.1.172 | `/model` en la entrada de distribución establece una sobrescritura del modelo de distribución con alcance de sesión. |

13| Claude for Teams / Enterprise | [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) | Métricas de uso, métricas de contribución con integración de GitHub, tabla de clasificación, exportación de datos | [Detalles](#access-analytics-for-team-and-enterprise) |13| Claude for Teams / Enterprise | [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) | Métricas de uso, métricas de contribución con integración de GitHub, tabla de clasificación, exportación de datos | [Detalles](#access-analytics-for-team-and-enterprise) |

14| API (Claude Console) | [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | Métricas de uso, seguimiento de gastos, información del equipo | [Detalles](#access-analytics-for-api-customers) |14| API (Claude Console) | [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | Métricas de uso, seguimiento de gastos, información del equipo | [Detalles](#access-analytics-for-api-customers) |

15 15 

16Code Review tiene su propio panel. Para ver la actividad de revisión y el gasto, consulta [Ver el uso](/docs/es/code-review-costs#view-usage).

17 

16<h2 id="access-analytics-for-team-and-enterprise">18<h2 id="access-analytics-for-team-and-enterprise">

17 Acceder a análisis para Team y Enterprise19 Acceder a análisis para Team y Enterprise

18</h2>20</h2>

75| La sesión está en [modo plan](/docs/es/permission-modes#analyze-before-you-edit-with-plan-mode) | Pregunta antes de la primera publicación de cada artefacto |75| La sesión está en [modo plan](/docs/es/permission-modes#analyze-before-you-edit-with-plan-mode) | Pregunta antes de la primera publicación de cada artefacto |

76| La publicación declara capacidades de tiempo de ejecución para la página, como [llamadas de conector](#pull-live-data-with-mcp-connectors) o [descargas de archivos](#offer-a-file-download) | Pregunta antes de esa publicación |76| La publicación declara capacidades de tiempo de ejecución para la página, como [llamadas de conector](#pull-live-data-with-mcp-connectors) o [descargas de archivos](#offer-a-file-download) | Pregunta antes de esa publicación |

77| Compartiste el artefacto públicamente | Pregunta una vez por conversación antes de cambiarlo |77| Compartiste el artefacto públicamente | Pregunta una vez por conversación antes de cambiarlo |

78| Desactivaste la [obtención de banderas de características](/docs/es/env-vars#features-that-need-feature-flag-fetching) | Pregunta antes de la primera publicación de cada artefacto |

79| Claude publica en un turno que inició una [tarea programada](/docs/es/scheduled-tasks) ejecutada en tu sesión, en lugar de un prompt que escribiste | Pregunta antes de la primera publicación de cada artefacto |78| Claude publica en un turno que inició una [tarea programada](/docs/es/scheduled-tasks) ejecutada en tu sesión, en lugar de un prompt que escribiste | Pregunta antes de la primera publicación de cada artefacto |

80| Claude no puede leer el archivo sin tu aprobación | Pregunta antes de publicarlo. Una regla de permiso para la herramienta `Artifact` no omite esta solicitud |79| Claude no puede leer el archivo sin tu aprobación | Pregunta antes de publicarlo. Una regla de permiso para la herramienta `Artifact` no omite esta solicitud |

80| En modo [Manual](/docs/es/permission-modes) o `acceptEdits`, Claude hace un pequeño cambio en el archivo de un artefacto que no puede editar sin tu aprobación, como un archivo del proyecto en modo Manual | Pregunta antes de publicar el cambio. Se te pregunta incluso si una regla de permiso cubre la herramienta `Artifact`, porque la edición del archivo necesita tu aprobación |

81 81 

82Claude lee archivos en los [directorios de trabajo](/docs/es/permissions#working-directories) de tu sesión, y en el directorio temporal donde escribe las páginas, sin preguntar. Para permitir que Claude publique desde otra carpeta sin la solicitud, agrega la carpeta como directorio de trabajo con [`--add-dir`](/docs/es/cli-reference#cli-flags) al iniciar o con `/add-dir` durante la sesión.82Para permitir que Claude lea un archivo fuera de tus [directorios de trabajo](/docs/es/permissions#working-directories) sin tu aprobación, agrega su carpeta como directorio de trabajo con [`--add-dir`](/docs/es/cli-reference#cli-flags) al iniciar o con `/add-dir` durante la sesión. Claude ya lee archivos en esos directorios, y en el directorio temporal donde escribe las páginas, sin preguntar.

83 

84Si una solicitud de publicación incluye una oración como `Also makes 1 edit to that file on disk.`, Claude está cambiando el archivo del artefacto y publicándolo en un solo paso. Cuando apruebas la solicitud, Claude Code publica la página y luego escribe el cambio en tu archivo.

83 85 

84<h2 id="update-an-artifact">86<h2 id="update-an-artifact">

85 Actualizar un artefacto87 Actualizar un artefacto

149* **Sesión en la nube sin acceso a la red**: para un [entorno en la nube](/docs/es/cloud-environments#access-levels), ese es el nivel **None**. En [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode), el clasificador puede aprobar en tu lugar; en una sesión de [Cowork](https://claude.com/product/cowork), la aprobación es exclusivamente tuya.151* **Sesión en la nube sin acceso a la red**: para un [entorno en la nube](/docs/es/cloud-environments#access-levels), ese es el nivel **None**. En [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode), el clasificador puede aprobar en tu lugar; en una sesión de [Cowork](https://claude.com/product/cowork), la aprobación es exclusivamente tuya.

150* **Artefacto público de otra organización**: Claude Code te pregunta primero, incluso en modo automático. Cuando Claude Code no puede preguntarte, como en el modo `bypassPermissions`, Claude no puede leer el artefacto. Claude puede leer estos artefactos solo mientras la [obtención de feature flags](/docs/es/env-vars#features-that-need-feature-flag-fetching) esté activada.152* **Artefacto público de otra organización**: Claude Code te pregunta primero, incluso en modo automático. Cuando Claude Code no puede preguntarte, como en el modo `bypassPermissions`, Claude no puede leer el artefacto. Claude puede leer estos artefactos solo mientras la [obtención de feature flags](/docs/es/env-vars#features-that-need-feature-flag-fetching) esté activada.

151* **Propietario o ajuste de red sin confirmar**: cuando Claude Code no puede confirmar quién creó el artefacto, o no puede confirmar el ajuste de red de una sesión en la nube, pregunta, y tu aprobación cubre esa única solicitud.153* **Propietario o ajuste de red sin confirmar**: cuando Claude Code no puede confirmar quién creó el artefacto, o no puede confirmar el ajuste de red de una sesión en la nube, pregunta, y tu aprobación cubre esa única solicitud.

152* **Modo plan, u obtención de feature flags desactivada**: en [modo plan](/docs/es/permission-modes#analyze-before-you-edit-with-plan-mode), o si desactivaste la [obtención de feature flags](/docs/es/env-vars#features-that-need-feature-flag-fetching), Claude Code pregunta antes de que la herramienta Artifact lea un artefacto creado por otra persona de tu organización.154* **Modo plan**: en [modo plan](/docs/es/permission-modes#analyze-before-you-edit-with-plan-mode), Claude Code pregunta antes de que la herramienta Artifact lea un artefacto creado por otra persona de tu organización.

153 155 

154Cuando Claude lee el artefacto con WebFetch, las propias [reglas de solicitud de permisos](/docs/es/tools-reference#webfetch-tool-behavior) de WebFetch siguen aplicándose.156Cuando Claude lee el artefacto con WebFetch, las propias [reglas de solicitud de permisos](/docs/es/tools-reference#webfetch-tool-behavior) de WebFetch siguen aplicándose.

155 157 

102Un [subagente](/docs/es/sub-agents) realiza ediciones con las herramientas de edición de archivos de Claude, pero Claude Code normalmente no captura esas ediciones en los checkpoints de su sesión. Si el rewind las restaura depende de cómo se ejecute el subagente:102Un [subagente](/docs/es/sub-agents) realiza ediciones con las herramientas de edición de archivos de Claude, pero Claude Code normalmente no captura esas ediciones en los checkpoints de su sesión. Si el rewind las restaura depende de cómo se ejecute el subagente:

103 103 

104* **Skill forked en primer plano**: un [skill con `context: fork`](/docs/es/skills#run-skills-in-a-subagent) que se ejecuta en primer plano edita su árbol de trabajo durante su propio turno, por lo que el rewind restaura sus ediciones como de costumbre. Establezca `background: false` para ejecutar un fork en primer plano; algunas situaciones, [listadas en la página de skills](/docs/es/skills#run-skills-in-a-subagent), lo ejecutan allí independientemente de la configuración.104* **Skill forked en primer plano**: un [skill con `context: fork`](/docs/es/skills#run-skills-in-a-subagent) que se ejecuta en primer plano edita su árbol de trabajo durante su propio turno, por lo que el rewind restaura sus ediciones como de costumbre. Establezca `background: false` para ejecutar un fork en primer plano; algunas situaciones, [listadas en la página de skills](/docs/es/skills#run-skills-in-a-subagent), lo ejecutan allí independientemente de la configuración.

105* **Cualquier otro subagente**: el rewind no restaura las ediciones. Use git para revertirlas. Esto incluye un skill forked que se ejecuta en segundo plano, el predeterminado, y una ejecución de [`/code-review --fix`](/docs/es/code-review) en segundo plano.105* **Cualquier otro subagente**: el rewind solo restaura los archivos que Claude ya había editado en tu conversación. Las ediciones del subagente en otros archivos se mantienen, así que usa git para revertirlas. Esto incluye un skill forked que se ejecuta en segundo plano, el predeterminado, y una ejecución de [`/code-review --fix`](/docs/es/code-review-local) en segundo plano.

106 106 

107<h3 id="external-changes-not-tracked">107<h3 id="external-changes-not-tracked">

108 Los cambios externos no se rastrean108 Los cambios externos no se rastrean

64Consulta [Conectar desde tu terminal](/docs/es/web-quickstart#connect-from-your-terminal) para el tutorial de `/web-setup`, incluyendo qué almacena `/web-setup` y cómo eliminarlo.64Consulta [Conectar desde tu terminal](/docs/es/web-quickstart#connect-from-your-terminal) para el tutorial de `/web-setup`, incluyendo qué almacena `/web-setup` y cómo eliminarlo.

65 65 

66<Note>66<Note>

67 Las organizaciones con [Retención de datos cero](/docs/es/zero-data-retention) habilitada, o con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada, no pueden usar `/web-setup` u otras características de sesión en la nube.67 Las organizaciones con [Retención de datos cero](/docs/es/zero-data-retention) habilitada, o con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada, no pueden usar `/web-setup` u otras características de sesión en la nube. Las organizaciones que usan [claves de cifrado administradas por el cliente](https://platform.claude.com/docs/en/manage-claude/cmek) (CMEK) tampoco pueden iniciar sesiones en la nube.

68</Note>68</Note>

69 69 

70<h3 id="quick-setup-for-team-and-enterprise">70<h3 id="quick-setup-for-team-and-enterprise">

559 559 

560El `matcher` limita el hook a los eventos `startup` y `resume`, y `$CLAUDE_PROJECT_DIR` se resuelve a la raíz del repositorio, por lo que el hook encuentra el script independientemente del directorio de trabajo de la sesión.560El `matcher` limita el hook a los eventos `startup` y `resume`, y `$CLAUDE_PROJECT_DIR` se resuelve a la raíz del repositorio, por lo que el hook encuentra el script independientemente del directorio de trabajo de la sesión.

561 561 

562A continuación, cree el script en `scripts/install_pkgs.sh`. Sale inmediatamente fuera de la nube, luego instala sus dependencias:562A continuación, crea el script en `scripts/install_pkgs.sh`. Sale inmediatamente fuera de la nube y luego instala tus dependencias. Omite `npm install` mientras `package.json`, `package-lock.json` y el propio script no hayan cambiado desde la última instalación exitosa:

563 563 

564```bash theme={null}564```bash theme={null}

565#!/bin/bash565#!/bin/bash

568 exit 0568 exit 0

569fi569fi

570 570 

571npm install571cd "$CLAUDE_PROJECT_DIR" || exit 1

572hashes=node_modules/.install_pkgs.sha256

573 

574if ! sha256sum --check --status "$hashes" 2>/dev/null; then

575 # Delete the old hashes first, so a failed install runs again next time

576 rm -f "$hashes"

577 if npm install; then

578 sha256sum scripts/install_pkgs.sh package.json package-lock.json > "$hashes" || rm -f "$hashes"

579 fi

580fi

581 

582# pip skips requirements that are already satisfied

572pip install -r requirements.txt583pip install -r requirements.txt

573exit 0584exit 0

574```585```

575 586 

576La verificación `CLAUDE_CODE_REMOTE` es lo que limita la instalación a sesiones en la nube: la VM de la sesión lleva esa variable como `true`, nunca es `true` localmente, por lo que en su portátil el script sale antes de instalar cualquier cosa.587La verificación `CLAUDE_CODE_REMOTE` es lo que limita la instalación a sesiones en la nube: la VM de la sesión lleva esa variable como `true`, nunca es `true` localmente, por lo que en su portátil el script sale antes de instalar cualquier cosa.

577 588 

578Juntos, los dos archivos dan a cada sesión en la nube un `npm install` y `pip install` nuevo al inicio mientras dejan las sesiones locales sin tocar.589Para confirmar que `npm install` se completó correctamente, inicia una sesión en la nube y pídele a Claude que muestre `node_modules/.install_pkgs.sha256`. El archivo enumera un hash para cada uno de los tres archivos. Si el archivo no existe, pídele a Claude que ejecute `npm install` y que informe el error.

590 

591<Note>

592 Si `npm install` lee otros archivos, como el `package.json` de un espacio de trabajo, un `.npmrc` o las entradas de tu script `postinstall`, agrégalos al comando `sha256sum` que guarda los hashes. De lo contrario, conservarás los paquetes antiguos después de que cambie uno de esos archivos.

593</Note>

579 594 

580<h4 id="limitations-in-cloud-sessions">595<h4 id="limitations-in-cloud-sessions">

581 Limitaciones en sesiones en la nube596 Limitaciones en sesiones en la nube

587* **Sin alcance solo en la nube**: los hooks se ejecutan en sesiones locales y en la nube. Para omitir la ejecución local, salga temprano a menos que la variable de entorno `CLAUDE_CODE_REMOTE` sea `true`, de la manera que lo hace el [script de instalación de dependencias](#install-dependencies-with-a-sessionstart-hook).602* **Sin alcance solo en la nube**: los hooks se ejecutan en sesiones locales y en la nube. Para omitir la ejecución local, salga temprano a menos que la variable de entorno `CLAUDE_CODE_REMOTE` sea `true`, de la manera que lo hace el [script de instalación de dependencias](#install-dependencies-with-a-sessionstart-hook).

588* **Requiere acceso a la red**: los comandos de instalación necesitan alcanzar registros de paquetes. Si su entorno usa acceso a la red **None**, estos hooks fallan. La [lista permitida predeterminada](#default-allowed-domains) bajo **Trusted** cubre npm, PyPI, RubyGems y crates.io.603* **Requiere acceso a la red**: los comandos de instalación necesitan alcanzar registros de paquetes. Si su entorno usa acceso a la red **None**, estos hooks fallan. La [lista permitida predeterminada](#default-allowed-domains) bajo **Trusted** cubre npm, PyPI, RubyGems y crates.io.

589* **Compatibilidad con proxy**: en entornos alojados por Anthropic, todo el tráfico saliente pasa por un [proxy de seguridad](#security-proxy), y algunos administradores de paquetes no funcionan correctamente con él; Bun es un ejemplo conocido. En un [entorno autohospedado](/docs/es/self-hosted-environments-deploy#default-deny-egress), el tráfico saliente va a través de su propio límite de red en su lugar.604* **Compatibilidad con proxy**: en entornos alojados por Anthropic, todo el tráfico saliente pasa por un [proxy de seguridad](#security-proxy), y algunos administradores de paquetes no funcionan correctamente con él; Bun es un ejemplo conocido. En un [entorno autohospedado](/docs/es/self-hosted-environments-deploy#default-deny-egress), el tráfico saliente va a través de su propio límite de red en su lugar.

590* **Agrega latencia de inicio**: los hooks se ejecutan cada vez que comienza o se reanuda una sesión, a diferencia de los scripts de configuración que se benefician del [almacenamiento en caché del entorno](#environment-caching). Mantenga los scripts de instalación rápidos verificando si las dependencias ya están presentes antes de reinstalar.605* **Agrega latencia de inicio**: los hooks se ejecutan cada vez que comienza o se reanuda una sesión, a diferencia de los scripts de configuración, que se benefician del [almacenamiento en caché del entorno](#environment-caching). Mantén rápidos los scripts de instalación omitiendo el trabajo que ya está hecho, como lo hace el [script de instalación de dependencias](#install-dependencies-with-a-sessionstart-hook).

591 606 

592Para personalizar la imagen base, use un script de configuración para instalar lo que necesita encima de la [imagen proporcionada](#installed-tools), o ejecute su propia imagen como un contenedor junto a Claude con `docker compose`. Reemplazar la imagen base completamente aún no es compatible.607Para personalizar la imagen base, use un script de configuración para instalar lo que necesita encima de la [imagen proporcionada](#installed-tools), o ejecute su propia imagen como un contenedor junto a Claude con `docker compose`. Reemplazar la imagen base completamente aún no es compatible.

593 608 

4 4 

5# Code Review5# Code Review

6 6 

7> Configure revisiones automatizadas de PR que detecten errores lógicos, vulnerabilidades de seguridad y regresiones mediante análisis multiagente de su base de código completa7> Detecta errores en pull requests de GitHub con Code Review: Claude revisa cada cambio, verifica sus hallazgos y comenta en línea. Para los planes Team y Enterprise

8 8 

9<Note>9Con Code Review, Claude revisa los pull requests de tus repositorios de GitHub. Varios agentes leen cada cambio junto con el código circundante y buscan problemas como errores lógicos, vulnerabilidades de seguridad o casos límite rotos. Un paso de verificación contrasta los hallazgos con el código antes de reportarlos.

10 Code Review está en vista previa de investigación, disponible para suscripciones de [Team y Enterprise](https://claude.ai/admin-settings/claude-code). No está disponible para organizaciones con [Zero Data Retention](/docs/es/zero-data-retention) habilitado o con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada, y no está cubierto por el BAA de Anthropic. En otros planes, aún puedes [revisar un diff localmente](#review-a-diff-locally) con el comando `/code-review`.

11</Note>

12 

13Code Review analiza sus solicitudes de extracción de GitHub y publica hallazgos como comentarios en línea en las líneas de código donde encontró problemas. Una flota de agentes especializados examina los cambios de código en el contexto de su base de código completa, buscando errores lógicos, vulnerabilidades de seguridad, casos límite rotos y regresiones sutiles.

14 

15Los hallazgos se etiquetan por severidad y no aprueban ni bloquean su PR, por lo que los flujos de trabajo de revisión existentes permanecen intactos. Puede ajustar lo que Claude marca agregando un archivo `CLAUDE.md` o `REVIEW.md` a su repositorio.

16 

17Para ejecutar Claude en su propia infraestructura de CI en lugar de este servicio administrado, consulte [GitHub Actions](/docs/es/github-actions) o [GitLab CI/CD](/docs/es/gitlab-ci-cd). Para repositorios en una instancia de GitHub autohospedada, consulte [GitHub Enterprise Server](/docs/es/github-enterprise-server).

18 10 

19Esta página cubre:11Los hallazgos llegan como comentarios en línea en las líneas afectadas, clasificados por [severidad](/docs/es/code-review-pull-requests#severity-levels), con un resumen y una ejecución de verificación en el pull request. Una revisión nunca aprueba ni bloquea el pull request, así que la decisión de fusionar sigue siendo de tu equipo.

20 12 

21* [Cómo funcionan las revisiones](#how-reviews-work)13<img src="https://mintcdn.com/claude-code/gLJVaPQEgKC8ZyUD/images/code-review-pipeline.svg?fit=max&auto=format&n=gLJVaPQEgKC8ZyUD&q=85&s=0351c96df9efa3105172eb00a672f130" className="dark:hidden" alt="Diagrama de una revisión en cuatro etapas. Un pull request en GitHub pasa a varios agentes que buscan en paralelo en la infraestructura de Anthropic. Un paso de verificación descarta los falsos positivos, los hallazgos restantes se desduplican y se clasifican por severidad, y la revisión publica comentarios en línea, un resumen y una ejecución de verificación de vuelta en GitHub." width="760" height="300" data-path="images/code-review-pipeline.svg" />

22* [Configuración](#set-up-code-review)

23* [Disparar revisiones manualmente](#manually-trigger-reviews) con `@claude review` y `@claude review always`

24* [Personalizar revisiones](#customize-reviews) con `CLAUDE.md` y `REVIEW.md`

25* [Precios](#pricing)

26* [Solución de problemas](#troubleshooting) ejecuciones fallidas y comentarios faltantes

27* [Revisar un diff localmente](#review-a-diff-locally) con el comando `/code-review`

28 

29<h2 id="how-reviews-work">

30 Cómo funcionan las revisiones

31</h2>

32 14 

33Una vez que un administrador [habilita Code Review](#set-up-code-review) para su organización, las revisiones se activan cuando se abre un PR, en cada push, o cuando se solicita manualmente, según el comportamiento configurado del repositorio. Comentar `@claude review` [inicia una revisión en un PR](#manually-trigger-reviews) en cualquier modo.15<img src="https://mintcdn.com/claude-code/gLJVaPQEgKC8ZyUD/images/code-review-pipeline-dark.svg?fit=max&auto=format&n=gLJVaPQEgKC8ZyUD&q=85&s=9cf26bde98f4e999d0d9ff5bf5bdff40" className="hidden dark:block" alt="Diagrama de una revisión en cuatro etapas. Un pull request en GitHub pasa a varios agentes que buscan en paralelo en la infraestructura de Anthropic. Un paso de verificación descarta los falsos positivos, los hallazgos restantes se desduplican y se clasifican por severidad, y la revisión publica comentarios en línea, un resumen y una ejecución de verificación de vuelta en GitHub." width="760" height="300" data-path="images/code-review-pipeline-dark.svg" />

34 

35Cuando se ejecuta una revisión, múltiples agentes analizan el diff y el código circundante en paralelo en la infraestructura de Anthropic. Cada agente busca una clase diferente de problema, luego un paso de verificación verifica los candidatos contra el comportamiento real del código para filtrar falsos positivos. Los resultados se desduplican, se clasifican por severidad y se publican como comentarios en línea en las líneas específicas donde se encontraron problemas, con un resumen en el cuerpo de la revisión. Si no se encuentran problemas, Code Review actualiza la ejecución de verificación de GitHub para mostrar que no se detectaron problemas. Claude también puede publicar un breve comentario de confirmación en el PR.

36 

37Las revisiones se escalan en costo con el tamaño y la complejidad del PR, completándose en un promedio de 20 minutos. Los administradores pueden monitorear la actividad de revisión y el gasto a través del [panel de análisis](#view-usage).

38 

39<h3 id="severity-levels">

40 Niveles de severidad

41</h3>

42 

43Cada hallazgo se etiqueta con un nivel de severidad:

44 

45| Marcador | Severidad | Significado |

46| :- | :- | :- |

47| 🔴 | Importante | Un error que debe corregirse antes de fusionar |

48| 🟡 | Nit | Un problema menor, vale la pena corregir pero no bloqueante |

49| 🟣 | Preexistente | Un error que existe en la base de código pero no fue introducido por este PR |

50 

51Los hallazgos incluyen una sección contraíble **Por qué se marcó esto** que puede expandir para leer por qué Claude marcó el problema y cómo verificó el problema.

52 

53<h3 id="rate-and-reply-to-findings">

54 Calificar y responder a hallazgos

55</h3>

56 

57Cada comentario de revisión de Claude llega con 👍 y 👎 ya adjuntos para que ambos botones aparezcan en la interfaz de usuario de GitHub para calificación de un clic. Haga clic en 👍 si el hallazgo fue útil o 👎 si fue incorrecto o ruidoso. Anthropic recopila conteos de reacciones después de que se fusiona el PR y los utiliza para ajustar el revisor. Las reacciones no activan una re-revisión ni cambian nada en el PR.

58 

59Responder a un comentario en línea no solicita a Claude que responda o actualice el PR. Para actuar sobre un hallazgo, corrija el código y haga push. Si el PR está suscrito a revisiones activadas por push, la siguiente ejecución resuelve el hilo cuando se corrige el problema. Para solicitar una revisión nueva sin hacer push, comente `@claude review` como un [comentario de PR de nivel superior](#manually-trigger-reviews).

60 

61Para descartar un hallazgo sin un cambio de código, resuelva su hilo; responder no lo descarta.

62 

63<h3 id="check-run-output">

64 Salida de ejecución de verificación

65</h3>

66 

67Más allá de los comentarios de revisión en línea, cada revisión completa la ejecución de verificación **Claude Code Review** que aparece junto a sus verificaciones de CI. Expanda su enlace **Details** para ver un resumen de cada hallazgo en un solo lugar, ordenado por severidad:

68 

69| Severidad | Archivo:Línea | Problema |

70| - | - | - |

71| 🔴 Importante | `src/auth/session.ts:142` | La actualización de token corre una carrera con el cierre de sesión, dejando sesiones obsoletas activas |

72| 🟡 Nit | `src/auth/session.ts:88` | `parseExpiry` devuelve silenciosamente 0 en entrada malformada |

73 

74Cada hallazgo también aparece como una anotación en la pestaña **Files changed**, marcado directamente en las líneas de diff relevantes. Los hallazgos importantes se representan con un marcador rojo, los nits con una advertencia amarilla y los errores preexistentes con un aviso gris. Las anotaciones y la tabla de severidad se escriben en la ejecución de verificación independientemente de los comentarios de revisión en línea, por lo que permanecen disponibles incluso si GitHub rechaza un comentario en línea en una línea que se movió.

75 

76La ejecución de verificación siempre se completa con una conclusión neutral para que nunca bloquee la fusión a través de reglas de protección de rama. Si desea bloquear fusiones en hallazgos de Code Review, lea el desglose de severidad de la salida de ejecución de verificación en su propio CI. La última línea del texto de Details es un comentario legible por máquina que su flujo de trabajo puede analizar con `gh` y jq. Para encontrar el ID de ejecución de verificación, enumere las ejecuciones de verificación del commit con `gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}'` y tome el `id` de la ejecución **Claude Code Review**. Reemplace `OWNER`, `REPO` y `CHECK_RUN_ID` con el propietario del repositorio, el nombre del repositorio y ese ID:

77 

78```bash theme={null}

79gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \

80 --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

81```

82 

83Esto devuelve un objeto JSON con conteos por severidad, por ejemplo `{"normal": 2, "nit": 1, "pre_existing": 0}`. La clave `normal` contiene el conteo de hallazgos Importantes; un valor distinto de cero significa que Claude encontró al menos un error que vale la pena corregir antes de fusionar.

84 

85<h3 id="what-code-review-checks">

86 Qué verifica Code Review

87</h3>

88 

89Por defecto, Code Review se enfoca en la corrección: errores que romperían la producción, no preferencias de formato o cobertura de pruebas faltante. Puede expandir lo que verifica [agregando archivos de orientación](#customize-reviews) a su repositorio.

90 

91<h2 id="set-up-code-review">

92 Configurar Code Review

93</h2>

94 

95Un propietario habilita Code Review una vez para la organización y selecciona qué repositorios incluir.

96 

97<Steps>

98 <Step title="Abrir configuración de administrador de Claude Code">

99 Vaya a [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) y encuentre la sección Code Review. Necesita el rol de propietario o propietario principal en su organización de Claude y permiso para instalar GitHub Apps en su organización de GitHub.

100 </Step>

101 

102 <Step title="Iniciar configuración">

103 Haga clic en **Setup**. Esto inicia el flujo de instalación de GitHub App.

104 </Step>

105 

106 <Step title="Instalar la Claude GitHub App">

107 Siga las indicaciones para instalar la Claude GitHub App: seleccione la organización de GitHub que posee los repositorios que desea revisar, elija a qué repositorios puede acceder la aplicación y apruebe los permisos solicitados.

108 

109 Para revisar una solicitud de extracción, Claude lee el contenido de su repositorio a través del acceso de lectura de la aplicación y publica comentarios y la [ejecución de verificación](#check-run-output) a través de su acceso de escritura a solicitudes de extracción y verificaciones. Durante la instalación, otorga un conjunto de permisos más amplio compartido por otras características de Claude, como [GitHub Actions](/docs/es/github-actions); consulte [Permisos de GitHub App](/docs/es/github-actions#github-app-permissions) para obtener la lista completa.

110 </Step>

111 

112 <Step title="Seleccionar repositorios">

113 Elija qué repositorios habilitar para Code Review. Si no ve un repositorio, asegúrese de haber dado a la Claude GitHub App acceso a él durante la instalación. Puede agregar más repositorios más adelante.

114 </Step>

115 

116 <Step title="Establecer disparadores de revisión por repositorio">

117 Después de que se complete la configuración, la sección Code Review muestra sus repositorios en una tabla. Para cada repositorio, use el menú desplegable **Review Behavior** para elegir cuándo se ejecutan las revisiones:

118 

119 * **Once after PR creation**: la revisión se ejecuta una vez cuando se abre un PR o se marca como listo para revisión

120 * **After every push**: la revisión se ejecuta en cada push a la rama del PR, detectando nuevos problemas a medida que el PR evoluciona y resolviendo automáticamente los hilos cuando corrige problemas marcados

121 * **Manual**: abrir o hacer push a un PR no inicia una revisión; comente [`@claude review`](#manually-trigger-reviews) para solicitar una, o `@claude review always` para también suscribir el PR a revisiones en push posteriores

122 

123 Sea cual sea la opción que elija, Claude revisa una [solicitud de extracción de una bifurcación](#review-pull-requests-from-forks) solo cuando alguien comenta `@claude review` en ella.

124 

125 Revisar en cada push ejecuta la mayoría de revisiones y cuesta más. El modo manual es útil para repositorios de alto tráfico donde desea optar por revisión en PR específicos, o para comenzar a revisar sus PR solo cuando estén listos.

126 </Step>

127</Steps>

128 

129La tabla de repositorios también muestra el costo promedio por revisión para cada repositorio basado en la actividad reciente. Use el menú de acciones de fila para activar o desactivar Code Review por repositorio, o para eliminar un repositorio por completo.

130 

131Para verificar la configuración, abra un PR de prueba. Si eligió un disparador automático, aparece una ejecución de verificación llamada **Claude Code Review** dentro de unos minutos. Si eligió Manual, comente `@claude review` en el PR para iniciar la primera revisión. Si no aparece ninguna ejecución de verificación, confirme que el repositorio esté listado en su configuración de administrador y que la Claude GitHub App tenga acceso a él.

132 

133<h2 id="manually-trigger-reviews">

134 Disparar revisiones manualmente

135</h2>

136 

137Los comandos de comentario inician una revisión bajo demanda. Funcionan independientemente del disparador configurado del repositorio, por lo que puede usarlos para optar por PR específicos en revisión en modo Manual o para obtener una re-revisión inmediata en otros modos.

138 

139| Comando | Lo que hace |

140| :- | :- |

141| `@claude review` | Inicia una única revisión sin suscribir el PR a futuras inserciones |

142| `@claude review always` | Inicia una revisión y suscribe el PR a revisiones activadas por push en adelante |

143| `@claude review once` | Lo mismo que `@claude review`: inicia una única revisión sin suscribir |

144 

145Use `@claude review always` cuando desee que cada inserción posterior al PR inicie una revisión nueva, como en un PR de alta prioridad en un repositorio configurado en modo Manual. Dado que el comando simple no suscribe el PR, puede solicitar una segunda opinión única sin cambiar si las inserciones posteriores activan revisiones.

146 16 

147<Note>17<Note>

148 Antes de una actualización de julio de 2026, `@claude review` suscribía el PR a revisiones activadas por push. Si dependía de ese comportamiento, comente `@claude review always` en su lugar. `@claude review once` sigue funcionando y se comporta igual que el comando simple.18 Code Review usa IA para revisar código y puede pasar por alto errores, vulnerabilidades de seguridad u otros problemas. Una revisión sin hallazgos no significa que tu código esté libre de errores ni que sea seguro.

149</Note>19</Note>

150 20 

151Para que cualquiera de estos comandos active una revisión:21<span id="review-a-diff-locally" />

152 

153* Publíquelo como un comentario de PR de nivel superior, no un comentario en línea en una línea de diff

154* Ponga el comando al inicio del comentario, con `once` o `always` en la misma línea que el resto del comando

155* Debe tener permiso de escritura, mantenimiento o administrador en el repositorio

156* El PR debe estar abierto

157 

158A diferencia de los disparadores automáticos, los disparadores manuales se ejecutan en PR de borrador, ya que una solicitud explícita señala que desea la revisión ahora independientemente del estado de borrador.

159 

160Si una revisión ya se está ejecutando en ese PR, la solicitud se pone en cola hasta que se complete la revisión en progreso. Puede monitorear el progreso a través de la ejecución de verificación en el PR.

161 

162<h3 id="review-pull-requests-from-forks">

163 Revisar solicitudes de extracción desde bifurcaciones

164</h3>

165 

166Claude no revisa una solicitud de extracción desde una bifurcación automáticamente, independientemente de la configuración de **Comportamiento de revisión** del repositorio. Para iniciar una, comente `@claude review` en la solicitud de extracción. Los [requisitos para comandos de comentario](#manually-trigger-reviews) aún se aplican, y el acceso de escritura que necesita es al repositorio base, no a la bifurcación.

167 22 

168Para obtener otra revisión de una solicitud de extracción de bifurcación, publique un nuevo comentario `@claude review`. `@claude review always` también funciona, pero no suscribe la solicitud de extracción a revisiones en inserciones posteriores. Nada más que un comando de comentario inicia una revisión en una solicitud de extracción de bifurcación:23Para activar Code Review, un Owner de tu organización de Claude sigue [Configurar Code Review](/docs/es/code-review-setup). Claude también puede revisar código sin este servicio. Ejecuta [`/code-review`](/docs/es/code-review-local) en tu sesión de Claude Code en cualquier plan, o [compara todas las opciones](#compare-ways-to-get-a-review).

169 24 

170* Hacer clic en **Re-ejecutar** en la ejecución de verificación no inicia una revisión25<h2 id="availability">

171* Insertar nuevos commits no inicia una revisión, incluso en un repositorio configurado en **Después de cada push**26 Disponibilidad

172 

173<h2 id="customize-reviews">

174 Personalizar revisiones

175</h2>27</h2>

176 28 

177Code Review lee dos archivos de su repositorio para guiar lo que marca. Difieren en cuán fuertemente influyen en la revisión:29Comprueba que tu organización cumpla los requisitos antes de configurar Code Review:

178 

179* **`CLAUDE.md`**: instrucciones de proyecto compartidas que Claude Code utiliza para todas las tareas, no solo revisiones. Code Review lo lee como contexto de proyecto e marca las violaciones recién introducidas como nits.

180* **`REVIEW.md`**: instrucciones solo de revisión, proporcionadas a los agentes que encuentran y verifican hallazgos y consultadas por los agentes que clasifican y reportan hallazgos. Úselo para indicar qué desea que se marque su equipo, con qué severidad y cómo se reportan los hallazgos.

181 

182<h3 id="claude-md">

183 CLAUDE.md

184</h3>

185 

186Code Review lee sus archivos `CLAUDE.md` del repositorio y trata las violaciones recién introducidas como hallazgos de [nivel nit](#severity-levels). Esto funciona bidireccionalamente: si su PR cambia el código de una manera que hace que una declaración `CLAUDE.md` esté desactualizada, Claude marca que los documentos necesitan actualización también.

187 

188Claude lee archivos `CLAUDE.md` en cada nivel de su jerarquía de directorios, por lo que las reglas en el `CLAUDE.md` de un subdirectorio se aplican solo a archivos bajo esa ruta. Consulte la [documentación de memoria](/docs/es/memory) para obtener más información sobre cómo funciona `CLAUDE.md`.

189 30 

190Para orientación específica de revisión que no desea aplicar a sesiones generales de Claude Code, use [`REVIEW.md`](#review-md) en su lugar.31* **Planes**: [Team y Enterprise](/docs/es/feature-availability)

191 32* **Hosts de código**: repositorios alojados en GitHub, incluidos [GitHub Enterprise Server](/docs/es/github-enterprise-server) y GitHub Enterprise Cloud con residencia de datos. Para la residencia de datos, pide a un Owner que siga la [configuración de administración de GitHub Enterprise Server](/docs/es/github-enterprise-server#admin-setup) e introduzca el nombre de host `ghe.com` de tu empresa.

192<h3 id="review-md">33* **Retención de datos**: Code Review no está disponible para organizaciones con [Zero Data Retention](/docs/es/zero-data-retention) habilitado o con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada, y no está cubierto por el Business Associate Agreement (BAA) de Anthropic.

193 REVIEW\.md34* **Claves de cifrado**: Code Review aún no está disponible para organizaciones que usan claves de cifrado administradas por el cliente (CMEK).

194</h3>35* **Proveedores de nube**: necesitas una organización de Claude en uno de estos planes incluso si tus desarrolladores usan Claude Code a través de Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry

195 36 

196`REVIEW.md` es un archivo en la raíz de su repositorio que personaliza Code Review para su repositorio. Los agentes en la canalización de revisión que encuentran y verifican hallazgos reciben su contenido como las instrucciones de revisión de su repositorio, junto con la orientación de revisión predeterminada de Code Review, y los agentes que clasifican y reportan hallazgos la consultan antes de establecer la severidad y escribir la revisión.37<h2 id="set-up-and-use-code-review">

197 38 Configurar y usar Code Review

198Ponga las reglas que desea aplicar directamente en `REVIEW.md`.

199 

200<h4 id="what-you-can-tune">

201 Qué puede ajustar

202</h4>

203 

204`REVIEW.md` es markdown de forma libre, por lo que cualquier cosa que pueda expresar como una instrucción de revisión está en el alcance. Los patrones a continuación tienen el mayor impacto en la práctica.

205 

206**Severidad**: redefina qué significa 🔴 Importante para su repositorio. La calibración predeterminada se dirige al código de producción; un repositorio de documentos, un repositorio de configuración, o un prototipo podría querer una definición mucho más estrecha. Indique explícitamente qué clases de hallazgo son Importantes y cuáles son Nit como máximo. También puede escalar en la otra dirección, por ejemplo tratando cualquier violación de `CLAUDE.md` como Importante en lugar del nit predeterminado.

207 

208**Volumen de nit**: limite cuántos comentarios 🟡 Nit publica una única revisión. La prosa y los archivos de configuración pueden pulirse para siempre. Un límite como "reportar como máximo cinco nits, mencionar el resto como un conteo en el resumen" mantiene las revisiones accionables.

209 

210**Reglas de omisión**: enumere rutas, patrones de rama y categorías de hallazgo donde Claude no debe publicar hallazgos. Los candidatos comunes son código generado, archivos de bloqueo, dependencias vendidas y ramas creadas por máquinas, junto con cualquier cosa que su CI ya aplique como linting o verificación ortográfica. Para rutas que justifiquen alguna revisión pero no escrutinio completo, establezca una barra más alta en lugar de omitir completamente: "en `scripts/`, solo reportar si está cerca de cierto y es severo."

211 

212**Verificaciones específicas del repositorio**: agregue reglas que desea marcar en cada PR, como "las nuevas rutas de API deben tener una prueba de integración." Porque `REVIEW.md` llega a cada agente de hallazgo y verificación directamente, estos se aterrizan más confiablemente que las mismas reglas en un `CLAUDE.md` largo.

213 

214**Barra de verificación**: requiera evidencia antes de que se publique una clase de hallazgo. Por ejemplo, "las afirmaciones de comportamiento necesitan una cita `file:line` en la fuente, no una inferencia de nombres" reduce falsos positivos que de otro modo costarían al autor un viaje de ida y vuelta.

215 

216**Convergencia de re-revisión**: dígale a Claude cómo comportarse cuando un PR ya ha sido revisado. Una regla como "después de la primera revisión, suprima nits nuevos y publique hallazgos Importantes solo" detiene una corrección de una línea de alcanzar la ronda siete solo por estilo.

217 

218**Forma de resumen**: pida que el cuerpo de revisión se abra con un conteo de una línea como `2 factual, 4 style`, y que comience con "no hay problemas factuales" cuando ese sea el caso. El autor quiere saber la forma del trabajo antes de los detalles.

219 

220<h4 id="example">

221 Ejemplo

222</h4>

223 

224Este `REVIEW.md` recalibra la severidad para un servicio backend, limita nits, omite archivos generados y agrega verificaciones específicas del repositorio.

225 

226```markdown theme={null}

227# Instrucciones de revisión

228 

229## Qué significa Importante aquí

230 

231Reserve Importante para hallazgos que romperían el comportamiento, filtrarían datos,

232o bloquearían un retroceso: lógica incorrecta, consultas de base de datos sin alcance, PII

233en registros o mensajes de error, y migraciones que no son compatibles hacia atrás.

234El estilo, nombres y sugerencias de refactorización son Nit como máximo.

235 

236## Limitar los nits

237 

238Reportar como máximo cinco Nits por revisión. Si encontró más, diga "más N

239elementos similares" en el resumen en lugar de publicarlos en línea. Si

240todo lo que encontró es un Nit, comience el resumen con "Sin problemas bloqueantes."

241 

242## No reportar

243 

244- Cualquier cosa que CI ya aplique: lint, formato, errores de tipo

245- Archivos generados bajo `src/gen/` y cualquier archivo `*.lock`

246- Código solo de prueba que intencionalmente viola reglas de producción

247 

248## Siempre verificar

249 

250- Las nuevas rutas de API tienen una prueba de integración

251- Las líneas de registro no incluyen direcciones de correo electrónico, IDs de usuario o cuerpos de solicitud

252- Las consultas de base de datos están limitadas al inquilino del llamador

253```

254 

255<h4 id="keep-it-focused">

256 Mantenerlo enfocado

257</h4>

258 

259La longitud tiene un costo: un `REVIEW.md` largo diluye las reglas que más importan. Manténgalo en instrucciones que cambien el comportamiento de revisión, y deje el contexto general del proyecto en `CLAUDE.md`.

260 

261<h2 id="view-usage">

262 Ver uso

263</h2>39</h2>

264 40 

265Vaya a [claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) para ver la actividad de Code Review en toda su organización. El panel muestra:41<span id="set-up-code-review" />

266 

267| Sección | Lo que muestra |

268| :- | :- |

269| PRs reviewed | Conteo diario de solicitudes de extracción revisadas durante el rango de tiempo seleccionado |

270| Code Review cost | Gasto en Code Review en lo que va del mes |

271| Feedback | Conteo de comentarios de revisión que se resolvieron automáticamente porque un desarrollador abordó el problema |

272| Repository breakdown | Conteos por repositorio de PR revisados, comentarios resueltos y ejecuciones de revisión, con costo estimado y una vista por PR |

273 

274La tarjeta Code Review cost muestra un monto solo cuando está seleccionado el mes en curso. Las cifras de costo en analytics pueden diferir de tu factura. Los costos de Repository breakdown se estiman a precio de lista, antes de cualquier descuento o crédito, y cubren solo las revisiones que Claude publicó en un pull request. Para un gasto preciso según la factura, consulta tu factura de Anthropic.

275 

276<h2 id="pricing">

277 Precios

278</h2>

279 

280Code Review se factura según el uso de tokens. Cada revisión promedia \$15-25 en costo, escalando con el tamaño del PR, la complejidad de la base de código y cuántos problemas requieren verificación. El uso de Code Review se factura por separado a través de [créditos de uso](https://support.claude.com/es/articles/12429409-extra-usage-for-paid-claude-plans) y no cuenta contra el uso incluido de su plan.

281 

282El disparador de revisión que elija afecta el costo total:

283 

284* **Once after PR creation**: se ejecuta una vez por PR

285* **After every push**: se ejecuta en cada push, multiplicando el costo por el número de push

286* **Manual**: sin revisiones en PR abiertos o push, por lo que el costo se acumula solo de las revisiones que alguien solicita

287 

288En modo Once after PR creation o Manual, comentar `@claude review always` [opta el PR en revisiones activadas por push](#manually-trigger-reviews), por lo que se acumula costo adicional por push después de ese comentario. En modo After every push, los push ya activan revisiones, por lo que la suscripción no cambia el costo por push. Comentar `@claude review` ejecuta una única revisión sin suscribirse a push futuros. Claude revisa una [solicitud de extracción desde un fork](#review-pull-requests-from-forks) solo cuando alguien comenta `@claude review`, por lo que una solicitud de extracción de fork nunca acumula costo por push en ningún modo.

289 42 

290Los costos aparecen en su factura de Anthropic independientemente de si su organización usa Amazon Bedrock o Google Cloud's Agent Platform para otras características de Claude Code. Para establecer un límite de gasto mensual para Code Review, vaya a [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) y configure el límite para el servicio Claude Code Review.43<span id="pricing" />

291 44 

292Para monitorear el gasto, usa el [panel de analytics](#view-usage).45<span id="manually-trigger-reviews" />

293 46 

294<h2 id="troubleshooting">47<span id="customize-reviews" />

295 Solución de problemas

296</h2>

297 

298Las ejecuciones de revisión son de mejor esfuerzo, y una ejecución fallida nunca bloquea su PR. Code Review reintenta algunas revisiones interrumpidas por su cuenta. Esta sección cubre cómo ejecutar una revisión nuevamente usted mismo y dónde buscar cuando la ejecución de verificación reporta problemas que no puede encontrar.

299 

300<h3 id="retrigger-a-failed-or-timed-out-review">

301 Reactivar una revisión fallida o agotada por tiempo

302</h3>

303 48 

304Cuando una revisión falla o excede su límite de tiempo, la ejecución de verificación se completa con un título como **Code review failed** o **Code review timed out**. La conclusión sigue siendo neutral, por lo que nada bloquea su fusión. A menos que el resumen de la ejecución de verificación indique que una nueva revisión del commit ha sido puesta en cola automáticamente, ejecute la revisión nuevamente usted mismo.49<span id="troubleshooting" />

305 50 

306Para ejecutar la revisión nuevamente, comente `@claude review` en el PR. Esto inicia una revisión nueva sin suscribir el PR a push futuros. Si el PR no es [de una bifurcación](#review-pull-requests-from-forks), puede hacer clic en **Re-run** en la verificación **Claude Code Review** en la pestaña Checks de GitHub. Una reejecución también inicia una revisión nueva sin suscribir el PR.51Elige la página según lo que necesites hacer:

307 52 

308<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">53<CardGroup cols={2}>

309 La revisión no se ejecutó y el PR muestra un mensaje de presupuesto54 <Card title="Configurar Code Review" icon="toggle-on" href="/docs/es/code-review-setup">

310</h3>55 Revisa los requisitos, instala la Claude GitHub App y elige los repositorios, un nivel de revisión y cuándo se ejecutan las revisiones

311 56 </Card>

312Cuando se alcanza el límite de gasto mensual de tu organización para Code Review o se agota su saldo de créditos de uso, Code Review omite la revisión y publica un único comentario en el PR. Tanto el comentario como la tarjeta de la ejecución de verificación indican la causa y enlazan a la página de administración donde un administrador puede solucionarlo:

313 57 

314* **Límite de gasto alcanzado**: las revisiones se reanudan al inicio del próximo período de facturación, o inmediatamente después de que un administrador aumente el límite en [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage)58 <Card title="Personalizar Code Review" icon="sliders" href="/docs/es/code-review-customize">

315* **Créditos de uso agotados**: las revisiones se reanudan una vez que un administrador agregue más [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) en [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage)59 Ajusta lo que se marca con archivos `REVIEW.md` y `CLAUDE.md` en tu repositorio

60 </Card>

316 61 

317<h3 id="find-issues-that-aren’t-showing-as-inline-comments">62 <Card title="Leer y solicitar revisiones en un pull request" icon="code-pull-request" href="/docs/es/code-review-pull-requests">

318 Encontrar problemas que no se muestran como comentarios en línea63 Lee los hallazgos y sus severidades, y solicita otra revisión con un comentario

319</h3>64 </Card>

320 65 

321Si el título de la ejecución de verificación dice que se encontraron problemas pero no ve comentarios de revisión en línea en el diff, busque en estas otras ubicaciones donde se muestran los hallazgos:66 <Card title="Solución de problemas de Code Review" icon="wrench" href="/docs/es/code-review-troubleshooting">

67 Soluciona una revisión que no se inició, falló o se omitió por presupuesto

68 </Card>

322 69 

323* **Check run Details**: haga clic en **Details** junto a la verificación Claude Code Review en la pestaña Checks. La tabla de severidad enumera cada hallazgo con su archivo, línea y resumen independientemente de si el comentario en línea fue aceptado.70 <Card title="Costos y uso de Code Review" icon="chart-line" href="/docs/es/code-review-costs">

324* **Files changed annotations**: abra la pestaña **Files changed** en el PR. Los hallazgos se representan como anotaciones adjuntas directamente a las líneas de diff, separadas de los comentarios de revisión.71 Consulta cómo se facturan las revisiones, estima el gasto, establece el límite de gasto mensual y haz seguimiento de la actividad de revisión

325* **Review body**: si hizo push al PR mientras se ejecutaba una revisión, algunos hallazgos pueden hacer referencia a líneas que ya no existen en el diff actual. Esos aparecen bajo un encabezado **Additional findings** en el texto del cuerpo de revisión en lugar de como comentarios en línea.72 </Card>

73</CardGroup>

326 74 

327<h2 id="review-a-diff-locally">75<h2 id="how-reviews-work">

328 Revisar un diff localmente76 Cómo funcionan las revisiones

329</h2>77</h2>

330 78 

331El comando [`/code-review`](/docs/es/commands) revisa un diff en tu terminal sin instalar la aplicación de GitHub. Reporta errores de corrección. Según tu modelo y nivel de esfuerzo, la revisión también cubre limpiezas de reutilización, simplificación y eficiencia.79<span id="what-code-review-checks" />

332 

333`/review` es un alias de `/code-review`; antes de v2.1.223, era un comando separado que ejecutaba una revisión de una sola pasada, de solo lectura, de una solicitud de extracción de GitHub.

334 

335<Steps>

336 <Step title="Ejecutar /code-review">

337 Desde la sesión en la que está trabajando, ejecute el comando:

338 

339 ```text theme={null}

340 /code-review

341 ```

342 

343 Revisa los commits de su rama por delante de su rama ascendente más cualquier cambio sin confirmar, por lo que necesita trabajo en la rama o en el árbol de trabajo para tener algo que reportar. Para revisar algo diferente, pase un objetivo: una ruta de archivo, un número de PR, un nombre de rama o un rango de ref como `main...my-feature`.

344 

345 También puede agregar indicadores:

346 

347 * `--fix`: aplica los hallazgos a tu árbol de trabajo después de la revisión

348 * `--comment`: publica los hallazgos como comentarios en línea en un pull request de GitHub, o como una nota única en un merge request de GitLab

349 * `--post`: en una revisión en la nube `ultra` de un pull request de `github.com`, preselecciona publicar los hallazgos terminados en el PR en el diálogo de lanzamiento; consulta [Publicar hallazgos en el pull request](/docs/es/ultrareview#post-findings-to-the-pull-request). Requiere Claude Code v2.1.227 o posterior

350 * `--max-findings <n>`, `--max-findings all` o `--max-findings default`: reporta hasta `n` hallazgos, o todos los hallazgos con `all`, en lugar del límite habitual de la revisión. Las revisiones posteriores reutilizan el valor que escribiste hasta que pases `--max-findings default`. Requiere Claude Code v2.1.288 o posterior

351 

352 Cuando pasa `--comment` para una solicitud de fusión de GitLab, Claude Code publica los hallazgos a través de la CLI `glab` de GitLab. Requiere Claude Code v2.1.257 o posterior. Cuando `glab` no está instalado, Claude imprime los hallazgos en la terminal en su lugar.

353 80 

354 Pase la solicitud de fusión como su URL o una referencia `!123`. Claude Code trata un número desnudo o un nombre de rama como una solicitud de fusión solo cuando el checkout de origen está en `gitlab.com`. En una instancia de GitLab autogestionada, pase la URL o el formulario `!123`.81Por defecto, Code Review se enfoca en la corrección: errores que romperían la producción, no preferencias de formato o cobertura de pruebas faltante. Para cambiar lo que marca, [agrega archivos de orientación](/docs/es/code-review-customize) a tu repositorio.

355 </Step>

356 82 

357 <Step title="Continuar trabajando">83Una revisión se ejecuta en la infraestructura de Anthropic en cuatro etapas:

358 La revisión se ejecuta como un [subagente](/docs/es/sub-agents) de fondo con su propia ventana de contexto, por lo que no llena su conversación. Los hallazgos llegan a su conversación cuando se completa la revisión.

359 </Step>

360 84 

361 <Step title="Actuar sobre los hallazgos">851. **Encontrar**: varios agentes examinan el diff y el código circundante en paralelo.

362 Pida a Claude que corrija lo que encontró la revisión. Si pasó `--fix` o `--comment`, la revisión ya ha aplicado o publicado sus hallazgos.862. **Verificar**: un paso de verificación contrasta los hallazgos candidatos con el código y filtra los falsos positivos.

363 </Step>873. **Clasificar**: los hallazgos restantes se desduplican y se clasifican por severidad.

364</Steps>884. **Publicar**: la revisión publica sus resultados en el pull request.

365 89 

366Claude reporta los hallazgos como texto en la respuesta en ambas ejecuciones, incluso cuando una aplicación host solicita una lista de hallazgos:90Cada revisión deja esto en el pull request:

367 91 

368* En una sesión de terminal, donde `/code-review` ejecuta la revisión como un [subagente bifurcado](/docs/es/skills#run-skills-in-a-subagent)92* **Hallazgos**: comentarios en línea en las líneas afectadas, con un resumen en el cuerpo de la revisión

369* En una ejecución `-p` con salida de texto o JSON93* **Una ejecución de verificación**: llamada **Claude Code Review**, con los hallazgos listados en sus [detalles](/docs/es/code-review-pull-requests#check-run-output). La ejecución de verificación no concluye como fallo.

94* **Cuando no encuentra nada**: el título de la ejecución de verificación dice **Code review found no issues**, y Claude publica la misma nota breve en el pull request

370 95 

371En una aplicación host que solicita la lista de hallazgos, como la [aplicación de escritorio](/docs/es/desktop#review-your-code), Claude reporta los hallazgos de la revisión a través de la herramienta [`ReportFindings`](/docs/es/tools-reference). Claude Code renderiza el informe como una lista de hallazgos, y cada entrada muestra la ubicación del archivo, un resumen de una oración y una etiqueta de categoría como `correctness` cuando el hallazgo lleva una. Una solicitud de host se aplica en cada nivel de esfuerzo y requiere Claude Code v2.1.218 o posterior.96Code Review elige los modelos de Claude en los que se ejecutan las revisiones, y su configuración de administración no ofrece elegir modelo. Para que las revisiones sean más o menos exhaustivas, cambia el [nivel de revisión](#review-levels).

372 97 

373Cuando Claude corrige hallazgos reportados más adelante en la sesión, los reporta nuevamente, y Claude Code marca cada hallazgo en la lista de hallazgos actualizada como corregido, omitido o sin cambios necesarios.98Después de que un Owner activa Code Review, cada repositorio tiene un ajuste para [cuándo se ejecutan las revisiones](/docs/es/code-review-setup#set-when-reviews-run): una vez cuando se abre un pull request, después de cada push o solo cuando se solicita. Sea cual sea, alguien con acceso de escritura al repositorio puede comentar `@claude review` en un pull request para [iniciar una revisión](/docs/es/code-review-pull-requests#comment-commands).

374 99 

375<h3 id="what-the-review-reads-and-edits">100<h3 id="review-levels">

376 Qué lee y edita la revisión101 Niveles de revisión

377</h3>102</h3>

378 103 

379La revisión sigue su `CLAUDE.md` como cualquier sesión de Claude Code, pero no lee [`REVIEW.md`](#review-md). Una revisión de fondo aplica sus ediciones `--fix` fuera de los [puntos de control](/docs/es/checkpointing#subagent-edits-not-restored) de su sesión, por lo que `/rewind` no las deshace; use git para revertirlas. Cuando la revisión [se ejecuta en primer plano](#run-in-the-foreground), edita su árbol de trabajo durante su propio turno, por lo que `/rewind` restaura sus ediciones como de costumbre.104El nivel de revisión establece qué tan exhaustiva es cada revisión, y una revisión más exhaustiva cuesta más:

380 105 

381<h3 id="tune-effort-and-arguments">106* **Quick**: una pasada más ligera. El nivel más rápido, al menor costo.

382 Ajustar esfuerzo y argumentos107* **Standard**: equilibrio entre profundidad, velocidad y costo. El nivel predeterminado.

383</h3>108* **Deep**: la pasada más exhaustiva. Es la que más tarda y la que más cuesta.

384 

385Pasa un [nivel de esfuerzo](/docs/es/model-config#adjust-effort-level) para intercambiar cobertura por confianza. En `low`, la revisión reporta los hallazgos en los que tiene más confianza, por lo que ves menos falsos positivos. De `medium` a `max`, la revisión amplía la cobertura.

386 

387Cuando no escribe un nivel, la revisión reutiliza el último nivel de `low` a `max` que escribió, incluso en una sesión anterior, y Claude Code muestra un aviso como `Reusing high effort, the level you typed last time`. Escriba un nivel, como `/code-review high`, para cambiar lo que reutilizan las ejecuciones posteriores; un nivel que pase en una ejecución `-p` no interactiva no lo actualiza. `ultra` ni actualiza ni utiliza el nivel recordado. Si nunca ha escrito un nivel, la revisión utiliza el esfuerzo actual de la sesión. Antes de v2.1.223, un `/code-review` sin un nivel siempre utilizaba el esfuerzo actual de la sesión.

388 

389Después del nivel de esfuerzo y los indicadores, Claude Code lee el resto de la línea de una de dos formas:

390 

391* **Sin `ultra`**: todo lo que queda es el objetivo de la revisión, incluso cuando comienza con otro nombre de comando. `/code-review /fix-issue 123` revisa con `/fix-issue 123` como texto objetivo en lugar de cargar `/fix-issue` como una [skill apilada](/docs/es/skills#pass-arguments-to-skills) separada. Antes de v2.1.218, un comando apilado después de `/code-review` se expandía como su propia skill.

392* **Con `ultra`**: Claude Code lee una sola palabra como una rama base o número de PR, y convierte texto más largo que no nombra una rama o PR en [una nota adjunta a la revisión](/docs/es/ultrareview#pass-a-request-in-plain-words). `/code-review ultra check my auth changes` revisa su rama actual, y Claude relaciona los hallazgos con su nota.

393 

394<h3 id="run-in-the-foreground">

395 Ejecutar en primer plano

396</h3>

397 

398La revisión se ejecuta en segundo plano de forma predeterminada; antes de v2.1.218, se ejecutaba dentro de su conversación. Se ejecuta en primer plano en su lugar en casos como estos:

399 109 

400* Ejecuta `/code-review` nuevamente mientras una revisión anterior aún está en progreso110Un Owner [elige un nivel para la organización](/docs/es/code-review-setup#set-the-default-review-level) y puede asignar a un repositorio concreto su propio nivel, como Quick para una base de código de mantenimiento habitual y Deep para una crítica. Para conocer qué más influye en el costo de cada revisión, consulta [Costos y uso de Code Review](/docs/es/code-review-costs).

401* Lo ejecutas en modo no interactivo, con el flag `-p` o el Agent SDK; Claude Code espera la revisión e incluye los hallazgos en la respuesta, excepto con `ultra`, que [no espera la revisión en la nube](/docs/es/ultrareview#run-ultrareview-non-interactively)

402* Establece [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/es/env-vars) en `1`, lo que también desactiva todas las demás características de tareas de fondo

403 111 

404<h3 id="let-claude-start-the-review">112<h3 id="what-a-review-can-access">

405 Dejar que Claude inicie la revisión113 A qué puede acceder una revisión

406</h3>114</h3>

407 115 

408Claude puede iniciar `/code-review` por su cuenta. Pídale que revise sus cambios en lenguaje natural y puede ejecutar la skill sin que escriba el comando, y una [tarea programada](/docs/es/scheduled-tasks) con `/code-review` como su indicación ejecuta la revisión.116Una revisión accede a tu repositorio a través de la Claude GitHub App que un Owner [instala durante la configuración](/docs/es/code-review-setup#turn-on-code-review):

409 117 

410Una tarea programada nunca lanza la [revisión en la nube](#escalate-to-ultrareview), por lo que programe `/code-review` sin el argumento `ultra`.118* **Dónde se ejecuta**: en la infraestructura de Anthropic, en un entorno administrado. Las revisiones no se ejecutan en [entornos autohospedados](/docs/es/self-hosted-environments).

119* **Qué lee y escribe**: dentro de una revisión, el acceso a tu repositorio es de solo lectura, y una revisión no hace push de commits. En el pull request, publica comentarios y la [ejecución de verificación](/docs/es/code-review-pull-requests#check-run-output), resuelve sus propios hilos de comentarios anteriores y puede reaccionar a un comando de comentario con 👀. La aplicación en sí tiene un [conjunto de permisos más amplio](/docs/es/github-actions#github-app-permissions) que comparten otras características de Claude.

120* **Cómo examina tu código**: una revisión trabaja leyendo el diff y el código circundante, sin compilar ni ejecutar tu código.

411 121 

412Para evitar que Claude y las tareas programadas inicien la revisión mientras mantiene `/code-review` disponible para que escriba, agregue una entrada [`skillOverrides`](/docs/es/skills#override-skill-visibility-from-settings) a un [archivo de configuración](/docs/es/settings#where-settings-live) como `~/.claude/settings.json`:122<h3 id="who-controls-a-review">

413 123 Quién controla una revisión

414```json theme={null}

415{

416 "skillOverrides": {

417 "code-review": "user-invocable-only"

418 }

419}

420```

421 

422Antes de v2.1.246, Claude iniciaba `/code-review` por su cuenta solo donde una bandera de característica obtenida de Anthropic la activaba. En [sesiones que no obtienen banderas de características](/docs/es/env-vars#features-that-need-feature-flag-fetching), `/code-review` se ejecutaba solo cuando la escribía, y una `/code-review` programada llegaba a Claude como texto sin formato.

423 

424<h3 id="escalate-to-ultrareview">

425 Escalar a ultrareview

426</h3>124</h3>

427 125 

428`/code-review ultra --fix` ejecuta la [ultrareview](/docs/es/ultrareview) más profunda en la nube, luego aplica sus hallazgos a su árbol de trabajo cuando regresan a su sesión.126* **Quién puede iniciarla**: donde las revisiones se ejecutan automáticamente, abrir un pull request o hacer push a él inicia una revisión, [excepto en borradores y forks](/docs/es/code-review-pull-requests#review-drafts-and-pull-requests-from-forks). Un [comando de comentario](/docs/es/code-review-pull-requests#comment-commands) inicia una solo cuando proviene de una persona con acceso de escritura al repositorio.

429 127* **Qué instrucciones sigue**: `REVIEW.md` de la rama base o predeterminada y [nunca de los propios cambios del pull request](/docs/es/code-review-customize#which-branch-review-md-is-read-from).

430Ultrareview utiliza su propio alcance: su rama actual contra la rama predeterminada del repositorio, más cambios sin confirmar y preparados en el árbol de trabajo. Para cambios sin confirmar en archivos nombrados como credenciales o claves, como archivos `.env` y `*.tfvars`, Claude Code sigue las reglas para [cargar un repositorio local en una sesión en la nube](/docs/es/claude-code-on-the-web#send-local-repositories-without-github). Pase un nombre de rama, como `/code-review ultra develop`, para comparar contra una base diferente.

431 128 

432Cuando el objetivo es una solicitud de extracción de `github.com`, puede hacer que Claude [publique los hallazgos terminados en el PR](/docs/es/ultrareview#post-findings-to-the-pull-request) como un comentario desde su cuenta de GitHub. Requiere Claude Code v2.1.227 o posterior.129<h2 id="compare-ways-to-get-a-review">

433 130 Comparar formas de obtener una revisión

434<Note>131</h2>

435 Ultrareview requiere autenticación con una cuenta de claude.ai y no está disponible en Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry, ni para organizaciones con Zero Data Retention habilitado o con la [configuración de HIPAA](/docs/es/hipaa-setup) aplicada. Cuando ultrareview no está disponible, `/code-review ultra` ejecuta una revisión local en tu sesión en su lugar.

436</Note>

437 132 

438Para ejecutar una revisión en la nube desde un script o un job de CI, usa el [subcomando `claude ultrareview`](/docs/es/ultrareview#run-ultrareview-non-interactively), que espera los hallazgos y los imprime en stdout.133Para encontrar las opciones disponibles para ti, compara la columna **Quién puede usarla** con tu plan y tu host de código:

439 134 

440El comando se llamaba `/simplify` antes de v2.1.147, cuando aplicaba correcciones de forma predeterminada. `/simplify` ejecuta una revisión separada de solo limpieza que aplica correcciones sin buscar errores. Si escribió scripts con `/simplify` para búsqueda de errores, cambie a `/code-review --fix`.135| Opción | Qué inicia una revisión | Dónde se ejecuta | Quién puede usarla |

136| :- | :- | :- | :- |

137| [Code Review](#how-reviews-work) | La actividad del pull request, según la configuración de cada repositorio, o un comentario `@claude review` | Infraestructura de Anthropic | Organizaciones con un plan Team o Enterprise y repositorios de GitHub, una vez que un Owner lo activa |

138| [`/code-review`](/docs/es/code-review-local) | Ejecutas el comando en tu rama | Tu sesión de Claude Code | Cualquiera, en cualquier plan |

139| [Ultrareview](/docs/es/ultrareview) | La inicias desde Claude Code | Un sandbox en la nube | Requiere iniciar sesión con una cuenta de claude.ai. Consulta [Ultrareview](/docs/es/ultrareview) para saber dónde no está disponible |

140| Claude en tu propio CI, con [GitHub Actions](/docs/es/github-actions) o [GitLab CI/CD](/docs/es/gitlab-ci-cd) | Los eventos de tu pipeline, como cada pull request o merge request | Tus propios runners de CI | Cualquiera con una clave de API de Claude o credenciales de un proveedor de nube, en GitHub o GitLab |

141| Tu propio revisor, como un [subagente](/docs/es/sub-agents) o un [skill](/docs/es/skills) | Tú o Claude lo invocan durante una sesión | Donde sea que ejecutes Claude Code | Cualquiera que escriba uno |

441 142 

442<h2 id="related-resources">143<h2 id="related-resources">

443 Recursos relacionados144 Recursos relacionados

444</h2>145</h2>

445 146 

446* [Commands](/docs/es/commands): ejecute `/code-review` en una sesión local de Claude Code para verificar un diff antes de hacer push147* [GitHub Enterprise Server](/docs/es/github-enterprise-server): usa Code Review con una instancia de GitHub autohospedada

447* [GitHub Actions](/docs/es/github-actions): ejecute Claude en sus propios flujos de trabajo de GitHub Actions para automatización personalizada más allá de la revisión de código148* [Permisos de GitHub App](/docs/es/github-actions#github-app-permissions): el conjunto completo de permisos que solicita la Claude GitHub App

448* [GitLab CI/CD](/docs/es/gitlab-ci-cd): integración de Claude autohospedada para canalizaciones de GitLab

449* [Memory](/docs/es/memory): cómo funcionan los archivos `CLAUDE.md` en Claude Code

450* [Analytics](/docs/es/analytics): rastrear el uso de Claude Code más allá de la revisión de código

451* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/how-anthropic-secures-its-ai-native-software-development-lifecycle): cómo la revisión automatizada se ajusta como una capa del proceso de desarrollo seguro de Anthropic149* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/how-anthropic-secures-its-ai-native-software-development-lifecycle): cómo la revisión automatizada se ajusta como una capa del proceso de desarrollo seguro de Anthropic

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Costos y uso de Code Review

6 

7> Estima y limita lo que tu organización gasta en Claude Code Review: cómo se facturan las revisiones mediante créditos de uso, qué determina el costo y dónde hacer seguimiento del uso.

8 

9[Code Review](/docs/es/code-review) no tiene un precio fijo por revisión. Lo que gastas depende del costo de cada revisión y de cuántas revisiones se ejecutan:

10 

11* **Costo de cada revisión**: aumenta según el [nivel de revisión](/docs/es/code-review-setup#set-the-default-review-level), el tamaño del cambio, la complejidad del código circundante y cuántos problemas candidatos necesitan verificación

12* **Número de revisiones**: lo determina [con qué frecuencia se ejecutan las revisiones](#how-often-reviews-run) en cada repositorio

13 

14<h2 id="pricing">

15 Precios

16</h2>

17 

18Code Review se factura según el uso de tokens mediante [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), por separado del uso incluido en tu plan. Las revisiones se facturan a tu organización, no al desarrollador que abrió el PR o solicitó la revisión. Los costos aparecen en tu factura de Anthropic independientemente de si tu organización usa Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry para otras funciones de Claude Code.

19 

20<h3 id="how-often-reviews-run">

21 Con qué frecuencia se ejecutan las revisiones

22</h3>

23 

24Un repositorio que agregas desde la página de administración comienza con **After every push**, que es la opción que ejecuta más revisiones. El [ajuste **Review runs**](/docs/es/code-review-setup#set-when-reviews-run) de cada repositorio decide cuántas revisiones recibe un pull request:

25 

26* **Once after PR creation**: se ejecuta una revisión cuando el pull request se abre, se vuelve a abrir o se marca como listo para revisión

27* **After every push**: se ejecuta en cada push, multiplicando el costo por el número de pushes

28* **Manual (@claude review)**: no hay revisiones al abrir ni al hacer push

29 

30Los comandos en comentarios, los borradores y los pull requests desde forks ajustan esos recuentos:

31 

32* **`@claude review always` en el modo Once after PR creation o Manual**: [suscribe el PR a revisiones activadas por push](/docs/es/code-review-pull-requests#comment-commands), por lo que se acumula costo adicional por cada push después de ese comentario

33* **`@claude review always` en el modo After every push**: los pushes ya activan revisiones, así que la suscripción no cambia el costo por push

34* **`@claude review`**: ejecuta una sola revisión sin suscribirse a pushes futuros

35* **Borradores y pull requests desde forks**: [las revisiones automáticas omiten ambos](/docs/es/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), así que los pushes a ellos no agregan revisiones

36 

37<h2 id="estimate-your-spend">

38 Estima tu gasto

39</h2>

40 

41Antes de un despliegue amplio, ejecuta un piloto pequeño para estimar el gasto mensual a partir de tus propios pull requests.

42 

431. Establece un [límite de gasto mensual](#limit-your-spend) para el piloto.

442. Activa Code Review en algunos repositorios representativos con **Review runs** configurado en **Once after PR creation** o **Manual (@claude review)**.

453. Después de que se hayan ejecutado varias revisiones, consulta el costo promedio por revisión de cada repositorio en la columna **Average cost** de la tabla **Repositories**, en la sección **Code review** de [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review).

464. Multiplica ese promedio por el número de pull requests que se abren en el repositorio en un mes. Para **After every push**, multiplica de nuevo por el número típico de pushes por pull request.

47 

48El promedio de un repositorio varía con el tamaño de sus pull requests y con el nivel de revisión que elijas.

49 

50<h2 id="limit-your-spend">

51 Limita tu gasto

52</h2>

53 

54Para establecer un límite de gasto mensual para Code Review, ve a [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) y configura el límite para el servicio Claude Code Review. El límite se aplica a toda la organización.

55 

56Code Review omite revisiones cuando se agota cualquiera de estos:

57 

58* **Límite de gasto de Code Review**: el límite mensual que estableces para el servicio Claude Code Review. Se restablece al inicio del siguiente período de facturación, y las revisiones se reanudan antes si lo aumentas.

59* **Límite de gasto de la organización**: el límite de gasto mensual general de tu organización para los créditos de uso. Auméntalo en la misma página.

60* **Saldo de créditos de uso**: el saldo de créditos de uso de tu organización. Agrega créditos en la misma página.

61 

62Code Review también omite revisiones cuando lo que queda es menor que el costo esperado de una revisión. Cuando se omite una revisión, los desarrolladores ven un [comentario en el PR](/docs/es/code-review-troubleshooting#review-didn’t-run-and-the-pr-shows-a-budget-message) que indica la causa y enlaza a la configuración de uso.

63 

64Para supervisar el gasto, usa el [panel de análisis](#view-usage).

65 

66<h2 id="view-usage">

67 Ver el uso

68</h2>

69 

70Ve a [claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) para ver la actividad de Code Review en toda tu organización.

71 

72| Sección | Qué muestra |

73| :- | :- |

74| PRs reviewed | Recuento diario de pull requests revisados durante el intervalo de tiempo seleccionado |

75| Code Review cost | Gasto de Code Review en lo que va del mes |

76| Feedback | Recuento de comentarios de revisión que se resolvieron automáticamente porque un desarrollador abordó el problema |

77| Repository breakdown | Recuentos por repositorio de PRs revisados, comentarios resueltos y ejecuciones de revisión, con costo estimado y una vista por PR |

78 

79La tarjeta Code Review cost muestra un monto solo cuando está seleccionado el mes actual. Las cifras de costo en el panel de análisis pueden diferir de tu factura. Los costos de Repository breakdown se estiman a precio de lista, antes de cualquier descuento o crédito, y cubren solo las revisiones que Claude publicó en un pull request. Para conocer el gasto exacto según la factura, consulta tu factura de Anthropic.

80 

81<h2 id="related-resources">

82 Recursos relacionados

83</h2>

84 

85* [Configurar Code Review](/docs/es/code-review-setup): dónde elegir el nivel de revisión y cuándo se ejecutan las revisiones en cada repositorio

86* [Leer y solicitar revisiones en un pull request](/docs/es/code-review-pull-requests): los comandos en comentarios, los pull requests desde forks y el mensaje de presupuesto que ven los desarrolladores cuando se omite una revisión

87* [Code Review](/docs/es/code-review): qué verifica una revisión y qué publica

88* [Administrar costos de forma eficaz](/docs/es/costs): controles de gasto y seguimiento del uso para el resto de Claude Code

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Personalizar Code Review

6 

7> Ajusta lo que Code Review señala en tus pull requests con REVIEW.md y CLAUDE.md: recalibra la severidad, omite rutas, agrega comprobaciones y consulta qué copia se aplica.

8 

9Puedes cambiar lo que [Code Review](/docs/es/code-review) señala en tu repositorio confirmando instrucciones en él. Así es como reduces el volumen de nits, detienes los comentarios sobre archivos generados o agregas una regla que le importa a tu equipo. Colócalas en uno de estos dos archivos:

10 

11* **`CLAUDE.md`**: [instrucciones del proyecto](/docs/es/memory) que Claude Code lee en cada tarea, incluidas las revisiones. Code Review las lee como contexto del proyecto y señala los cambios que las infringen.

12* **`REVIEW.md`**: instrucciones exclusivas para las revisiones. Úsalo para indicar qué quiere tu equipo que se señale, con qué severidad y qué omitir.

13 

14Agrega `REVIEW.md` en la raíz de tu repositorio y fusiónalo. Luego [protege tu rama predeterminada](#which-branch-review-md-is-read-from).

15 

16<Note>

17 Para cambiar qué tan exhaustivas son las revisiones o cuándo se ejecutan, pídele a un Owner que cambie el [nivel de revisión](/docs/es/code-review-setup#set-the-default-review-level) o el [ajuste **Review runs**](/docs/es/code-review-setup#set-when-reviews-run).

18</Note>

19 

20<h2 id="use-claude-md-for-project-wide-rules">

21 Usa CLAUDE.md para reglas de todo el proyecto

22</h2>

23 

24Code Review lee los archivos `CLAUDE.md` de tu repositorio como contexto del proyecto. Un cambio que infringe una de sus reglas se convierte en un hallazgo con el [nivel de severidad](/docs/es/code-review-pull-requests#severity-levels) que corresponda al problema.

25 

26Una revisión lee el `CLAUDE.md` de la raíz de tu repositorio y los archivos `CLAUDE.md` de los directorios padre de cada archivo modificado. El `CLAUDE.md` de un subdirectorio se lee cuando el pull request modifica un archivo bajo esa ruta.

27 

28<h2 id="use-review-md-for-review-only-rules">

29 Usa REVIEW\.md para reglas exclusivas de revisión

30</h2>

31 

32`REVIEW.md` es un archivo en la raíz de tu repositorio que adapta Code Review a tu repositorio. También puedes agregar un `REVIEW.md` en un subdirectorio para añadir comprobaciones a los cambios bajo esa ruta, además del archivo raíz.

33 

34Los agentes que encuentran problemas y los agentes que los verifican reciben su contenido como las instrucciones de revisión de tu repositorio, junto con las pautas de revisión predeterminadas de Code Review. El paso que redacta la revisión final lo consulta antes de definir la severidad y escribir el resumen.

35 

36Este diseño de ejemplo tiene un archivo raíz y un archivo en un subdirectorio:

37 

38```text theme={null}

39your-repo/

40├── REVIEW.md # Root file

41├── services/

42│ └── billing/

43│ └── REVIEW.md # Adds checks for changes under services/billing/

44└── src/

45```

46 

47Antes de depender de un archivo en un subdirectorio, protege tu rama predeterminada y consulta [qué lee una revisión según la configuración de tus ramas](#what-a-review-reads-for-each-branch-setup).

48 

49<Note>

50 El servicio Code Review y el [comando local `/code-review`](/docs/es/code-review-local) son dos herramientas distintas y leen archivos diferentes. El servicio lee tanto `CLAUDE.md` como `REVIEW.md`. El comando `/code-review`, que ejecutas dentro de una sesión de Claude Code en tu propia máquina, lee tus archivos `CLAUDE.md` pero no `REVIEW.md`. Coloca en `CLAUDE.md` las pautas que quieras aplicar en ambos lugares y reserva `REVIEW.md` para reglas específicas de la revisión de pull requests.

51</Note>

52 

53<h3 id="example-review-md">

54 Ejemplo de REVIEW\.md

55</h3>

56 

57Este `REVIEW.md` recalibra la severidad para un servicio de backend, limita los nits, omite los archivos generados y agrega comprobaciones específicas del repositorio.

58 

59```markdown theme={null}

60# Review instructions

61 

62## What Important means here

63 

64Reserve Important for findings that would break behavior, leak data,

65or block a rollback: incorrect logic, unscoped database queries, PII

66in logs or error messages, and migrations that aren't backward

67compatible. Style, naming, and refactoring suggestions are Nit at

68most.

69 

70## Cap the nits

71 

72Report at most five Nits per review.

73 

74## Do not report

75 

76- Anything CI already enforces: lint, formatting, type errors

77- Generated files under `src/gen/` and any `*.lock` file

78- Test-only code that intentionally violates production rules

79 

80## Always check

81 

82- New API routes have an integration test

83- Log lines don't include email addresses, user IDs, or request bodies

84- Database queries are scoped to the caller's tenant

85```

86 

87<h3 id="choose-what-to-write-in-review-md">

88 Elige qué escribir en REVIEW\.md

89</h3>

90 

91`REVIEW.md` es markdown de formato libre que cambia lo que una revisión encuentra y reporta. No cambia el formato de la revisión. Busca el problema que estás viendo y luego agrega una instrucción como la que se muestra. El [ejemplo](#example-review-md) usa las cuatro primeras.

92 

93* **Se marcan como Important las cosas equivocadas**: redefine qué significa 🔴 Important para tu repositorio. La calibración predeterminada apunta a código de producción, y un repositorio de documentación, un repositorio de configuración o un prototipo podrían necesitar una definición mucho más estrecha. Indica qué clases de hallazgos son Important y cuáles son, como mucho, Nit. También puedes escalar, por ejemplo, tratando cualquier infracción de `CLAUDE.md` como Important.

94* **Demasiados nits**: limita cuántos comentarios 🟡 Nit publica una sola revisión. Un límite como "reporta como máximo cinco nits" mantiene las revisiones accionables.

95* **Comentarios sobre archivos generados o sobre lo que CI ya comprueba**: enumera las rutas y categorías de hallazgos en las que Claude debe omitir hallazgos. Los candidatos habituales son el código generado, los lockfiles y las dependencias incluidas en el repositorio (vendored), junto con cualquier cosa que tu CI ya aplique, como el linting o la revisión ortográfica. Para rutas que merecen algo de revisión pero no un escrutinio completo, establece un umbral más alto: "en `scripts/`, reporta solo si es casi seguro y grave".

96* **No se comprueba una regla del equipo**: agrega las reglas que quieras que se señalen en cada pull request, como "las nuevas rutas de API deben tener una prueba de integración".

97* **Hallazgos que resultan ser incorrectos**: exige evidencia antes de que se publique una clase de hallazgo. Por ejemplo, "las afirmaciones sobre el comportamiento necesitan una cita `file:line` en el código fuente, no una inferencia a partir de los nombres" reduce los falsos positivos que, de lo contrario, le costarían al autor una ida y vuelta.

98 

99Algunas de estas instrucciones [necesitan el archivo raíz en una rama predeterminada protegida](#which-branch-review-md-is-read-from).

100 

101Limita `REVIEW.md` a instrucciones que cambien el comportamiento de la revisión y deja el contexto general del proyecto en `CLAUDE.md`.

102 

103<h3 id="which-branch-review-md-is-read-from">

104 Desde qué rama se lee REVIEW\.md

105</h3>

106 

107Code Review lee `REVIEW.md` desde la rama base del pull request o desde la rama predeterminada, nunca desde los propios cambios del pull request. Para cambiar el comportamiento de la revisión, fusiona primero el cambio en `REVIEW.md`.

108 

109Mantén `REVIEW.md` en tu rama predeterminada y protege esa rama. Cuando una revisión lee la copia de una rama predeterminada protegida, la primera fila de la tabla siguiente, respeta estas instrucciones del archivo raíz:

110 

111* Reducir la severidad de un hallazgo

112* Excluir rutas, archivos o clases de problemas

113* Limitar los comentarios de tipo nit

114 

115<h4 id="what-counts-as-branch-protection">

116 Qué cuenta como protección de rama

117</h4>

118 

119Code Review considera protección los siguientes ajustes:

120 

121* **Rama predeterminada**: una regla clásica de protección de rama o un ruleset

122* **Cualquier otra rama**: solo un ruleset

123 

124Un ruleset cuenta cuando restringe las actualizaciones o exige pull requests con al menos una aprobación. Si exige pull requests, también debe descartar esa aprobación ante un nuevo push o exigir que la aprobación llegue después del último push.

125 

126<h4 id="what-a-review-reads-for-each-branch-setup">

127 Qué lee una revisión según la configuración de ramas

128</h4>

129 

130Busca la situación de tu repositorio en la primera columna de la tabla siguiente.

131 

132| Protección de rama | Copia leída | Archivos leídos |

133| :- | :- | :- |

134| La rama predeterminada está protegida y el pull request apunta a ella o a una rama que ningún ruleset protege | Rama predeterminada | Archivos raíz y de subdirectorios |

135| El pull request apunta a otra rama que un ruleset protege | Esa rama base | Archivos raíz y de subdirectorios |

136| La rama predeterminada no está protegida y la rama base no tiene ninguna regla de protección de ningún tipo | Rama predeterminada | Archivo raíz |

137| Code Review no puede confirmar la configuración de protección. Esto incluye una rama predeterminada sin protección con una rama base que solo tiene una regla clásica | Ninguna | Ninguno |

138 

139Si la ejecución de comprobación menciona `REVIEW.md`, consulta [The check run mentions REVIEW.md](/docs/es/code-review-troubleshooting#the-check-run-mentions-review-md).

140 

141<h2 id="related-resources">

142 Recursos relacionados

143</h2>

144 

145* [Code Review](/docs/es/code-review): qué es el servicio y cómo se ejecuta una revisión

146* [Leer y solicitar revisiones en un pull request](/docs/es/code-review-pull-requests#severity-levels): qué significa cada nivel de severidad y cómo aparecen los hallazgos

147* [Configurar Code Review](/docs/es/code-review-setup): el nivel de revisión y cuándo se ejecutan las revisiones, que establece un Owner

148* [Revisar localmente con `/code-review`](/docs/es/code-review-local): el comando `/code-review`, sus argumentos y los niveles de esfuerzo

149* [Memoria](/docs/es/memory): cómo funcionan los archivos `CLAUDE.md` en Claude Code

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Revisa localmente con /code-review

6 

7> Ejecuta `/code-review` en una sesión de Claude Code para encontrar bugs en los cambios de tu rama, apunta la revisión a un pull request o una ruta, y haz que Claude aplique las correcciones.

8 

9`/code-review` es un comando que escribes en el prompt de Claude Code, en la sesión donde estás trabajando. Claude revisa los cambios de tu rama, busca bugs de corrección e informa lo que encontró en tu conversación. Según tu modelo y tu nivel de esfuerzo, la revisión también abarca limpiezas de reutilización, simplificación y eficiencia.

10 

11El comando funciona en cualquier plan. La revisión se ejecuta en tu propia sesión, así que cuenta para el uso de tu plan o la facturación de la API de la misma manera que el resto de la sesión.

12 

13<Note>

14 Para que cada pull request de un repositorio se revise automáticamente en GitHub, consulta [Code Review](/docs/es/code-review), un servicio administrado que un Owner activa para tu organización.

15</Note>

16 

17`/review` es un alias de `/code-review`. Antes de la v2.1.223, `/review` era un comando independiente que ejecutaba una revisión de una sola pasada y de solo lectura de un pull request de GitHub.

18 

19<Steps>

20 <Step title="Ejecuta /code-review">

21 Ejecuta el comando:

22 

23 ```text theme={null}

24 /code-review

25 ```

26 

27 Sin un objetivo, la revisión abarca los cambios de tu rama actual. Para apuntar la revisión a un pull request, otra rama, una ruta o un rango de commits, consulta [Elige qué revisar](#choose-what-to-review).

28 

29 También puedes agregar flags:

30 

31 * `--fix`: también le pide a Claude que aplique los hallazgos a tu árbol de trabajo después de la revisión. Sus ediciones pasan por tu [modo de permisos](/docs/es/permission-modes).

32 * `--comment`: publica los hallazgos en un pull request de GitHub como comentarios en línea, o en un [merge request de GitLab](#post-findings-to-a-gitlab-merge-request) como una sola nota

33 </Step>

34 

35 <Step title="Sigue trabajando">

36 La revisión se ejecuta como un [subagente](/docs/es/sub-agents) en segundo plano con su propia ventana de contexto, así que no llena tu conversación. Los hallazgos llegan a tu conversación cuando la revisión termina.

37 </Step>

38 

39 <Step title="Actúa sobre los hallazgos">

40 Pídele a Claude que corrija lo que encontró la revisión. Con `--fix` o `--comment`, Claude aplica o publica los hallazgos como parte de la revisión, y es posible que se te pida aprobar sus ediciones.

41 </Step>

42</Steps>

43 

44<h2 id="choose-what-to-review">

45 Elige qué revisar

46</h2>

47 

48Para revisar algo distinto de tu rama actual, escribe un objetivo después del nivel de esfuerzo y de cualquier flag. Claude recibe ese texto como el objetivo de la revisión. Un objetivo puede ser un número de pull request, un nombre de rama, una ruta de archivo o un rango de revisiones de Git. Busca lo que quieres revisar en la primera columna y escribe lo que muestra la segunda columna:

49 

50| Para apuntar la revisión a | Escribe |

51| :- | :- |

52| Tu rama actual y los cambios sin commit | `/code-review` |

53| Tus últimos 15 commits | `/code-review HEAD~15..HEAD` |

54| Una rama frente a otra | `/code-review main...my-feature` |

55| Un solo commit, donde `abc1234` es el hash del commit | `/code-review abc1234^..abc1234` |

56| Un pull request por número | `/code-review 1234` |

57| Una ruta de archivo o directorio | `/code-review src/auth` |

58 

59Sin un objetivo, `/code-review` revisa los commits de tu rama que van por delante de su rama upstream, además de tus cambios sin commit. Si la rama no tiene upstream, Claude compara con `main`, o con el commit anterior.

60 

61Con `ultra`, Claude Code interpreta el objetivo de otra manera, como se describe en [Texto después del nivel de esfuerzo y los flags](#text-after-the-effort-level-and-flags).

62 

63<h2 id="what-the-review-reads-and-edits">

64 Qué lee y edita la revisión

65</h2>

66 

67Revisa estos puntos antes de ejecutar una revisión, especialmente con `--fix`:

68 

69* **Ediciones**: sin `--fix`, las instrucciones de la revisión le piden a Claude solo un informe. Con `--fix`, también le piden que aplique los hallazgos a tu árbol de trabajo. En cualquier caso, toda edición pasa por tu modo de permisos.

70* **Retroceder**: una revisión en segundo plano aplica sus ediciones de `--fix` fuera de los [checkpoints](/docs/es/checkpointing#subagent-edits-not-restored) de tu sesión. Después de una, `/rewind` restaura solo los archivos que Claude ya había editado en tu conversación. Las ediciones de la revisión en otros archivos se mantienen, así que usa git para revertirlas. Cuando la revisión [se ejecuta en primer plano](#run-in-the-foreground), edita tu árbol de trabajo durante tu propio turno, así que `/rewind` restaura sus ediciones como de costumbre.

71* **Instrucciones**: la revisión sigue tu `CLAUDE.md`, incluso en una ejecución no interactiva con `-p`. No lee `REVIEW.md`. Ese archivo configura el [servicio Code Review](/docs/es/code-review-customize#use-review-md-for-review-only-rules) administrado en pull requests de GitHub.

72 

73<h2 id="how-findings-are-reported">

74 Cómo se informan los hallazgos

75</h2>

76 

77Claude informa los hallazgos como texto en la respuesta en ambas de estas ejecuciones:

78 

79* En una sesión de terminal, donde `/code-review` ejecuta la revisión como un [subagente bifurcado](/docs/es/skills#run-skills-in-a-subagent)

80* En una ejecución con `-p` con salida de texto o JSON

81 

82En una aplicación host que solicita la lista de hallazgos, como la [aplicación de escritorio](/docs/es/desktop#review-your-code), Claude informa los hallazgos de la revisión a través de la [herramienta `ReportFindings`](/docs/es/tools-reference) en su lugar. El informe aparece como una lista de hallazgos, y cada entrada muestra la ubicación del archivo, un resumen de una oración y una etiqueta de categoría como `correctness` cuando el hallazgo tiene una. Una solicitud del host aplica en todos los niveles de esfuerzo y requiere Claude Code v2.1.218 o posterior.

83 

84Cuando Claude corrige hallazgos informados más adelante en la sesión, los informa de nuevo. Luego, Claude Code marca cada hallazgo en la lista actualizada como corregido, omitido o sin cambios necesarios.

85 

86<h2 id="tune-effort-and-arguments">

87 Ajusta el esfuerzo y los argumentos

88</h2>

89 

90Además de `--fix` y `--comment`, el comando acepta estos flags:

91 

92* `--post`: en una revisión en la nube con `ultra` de un pull request de `github.com`, preselecciona publicar los hallazgos finales en el PR en el diálogo de inicio. Consulta [Publicar los hallazgos en el pull request](/docs/es/ultrareview#post-findings-to-the-pull-request). Requiere Claude Code v2.1.227 o posterior.

93* `--max-findings <n>`, `--max-findings all` o `--max-findings default`: informa hasta `n` hallazgos, o todos los hallazgos con `all`, en lugar del límite habitual de la revisión. Cuando la revisión informa a través de la herramienta de hallazgos, el límite es 32. Las revisiones posteriores reutilizan el valor que escribiste hasta que pases `--max-findings default`, pero un valor pasado en una ejecución no interactiva con `-p` no se recuerda. Requiere Claude Code v2.1.288 o posterior.

94 

95Pasa un [nivel de esfuerzo](/docs/es/model-config#adjust-effort-level) para equilibrar cobertura y confianza. En `low`, la revisión informa los hallazgos de los que tiene más certeza, así que ves menos falsos positivos. Desde `medium` hasta `max`, la revisión amplía la cobertura.

96 

97Cuando no escribes un nivel, la revisión reutiliza el último nivel entre `low` y `max` que escribiste, incluso en una sesión anterior. Claude Code muestra un aviso como `Reusing high effort, the level you typed last time`. Estas reglas deciden qué nivel usa una ejecución:

98 

99* **Escribir un nivel**: un nivel que escribes, como `/code-review high`, cambia lo que reutilizan las ejecuciones posteriores

100* **Ejecuciones no interactivas**: un nivel que pasas en una ejecución no interactiva con `-p` no actualiza el nivel recordado

101* **`ultra`**: la revisión no usa ni actualiza el nivel recordado

102* **Nunca se escribió un nivel**: la revisión usa el esfuerzo actual de la sesión

103 

104Antes de la v2.1.223, un `/code-review` sin nivel siempre usaba el esfuerzo actual de la sesión.

105 

106<h3 id="post-findings-to-a-gitlab-merge-request">

107 Publicar los hallazgos en un merge request de GitLab

108</h3>

109 

110Cuando pasas `--comment` para un merge request de GitLab, Claude Code publica los hallazgos a través de la CLI `glab` de GitLab. Requiere Claude Code v2.1.257 o posterior. Cuando `glab` no está instalado, Claude imprime los hallazgos en la terminal en su lugar.

111 

112Pasa el merge request como su URL o como una referencia `!123`. Claude Code trata un número o un nombre de rama sin más como un merge request solo cuando el origin del checkout está en `gitlab.com`. En una instancia de GitLab autoadministrada, pasa la URL o la forma `!123`.

113 

114<h3 id="text-after-the-effort-level-and-flags">

115 Texto después del nivel de esfuerzo y los flags

116</h3>

117 

118Después del nivel de esfuerzo y los flags, Claude Code lee el resto de la línea como el objetivo de la revisión. El argumento `ultra` cambia esa interpretación:

119 

120* **Con `ultra`**: Claude Code lee una sola palabra como una rama base o un número de PR. Un texto más largo que no nombra una rama ni un PR se convierte en [una nota adjunta a la revisión](/docs/es/ultrareview#pass-a-request-in-plain-words). `/code-review ultra check my auth changes` revisa tu rama actual, y Claude relaciona los hallazgos con tu nota.

121* **Sin `ultra`**: todo lo que queda es el objetivo de la revisión, incluso cuando empieza con el nombre de otro comando. `/code-review /fix-issue 123` revisa con `/fix-issue 123` como texto del objetivo en lugar de cargar `/fix-issue` como un segundo [skill apilado](/docs/es/skills#pass-arguments-to-skills). Antes de la v2.1.218, un comando apilado después de `/code-review` se expandía como su propio skill.

122 

123<h2 id="run-in-the-foreground">

124 Ejecutar en primer plano

125</h2>

126 

127Para que la revisión se ejecute en primer plano, haz una de estas cosas:

128 

129* Ejecútala en modo no interactivo, con el flag `-p` o el Agent SDK. Claude Code espera la revisión e incluye los hallazgos en la respuesta, excepto con `ultra`, que [no espera la revisión en la nube](/docs/es/ultrareview#run-ultrareview-non-interactively).

130* Establece [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/es/env-vars) en `1`, lo que también desactiva todas las demás funciones de tareas en segundo plano

131* Ejecuta `/code-review` de nuevo mientras una revisión anterior sigue en curso

132 

133Antes de la v2.1.218, la revisión se ejecutaba dentro de tu conversación.

134 

135<h2 id="let-claude-start-the-review">

136 Deja que Claude inicie la revisión

137</h2>

138 

139Claude puede iniciar `/code-review` por su cuenta, sin que escribas el comando:

140 

141* **Cuando lo pides en lenguaje natural**: pídele a Claude que revise tus cambios y puede ejecutar el skill

142* **Desde una tarea programada**: una [tarea programada](/docs/es/scheduled-tasks) con `/code-review` como prompt ejecuta la revisión

143 

144Una tarea programada nunca inicia la [revisión en la nube](#escalate-to-ultrareview), así que programa `/code-review` sin el argumento `ultra`.

145 

146Para evitar que tanto Claude como las tareas programadas inicien la revisión, manteniendo `/code-review` disponible para que lo escribas tú, agrega una entrada [`skillOverrides`](/docs/es/skills#override-skill-visibility-from-settings) a un [archivo de configuración](/docs/es/settings#where-settings-live) como `~/.claude/settings.json`:

147 

148```json theme={null}

149{

150 "skillOverrides": {

151 "code-review": "user-invocable-only"

152 }

153}

154```

155 

156Antes de la v2.1.246, Claude iniciaba `/code-review` por su cuenta solo donde un feature flag obtenido de Anthropic lo activaba. En [sesiones que no obtienen feature flags](/docs/es/env-vars#features-that-need-feature-flag-fetching), `/code-review` se ejecutaba solo cuando lo escribías, y un `/code-review` programado llegaba a Claude como texto plano.

157 

158<h2 id="escalate-to-ultrareview">

159 Escalar a ultrareview

160</h2>

161 

162`/code-review ultra --fix` ejecuta el [ultrareview](/docs/es/ultrareview) más profundo en la nube y luego le pide a Claude que aplique sus hallazgos a tu árbol de trabajo cuando regresen a tu sesión.

163 

164Ultrareview usa su propio alcance:

165 

166* **Qué compara**: tu rama actual frente a la rama predeterminada del repositorio, además de los cambios sin commit y los cambios preparados (staged) en el árbol de trabajo

167* **Archivos sensibles**: para los cambios sin commit en archivos con nombres de credenciales o claves, como los archivos `.env` y `*.tfvars`, Claude Code sigue las reglas para [subir un repositorio local a una sesión en la nube](/docs/es/claude-code-on-the-web#send-local-repositories-without-github)

168* **Una base diferente**: pasa un nombre de rama, como `/code-review ultra develop`, para comparar con una base diferente

169 

170Cuando el objetivo es un pull request de `github.com`, puedes hacer que Claude [publique los hallazgos finales en el PR](/docs/es/ultrareview#post-findings-to-the-pull-request) como un comentario desde tu cuenta de GitHub. Requiere Claude Code v2.1.227 o posterior.

171 

172<Note>

173 Ultrareview requiere autenticación con una cuenta de claude.ai. No está disponible en Amazon Bedrock, Agent Platform de Google Cloud ni Microsoft Foundry, ni para organizaciones con Zero Data Retention habilitado o con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada. En estos casos, `/code-review ultra` ejecuta una revisión local en tu sesión en su lugar. Las organizaciones que usan [claves de cifrado administradas por el cliente](https://platform.claude.com/docs/en/manage-claude/cmek) (CMEK) no pueden ejecutar ultrareview. Para revisar tus cambios localmente, ejecuta `/code-review`.

174</Note>

175 

176Para ejecutar una revisión en la nube desde un script o un job de CI, usa el [subcomando `claude ultrareview`](/docs/es/ultrareview#run-ultrareview-non-interactively), que espera los hallazgos y los imprime en stdout.

177 

178<h2 id="change-or-build-on-the-review">

179 Modifica la revisión o construye sobre ella

180</h2>

181 

182`/code-review` es un [skill incluido](/docs/es/skills#bundled-skills): sus instrucciones están integradas en Claude Code, así que no hay ningún archivo `SKILL.md` en disco que abrir o editar. Para darle a cada revisión reglas del proyecto que seguir, agrégalas a tu `CLAUDE.md`. Para ir más allá, empieza desde una de estas páginas:

183 

184* **Reemplazar el comando**: un skill de proyecto o personal llamado `code-review` se ejecuta en lugar del incluido, y el alias `/review` sigue ejecutando la revisión incluida. Consulta [Resolver skills que comparten nombre](/docs/es/skills#resolve-skills-that-share-a-name).

185* **Crear tu propio revisor**: escribe un [subagente](/docs/es/sub-agents) revisor o un [skill](/docs/es/skills) de revisión

186* **Usar un comando cercano**: [`/simplify`](/docs/es/commands) revisa solo para limpieza y aplica sus correcciones, y [`/verify`](/docs/es/commands) ejecuta tu aplicación para confirmar que un cambio funciona

187 

188El comando se llamaba `/simplify` antes de la v2.1.147, cuando aplicaba correcciones de forma predeterminada. Si tenías scripts con `/simplify` para encontrar bugs, cámbialos a `/code-review --fix`.

189 

190<h2 id="related-resources">

191 Recursos relacionados

192</h2>

193 

194* [Code Review](/docs/es/code-review): el servicio administrado que revisa cada pull request en GitHub para tu organización

195* [Ultrareview](/docs/es/ultrareview): configuración, límites y costo de la revisión en la nube más profunda

196* [Comandos](/docs/es/commands): la referencia de una línea para `/code-review`, `/review`, `/simplify` y `/verify`

197* [Skills](/docs/es/skills): cómo funcionan los skills incluidos y cómo escribir los tuyos

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Leer y solicitar revisiones en un pull request

6 

7> Lee los hallazgos de Code Review en tu pull request de GitHub, respóndelos o descártalos, y solicita una revisión con `@claude review`.

8 

9Code Review es un servicio gestionado que un Owner de tu organización de Claude activa para un conjunto de repositorios de GitHub. Una vez activado, Claude revisa los pull requests de esos repositorios y publica sus hallazgos como comentarios en línea, un resumen en el cuerpo de la revisión y un check run llamado **Claude Code Review**. Una revisión nunca aprueba ni bloquea tu pull request, y el check run nunca concluye como fallido.

10 

11Un Owner controla [cuándo se ejecutan las revisiones](/docs/es/code-review-setup#set-when-reviews-run) y [qué tan exhaustivas son](/docs/es/code-review-setup#set-the-default-review-level) para cada repositorio.

12 

13<Note>

14 Si tu plan no incluye Code Review, aún puedes hacer que Claude revise tu rama desde una sesión de Claude Code: consulta [Revisar localmente con `/code-review`](/docs/es/code-review-local).

15</Note>

16 

17<h2 id="severity-levels">

18 Niveles de gravedad

19</h2>

20 

21Claude publica cada hallazgo como un comentario en línea sobre las líneas afectadas y lo marca con uno de tres niveles de gravedad:

22 

23| Marcador | Gravedad | Significado |

24| :- | :- | :- |

25| 🔴 | Important | Un bug que debería corregirse antes de fusionar |

26| 🟡 | Nit | Un problema menor, que vale la pena corregir pero no es bloqueante |

27| 🟣 | Pre-existing | Un bug que existe en la base de código pero que no fue introducido por este PR |

28 

29Cuando la revisión registró su razonamiento, el hallazgo tiene una sección contraída **Why this was flagged**. Expándela para leer por qué Claude señaló el problema y cómo lo verificó.

30 

31Para cambiar lo que Claude señala en tu repositorio o cómo clasifica la gravedad, consulta [Personalizar Code Review](/docs/es/code-review-customize).

32 

33<h2 id="respond-to-findings">

34 Responder a los hallazgos

35</h2>

36 

37Puedes fusionar sin responder a un hallazgo, a menos que las propias reglas de tu repositorio lo exijan. Si su protección de rama [exige la resolución de conversaciones](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-conversation-resolution-before-merging), resuelve el hilo de cada hallazgo antes de fusionar.

38 

39Para eliminar un hallazgo, resuelve su hilo o sube una corrección.

40 

41* **Descartarlo sin cambiar el código**: resuelve el hilo tú mismo en GitHub. Responder por sí solo no descarta un hallazgo.

42* **Corregir el problema**: cambia el código y haz push. La siguiente revisión del pull request resuelve su hilo anterior cuando considera que el problema está corregido, ya sea que esa revisión se ejecute automáticamente con tu push o que la solicites tú.

43* **Explicar o estar en desacuerdo**: responde al comentario. Claude no responde de inmediato, y una respuesta no inicia una revisión. La siguiente revisión del pull request lee las respuestas a sus hallazgos anteriores, y puede resolver el hilo o publicar una respuesta de seguimiento. Si el mismo tipo de hallazgo sigue apareciendo, pídele a un maintainer que agregue una regla a [`REVIEW.md`](/docs/es/code-review-customize#choose-what-to-write-in-review-md).

44 

45Para obtener esa siguiente revisión sin hacer push, comenta `@claude review` como un [comentario de nivel superior en el pull request](#comment-commands).

46 

47<h2 id="check-run-output">

48 Salida del check run

49</h2>

50 

51El enlace **Details** del check run **Claude Code Review** abre los hallazgos en una tabla ordenada por gravedad, incluido cualquier hallazgo cuyo comentario en línea GitHub no aceptó:

52 

53| Gravedad | Archivo:Línea | Problema |

54| - | - | - |

55| 🔴 Important | `src/auth/session.ts:142` | La actualización del token compite con el cierre de sesión, dejando activas sesiones obsoletas |

56| 🟡 Nit | `src/auth/session.ts:88` | `parseExpiry` devuelve 0 silenciosamente ante una entrada mal formada |

57 

58Un hallazgo que tiene una línea pero que no se publicó como comentario en línea aparece como una anotación en la pestaña **Files changed**, sobre las líneas afectadas. Los hallazgos Important se muestran en rojo, los nits en amarillo y los bugs preexistentes en gris.

59 

60El check run concluye como neutral, o como omitido cuando una revisión automática no se ejecutó porque un push no cambió ningún archivo. Nunca concluye como fallido, así que una revisión terminada no hace fallar un check obligatorio. Si no ves hallazgos, o una revisión no se ejecutó, consulta [Solucionar problemas de Code Review](/docs/es/code-review-troubleshooting).

61 

62<h3 id="read-the-result-from-a-script">

63 Leer el resultado desde un script

64</h3>

65 

66Para condicionar una fusión o publicar un resumen desde tu propio CI, analiza la última línea del texto de Details con `gh` y jq. Esa línea es un comentario legible por máquina.

67 

68<Steps>

69 <Step title="Encuentra el ID del check run">

70 Desde tu shell, lista los check runs del commit y toma el `id` del run `Claude Code Review`. Reemplaza `OWNER` y `REPO` con el propietario y el nombre de tu repositorio, y `<commit-sha>` con el commit head del pull request:

71 

72 ```bash theme={null}

73 gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}'

74 ```

75 </Step>

76 

77 <Step title="Lee los conteos de gravedad">

78 Lee los conteos de ese check run, reemplazando `CHECK_RUN_ID` con el ID:

79 

80 ```bash theme={null}

81 gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \

82 --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

83 ```

84 

85 Esto imprime un objeto JSON con un conteo por gravedad y sus claves en orden alfabético, por ejemplo `{"nit": 1, "normal": 2, "pre_existing": 0}`. Los conteos incluyen hallazgos de revisiones anteriores del pull request cuyos hilos siguen abiertos.

86 </Step>

87 

88 <Step title="Actúa según el resultado">

89 Haz que tu script maneje estos casos:

90 

91 * **`normal` es mayor que cero**: haz fallar el job si quieres condicionar la fusión. La clave `normal` contiene el conteo de hallazgos Important, así que Claude encontró al menos un bug que vale la pena corregir antes de fusionar.

92 * **Falta la línea**: trátalo como ausencia de veredicto y no como cero hallazgos. Un check run de una revisión que falló, agotó el tiempo de espera, fue cancelada o fue reemplazada por una más reciente no tiene esa línea, y algunas revisiones completadas tampoco la tienen.

93 </Step>

94</Steps>

95 

96<h2 id="request-a-review">

97 Solicitar una revisión

98</h2>

99 

100Si tu pull request es un borrador o proviene de un fork, las revisiones automáticas lo omiten, así que [solicita la revisión con un comando de comentario](#review-drafts-and-pull-requests-from-forks). Para obtener una revisión en tu pull request, haz una de estas cosas:

101 

102* **Ábrelo o márcalo como listo**: en un repositorio configurado como **Once after PR creation** o **After every push**, una revisión se inicia cuando abres o reabres el pull request, o marcas un borrador como listo para revisión.

103* **Comenta un comando**: publica [`@claude review`](#comment-commands) en el pull request.

104* **Haz push de un commit**: un push inicia una revisión en un repositorio configurado como **After every push**, o en un pull request que suscribiste con `@claude review always`.

105* **Haz clic en Re-run**: después de que una revisión falle o agote el tiempo de espera en un pull request que no proviene de un fork, [vuelve a ejecutarla](/docs/es/code-review-troubleshooting#retrigger-a-failed-or-timed-out-review) desde el check run.

106* **Espera el reintento automático**: una revisión cuya sesión se interrumpió se reintenta una vez automáticamente. El [resumen del check run](/docs/es/code-review-troubleshooting#retrigger-a-failed-or-timed-out-review) indica cuándo está ocurriendo esto.

107 

108<h3 id="comment-commands">

109 Comandos de comentario

110</h3>

111 

112Publica uno de estos comandos como comentario en el pull request:

113 

114| Comando | Qué hace | Cuándo usarlo |

115| :- | :- | :- |

116| `@claude review` | Inicia una sola revisión sin suscribir el PR a futuros pushes | Quieres una revisión ahora, por ejemplo en un pull request de un repositorio configurado como Manual, u otra revisión de inmediato en los otros modos |

117| `@claude review always` | Inicia una revisión y suscribe el PR a revisiones activadas por push de ahí en adelante | Quieres que cada push posterior inicie una revisión nueva, por ejemplo en un PR de alta prioridad en un repositorio configurado como Manual |

118| `@claude review once` | Igual que `@claude review`: inicia una sola revisión sin suscribir | Los mismos casos que `@claude review` |

119 

120Para que cualquiera de estos comandos inicie una revisión, deben cumplirse todas estas condiciones:

121 

122* Publícalo como un nuevo comentario de nivel superior en el pull request, no como un comentario en línea sobre una línea del diff ni como el cuerpo de una revisión. Editar un comentario anterior no cuenta.

123* Pon el comando al inicio del comentario, con `always` en la misma línea que el resto del comando. Las mayúsculas y minúsculas no importan.

124* Necesitas permiso de write, maintain o admin en el repositorio. Claude lo verifica con GitHub para cada persona que comenta, y los comentarios de bots no inician revisiones.

125* El pull request debe estar abierto.

126 

127Cuando se acepta el comando, aparece un check run **Claude Code Review** en el pull request con el título **Code review queued...**. El título cambia a **Code review in progress...** cuando la revisión comienza. Claude también puede reaccionar a tu comentario con 👀, pero esa reacción puede aparecer aunque no se inicie ninguna revisión, así que busca el check run en su lugar.

128 

129Si ya hay una revisión en ejecución sobre el último commit del pull request, una nueva solicitud no inicia una segunda.

130 

131<Note>

132 Antes de una actualización de julio de 2026, `@claude review` suscribía el PR a revisiones activadas por push. Si dependías de ese comportamiento, comenta `@claude review always` en su lugar.

133</Note>

134 

135<h3 id="what-a-later-review-covers">

136 Qué cubre una revisión posterior

137</h3>

138 

139Una revisión posterior que se inicia por sí sola, por ejemplo después de un push, se centra en lo que cambió desde la última revisión y publica menos nits y hallazgos preexistentes. Su resumen cuenta lo que omitió, en una línea que termina en "found and not posted" u "outside the scope of this re-review and not posted."

140 

141Para obtener una revisión que no omita nada de esto, comenta [`@claude review`](#comment-commands). Cubre de nuevo todo el pull request.

142 

143<h3 id="review-drafts-and-pull-requests-from-forks">

144 Revisar borradores y pull requests de forks

145</h3>

146 

147Las revisiones automáticas omiten ambos casos, así que solicita la revisión con un comando de comentario:

148 

149* **Pull requests en borrador**: un comando de comentario se ejecuta en un borrador, así que puedes solicitar una revisión antes de marcar el pull request como listo. Los pushes a un borrador no inician revisiones, incluso después de `@claude review always`. La suscripción entra en vigor una vez que marcas el pull request como listo.

150* **Pull requests de forks**: Claude no revisa automáticamente un pull request de un fork, independientemente del ajuste **Review runs** del repositorio. Para iniciar una, comenta `@claude review` en el pull request. Las [condiciones para los comandos de comentario](#comment-commands) siguen aplicando, y el acceso de escritura que necesitas es al repositorio base, no al fork.

151 

152En un pull request de un fork, `@claude review always` también funciona, pero no suscribe el pull request a revisiones en pushes posteriores. Hacer clic en **Re-run** en el check run no inicia una revisión allí.

153 

154<h3 id="use-code-review-alongside-the-claude-code-github-action">

155 Usar Code Review junto con la GitHub Action de Claude Code

156</h3>

157 

158Si el repositorio también ejecuta la [GitHub Action de Claude Code](/docs/es/github-actions) en modo interactivo con su frase de activación predeterminada `@claude`, un comentario `@claude review` también inicia la Action. Para mantener ambas separadas, establece el input `trigger_phrase` de la Action en una frase diferente.

159 

160<h2 id="related-resources">

161 Recursos relacionados

162</h2>

163 

164* [Solucionar problemas de Code Review](/docs/es/code-review-troubleshooting): una revisión que no se inició, falló o se omitió por presupuesto

165* [Code Review](/docs/es/code-review): qué es el servicio y cómo se ejecuta una revisión

166* [Configurar Code Review](/docs/es/code-review-setup): para Owners, activa Code Review y elige cuándo se ejecutan las revisiones y con qué nivel

167* [Personalizar Code Review](/docs/es/code-review-customize): cambia lo que Claude señala con `REVIEW.md` y `CLAUDE.md`

168* [Costos y uso de Code Review](/docs/es/code-review-costs): cómo se facturan las revisiones y dónde se establece el límite de gasto

169* [Revisar localmente con `/code-review`](/docs/es/code-review-local): ejecuta una revisión de tu rama desde una sesión de Claude Code

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Configurar Code Review

6 

7> Activa Code Review para tu organización de Claude: conecta GitHub, instala la Claude GitHub App, elige los repositorios y establece cuándo se ejecutan las revisiones

8 

9Como Owner de tu organización de Claude, activas Code Review en [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) en claude.ai. Las revisiones se ejecutan en la infraestructura de Anthropic, así que no necesitas agregar archivos de workflow a tus repositorios.

10 

11Después de la configuración, eliges qué tan exhaustivas son las revisiones y cuándo se ejecutan en cada repositorio. Gastas más con un nivel de revisión más alto y cuando las revisiones se ejecutan con más frecuencia. Consulta [Costos de Code Review](/docs/es/code-review-costs#pricing).

12 

13<h2 id="what-you-need-to-turn-on-code-review">

14 Lo que necesitas para activar Code Review

15</h2>

16 

17Primero verifica que tu organización [cumpla los requisitos para Code Review](/docs/es/code-review#availability). Luego asegúrate de tener este acceso, o de contar con alguien que lo tenga:

18 

19| Acceso | Necesario para |

20| :- | :- |

21| [Rol de Owner](/docs/es/server-managed-settings#access-control) en tu organización de Claude | Cada paso en la página de administración |

22| Owner de la organización de GitHub | Instalar la Claude GitHub App y [vincularla a tu organización de Claude](/docs/es/admin-setup#connected-github-accounts). Si no eres owner, pide a uno que instale y vincule la app antes de empezar |

23| Acceso de escritura a cada repositorio que agregues, desde la cuenta de GitHub que conectes a Claude | Agregar el repositorio |

24 

25<h2 id="turn-on-code-review">

26 Activar Code Review

27</h2>

28 

29<Steps>

30 <Step title="Haz clic en el interruptor Allow code review">

31 Ve a la sección **Code review** de [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) y haz clic en el interruptor **Allow code review**.

32 

33 Si Code Review se activa de inmediato sin ningún cuadro de diálogo, tu organización ya tiene la Claude GitHub App vinculada o repositorios agregados. Ve a [Agregar más repositorios](#add-more-repositories) y luego vuelve para el último paso.

34 </Step>

35 

36 <Step title="Conecta tu cuenta de GitHub">

37 Si se abre un cuadro de diálogo **Connect GitHub**, haz clic en **Connect**. Si tu organización usa GitHub Enterprise Server, primero selecciona tu instancia en el cuadro de diálogo. GitHub te pide que autorices a Claude y luego te devuelve a la página de administración con el cuadro de diálogo **Add a repository** abierto.

38 

39 Si **Add a repository** se abrió directamente, tu cuenta ya está conectada, así que continúa con el siguiente paso.

40 </Step>

41 

42 <Step title="Instala la Claude GitHub App">

43 Si los repositorios que quieres aparecen en el cuadro de diálogo **Add a repository**, o los encuentras buscándolos ahí, continúa con el siguiente paso. El cuadro de diálogo solo muestra un repositorio si la Claude GitHub App puede acceder a él, así que si no aparecen, instala la app:

44 

45 * Haz clic en **Install GitHub App**. Cuando no hay repositorios en la lista, es un botón en el cuadro de diálogo. De lo contrario, está al final del menú de filtro de organizaciones de GitHub del cuadro de diálogo. La página de instalación de GitHub se abre en una pestaña nueva.

46 * Elige la organización de GitHub a la que pertenecen los repositorios.

47 * Elige a qué repositorios puede acceder la app.

48 * Aprueba los permisos solicitados. El conjunto es más amplio de lo que usa una revisión y lo comparten otras funciones de Claude, como [GitHub Actions](/docs/es/github-actions). Consulta [a qué puede acceder una revisión](/docs/es/code-review#what-a-review-can-access) y la [lista completa de permisos](/docs/es/github-actions#github-app-permissions).

49 * Cuando termina la instalación, la pestaña vuelve a Claude. Si muestra un botón **Finish connecting GitHub**, haz clic en él para vincular la instalación a tu organización de Claude.

50 * Vuelve a la pestaña de la página de administración, donde la lista del cuadro de diálogo se actualiza.

51 </Step>

52 

53 <Step title="Elige los repositorios">

54 Selecciona los repositorios que quieres que se revisen y luego haz clic en **Continue**. Para agregar un repositorio necesitas acceso de escritura a él desde la cuenta de GitHub que conectaste. Puedes [agregar más repositorios](#add-more-repositories) más adelante.

55 </Step>

56 

57 <Step title="Haz clic en Finish">

58 A continuación aparece un cuadro de diálogo **Code review is set up**. Haz clic en **Finish** para activar Code Review. Si cierras el cuadro de diálogo de cualquier otra forma, tus repositorios siguen agregados, pero **Allow code review** sigue desactivado y lo activas desde el interruptor.

59 

60 Cada repositorio empieza configurado para revisar después de cada push, lo que ejecuta la mayor cantidad de revisiones. Para ejecutar menos, [establece cuándo se ejecutan las revisiones](#set-when-reviews-run).

61 </Step>

62 

63 <Step title="Verifica con un pull request de prueba">

64 Abre un pull request de prueba en uno de los repositorios que agregaste y no lo marques como borrador. En pocos minutos aparece un check run llamado **Claude Code Review**. Si ya configuraste el repositorio como **Manual (@claude review)**, comenta `@claude review` en el pull request para iniciar la primera revisión.

65 

66 Si no aparece ningún check run, consulta [No check run appears on the test pull request](/docs/es/code-review-troubleshooting#no-check-run-appears-on-the-test-pull-request).

67 

68 Cuando llegue la revisión, envía a tus desarrolladores [Leer y solicitar revisiones en un pull request](/docs/es/code-review-pull-requests), que explica los niveles de gravedad, los comandos de comentario y cómo responder a los hallazgos.

69 </Step>

70</Steps>

71 

72<h2 id="set-defaults-for-your-organization">

73 Establecer los valores predeterminados de tu organización

74</h2>

75 

76Como Owner, decides qué tan exhaustivas son las revisiones y con qué frecuencia se ejecutan. Ambas opciones están en la sección **Code review** de [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review).

77 

78<h3 id="set-the-default-review-level">

79 Establecer el nivel de revisión predeterminado

80</h3>

81 

82El nivel de revisión determina qué tan exhaustiva es cada revisión, y una revisión más exhaustiva cuesta más. Estableces un valor predeterminado para la organización y puedes sobrescribirlo para repositorios individuales.

83 

84| Nivel | Qué sacrifica |

85| :- | :- |

86| Quick | Una pasada más ligera. El nivel más rápido, al menor costo |

87| Standard | Equilibrio entre profundidad, velocidad y costo. El nivel predeterminado |

88| Deep | La pasada más exhaustiva. Es la que más tarda y la que más cuesta |

89 

90* **Valor predeterminado de la organización**: selecciona un nivel en **Review level** y confirma con **Change level**. Todos los repositorios lo usan, a menos que le asignes a un repositorio su propio nivel.

91* **Un repositorio**: haz clic en **Edit** en la fila del repositorio y luego selecciona un **Review level** ahí. La primera opción, **Default**, sigue a la organización. El nivel se guarda en cuanto lo seleccionas.

92 

93Un nivel nuevo se aplica a las revisiones que comienzan después del cambio. Para conocer qué más determina el costo de cada revisión, consulta [Costos y uso de Code Review](/docs/es/code-review-costs).

94 

95<h3 id="set-when-reviews-run">

96 Establecer cuándo se ejecutan las revisiones

97</h3>

98 

99Cada repositorio tiene su propio ajuste **Review runs**, que decide cuándo se revisan sus pull requests.

100 

101* **Once after PR creation**: se ejecuta una revisión cuando se abre o se vuelve a abrir un pull request, o cuando se marca como listo para revisión

102* **After every push**: se ejecuta una revisión con cada push a la rama del pull request, lo que detecta problemas nuevos a medida que el pull request evoluciona y resuelve automáticamente los hilos cuando corriges los problemas señalados

103* **Manual (@claude review)**: abrir un pull request o hacer push a él no inicia una revisión. Comenta [`@claude review`](/docs/es/code-review-pull-requests#comment-commands) para solicitar una, o `@claude review always` para además suscribir el pull request a revisiones en los pushes posteriores.

104 

105Manual es útil en repositorios con mucho tráfico donde quieres incluir pull requests específicos en la revisión, o para empezar a revisar los pull requests solo cuando estén listos. Para comparar cómo afecta cada opción al gasto, consulta [Con qué frecuencia se ejecutan las revisiones](/docs/es/code-review-costs#how-often-reviews-run).

106 

107Para cambiar el ajuste, haz clic en **Edit** en la fila del repositorio en la tabla **Repositories** y selecciona una opción de **Review runs**. La elección se guarda en cuanto la seleccionas, y la columna **Review runs** de la tabla la muestra abreviada como Once per PR, Every push o Manual.

108 

109* **Borradores y pull requests desde forks**: sin importar la opción que elijas, [las revisiones automáticas omiten ambos](/docs/es/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)

110* **Repositorios nuevos**: un repositorio que agregas desde el cuadro de diálogo **Add a repository** empieza en **After every push**. Si su organización de GitHub está [cubierta en su totalidad](#cover-a-whole-github-organization), toma en su lugar el ajuste de la fila de esa organización.

111 

112<h3 id="turn-tip-comments-on-or-off">

113 Activar o desactivar los comentarios de sugerencia

114</h3>

115 

116Un comentario de sugerencia es un comentario breve que Claude publica en un pull request cuando no se inicia ninguna revisión, indicando el motivo y qué hacer a continuación. **Show tips on pull requests** está activado de forma predeterminada. Con esta opción activada, Claude publica una sugerencia en cada uno de estos casos, explicando:

117 

118* **El repositorio está configurado como Manual**: cómo solicitar una revisión con un comentario

119* **El pull request proviene de un fork**: que un maintainer puede solicitar la revisión

120* **Un bot, o alguien sin acceso de escritura, comenta `@claude review`**: que no se inició ninguna revisión y quién puede solicitarla

121* **La organización de GitHub no está vinculada a tu organización de Claude**: que las revisiones están en pausa y cómo vincularla

122 

123Desactiva el ajuste para dejar de publicar estos comentarios.

124 

125<h3 id="what-developers-can-change">

126 Lo que pueden cambiar los desarrolladores

127</h3>

128 

129Los desarrolladores acuden a ti para cambiar el nivel de revisión, el ajuste **Review runs** o qué repositorios reciben revisiones. Desde GitHub, sin el rol de Owner, pueden hacer lo siguiente:

130 

131* **Solicitar una revisión**: comentar [`@claude review`](/docs/es/code-review-pull-requests#comment-commands) en un pull request. Esto requiere acceso de escritura al repositorio y funciona en [borradores y pull requests desde forks](/docs/es/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), que las revisiones automáticas omiten.

132* **Suscribir un pull request a una revisión en cada push**: comentar `@claude review always` en un pull request que no sea [un borrador ni provenga de un fork](/docs/es/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), por ejemplo en un repositorio configurado como Manual

133* **Cambiar lo que señalan las revisiones**: hacer commit de [archivos `REVIEW.md` y `CLAUDE.md`](/docs/es/code-review-customize) en el repositorio, por ejemplo para agregar una comprobación

134 

135Las revisiones que solicitan los desarrolladores se [facturan a tu organización](/docs/es/code-review-costs#pricing). Para limitar lo que gasta Code Review en un mes, consulta [Limitar tu gasto](/docs/es/code-review-costs#limit-your-spend).

136 

137<h2 id="manage-repositories">

138 Administrar repositorios

139</h2>

140 

141Puedes agregar repositorios uno por uno o cubrir toda una organización de GitHub a la vez, y detener las revisiones donde no las quieras.

142 

143<h3 id="add-more-repositories">

144 Agregar más repositorios

145</h3>

146 

147Para agregar repositorios después de la configuración, haz clic en **Add** encima de la tabla **Repositories** en la sección **Code review**. Se abre el cuadro de diálogo **Add a repository**. Selecciona los repositorios y haz clic en **Continue**.

148 

149* **Un repositorio no aparece en la lista**: consulta [A repository isn't listed in Add a repository](/docs/es/code-review-troubleshooting#a-repository-isn’t-listed-in-add-a-repository).

150* **Quieres todos los repositorios de una organización de GitHub**: [cubre la organización](#cover-a-whole-github-organization) en lugar de seleccionar los repositorios uno por uno

151 

152<h3 id="cover-a-whole-github-organization">

153 Cubrir toda una organización de GitHub

154</h3>

155 

156Para activar Code Review en todos los repositorios de una organización de GitHub, establece **Review runs** en la fila de la organización en la tabla **Repositories**. Eso cubre todos los repositorios de esa organización a los que puede acceder la Claude GitHub App, incluidos los repositorios que se agreguen más adelante. Esto puede aumentar el gasto considerablemente. Requiere todo lo siguiente:

157 

158* La cuenta de GitHub que conectaste a Claude es owner de esa organización de GitHub.

159* La organización está en github.com. Las instancias de GitHub Enterprise Server y las cuentas personales de GitHub no cumplen los requisitos.

160* Hay un [límite de gasto mensual](/docs/es/code-review-costs#limit-your-spend) establecido, para tu organización de Claude o para Code Review.

161 

162Para cubrir la organización, haz clic en **Edit** en su fila, selecciona una opción de **Review runs** y confirma. Las opciones son las tres de [Establecer cuándo se ejecutan las revisiones](#set-when-reviews-run) más **Off**.

163 

164Después de confirmar, estos cambios entran en vigor:

165 

166* **Cobertura**: cada repositorio queda cubierto a partir de su siguiente pull request. Si la Claude GitHub App se instaló en repositorios seleccionados en lugar de en todos, Claude revisa esos repositorios; cambia el acceso a repositorios de la app en GitHub para cubrir el resto.

167* **Ajustes existentes**: todos los repositorios de esa organización de GitHub toman la opción que seleccionas, incluidos los repositorios que habías configurado individualmente. Volver a establecer la fila tiene el mismo efecto. Los repositorios que desactivaste en sus propias filas siguen desactivados.

168* **Cambios individuales posteriores**: un repositorio que luego configures de forma distinta a su organización se marca como **Custom** en la tabla.

169* **Nivel de revisión**: una fila de organización no tiene un nivel de revisión propio.

170 

171<h3 id="turn-off-code-review-or-remove-a-repository">

172 Desactivar Code Review o quitar un repositorio

173</h3>

174 

175En la sección **Code review** de [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review), elige el control que corresponda a lo que quieres detener:

176 

177* **Un repositorio, manteniéndolo en la lista**: haz clic en **Edit** en su fila y desactiva **Code review**. La tabla muestra el repositorio como Off.

178* **Un repositorio, quitándolo**: haz clic en **Edit** en su fila y luego en **Remove repository** al final del cuadro de diálogo. Las revisiones se detienen ahí, y otra organización de Claude puede entonces configurar ese repositorio. Mientras la organización de GitHub del repositorio esté cubierta en su totalidad, no puedes quitarlo; en su lugar, desactiva su interruptor **Code review**.

179* **Toda una organización de GitHub**: haz clic en **Edit** en la fila de la organización y selecciona **Off**. Esto también desactiva los repositorios de esa organización que agregaste uno por uno.

180* **Todo**: desactiva **Allow code review**. No se inician revisiones nuevas en ningún repositorio, y tu lista de repositorios se conserva para que puedas volver a activarlo más adelante.

181 

182<h2 id="related-resources">

183 Recursos relacionados

184</h2>

185 

186* [Costos y uso de Code Review](/docs/es/code-review-costs): cómo afectan al gasto el nivel de revisión y el momento en que se ejecutan las revisiones, cómo establecer un límite de gasto y dónde ver el uso

187* [Leer y solicitar revisiones en un pull request](/docs/es/code-review-pull-requests): lo que ven los desarrolladores en un pull request y los comandos de comentario

188* [Personalizar Code Review](/docs/es/code-review-customize): ajusta lo que señala Claude con `REVIEW.md` y `CLAUDE.md`

189* [GitHub Enterprise Server](/docs/es/github-enterprise-server): conecta una instancia de GitHub autoalojada antes de la configuración

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Solución de problemas de Code Review

6 

7> Corrige una revisión de Code Review que no se inició, falló o se omitió por presupuesto, encuentra hallazgos que faltan y resuelve problemas de configuración y de `REVIEW.md`.

8 

9Cuando [Code Review](/docs/es/code-review) no hace lo que esperas en un pull request, empieza por el check run **Claude Code Review**. Su título indica hasta dónde llegó la revisión.

10 

11<h2 id="check-how-far-the-review-got">

12 Comprueba hasta dónde llegó la revisión

13</h2>

14 

15Busca el check run **Claude Code Review** en tu pull request y luego compara su título con uno de estos títulos comunes:

16 

17| Título del check run | Qué significa | Qué hacer |

18| :- | :- | :- |

19| **Code review queued...** o **Code review in progress...** | La revisión no ha terminado | Espera a que cambie el título |

20| **Code review found no issues** | La revisión terminó y no encontró nada que señalar | Nada |

21| Un título que dice que se encontraron problemas | La revisión terminó con hallazgos | Si no los ves en el diff, consulta [Encuentra problemas que no aparecen como comentarios en línea](#find-issues-that-aren’t-showing-as-inline-comments) |

22| **Code review skipped — no new changes** | No se ejecutó una revisión automática en tu último push | Para obtener una revisión de todos modos, comenta `@claude review` |

23| **Code review failed** o **Code review timed out** | La revisión no terminó | Para ejecutarla de nuevo, consulta [Vuelve a iniciar una revisión que falló o agotó el tiempo de espera](#retrigger-a-failed-or-timed-out-review) |

24| **Code review declined** | La revisión no se ejecutó | Lee el resumen del check run. Si menciona un presupuesto o un límite de gasto, consulta [La revisión no se ejecutó y el PR muestra un mensaje de presupuesto](#review-didn’t-run-and-the-pr-shows-a-budget-message) |

25| Ningún check run | No se inició ninguna revisión | Comenta `@claude review`. Si después de eso no aparece ningún check run, consulta [Un comando en un comentario no inició una revisión](#a-comment-command-didn’t-start-a-review) |

26 

27<h2 id="a-review-didn’t-start">