Cómo usar Claude Code — 4 cosas que hacer después del tutorial inicial

Hay muchos artículos que explican cómo usar Claude Code, pero la mayoría terminan en «instalarlo y ejecutarlo por primera vez». Los problemas reales empiezan después: escribir las mismas instrucciones cada vez, demasiados diálogos de confirmación y alcanzar el límite de uso de 5 horas a mitad del trabajo. Esta página empieza donde terminan los artículos introductorios y resuelve esos 3 problemas en orden.

Como premisa, Claude Code no es una herramienta para pegar código en un chat, sino un agente que vive dentro del repositorio en el terminal. Lee y modifica archivos, ejecuta pruebas y hasta hace commits. Por eso lo primero que debes hacer no es aprender a usarlo, sino darle las reglas del proyecto.

Los 3 primeros pasos: iniciar, /init y hacer una solicitud concreta

Justo después de instalarlo solo merece la pena hacer estas 3 cosas. En especial, si omites el segundo paso, /init, tendrás que repetir la misma explicación 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 genera CLAUDE.md. El contenido generado es un borrador, así que no lo dejes tal cual: corrígelo siempre a mano. La siguiente sección explica qué debe contener.

CLAUDE.md: escribir una sola vez lo que explicas siempre

CLAUDE.md es un archivo Markdown situado en la raíz del proyecto y se carga automáticamente en cada sesión. Solo debes escribir aquí «lo que no se puede entender leyendo el código».

# CLAUDE.md — プロジェクトのルート、git にコミットする

## コマンド
- テスト: npm test（1 ファイルだけなら npm test -- path/to/file）
- 型チェック: npx tsc --noEmit
- Lint: npm run lint

## 決めごと
- 日付は必ず date-fns。moment は使わない。
- API ハンドラは app/api/**/route.ts のみ。lib に書かない。
- コミットメッセージは日本語、prefix は feat / fix / docs。

## 触ってはいけない場所
- db/migrations/ — 生成物。手で編集しない。

También está claro qué es mejor no escribir. La estructura de directorios y las explicaciones de las funciones se entienden leyendo el código, así que no son necesarias. Como CLAUDE.md se incluye en cada solicitud, si lo haces largo consumirás tokens inevitablemente: mantenlo breve y limita su contenido a las reglas. Si haces commit en git, las mismas reglas se aplicarán a todo el equipo.

Permisos: reducir las confirmaciones, pero sin omitir demasiado

Se pide confirmación cada vez que se modifica un archivo o se ejecuta un comando. Es un mecanismo de seguridad, así que la solución práctica no es eliminarlo todo, sino «permitir solo comandos de lectura y verificación». Si eliges «permitir siempre» durante la sesión, se recuerda; si lo escribes en .claude/settings.json, puedes fijarlo por proyecto.

También existe una opción para omitir todas las confirmaciones, pero elimina la confirmación incluso para borrar o hacer push al remoto. Solo debes usarla dentro de contenedores que puedas desechar si se rompen o en árboles de trabajo temporales. Los criterios y el uso seguro están reunidos en cuándo usar --dangerously-skip-permissions.

Comandos personalizados: no escribir la misma solicitud cada vez

Las tareas para las que casi siempre haces la misma solicitud, como revisiones, comprobaciones previas a un lanzamiento o dar formato a mensajes de commit, pueden convertirse en comandos. Solo tienes que colocar Markdown en .claude/commands/.

# .claude/commands/review.md — 置くだけで /review として使える
指定されたファイルをレビューして、次の 3 点だけ指摘してください。

1. 実際に落ちる条件があるバグ（再現手順を添える）
2. 既存のユーティリティで置き換えられる重複
3. テストが無い分岐

スタイルの好みは指摘しないでください。

Así, al escribir /review src/api/user.ts recibirás una revisión con los mismos criterios. Si haces commit en git, puedes compartirlo con el equipo y mantener los propios criterios de revisión en el repositorio. En Claude Code workflows se explican en inglés y con detalle los patrones de comandos útiles en la práctica.

Cómo continuar cuando se cierra la ventana de 5 horas

El límite de la suscripción se gestiona mediante una ventana móvil de 5 horas y puede cerrarse por la tarde, justo cuando el trabajo avanza. Cambiar a un plan superior no la abre en ese momento. En la práctica hay 3 opciones.

La tercera opción se puede hacer sin cancelar la suscripción. Solo mientras estén configuradas las 2 líneas siguientes se cobra por uso; al eliminar las variables, vuelves a la suscripción original.

# 5 時間ウィンドウが閉じても作業を続けるための 2 行。
# この変数が設定されている間だけ従量課金になり、消せば元のサブスクに戻る。
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Claude Code の既定モデルと opus エイリアスは最新の Opus を、sonnet エイリアスは
# Kunavo が提供していない Sonnet 5.5 を指す。/model sonnet や opusplan の実行
# フェーズ、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

# 補助的な処理を一番安いモデルに逃がす 1 行（毎セッション効く）
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Las tarifas se cargan 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 la factura de los meses sin uso es 0. Calculamos qué resulta más barato entre la suscripción y el cobro por uso, el coste real por paso y el punto de equilibrio en precios de Claude Code. El funcionamiento de la ventana está explicado en límites de Claude Pro, y la elección del modelo predeterminado en diferencias entre Opus y Sonnet.

Formas de solicitar que mejoran o empeoran la precisión

Por último, esta es la parte donde más se nota la habilidad al usarlo. Incluye el nombre y la ruta del archivo para reducir los tokens usados en la exploración y obtener resultados más rápidos y precisos: «corrige la validación» es peor que «sustituye por zod la validación de src/api/user.ts».

Y no envíes una solicitud grande de una sola vez. Si la divides en cambio → prueba → siguiente cambio, queda claro dónde volver aunque falle algo. La resolución de errores está explicada en páginas específicas como errores 401 de Claude Code.

Si quieres probar el mismo enfoque con el agente del lado de OpenAI, en cómo usar Codex explicamos cómo ejecutarlo con una clave de API sin un plan de ChatGPT.

Preguntas frecuentes