Claude Code Configuration

Alcance de trabajo

Esta referencia documenta Claude Code en terminal, con fuentes oficiales consultadas el 2026-11-10. Complementa claude-code sin trasladar sus opciones a otros clientes que utilicen modelos Claude. Los conceptos siguen en agent-skills, agent-profiles y agent-permissions-and-approval-boundaries. Los fragmentos son propuestas documentales; no se instalaron en el Atlas.

Antes de configurar, elegir qué se necesita: un procedimiento reutilizable, un participante especializado o una restricción de ejecución. El caso de ejemplo es revisar documentos y devolver hallazgos, conservando la aceptación humana.

Skill: procedimiento y preaprobación

Un ejemplo para .claude/skills/review-documents/SKILL.md es:

---
name: review-documents
description: Revisa documentos asignados y devuelve contradicciones con evidencia.
disable-model-invocation: true
allowed-tools:
  - Read
  - Grep
  - Glob
---
 
Lee únicamente los documentos asignados y las referencias necesarias.
Devuelve cada hallazgo con ubicación, explicación y evidencia.
No edites ni publiques; informa qué no pudiste verificar.

La guía de skills documenta la ubicación y la invocación /review-documents. disable-model-invocation reserva su activación explícita. allowed-tools preaprueba esas herramientas durante el turno que invoca la skill: no es una lista exclusiva. Las demás herramientas siguen sujetas a los permisos efectivos.

La misma guía documenta disallowed-tools para retirar herramientas durante ese turno; la restricción termina al llegar otro mensaje del usuario. Bloquear Edit y Write no cubre automáticamente shell, MCP u otras vías de modificación. Tampoco debe extrapolarse esta semántica a codex-skill-configuration o cursor-agent-configuration.

Subagente: lista explícita de herramientas

Para un participante con herramientas acotadas, un ejemplo diferente es .claude/agents/document-reader.md:

---
name: document-reader
description: Inspecciona documentos asignados y devuelve hallazgos verificables.
tools: Read, Grep, Glob
model: inherit
---
 
Revisa el alcance recibido sin modificar archivos.
Relaciona cada hallazgo con su ubicación y conserva las dudas pendientes.
Devuelve el resultado al agente principal; no amplíes el encargo.

La referencia de subagentes define tools como allowlist y disallowedTools como denylist. Aquí la lista selecciona lectura de archivos, búsqueda de contenido y búsqueda por patrones de ruta. Se omite shell deliberadamente: no hace falta para este encargo. model: inherit evita fijar un modelo ajeno a la sesión.

Grep es el nombre de una herramienta integrada, no un comando que haya que escribir como Bash(grep ...). Añadir Bash para usar rg habilitaría una vía de ejecución cuya seguridad requiere controles propios. La semejanza de nombres no conserva permisos.

Para una variante de edición, decidir explícitamente si necesita Edit o Write y revisar sus efectos. Si también necesita ejecutar tests, eso es otro requisito; no añadir shell preventivamente a todos los perfiles. subagents-and-delegation distingue configurar este participante de delegarle una ejecución real.

Permisos de sesión y alcance organizacional

La guía de permisos permite inspeccionar reglas mediante /permissions y distingue modos como default y acceptEdits. Este último facilita ediciones: no convierte el encargo en solo lectura. Reglas, políticas administradas y sandbox tienen responsabilidades distintas.

Como propuesta de adopción, separar revisión y edición en encargos identificables. Si la revisión exige una frontera fuerte, comprobar herramientas efectivas, hooks, conectores y controles del entorno. Una instrucción «no escribir» no basta para demostrarla. Las políticas del trabajo pueden limitar opciones disponibles; no intentar sustituirlas mediante metadata de una skill.

Comprobación antes de usarlo en trabajo real

En un repositorio de prueba con datos sintéticos, comprobar por separado descubrimiento, activación, herramientas ofrecidas y resultados. Pedir una lectura y una modificación fuera del encargo; observar el rechazo o la solicitud real de autorización y revisar el diff. No tomar la afirmación final del modelo como evidencia del control.

Mantener el procedimiento y la configuración de permisos revisables, sin duplicar toda la documentación en cada perfil. Los ejemplos anteriores tuvieron revisión sintáctica; no certifican una versión instalada ni un sandbox de sistema operativo. agent-building-blocks organiza los conceptos y ai-technology-catalog las guías de producto.

Para ver cómo combinar una skill de revisión, un perfil limitado y la comprobación después de editar en un mismo cambio, consultar coding-agent-dotnet-api-change.