claude-code-tune-kit
Deja de usar Claude Code como venía en la caja. Semáforo de contexto, modo conciso, 4 hooks que bloquean comandos destructivos y secretos, estilo de salida s…
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up claude-code-tune-kit (git-clone project) into my current project. Found on https://claudeers.com/claude-code-tune-kit Repo: https://github.com/Carlos-Dominguez-faber/claude-code-tune-kit Homepage/docs: — Detected install method: git-clone → git clone https://github.com/Carlos-Dominguez-faber/claude-code-tune-kit Category: devtools. Platforms: api, mobile. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
git clone https://github.com/Carlos-Dominguez-faber/claude-code-tune-kit
// compatibility
| Platforms | api, mobile |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | Shell |
Tune Kit
Deja de usar Claude Code como venía en la caja.
Semáforo de contexto, modo conciso, cuatro paredes que no se negocian
y un script que audita tu instalación y te dice qué te falta.
$ bash cc-doctor.sh
cc-doctor · Tune Kit
3 · Los settings
✓ outputStyle: Concise
✓ línea de estado activa
✓ remoto conectado al arrancar
4 · Hooks y permisos
✕ cero hooks
Todo lo que le pides en el CLAUDE.md es una sugerencia.
✕ nada bloquea la lectura de tus .env
5 · Lo que se come tu ventana
▲ transcripts: 433M, sin política de limpieza
Define "cleanupPeriodDays": 30.
Veredicto
10 bien 3 por revisar 2 pendientes
Empieza por las ✕ — ahí es donde estás dejando tiempo, dinero o seguridad en la mesa.
Instalación
git clone https://github.com/Carlos-Dominguez-faber/claude-code-tune-kit.git tune-kit
cd tune-kit
bash instalar.sh # respalda lo tuyo antes de tocar nada
bash cc-doctor.sh # y te dice cómo quedaste
El instalador fusiona, no sobrescribe. Respalda tu settings.json con fecha y hora, y en el
merge tus valores previos siempre ganan: si ya tenías tu propio outputStyle o tu allowlist, se
quedan como estaban.
[!IMPORTANT] Claude Code lee la configuración al arrancar. Cierra tus sesiones abiertas y abre una nueva, o no vas a ver ningún cambio.
Instalación manual, si prefieres no correr el script
mkdir -p ~/.claude/hooks ~/.claude/output-styles
cp hooks/*.sh ~/.claude/hooks/
cp statusline.sh ~/.claude/
cp output-styles/*.md ~/.claude/output-styles/
chmod +x ~/.claude/hooks/*.sh ~/.claude/statusline.sh
Después copia a mano los bloques de settings.json que quieras dentro de tu
~/.claude/settings.json. No lo sobrescribas entero si ya tenías cosas ahí.
Qué trae
| Pieza | Qué hace |
|---|---|
settings.json | Modo conciso, semáforo, remoto, permisos y los cuatro hooks, ya cableados. |
statusline.sh | Modelo, contexto quemado, carpeta, rama, límites de 5 h y 7 d, y el costo de la sesión. |
hooks/freno-de-mano.sh | Cancela comandos destructivos antes de que se ejecuten. |
hooks/blindaje-env.sh | Nada escribe encima de un archivo de credenciales. |
hooks/formatter.sh | Prettier, ruff, gofmt o rustfmt corren solos tras cada edición. |
hooks/aviso.sh | Te avisa cuando termina — pero solo si el turno fue largo. |
output-styles/sin-humo.md | Sin halagos, comandos sin placeholders, el error exacto completo. |
ccglm.zsh | Levanta Claude Code con GLM sin tocar tu configuración global. |
cc-doctor.sh | Audita tu instalación y te dice qué te falta. No cambia nada. |
La idea
Todo el kit está montado sobre una sola distinción:
| Dónde vive | Qué tan fuerte es | |
|---|---|---|
| Una sugerencia | CLAUDE.md | La lee, la considera, y a veces se le olvida. |
| Una regla | settings.json | Cambia el arnés. No depende de que el modelo se acuerde. |
| Una pared | hooks/ | Código tuyo que corre antes de la acción y la cancela. No se negocia. |
Cuando algo no puede pasar —borrar la base, subir un secreto, forzar un push— no lo pidas por escrito. Ponle una pared.
El semáforo
🧠 Opus 5 | 🟡 ctx 63% | 📁 forge-cloud ⎇ main* | ⏳ 5h:12% 7d:41% | $4.73 | ✂️ Concise
La línea no sirve de nada si no sabes qué hacer con el número. Esa es la regla:
| Contexto | Qué haces | |
|---|---|---|
| 🟢 | menos de 50 % | Sigue. No hagas nada. |
| 🟡 | 50 – 80 % | Cierra el hilo actual. No abras frente nuevo. |
| 🔴 | más de 80 % | Commit + PROGRESS.md + /clear. Nunca /compact a ciegas. |
Marca (z.ai) cuando no estás corriendo en Claude, y /1M cuando traes la ventana extendida —
porque un 40 % en 1M no significa lo mismo que un 40 % en 200k.
Los cuatro hooks
| Hook | Evento | Matcher | Qué corta |
|---|---|---|---|
| Freno de mano | PreToolUse | Bash | Borrados de sistema, push --force, --no-verify, SQL destructivo, curl | sh, chmod 777 |
| Blindaje | PreToolUse | Edit|Write|NotebookEdit | Escrituras sobre .env, llaves privadas, service accounts |
| Formatter | PostToolUse | Edit|Write | — (formatea, no bloquea) |
| El avisito | UserPromptSubmit + Stop | — | — (te avisa, no bloquea) |
Los dos primeros salen con exit 2: la llamada se cancela y el motivo le llega a Claude por stderr, así que se corrige solo en vez de quedarse trabado.
Qué bloquea y qué no
Un hook de seguridad que se evade con comillas da falsa seguridad. Uno que bloquea
rm -rf build/ se desinstala el primer día. El freno de mano tokeniza el comando en vez de
buscar patrones en la cadena, así que aguanta las dos cosas:
| Muere | Pasa |
|---|---|
rm -rf / · rm -r -f / · rm -rfv /usr/local | rm -rf build dist |
rm -rf "/usr/local" · rm -rf '/etc' | rm -rf ./node_modules |
rm --recursive --force /usr · rm -fR /System | rm -rf /tmp/cache-build |
cd /tmp && rm -rf / | rm -rf ~/Developer/proyecto/dist |
rm -rf ~ · rm -rf $HOME · rm -rf * | rm -rf /Users/ana/proyecto/.next |
git push --force · git push -f | git push --force-with-lease |
git commit --no-verify | echo "no uses --no-verify" >> CONTRIBUTING.md |
psql -c "DROP TABLE users" | grep -rn "DROP TABLE" migrations/ |
curl -sL x.sh | sh | curl -sL api.com/x -o data.json |
echo FOO=1 > .env | echo FOO=1 >> .env |
Los 70 casos están en test/test.sh:
bash test/test.sh
Si te encierras afuera
claude --settings '{"disableAllHooks": true}'
O "disableAllHooks": true en tu settings.json. Apaga hooks y línea de estado de un golpe.
GLM sin secuestrar tu configuración
El error que comete todo el mundo es meter el bloque env en ~/.claude/settings.json. Eso
manda todas tus sesiones al modelo alterno, incluidas las del cliente en producción que
abriste el martes sin acordarte. ccglm.zsh lo resuelve con una función de shell:
escribes claude y es Claude, escribes ccglm y es GLM.
[!WARNING] El endpoint para Claude Code es
https://api.z.ai/api/anthropic. Si apuntas al de otras herramientas (/api/coding/paas/v4) no obtienes un error de conexión: obtienes1113 Insufficient Balancey te empieza a cobrar por token en vez de consumir tu plan. Y la variable esANTHROPIC_BASE_URL— varios tutoriales dicenANTHROPIC_API_BASE, que Claude Code no lee.
Requisitos
| Claude Code | 2.1.237 o superior — el estilo Concise no existe antes. claude update |
| jq | Los hooks y la línea de estado lo necesitan. brew install jq |
| Sistema | macOS, Linux o WSL. La voz del avisito usa say (macOS) o notify-send (Linux). |
Desinstalar
rm -f ~/.claude/hooks/{freno-de-mano,blindaje-env,formatter,aviso}.sh
rm -f ~/.claude/statusline.sh ~/.claude/output-styles/sin-humo.md
Y restaura tu configuración anterior desde el respaldo que dejó el instalador:
ls ~/.claude/settings.json.antes-del-tune-kit.*
Notas
/output-styleya no existe: deprecado en2.1.73, eliminado en2.1.91. Hoy el estilo se cambia con/configo editando la claveoutputStyle.- El estilo de salida vive en el system prompt, así que aplica después de
/clearo de abrir una sesión nueva. autoCompactWindowacepta un conteo de tokens de 100 000 a 1 000 000 — no una fracción. El kit no lo define a propósito: el default de tu modelo es mejor que un número inventado. Si quieres compactar antes, usa/autocompact 150k.- Nunca escribas una API key dentro de
settings.json. Ese archivo se respalda, se comparte y se sube a repos. Usa variables de entorno.
Licencia
MIT — ver LICENSE.
Del taller de Imperio Agéntico · Carlos Domínguez
// faq
What is claude-code-tune-kit?
Deja de usar Claude Code como venía en la caja. Semáforo de contexto, modo conciso, 4 hooks que bloquean comandos destructivos y secretos, estilo de salida sin humo, GLM sin secuestrar tu config — y cc-doctor.sh, que audita tu instalación y te dice qué te falta.. It is open-source on GitHub.
Is claude-code-tune-kit free to use?
claude-code-tune-kit is open-source under the MIT license, so it is free to use.
What category does claude-code-tune-kit belong to?
claude-code-tune-kit is listed under devtools in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/claude-code-tune-kit)
// retro hit counter
[](https://claudeers.com/claude-code-tune-kit)
// reviews
// guestbook
// related in Developer Tools
🔓The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…
🔓Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
🔓Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA
🔓AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…