Hay muchos artículos sobre cómo usar Claude Code, pero la mayoría termina «después de instalarlo y recibir la primera respuesta». El verdadero bloqueo viene después: repetir las mismas explicaciones, ver demasiadas ventanas de confirmación y que la ventana de uso de 5 horas se cierre en plena tarea. Este artículo empieza justo donde terminan los textos introductorios y organiza esos tres problemas uno por uno.
Ajustemos una premisa. Claude Code no es una herramienta para pegar código en una ventana de chat, sino un agente que reside en el repositorio desde el terminal. Lee y modifica archivos, ejecuta pruebas e incluso hace commits. Por eso lo primero no es memorizar su uso, sino transmitirle las reglas del proyecto.
Los tres primeros pasos: ejecutar, /init y hacer una solicitud concreta
Justo después de instalarlo, solo merece la pena hacer estas tres cosas. En especial, si omites /init tendrás que repetir las mismas explicaciones en todas las sesiones posteriores.
# 1. 프로젝트 디렉터리에서 실행한다 (이게 전제 조건입니다)
cd ~/work/my-app
claude
# 2. 첫 명령은 /init — 저장소를 읽고 CLAUDE.md를 만들어 줍니다
> /init
# 3. 이후엔 한국어로 그냥 부탁하면 됩니다. 파일 경로를 붙일수록 정확해집니다
> src/api/user.ts의 검증 로직을 zod로 바꾸고 테스트도 같이 고쳐줘/init lee el repositorio y crea CLAUDE.md. El contenido generado es un borrador, así que no lo dejes tal cual: revísalo y ordénalo manualmente. La siguiente sección trata sobre su contenido.
CLAUDE.md — escribir una sola vez lo que explicabas cada vez
CLAUDE.md es un archivo Markdown que se coloca en la raíz del proyecto y se lee automáticamente en cada sesión. Aquí solo debes incluir «lo que no se puede saber leyendo el código».
# CLAUDE.md — 프로젝트 루트에 두고 git에 커밋합니다
## 명령어
- 테스트: npm test (파일 하나만: npm test -- path/to/file)
- 타입 검사: npx tsc --noEmit
- 린트: npm run lint
## 규칙
- 날짜는 date-fns만 사용. moment 금지.
- API 핸들러는 app/api/**/route.ts에만 둔다.
- 커밋 메시지는 한국어, prefix는 feat / fix / docs.
## 건드리면 안 되는 곳
- db/migrations/ — 생성물. 직접 수정 금지.También está claro lo que no debes escribir. La estructura de directorios y las descripciones de funciones son innecesarias porque aparecen al leer el código. CLAUDE.md se incluye en cada solicitud, así que cuanto más largo sea, más tokens consumirá: breve y solo con las reglas. Si lo confirmas en git, las mismas reglas se aplican a todo el equipo.
Permisos — reducir las confirmaciones sin desactivarlas todas
Aparece una ventana de confirmación cada vez que se modifica un archivo o se ejecuta un comando. Como es una medida de seguridad, lo práctico es permitir solo operaciones de lectura y verificación en lugar de desactivarla por completo. Si eliges «Permitir siempre» durante la sesión, se recuerda; si lo escribes en .claude/settings.json, queda fijado para todo el proyecto.
También existe una opción para omitir todas las confirmaciones, pero permite sin confirmación incluso borrar y hacer push remoto. Úsala solo dentro de un contenedor o árbol de trabajo desechable que puedas abandonar aunque se rompa. El criterio se resume en cuándo usar --dangerously-skip-permissions.
Comandos personalizados — no escribir la misma solicitud cada vez
Las tareas que solicitas casi siempre de la misma manera, como revisiones, comprobaciones previas a una versión o limpieza de mensajes de commit, pueden convertirse en comandos. Solo tienes que colocar un Markdown en .claude/commands/.
# .claude/commands/review.md — 파일만 두면 /review로 쓸 수 있습니다
지정된 파일을 리뷰하고 다음 세 가지만 지적하세요.
1. 실제로 실패하는 조건이 있는 버그 (재현 방법 포함)
2. 기존 유틸리티로 대체 가능한 중복
3. 테스트가 없는 분기
스타일 취향은 지적하지 마세요.Así puedes ejecutar una revisión desde la misma perspectiva con /review src/api/user.ts. Si lo confirmas en git, el equipo lo comparte y los propios criterios de revisión pueden vivir en el repositorio. Encontrarás una explicación más detallada en inglés sobre la forma de los comandos utilizados en la práctica en Claude Code workflows.
Cómo continuar cuando se cierra la ventana de uso
El uso de la suscripción se gestiona mediante una ventana móvil de 5 horas y puede cerrarse justo por la tarde, cuando más trabajo se acumula. Cambiar a un plan superior tampoco la abre inmediatamente. En la práctica, hay tres opciones.
| Opción | Situación adecuada |
|---|---|
| Esperar a que se abra la ventana | No hay fecha de entrega. Puedes posponerlo varias horas |
| Cambiar al plan superior | Ocurre todos los días. El límite se queda corto de forma constante |
| Cambiar solo esa tarea a una clave de API | Hay que terminar hoy. Solo ocurre unas pocas veces al mes |
La tercera opción funciona sin cancelar la suscripción. Solo se factura según el uso mientras estén configuradas las dos líneas siguientes; al eliminar las variables, vuelves a la suscripción. Si no tienes una clave, empieza por obtener una clave de API de Claude.
# 사용량 창이 닫혀도 작업을 이어가는 두 줄.
# 이 변수가 설정된 동안에만 종량제로 청구되고, 지우면 구독으로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# 클로드 코드의 기본 모델과 opus 별칭은 최신 Opus를, sonnet 별칭은 Sonnet 5.5를
# 가리킵니다. Kunavo가 제공하지 않는 모델(Sonnet 5.5, 아직 들어오지 않은 새 Opus)을
# 요청해 404가 나지 않도록 모델을 고정합니다. sonnet을 고정하지 않으면 /model sonnet,
# opusplan의 실행 단계, model: sonnet으로 지정한 서브에이전트가 404를 받습니다.
# opus 별칭에 고정한 Opus 5.5는 Claude Code v2.1.280 이상이 필요합니다
# (이전 버전이면 먼저 claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
# 보조 작업을 가장 싼 모델로 넘기는 한 줄 (매 세션 효과가 있습니다)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Las tarifas se leen directamente del catálogo: Claude Sonnet 5 cuesta $1.40 / $7.00 por 1M de tokens, y Claude Haiku 4.5 cuesta $0.70 / $3.50. Se descuenta del saldo prepago, por lo que no hay cargos en los meses en que no trabajas. El cálculo del punto de equilibrio para saber qué es más barato, la suscripción o el pago por uso, está en precios de Claude Code; la solución cuando el pago se bloquea con una tarjeta coreana está en precios y pagos de Claude API, y la estructura de la propia ventana de uso está en límite de Claude Pro.
Solicitudes que mejoran y empeoran los resultados
Por último, aquí es donde más se nota la diferencia en el uso. Si incluyes la ruta del archivo, reduces los tokens empleados en la exploración y el resultado es más rápido y preciso: «corrige la lógica de validación» frente a «cambia a zod la lógica de validación de src/api/user.ts».
Además, no lances una tarea grande de una sola vez. Si la divides en cambio → prueba → siguiente cambio, tendrás un punto claro al que volver cuando algo falle. La forma de distinguir los errores se explica en el resumen de errores de Claude Code.
Si quieres usar un agente de programación del lado de OpenAI de la misma manera, cómo usar Codex explica cómo ejecutar Codex CLI con una clave de API sin un plan de ChatGPT.
Preguntas frecuentes
¿Qué es lo primero que hay que hacer al usar Claude Code?
Ejecuta claude en el directorio del proyecto y ejecuta /init una vez. /init lee el repositorio y crea CLAUDE.md. Este archivo contiene cómo ejecutar las pruebas, las reglas del proyecto y las rutas que no deben modificarse, y se lee automáticamente en todas las sesiones posteriores. Si lo omites, tendrás que volver a escribir las mismas explicaciones cada vez.
¿Qué debe incluir CLAUDE.md?
Solo «lo que tendrías que explicar cada vez». Los comandos para ejecutar pruebas y comprobaciones de tipos, las reglas específicas del proyecto (usar esta biblioteca, no colocar lógica en esta capa) y las rutas de artefactos que no deben modificarse son suficientes. En cambio, no incluyas estructuras de directorios ni descripciones de funciones que puedan deducirse leyendo el código. CLAUDE.md se incluye en cada solicitud, así que cuanto más largo sea, más aumentará el coste sin mejorar la precisión.
¿Qué hago si alcanzo el límite de uso de 5 horas?
Hay tres opciones: esperar a que se abra de nuevo la ventana, cambiar a un plan superior o pasar solo esa tarea a una clave de API. La tercera opción requiere únicamente las dos líneas ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN y no es necesario cancelar la suscripción. Solo se factura según el uso mientras las variables estén configuradas; al eliminarlas, vuelves al funcionamiento original. Cambiar a un plan superior tampoco abre la ventana inmediatamente, así que en un día con una fecha límite la tercera opción es la más rápida.
¿Se pueden reducir las ventanas de confirmación que preguntan cada vez si se puede ejecutar algo?
Sí. Si eliges «Permitir siempre» durante la sesión, la elección se recuerda; si lo escribes en .claude/settings.json, queda fijado para todo el proyecto. Permitir únicamente operaciones de lectura y verificación, como npm test o git status, reduce mucho el número de confirmaciones. También existe una opción para omitirlas todas, pero permite sin confirmación incluso borrar y hacer push, así que úsala solo dentro de un contenedor que puedas desechar.
¿Cómo creo comandos personalizados?
Solo tienes que colocar un archivo Markdown en .claude/commands/. Si creas review.md, se invoca con /review. Basta con que el contenido sea un prompt en lenguaje natural. Si lo confirmas en git, todo el equipo podrá usar el mismo comando, por lo que puedes guardar en el repositorio tareas que siempre solicitas de la misma manera, como criterios de revisión o comprobaciones previas a una versión.
¿Cuál es el truco más fiable para mejorar los resultados?
Especificar las rutas de los archivos. «Corrige la lógica de validación» es menos eficaz que «cambia a zod la lógica de validación de src/api/user.ts»: usa menos tokens para explorar y es más rápido y preciso. Otro consejo es no lanzar una tarea grande de una sola vez; si la divides en cambio → prueba → siguiente cambio, tendrás un punto claro al que volver si algo falla.