{"content_id":"gqsjob8ujn","slug":"claude-code-setup-permissions-models-context-guide","locale":"es","schema_type":"TechArticle","category":"tutorial","category_name":"Tutorial","title":"Guía básica de Claude Code: instalación, permisos, modelos y gestión del contexto","summary":"Explica paso a paso desde la instalación y la primera ejecución de Claude Code hasta los modos de permisos, la selección de modelos, la limpieza del contexto y la redacción de CLAUDE.md. También corrige, conforme a la documentación oficial, el sistema de permisos y la información sobre costes simplificados en el material original.","author":{"name":"Equipo editorial de Injoys","url":"https://injoys.com/ko/about"},"key_points":["Claude Code es una herramienta de programación basada en agentes que puede leer y modificar archivos del directorio del proyecto y ejecutar herramientas de terminal.","VS Code es una opción práctica, pero no es un requisito; Claude Code también puede ejecutarse en entornos de terminal compatibles.","Para los principiantes, es más seguro revisar primero el alcance del trabajo en el modo Plan y luego cambiar al modo predeterminado o al modo Accept Edits.","El coste varía según el método de autenticación, el modelo elegido, el contexto de entrada y el número de repeticiones de la tarea.","CLAUDE.md no es un repositorio de memoria de las conversaciones, sino un archivo de instrucciones que proporciona repetidamente la estructura, los comandos y las reglas del proyecto."],"content_markdown":"Claude Code es una herramienta de desarrollo con agentes que permite usar Claude de Anthropic desde el terminal y los repositorios de código. No se limita a responder con fragmentos de código, sino que, dentro del ámbito autorizado, explora y edita archivos, ejecuta comandos, realiza pruebas y analiza errores.\n\nEsta guía explica no solo el procedimiento de instalación, sino también cómo configurar los permisos de forma segura, los criterios para elegir el modelo adecuado para cada tarea y cómo gestionar el contexto y las instrucciones del proyecto. Como los comandos y los entornos compatibles pueden actualizarse, al realizar la instalación se deben consultar los comandos más recientes que aparezcan en la documentación oficial de configuración.\n\n## Tres formas de programar con Claude\n\nCada modalidad se diferencia más por el **grado de interacción de la herramienta con el proyecto local** que por los resultados obtenidos.\n\n| Modalidad | Acceso a archivos locales | Ejecución de comandos | Tareas adecuadas | Principales limitaciones |\n|---|---:|---:|---|---|\n| Claude web | Limitado de forma predeterminada | No disponible de forma predeterminada | Preguntas, explicación de código, ejemplos breves, revisión de diseños | Para aplicar directamente las respuestas al proyecto es necesario copiarlas y ejecutarlas |\n| Aplicación de escritorio de Claude | Depende de las funciones, las integraciones y la aprobación del usuario | Depende de las funciones y las integraciones | Trabajo con documentos, tareas centradas en conversaciones, integraciones locales compatibles | No controla automáticamente el repositorio y el shell en todos los entornos de instalación |\n| Claude Code | Posible dentro del ámbito del proyecto | Posible según la política de permisos | Modificación de repositorios reales, pruebas, refactorización, proyectos a largo plazo | Como utiliza permisos del shell y de archivos, requiere revisión y configuración de seguridad |\n\nClaude Code no es solo para desarrolladores profesionales. Sin embargo, como puede realizar operaciones que afectan al sistema, tales como eliminar archivos, instalar dependencias o ejecutar scripts de compilación, cuanto menos experimentado sea el usuario, más recomendable es utilizar el modo Plan junto con un sistema de control de versiones.\n\n## Requisitos previos a la instalación\n\nPrepara primero los siguientes elementos.\n\n- Consulta en la documentación oficial los sistemas operativos y entornos de shell compatibles actualmente.\n- Prepara una cuenta de Anthropic con acceso a Claude Code o un entorno de autenticación y facturación compatible.\n- Si se trata de un proyecto existente, crea un repositorio Git y confirma los cambios o haz una copia de seguridad.\n- Identifica los comandos de pruebas, compilación y lint del proyecto.\n- Puedes usar un editor como VS Code, pero VS Code en sí no es un requisito de Claude Code.\n\nEn Windows, debes comprobar las condiciones para PowerShell, el símbolo del sistema o WSL indicadas en la documentación oficial. Si el equipo está administrado por una organización, comprueba primero los permisos de instalación, el proxy, el firewall y las políticas de tratamiento de datos.\n\n## Instalación y primera ejecución de Claude Code\n\n### 1. Consultar el comando oficial de instalación\n\nEn la documentación oficial de configuración de Claude Code, selecciona el método de instalación más reciente correspondiente a tu sistema operativo. Como los métodos y comandos de instalación pueden cambiar, es preferible basarse en la documentación oficial en lugar de reutilizar directamente comandos de vídeos o blogs antiguos.\n\n### 2. Abrir la carpeta del proyecto\n\nCrea una carpeta nueva o desplázate a un repositorio existente. Si usas VS Code, puedes abrir la carpeta mediante **File \u003e Open Folder** y después seleccionar **Terminal \u003e New Terminal**.\n\n```bash\ncd path/to/project\nclaude\n```\n\nAl ejecutar `claude`, se mostrará el proceso de autenticación en el navegador si es necesario. Tras iniciar sesión, Claude Code analiza el proyecto tomando como referencia el directorio de trabajo actual. Por eso, es más seguro ejecutarlo desde la raíz del repositorio real que desde el directorio de inicio o una carpeta superior con un ámbito excesivamente amplio.\n\n### 3. Empezar con una primera solicitud pequeña\n\nEn lugar de encargarle desde el principio la creación de toda una aplicación, divide el alcance de la siguiente manera.\n\n1. Pídele que lea y resuma la estructura del proyecto.\n2. Pídele que presente un plan de implementación y los archivos que se modificarán.\n3. Pídele que implemente una sola función.\n4. Pídele que ejecute pruebas o análisis estáticos.\n5. Pídele que explique los cambios y los riesgos pendientes.\n\nEjemplo de solicitud:\n\n```text\nLee este repositorio y resume su estructura y cómo se ejecuta. No modifiques todavía\nningún archivo; propón únicamente un plan para añadir un formulario de inicio de sesión\ny los archivos que habría que modificar.\n```\n\n## Modos de permisos y configuración segura\n\nLos textos que identifican los modos de permisos de Claude Code pueden variar según la versión y la pantalla de configuración. Los conceptos de modo más representativos utilizados en la configuración oficial son los siguientes.\n\n| Modo | Funcionamiento | Situación recomendada |\n|---|---|---|\n| Default | Solicita aprobación cuando es necesario al modificar archivos o ejecutar herramientas potencialmente peligrosas | Trabajo cotidiano habitual |\n| Accept Edits | Permite automáticamente la edición de archivos, aunque otras herramientas pueden seguir requiriendo una aprobación independiente | Trabajo de desarrollo en el que los archivos modificados se siguen mediante Git |\n| Plan | Se centra en el análisis y la planificación sin modificar archivos ni ejecutar comandos | Comprensión del repositorio, revisión de diseños, primer paso para principiantes |\n| Don't Ask | Política no interactiva que rechaza las operaciones no autorizadas previamente en vez de preguntar | Entornos automatizados o uso de una lista de permisos estricta |\n| Bypass Permissions | Omite el proceso de comprobación de permisos | Debe evitarse salvo en entornos con riesgos controlados, como contenedores aislados |\n\n`Shift+Tab` puede utilizarse para cambiar entre algunos estados de permisos disponibles en la interfaz interactiva. Sin embargo, no todas las configuraciones se recorren necesariamente solo con este atajo, por lo que debes consultar el estado mostrado en la pantalla actual y la documentación oficial sobre permisos.\n\n### Flujo recomendado para principiantes\n\n1. Obtén un plan de implementación en el modo Plan.\n2. Revisa los archivos que se modificarán y los comandos que se ejecutarán.\n3. Realiza la implementación en el modo Default o Accept Edits.\n4. Comprueba personalmente la instalación de paquetes, los cambios en bases de datos y los comandos de eliminación.\n5. Revisa `git diff` y los resultados de las pruebas antes de confirmar los cambios.\n\nBypass Permissions no es simplemente un modo rápido y cómodo. Puede agravar los daños causados por comandos incorrectos, un acceso excesivo a archivos o la exposición de información confidencial, por lo que no debe utilizarse como opción predeterminada en un ordenador personal o un repositorio importante.\n\n## Selección de modelos y gestión de costes\n\nEn una sesión interactiva, puedes usar `/model` para consultar o cambiar los modelos disponibles en tu cuenta y entorno. Como los nombres, alias y disponibilidad de los modelos pueden variar según el momento y el método de autenticación, es preferible no automatizar presuponiendo una lista fija de modelos.\n\n```text\n/model\n```\n\nLos principios generales de selección son los siguientes.\n\n| Tipo de tarea | Criterio de selección |\n|---|---|\n| Diseño de arquitectura, depuración difícil, razonamiento complejo | Considerar prioritariamente un modelo de alto rendimiento |\n| Implementación general, escritura de pruebas, desarrollo repetitivo | Considerar un modelo con un buen equilibrio entre rendimiento y velocidad |\n| Búsquedas simples, conversión de formatos, modificaciones breves | Si la cuenta lo permite, considerar un modelo rápido y económico |\n\nOpus, Sonnet y Haiku son nombres que distinguen familias de modelos, pero las versiones exactas de cada familia y su compatibilidad con Claude Code pueden cambiar continuamente. En algunos entornos se pueden usar alias como `/model sonnet`, pero lo más preciso es comprobar las opciones que aparecen en la sesión actual.\n\n### Métodos prácticos para reducir costes\n\n- Ejecuta la herramienta desde el subdirectorio necesario para reducir la exploración de archivos innecesarios.\n- Indica de una sola vez el objetivo, las restricciones y los criterios de finalización para reducir el trabajo repetido.\n- En lugar de proporcionar registros completos de gran tamaño, incluye el contexto del error y el procedimiento para reproducirlo.\n- Excluye rutas innecesarias, como archivos generados, resultados de compilación y conjuntos de datos grandes.\n- Cuando terminen la exploración y el diseño, organiza la sesión en torno a una nueva unidad de trabajo.\n- Para tareas sencillas, utiliza dentro de las opciones disponibles un modelo más rápido y económico.\n- Si el uso se basa en API, consulta conjuntamente los comandos relacionados con los costes y la información de uso de Anthropic Console.\n\nLa estructura de costes varía según el método de inicio de sesión. Las cuentas con suscripción a Claude pueden estar sujetas a límites de uso según el plan, mientras que el uso mediante la API de Anthropic o proveedores de servicios en la nube puede facturarse por tokens. Por tanto, no debe suponerse que un modelo concreto sea siempre gratuito o que cueste siempre una cantidad fija.\n\n## Gestión de la ventana de contexto\n\nLa ventana de contexto es el conjunto de conversaciones, contenido de archivos, resultados de herramientas, instrucciones del proyecto y demás información que el modelo puede consultar al generar la respuesta actual. No equivale a una memoria permanente ni al simple número de caracteres de la conversación.\n\n### Comandos principales\n\n| Comando | Finalidad | Precaución |\n|---|---|---|\n| `/context` | Consultar cómo se utiliza el contexto | La forma de mostrarlo puede variar según la versión |\n| `/compact` | Resumir la conversación actual para liberar espacio de contexto | Los detalles pueden abreviarse durante el proceso de resumen |\n| `/clear` | Borrar el historial de la conversación actual e iniciar una nueva | Primero deben documentarse las decisiones necesarias y el estado del trabajo |\n\nNo existe un criterio universal según el cual la calidad de las respuestas disminuya necesariamente cuando el contexto supera un porcentaje determinado. Claude Code también puede realizar una compactación automática, y la calidad depende no solo de la cantidad de información incluida, sino también de su relevancia, redundancia y posibles contradicciones.\n\nConsidera organizar el contexto si observas las siguientes señales.\n\n- Omite repetidamente requisitos que ya se han modificado.\n- Confunde un estado antiguo de los archivos con el estado actual.\n- Mezcla las condiciones de funciones diferentes.\n- Lee innecesariamente el mismo archivo una y otra vez.\n- La conversación y la salida de las herramientas se han vuelto excesivamente extensas.\n\nNo es necesario ejecutar `/clear` obligatoriamente cada vez que se completa una función. En su lugar, puedes reducir la pérdida de información documentando las decisiones completadas, los elementos pendientes y los resultados de las pruebas en la documentación o el registro de trabajo del proyecto antes de pasar a una nueva sesión.\n\n## Gestión de las instrucciones del proyecto con CLAUDE.md\n\nEl nombre del archivo suele escribirse como `CLAUDE.md`, con letras mayúsculas. Este archivo no constituye la memoria permanente de Claude, sino un documento de instrucciones persistentes que Claude Code consulta dentro del proyecto. Si se incluye en el repositorio, permite compartir las instrucciones con el equipo, pero no debe contener información confidencial.\n\nEl comando `/init` permite analizar el proyecto y comenzar a crear un archivo `CLAUDE.md` inicial, cuyo resultado siempre debe ser revisado por una persona.\n\n### Contenido recomendable\n\n- Objetivo y funciones principales del proyecto\n- Lenguajes, frameworks y versiones del entorno de ejecución\n- Función de los directorios y módulos importantes\n- Comandos de instalación, servidor de desarrollo, pruebas, lint y compilación\n- Estilo del código y reglas de nomenclatura\n- Archivos que no deben modificarse o código generado\n- Principios de seguridad y tratamiento de datos personales\n- Criterios de finalización del trabajo y procedimientos de verificación\n\nEjemplo:\n\n```markdown\n# Instrucciones del proyecto\n\n## Stack\n- Se utilizan TypeScript y Node.js.\n- El gestor de paquetes es pnpm.\n\n## Comandos\n- Pruebas: `pnpm test`\n- Lint: `pnpm lint`\n- Compilación: `pnpm build`\n\n## Reglas\n- No leer ni confirmar `.env` ni credenciales reales.\n- Presentar primero un plan antes de cambiar el formato de respuesta de una API pública.\n- Añadir las pruebas correspondientes cuando se modifique una función.\n```\n\n`CLAUDE.md` no tiene un límite máximo oficial de 200 líneas. Sin embargo, unas instrucciones demasiado extensas consumen contexto y pueden generar conflictos entre reglas, por lo que resulta práctico mantenerlas breves y concretas. Las explicaciones detalladas del diseño deben separarse en otros documentos, indicando las rutas necesarias.\n\n## Procedimiento de trabajo recomendado\n\nEl procedimiento básico para mejorar a la vez la seguridad y la calidad de los resultados es el siguiente.\n\n1. Comprueba que el estado de Git esté limpio y crea una copia de seguridad o una confirmación.\n2. Ejecuta Claude Code desde la raíz del repositorio.\n3. Revisa `CLAUDE.md` y la documentación existente.\n4. En el modo Plan, solicita el objetivo, los archivos que se modificarán y el plan de pruebas.\n5. Divide las tareas grandes en unidades pequeñas que puedan revisarse.\n6. Implementa una unidad cada vez en el modo Default o Accept Edits.\n7. Revisa personalmente los comandos de instalación, eliminación, despliegue y modificación de datos.\n8. Comprueba las pruebas, el lint, la verificación de tipos y `git diff`.\n9. Documenta el estado final y los problemas pendientes.\n10. Si la siguiente tarea no está relacionada con la conversación anterior, inicia una nueva sesión con `/clear`.\n\n## Lista de comprobación de seguridad\n\n- Evita que `.env`, las claves de API, los certificados y los datos de clientes queden expuestos en el prompt o el repositorio.\n- No experimentes directamente en servidores y bases de datos de producción.\n- Lee antes de ejecutar comandos del shell o scripts de instalación cuyo origen desconozcas.\n- Revisa también las dependencias, las licencias, las vulnerabilidades de seguridad y las pruebas del código escrito por Claude.\n- En tareas importantes, aplica el principio de privilegios mínimos y utiliza un entorno de desarrollo aislado.\n- Comprueba mediante Git diff los cambios generados automáticamente y asegúrate de que una persona asuma la responsabilidad final.\n\nClaude Code puede acortar considerablemente el proceso de desarrollo, pero no es un mecanismo automático que garantice la exactitud y la seguridad de los resultados. La forma más fiable de utilizarlo consiste en combinar instrucciones claras, permisos limitados, unidades pequeñas de cambio, pruebas automatizadas y revisión humana.","content_html":"\u003cp\u003eClaude Code es una herramienta de desarrollo con agentes que permite usar Claude de Anthropic desde el terminal y los repositorios de código. No se limita a responder con fragmentos de código, sino que, dentro del ámbito autorizado, explora y edita archivos, ejecuta comandos, realiza pruebas y analiza errores.\u003c/p\u003e\n\u003cp\u003eEsta guía explica no solo el procedimiento de instalación, sino también cómo configurar los permisos de forma segura, los criterios para elegir el modelo adecuado para cada tarea y cómo gestionar el contexto y las instrucciones del proyecto. Como los comandos y los entornos compatibles pueden actualizarse, al realizar la instalación se deben consultar los comandos más recientes que aparezcan en la documentación oficial de configuración.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#tres-formas-de-programar-con-claude\" class=\"anchor\" id=\"tres-formas-de-programar-con-claude\"\u003e\u003c/a\u003eTres formas de programar con Claude\u003c/h2\u003e\n\u003cp\u003eCada modalidad se diferencia más por el \u003cstrong\u003egrado de interacción de la herramienta con el proyecto local\u003c/strong\u003e que por los resultados obtenidos.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eModalidad\u003c/th\u003e\n\u003cth\u003eAcceso a archivos locales\u003c/th\u003e\n\u003cth\u003eEjecución de comandos\u003c/th\u003e\n\u003cth\u003eTareas adecuadas\u003c/th\u003e\n\u003cth\u003ePrincipales limitaciones\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modalidad\"\u003eClaude web\u003c/td\u003e\n\u003ctd data-label=\"Acceso a archivos locales\"\u003eLimitado de forma predeterminada\u003c/td\u003e\n\u003ctd data-label=\"Ejecución de comandos\"\u003eNo disponible de forma predeterminada\u003c/td\u003e\n\u003ctd data-label=\"Tareas adecuadas\"\u003ePreguntas, explicación de código, ejemplos breves, revisión de diseños\u003c/td\u003e\n\u003ctd data-label=\"Principales limitaciones\"\u003ePara aplicar directamente las respuestas al proyecto es necesario copiarlas y ejecutarlas\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modalidad\"\u003eAplicación de escritorio de Claude\u003c/td\u003e\n\u003ctd data-label=\"Acceso a archivos locales\"\u003eDepende de las funciones, las integraciones y la aprobación del usuario\u003c/td\u003e\n\u003ctd data-label=\"Ejecución de comandos\"\u003eDepende de las funciones y las integraciones\u003c/td\u003e\n\u003ctd data-label=\"Tareas adecuadas\"\u003eTrabajo con documentos, tareas centradas en conversaciones, integraciones locales compatibles\u003c/td\u003e\n\u003ctd data-label=\"Principales limitaciones\"\u003eNo controla automáticamente el repositorio y el shell en todos los entornos de instalación\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modalidad\"\u003eClaude Code\u003c/td\u003e\n\u003ctd data-label=\"Acceso a archivos locales\"\u003ePosible dentro del ámbito del proyecto\u003c/td\u003e\n\u003ctd data-label=\"Ejecución de comandos\"\u003ePosible según la política de permisos\u003c/td\u003e\n\u003ctd data-label=\"Tareas adecuadas\"\u003eModificación de repositorios reales, pruebas, refactorización, proyectos a largo plazo\u003c/td\u003e\n\u003ctd data-label=\"Principales limitaciones\"\u003eComo utiliza permisos del shell y de archivos, requiere revisión y configuración de seguridad\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eClaude Code no es solo para desarrolladores profesionales. Sin embargo, como puede realizar operaciones que afectan al sistema, tales como eliminar archivos, instalar dependencias o ejecutar scripts de compilación, cuanto menos experimentado sea el usuario, más recomendable es utilizar el modo Plan junto con un sistema de control de versiones.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#requisitos-previos-a-la-instalaci%C3%B3n\" class=\"anchor\" id=\"requisitos-previos-a-la-instalación\"\u003e\u003c/a\u003eRequisitos previos a la instalación\u003c/h2\u003e\n\u003cp\u003ePrepara primero los siguientes elementos.\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eConsulta en la documentación oficial los sistemas operativos y entornos de shell compatibles actualmente.\u003c/li\u003e\n\u003cli\u003ePrepara una cuenta de Anthropic con acceso a Claude Code o un entorno de autenticación y facturación compatible.\u003c/li\u003e\n\u003cli\u003eSi se trata de un proyecto existente, crea un repositorio Git y confirma los cambios o haz una copia de seguridad.\u003c/li\u003e\n\u003cli\u003eIdentifica los comandos de pruebas, compilación y lint del proyecto.\u003c/li\u003e\n\u003cli\u003ePuedes usar un editor como VS Code, pero VS Code en sí no es un requisito de Claude Code.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eEn Windows, debes comprobar las condiciones para PowerShell, el símbolo del sistema o WSL indicadas en la documentación oficial. Si el equipo está administrado por una organización, comprueba primero los permisos de instalación, el proxy, el firewall y las políticas de tratamiento de datos.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#instalaci%C3%B3n-y-primera-ejecuci%C3%B3n-de-claude-code\" class=\"anchor\" id=\"instalación-y-primera-ejecución-de-claude-code\"\u003e\u003c/a\u003eInstalación y primera ejecución de Claude Code\u003c/h2\u003e\n\u003ch3\u003e\n\u003ca href=\"#1-consultar-el-comando-oficial-de-instalaci%C3%B3n\" class=\"anchor\" id=\"1-consultar-el-comando-oficial-de-instalación\"\u003e\u003c/a\u003e1. Consultar el comando oficial de instalación\u003c/h3\u003e\n\u003cp\u003eEn la documentación oficial de configuración de Claude Code, selecciona el método de instalación más reciente correspondiente a tu sistema operativo. Como los métodos y comandos de instalación pueden cambiar, es preferible basarse en la documentación oficial en lugar de reutilizar directamente comandos de vídeos o blogs antiguos.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#2-abrir-la-carpeta-del-proyecto\" class=\"anchor\" id=\"2-abrir-la-carpeta-del-proyecto\"\u003e\u003c/a\u003e2. Abrir la carpeta del proyecto\u003c/h3\u003e\n\u003cp\u003eCrea una carpeta nueva o desplázate a un repositorio existente. Si usas VS Code, puedes abrir la carpeta mediante \u003cstrong\u003eFile \u0026gt; Open Folder\u003c/strong\u003e y después seleccionar \u003cstrong\u003eTerminal \u0026gt; New Terminal\u003c/strong\u003e.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003ecd\u003c/span\u003e\u003cspan\u003e path/to/project\n\u003c/span\u003e\u003cspan\u003eclaude\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eAl ejecutar \u003ccode\u003eclaude\u003c/code\u003e, se mostrará el proceso de autenticación en el navegador si es necesario. Tras iniciar sesión, Claude Code analiza el proyecto tomando como referencia el directorio de trabajo actual. Por eso, es más seguro ejecutarlo desde la raíz del repositorio real que desde el directorio de inicio o una carpeta superior con un ámbito excesivamente amplio.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#3-empezar-con-una-primera-solicitud-peque%C3%B1a\" class=\"anchor\" id=\"3-empezar-con-una-primera-solicitud-pequeña\"\u003e\u003c/a\u003e3. Empezar con una primera solicitud pequeña\u003c/h3\u003e\n\u003cp\u003eEn lugar de encargarle desde el principio la creación de toda una aplicación, divide el alcance de la siguiente manera.\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003ePídele que lea y resuma la estructura del proyecto.\u003c/li\u003e\n\u003cli\u003ePídele que presente un plan de implementación y los archivos que se modificarán.\u003c/li\u003e\n\u003cli\u003ePídele que implemente una sola función.\u003c/li\u003e\n\u003cli\u003ePídele que ejecute pruebas o análisis estáticos.\u003c/li\u003e\n\u003cli\u003ePídele que explique los cambios y los riesgos pendientes.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003eEjemplo de solicitud:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eLee este repositorio y resume su estructura y cómo se ejecuta. No modifiques todavía\n\u003c/span\u003e\u003cspan\u003eningún archivo; propón únicamente un plan para añadir un formulario de inicio de sesión\n\u003c/span\u003e\u003cspan\u003ey los archivos que habría que modificar.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch2\u003e\n\u003ca href=\"#modos-de-permisos-y-configuraci%C3%B3n-segura\" class=\"anchor\" id=\"modos-de-permisos-y-configuración-segura\"\u003e\u003c/a\u003eModos de permisos y configuración segura\u003c/h2\u003e\n\u003cp\u003eLos textos que identifican los modos de permisos de Claude Code pueden variar según la versión y la pantalla de configuración. Los conceptos de modo más representativos utilizados en la configuración oficial son los siguientes.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eModo\u003c/th\u003e\n\u003cth\u003eFuncionamiento\u003c/th\u003e\n\u003cth\u003eSituación recomendada\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003eDefault\u003c/td\u003e\n\u003ctd data-label=\"Funcionamiento\"\u003eSolicita aprobación cuando es necesario al modificar archivos o ejecutar herramientas potencialmente peligrosas\u003c/td\u003e\n\u003ctd data-label=\"Situación recomendada\"\u003eTrabajo cotidiano habitual\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003eAccept Edits\u003c/td\u003e\n\u003ctd data-label=\"Funcionamiento\"\u003ePermite automáticamente la edición de archivos, aunque otras herramientas pueden seguir requiriendo una aprobación independiente\u003c/td\u003e\n\u003ctd data-label=\"Situación recomendada\"\u003eTrabajo de desarrollo en el que los archivos modificados se siguen mediante Git\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003ePlan\u003c/td\u003e\n\u003ctd data-label=\"Funcionamiento\"\u003eSe centra en el análisis y la planificación sin modificar archivos ni ejecutar comandos\u003c/td\u003e\n\u003ctd data-label=\"Situación recomendada\"\u003eComprensión del repositorio, revisión de diseños, primer paso para principiantes\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003eDon't Ask\u003c/td\u003e\n\u003ctd data-label=\"Funcionamiento\"\u003ePolítica no interactiva que rechaza las operaciones no autorizadas previamente en vez de preguntar\u003c/td\u003e\n\u003ctd data-label=\"Situación recomendada\"\u003eEntornos automatizados o uso de una lista de permisos estricta\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003eBypass Permissions\u003c/td\u003e\n\u003ctd data-label=\"Funcionamiento\"\u003eOmite el proceso de comprobación de permisos\u003c/td\u003e\n\u003ctd data-label=\"Situación recomendada\"\u003eDebe evitarse salvo en entornos con riesgos controlados, como contenedores aislados\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003e\u003ccode\u003eShift+Tab\u003c/code\u003e puede utilizarse para cambiar entre algunos estados de permisos disponibles en la interfaz interactiva. Sin embargo, no todas las configuraciones se recorren necesariamente solo con este atajo, por lo que debes consultar el estado mostrado en la pantalla actual y la documentación oficial sobre permisos.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#flujo-recomendado-para-principiantes\" class=\"anchor\" id=\"flujo-recomendado-para-principiantes\"\u003e\u003c/a\u003eFlujo recomendado para principiantes\u003c/h3\u003e\n\u003col\u003e\n\u003cli\u003eObtén un plan de implementación en el modo Plan.\u003c/li\u003e\n\u003cli\u003eRevisa los archivos que se modificarán y los comandos que se ejecutarán.\u003c/li\u003e\n\u003cli\u003eRealiza la implementación en el modo Default o Accept Edits.\u003c/li\u003e\n\u003cli\u003eComprueba personalmente la instalación de paquetes, los cambios en bases de datos y los comandos de eliminación.\u003c/li\u003e\n\u003cli\u003eRevisa \u003ccode\u003egit diff\u003c/code\u003e y los resultados de las pruebas antes de confirmar los cambios.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003eBypass Permissions no es simplemente un modo rápido y cómodo. Puede agravar los daños causados por comandos incorrectos, un acceso excesivo a archivos o la exposición de información confidencial, por lo que no debe utilizarse como opción predeterminada en un ordenador personal o un repositorio importante.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#selecci%C3%B3n-de-modelos-y-gesti%C3%B3n-de-costes\" class=\"anchor\" id=\"selección-de-modelos-y-gestión-de-costes\"\u003e\u003c/a\u003eSelección de modelos y gestión de costes\u003c/h2\u003e\n\u003cp\u003eEn una sesión interactiva, puedes usar \u003ccode\u003e/model\u003c/code\u003e para consultar o cambiar los modelos disponibles en tu cuenta y entorno. Como los nombres, alias y disponibilidad de los modelos pueden variar según el momento y el método de autenticación, es preferible no automatizar presuponiendo una lista fija de modelos.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e/model\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eLos principios generales de selección son los siguientes.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eTipo de tarea\u003c/th\u003e\n\u003cth\u003eCriterio de selección\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Tipo de tarea\"\u003eDiseño de arquitectura, depuración difícil, razonamiento complejo\u003c/td\u003e\n\u003ctd data-label=\"Criterio de selección\"\u003eConsiderar prioritariamente un modelo de alto rendimiento\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Tipo de tarea\"\u003eImplementación general, escritura de pruebas, desarrollo repetitivo\u003c/td\u003e\n\u003ctd data-label=\"Criterio de selección\"\u003eConsiderar un modelo con un buen equilibrio entre rendimiento y velocidad\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Tipo de tarea\"\u003eBúsquedas simples, conversión de formatos, modificaciones breves\u003c/td\u003e\n\u003ctd data-label=\"Criterio de selección\"\u003eSi la cuenta lo permite, considerar un modelo rápido y económico\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eOpus, Sonnet y Haiku son nombres que distinguen familias de modelos, pero las versiones exactas de cada familia y su compatibilidad con Claude Code pueden cambiar continuamente. En algunos entornos se pueden usar alias como \u003ccode\u003e/model sonnet\u003c/code\u003e, pero lo más preciso es comprobar las opciones que aparecen en la sesión actual.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#m%C3%A9todos-pr%C3%A1cticos-para-reducir-costes\" class=\"anchor\" id=\"métodos-prácticos-para-reducir-costes\"\u003e\u003c/a\u003eMétodos prácticos para reducir costes\u003c/h3\u003e\n\u003cul\u003e\n\u003cli\u003eEjecuta la herramienta desde el subdirectorio necesario para reducir la exploración de archivos innecesarios.\u003c/li\u003e\n\u003cli\u003eIndica de una sola vez el objetivo, las restricciones y los criterios de finalización para reducir el trabajo repetido.\u003c/li\u003e\n\u003cli\u003eEn lugar de proporcionar registros completos de gran tamaño, incluye el contexto del error y el procedimiento para reproducirlo.\u003c/li\u003e\n\u003cli\u003eExcluye rutas innecesarias, como archivos generados, resultados de compilación y conjuntos de datos grandes.\u003c/li\u003e\n\u003cli\u003eCuando terminen la exploración y el diseño, organiza la sesión en torno a una nueva unidad de trabajo.\u003c/li\u003e\n\u003cli\u003ePara tareas sencillas, utiliza dentro de las opciones disponibles un modelo más rápido y económico.\u003c/li\u003e\n\u003cli\u003eSi el uso se basa en API, consulta conjuntamente los comandos relacionados con los costes y la información de uso de Anthropic Console.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eLa estructura de costes varía según el método de inicio de sesión. Las cuentas con suscripción a Claude pueden estar sujetas a límites de uso según el plan, mientras que el uso mediante la API de Anthropic o proveedores de servicios en la nube puede facturarse por tokens. Por tanto, no debe suponerse que un modelo concreto sea siempre gratuito o que cueste siempre una cantidad fija.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#gesti%C3%B3n-de-la-ventana-de-contexto\" class=\"anchor\" id=\"gestión-de-la-ventana-de-contexto\"\u003e\u003c/a\u003eGestión de la ventana de contexto\u003c/h2\u003e\n\u003cp\u003eLa ventana de contexto es el conjunto de conversaciones, contenido de archivos, resultados de herramientas, instrucciones del proyecto y demás información que el modelo puede consultar al generar la respuesta actual. No equivale a una memoria permanente ni al simple número de caracteres de la conversación.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#comandos-principales\" class=\"anchor\" id=\"comandos-principales\"\u003e\u003c/a\u003eComandos principales\u003c/h3\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eComando\u003c/th\u003e\n\u003cth\u003eFinalidad\u003c/th\u003e\n\u003cth\u003ePrecaución\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Comando\"\u003e\u003ccode\u003e/context\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"Finalidad\"\u003eConsultar cómo se utiliza el contexto\u003c/td\u003e\n\u003ctd data-label=\"Precaución\"\u003eLa forma de mostrarlo puede variar según la versión\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Comando\"\u003e\u003ccode\u003e/compact\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"Finalidad\"\u003eResumir la conversación actual para liberar espacio de contexto\u003c/td\u003e\n\u003ctd data-label=\"Precaución\"\u003eLos detalles pueden abreviarse durante el proceso de resumen\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Comando\"\u003e\u003ccode\u003e/clear\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"Finalidad\"\u003eBorrar el historial de la conversación actual e iniciar una nueva\u003c/td\u003e\n\u003ctd data-label=\"Precaución\"\u003ePrimero deben documentarse las decisiones necesarias y el estado del trabajo\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eNo existe un criterio universal según el cual la calidad de las respuestas disminuya necesariamente cuando el contexto supera un porcentaje determinado. Claude Code también puede realizar una compactación automática, y la calidad depende no solo de la cantidad de información incluida, sino también de su relevancia, redundancia y posibles contradicciones.\u003c/p\u003e\n\u003cp\u003eConsidera organizar el contexto si observas las siguientes señales.\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eOmite repetidamente requisitos que ya se han modificado.\u003c/li\u003e\n\u003cli\u003eConfunde un estado antiguo de los archivos con el estado actual.\u003c/li\u003e\n\u003cli\u003eMezcla las condiciones de funciones diferentes.\u003c/li\u003e\n\u003cli\u003eLee innecesariamente el mismo archivo una y otra vez.\u003c/li\u003e\n\u003cli\u003eLa conversación y la salida de las herramientas se han vuelto excesivamente extensas.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eNo es necesario ejecutar \u003ccode\u003e/clear\u003c/code\u003e obligatoriamente cada vez que se completa una función. En su lugar, puedes reducir la pérdida de información documentando las decisiones completadas, los elementos pendientes y los resultados de las pruebas en la documentación o el registro de trabajo del proyecto antes de pasar a una nueva sesión.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#gesti%C3%B3n-de-las-instrucciones-del-proyecto-con-claudemd\" class=\"anchor\" id=\"gestión-de-las-instrucciones-del-proyecto-con-claudemd\"\u003e\u003c/a\u003eGestión de las instrucciones del proyecto con CLAUDE.md\u003c/h2\u003e\n\u003cp\u003eEl nombre del archivo suele escribirse como \u003ccode\u003eCLAUDE.md\u003c/code\u003e, con letras mayúsculas. Este archivo no constituye la memoria permanente de Claude, sino un documento de instrucciones persistentes que Claude Code consulta dentro del proyecto. Si se incluye en el repositorio, permite compartir las instrucciones con el equipo, pero no debe contener información confidencial.\u003c/p\u003e\n\u003cp\u003eEl comando \u003ccode\u003e/init\u003c/code\u003e permite analizar el proyecto y comenzar a crear un archivo \u003ccode\u003eCLAUDE.md\u003c/code\u003e inicial, cuyo resultado siempre debe ser revisado por una persona.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#contenido-recomendable\" class=\"anchor\" id=\"contenido-recomendable\"\u003e\u003c/a\u003eContenido recomendable\u003c/h3\u003e\n\u003cul\u003e\n\u003cli\u003eObjetivo y funciones principales del proyecto\u003c/li\u003e\n\u003cli\u003eLenguajes, frameworks y versiones del entorno de ejecución\u003c/li\u003e\n\u003cli\u003eFunción de los directorios y módulos importantes\u003c/li\u003e\n\u003cli\u003eComandos de instalación, servidor de desarrollo, pruebas, lint y compilación\u003c/li\u003e\n\u003cli\u003eEstilo del código y reglas de nomenclatura\u003c/li\u003e\n\u003cli\u003eArchivos que no deben modificarse o código generado\u003c/li\u003e\n\u003cli\u003ePrincipios de seguridad y tratamiento de datos personales\u003c/li\u003e\n\u003cli\u003eCriterios de finalización del trabajo y procedimientos de verificación\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eEjemplo:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e# Instrucciones del proyecto\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e## Stack\n\u003c/span\u003e\u003cspan\u003e- Se utilizan TypeScript y Node.js.\n\u003c/span\u003e\u003cspan\u003e- El gestor de paquetes es pnpm.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e## Comandos\n\u003c/span\u003e\u003cspan\u003e- Pruebas: \u003c/span\u003e\u003cspan\u003e`pnpm test`\n\u003c/span\u003e\u003cspan\u003e- Lint: \u003c/span\u003e\u003cspan\u003e`pnpm lint`\n\u003c/span\u003e\u003cspan\u003e- Compilación: \u003c/span\u003e\u003cspan\u003e`pnpm build`\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e## Reglas\n\u003c/span\u003e\u003cspan\u003e- No leer ni confirmar \u003c/span\u003e\u003cspan\u003e`.env`\u003c/span\u003e\u003cspan\u003e ni credenciales reales.\n\u003c/span\u003e\u003cspan\u003e- Presentar primero un plan antes de cambiar el formato de respuesta de una API pública.\n\u003c/span\u003e\u003cspan\u003e- Añadir las pruebas correspondientes cuando se modifique una función.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003e\u003ccode\u003eCLAUDE.md\u003c/code\u003e no tiene un límite máximo oficial de 200 líneas. Sin embargo, unas instrucciones demasiado extensas consumen contexto y pueden generar conflictos entre reglas, por lo que resulta práctico mantenerlas breves y concretas. Las explicaciones detalladas del diseño deben separarse en otros documentos, indicando las rutas necesarias.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#procedimiento-de-trabajo-recomendado\" class=\"anchor\" id=\"procedimiento-de-trabajo-recomendado\"\u003e\u003c/a\u003eProcedimiento de trabajo recomendado\u003c/h2\u003e\n\u003cp\u003eEl procedimiento básico para mejorar a la vez la seguridad y la calidad de los resultados es el siguiente.\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003eComprueba que el estado de Git esté limpio y crea una copia de seguridad o una confirmación.\u003c/li\u003e\n\u003cli\u003eEjecuta Claude Code desde la raíz del repositorio.\u003c/li\u003e\n\u003cli\u003eRevisa \u003ccode\u003eCLAUDE.md\u003c/code\u003e y la documentación existente.\u003c/li\u003e\n\u003cli\u003eEn el modo Plan, solicita el objetivo, los archivos que se modificarán y el plan de pruebas.\u003c/li\u003e\n\u003cli\u003eDivide las tareas grandes en unidades pequeñas que puedan revisarse.\u003c/li\u003e\n\u003cli\u003eImplementa una unidad cada vez en el modo Default o Accept Edits.\u003c/li\u003e\n\u003cli\u003eRevisa personalmente los comandos de instalación, eliminación, despliegue y modificación de datos.\u003c/li\u003e\n\u003cli\u003eComprueba las pruebas, el lint, la verificación de tipos y \u003ccode\u003egit diff\u003c/code\u003e.\u003c/li\u003e\n\u003cli\u003eDocumenta el estado final y los problemas pendientes.\u003c/li\u003e\n\u003cli\u003eSi la siguiente tarea no está relacionada con la conversación anterior, inicia una nueva sesión con \u003ccode\u003e/clear\u003c/code\u003e.\u003c/li\u003e\n\u003c/ol\u003e\n\u003ch2\u003e\n\u003ca href=\"#lista-de-comprobaci%C3%B3n-de-seguridad\" class=\"anchor\" id=\"lista-de-comprobación-de-seguridad\"\u003e\u003c/a\u003eLista de comprobación de seguridad\u003c/h2\u003e\n\u003cul\u003e\n\u003cli\u003eEvita que \u003ccode\u003e.env\u003c/code\u003e, las claves de API, los certificados y los datos de clientes queden expuestos en el prompt o el repositorio.\u003c/li\u003e\n\u003cli\u003eNo experimentes directamente en servidores y bases de datos de producción.\u003c/li\u003e\n\u003cli\u003eLee antes de ejecutar comandos del shell o scripts de instalación cuyo origen desconozcas.\u003c/li\u003e\n\u003cli\u003eRevisa también las dependencias, las licencias, las vulnerabilidades de seguridad y las pruebas del código escrito por Claude.\u003c/li\u003e\n\u003cli\u003eEn tareas importantes, aplica el principio de privilegios mínimos y utiliza un entorno de desarrollo aislado.\u003c/li\u003e\n\u003cli\u003eComprueba mediante Git diff los cambios generados automáticamente y asegúrate de que una persona asuma la responsabilidad final.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eClaude Code puede acortar considerablemente el proceso de desarrollo, pero no es un mecanismo automático que garantice la exactitud y la seguridad de los resultados. La forma más fiable de utilizarlo consiste en combinar instrucciones claras, permisos limitados, unidades pequeñas de cambio, pruebas automatizadas y revisión humana.\u003c/p\u003e\n","tags":["Claude Code","Anthropic","Programación con IA","Herramientas de desarrollo","CLI"],"faqs":[{"question":"¿Es absolutamente necesario VS Code para usar Claude Code?","answer":"No. Usar el terminal integrado de VS Code resulta práctico, pero no es un requisito indispensable. Si se dispone de un sistema operativo y un entorno de terminal compatibles según la documentación oficial, se puede ejecutar `claude` desde el directorio del proyecto."},{"question":"¿Cuál es la principal diferencia entre Claude web y Claude Code?","answer":"Mientras que Claude web ofrece principalmente conversaciones y respuestas sobre código, Claude Code puede leer y modificar archivos reales del proyecto y ejecutar herramientas del terminal dentro de los límites autorizados. Esto aumenta la productividad, pero exige gestionar con cuidado los permisos sobre archivos y comandos."},{"question":"¿Con qué modo de permisos deben empezar los principiantes?","answer":"Un flujo seguro consiste en revisar primero el plan de cambios y los archivos afectados en el modo Plan y, después, implementarlos en el modo Default o Accept Edits. Es preferible no aprobar automáticamente tareas como instalar paquetes, eliminar archivos o modificar bases de datos."},{"question":"¿El modo Don't Ask ejecuta automáticamente todas las tareas?","answer":"No. Don't Ask suele ser una política que rechaza las tareas que no se hayan autorizado previamente, en lugar de solicitar permiso al usuario. Debe distinguirse de Bypass Permissions, que omite todas las comprobaciones de permisos."},{"question":"¿Cómo se cambia el modelo en Claude Code?","answer":"En una sesión interactiva, se introduce `/model` para consultar y seleccionar los modelos disponibles en la cuenta y el entorno actuales. Como las versiones y los alias de los modelos pueden cambiar, debe tomarse como referencia el menú actual en vez de una lista antigua."},{"question":"¿Usar Sonnet siempre es la opción menos costosa?","answer":"No siempre. El coste no solo depende de la tarifa del modelo, sino también del contexto de entrada, la longitud de la salida, el número de reintentos, el uso de la caché y los métodos de autenticación y facturación. Para tareas sencillas puede resultar más conveniente un modelo más económico, pero, en tareas difíciles, un modelo de mayor rendimiento también puede reducir el coste total al evitar trabajo adicional."},{"question":"¿Cuál es la diferencia entre /clear y /compact?","answer":"`/clear` se utiliza para borrar el historial de la conversación actual y comenzar como si fuera una sesión nueva. `/compact` resume la conversación existente para liberar espacio de contexto, aunque algunos detalles pueden quedar abreviados durante el proceso de resumen."},{"question":"¿La calidad de las respuestas empeora necesariamente si el contexto supera el 80%?","answer":"No existe un umbral oficial universal de ese tipo. Además del porcentaje utilizado, la calidad se ve afectada por la relevancia, la repetición y los conflictos de la información, así como por el tamaño de la salida de las herramientas. Es razonable comprobar el estado con `/context` y organizarlo cuando aparezcan señales como la confusión de requisitos antiguos."},{"question":"¿Cuál es el nombre de archivo correcto: claude.md o CLAUDE.md?","answer":"En la documentación oficial, el archivo de instrucciones del proyecto aparece como `CLAUDE.md`. Dado que algunos sistemas operativos y herramientas distinguen entre mayúsculas y minúsculas, lo más seguro es utilizar exactamente la grafía oficial."},{"question":"¿CLAUDE.md debe tener 200 líneas o menos?","answer":"No existe un límite máximo oficial de 200 líneas. Sin embargo, las instrucciones extensas consumen más contexto y pueden provocar conflictos entre reglas, por lo que conviene redactar de forma concisa los comandos y las restricciones principales y separar las explicaciones detalladas en documentos independientes."},{"question":"¿Se pueden incluir claves de API o contraseñas en CLAUDE.md?","answer":"No. Como CLAUDE.md puede incorporarse al repositorio y compartirse con el equipo, no deben registrarse en él credenciales reales, datos de clientes ni claves secretas. La información confidencial debe gestionarse mediante variables de entorno o sistemas de gestión de secretos aprobados por la organización."},{"question":"¿Cuándo debe utilizarse Bypass Permissions?","answer":"Solo debe considerarse con cautela en entornos controlados, como contenedores aislados o entornos de pruebas desechables, donde sea posible limitar los daños derivados de la omisión de permisos. Es aconsejable no utilizarlo como modo predeterminado en ordenadores personales, repositorios importantes ni entornos de producción."}],"sources":[{"url":"https://code.claude.com/docs/en/overview","title":"Descripción general de Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/setup","title":"Configuración de Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/permissions","title":"Permisos de Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/model-config","title":"Configuración del modelo de Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/costs","title":"Costes de Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/memory","title":"Memoria de Claude Code y CLAUDE.md","type":"source"},{"url":"https://code.claude.com/docs/en/interactive-mode","title":"Modo interactivo de Claude Code","type":"source"}],"images":[{"id":617,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0NCwicHVyIjoiYmxvYl9pZCJ9fQ==--d808896af034f2719d1a1a65b061553a991d3196/ai-572421ed.webp","is_representative":true,"generation_method":"ai_image","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"코드가 표시된 노트북과 파일 트리, 권한 방패, 연결된 작업 흐름을 그린 일러스트","caption":"코드 작업에서 파일, 권한, 컨텍스트가 연결되는 구조를 시각화합니다.","description":null},"en":{"alt":"Illustration of a coding laptop, file tree, permission shield, and connected workflow","caption":"The diagram visualizes how files, permissions, and context connect in a coding workflow.","description":null},"ja":{"alt":"コード画面のノートPC、ファイルツリー、権限シールド、連携ワークフローのイラスト","caption":"コーディング作業でファイル、権限、コンテキストが連携する仕組みを示しています。","description":null},"es":{"alt":"Ilustración de un portátil con código, árbol de archivos, escudo de permisos y flujo conectado","caption":"El diagrama muestra cómo se conectan archivos, permisos y contexto en un flujo de programación.","description":null},"id":{"alt":"Ilustrasi laptop berkode, pohon file, perisai izin, dan alur kerja yang terhubung","caption":"Diagram ini memvisualisasikan hubungan file, izin, dan konteks dalam alur kerja pemrograman.","description":null},"pt":{"alt":"Ilustração de notebook com código, árvore de arquivos, escudo de permissões e fluxo conectado","caption":"O diagrama mostra como arquivos, permissões e contexto se conectam em um fluxo de programação.","description":null},"zh-hant":{"alt":"顯示程式碼的筆電、檔案樹、權限盾牌與連接工作流程的插圖","caption":"此圖呈現程式開發流程中檔案、權限與上下文的連結方式。","description":null},"de":{"alt":"Illustration eines Laptops mit Code, Dateibaum, Berechtigungsschild und vernetztem Arbeitsablauf","caption":"Die Grafik zeigt, wie Dateien, Berechtigungen und Kontext in einem Programmierablauf verbunden sind.","description":null}}},{"id":618,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NzQ1MCwicHVyIjoiYmxvYl9pZCJ9fQ==--e073adddcaf8ad6bf81bc0a0b0ca1d385d6d6a38/ai-c02b920d.webp","is_representative":false,"generation_method":"ai_image","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"중앙 서버에 코드, 권한 잠금, 워크플로, 문서, 데이터베이스, 클라우드가 연결된 그림","caption":"Claude Code의 코드 실행, 권한, 컨텍스트와 데이터 연결 구조를 시각화한 그림입니다.","description":null},"en":{"alt":"Central server linked to code, permission lock, workflow, documents, databases, and cloud services","caption":"The illustration visualizes how Claude Code connects execution, permissions, context, and data.","description":null},"ja":{"alt":"中央サーバーにコード、権限ロック、ワークフロー、文書、データベース、クラウドが接続された図","caption":"Claude Codeにおけるコード実行、権限、コンテキスト、データの連携を表しています。","description":null},"es":{"alt":"Servidor central conectado con código, permisos, flujos, documentos, bases de datos y nube","caption":"La ilustración representa la conexión entre ejecución, permisos, contexto y datos en Claude Code.","description":null},"id":{"alt":"Server pusat terhubung ke kode, kunci izin, alur kerja, dokumen, basis data, dan cloud","caption":"Ilustrasi ini menunjukkan hubungan eksekusi, izin, konteks, dan data dalam Claude Code.","description":null},"pt":{"alt":"Servidor central ligado a código, bloqueio de permissões, fluxos, documentos, bancos de dados e nuvem","caption":"A ilustração mostra a conexão entre execução, permissões, contexto e dados no Claude Code.","description":null},"zh-hant":{"alt":"中央伺服器連接程式碼、權限鎖、工作流程、文件、資料庫與雲端服務","caption":"此圖呈現 Claude Code 中程式執行、權限、上下文與資料的連接關係。","description":null},"de":{"alt":"Zentraler Server mit Code, Zugriffssperre, Abläufen, Dokumenten, Datenbanken und Cloud-Diensten","caption":"Die Grafik zeigt das Zusammenspiel von Ausführung, Berechtigungen, Kontext und Daten in Claude Code.","description":null}}}],"published_at":"2026-08-13T12:12:59+09:00","updated_at":"2026-08-13T12:12:59+09:00","license":"cc_by","translation_status":"reviewed","available_locales":["ko","en","ja","es"],"data_locales":["ko","en","ja","es","id","pt","zh-hant","de"],"url":"https://injoys.com/es/articles/claude-code-setup-permissions-models-context-guide"}