claude.sh

Código de Claude reescrito como un script bash. ~1,500 líneas. Cero paquetes npm.

Por qué

El código original de Claude tiene ~380,000 líneas de TypeScript con 266 dependencias npm. Esto hace el mismo trabajo básico en bash con solo curl y jq.

Características

Transmisión en tiempo real vía tubería FIFO — el texto aparece a medida que Claude lo genera
6 herramientas: Bash, Read, Edit, Write, Glob, Grep
Encadenamiento de herramientas — hasta 25 llamadas a herramientas por turno
Solicitud de permiso — pregunta antes de ejecutar comandos no seguros (y/n/a)
Carga de CLAUDE.md — lee instrucciones del proyecto desde archivos CLAUDE.md en la jerarquía de directorios
Contexto consciente de Git — rama, estado y commits recientes en el prompt del sistema
Guardar/reanudar sesión — guarda automáticamente al salir, reanuda con --resume
Reintentos con retroceso — reintentos exponenciales en límites de tasa 429/529
Seguimiento de costos — totales por turno y por sesión
Indicador giratorio — con los verbos originales del spinner (Clauding, Flibbertigibbeting, etc.)
Comandos slash — /help, /cost, /model, /clear, /save, /resume, /commit, /diff
Modo pipe — echo "explain this" | ./claude.sh

Instalación

git clone https://github.com/jdcodes1/claude.sh.git
cd claude.sh
chmod +x claude.sh

Dependencias

curl
jq
Opcional: rg (ripgrep) para una mejor búsqueda
Opcional: python3 para la herramienta de edición

Las versiones en tiempo de ejecución están fijadas en .tool-versions. Instálalas con mise:

mise install

Uso

export ANTHROPIC_API_KEY="sk-ant-..."
./claude.sh

Variables de Entorno

| Variable | Predeterminado | Descripción | | --- | --- | --- | | ANTHROPIC_API_KEY | (obligatorio) | Tu clave API de Anthropic | | CLAUDE_MODEL | claude-sonnet-4-6 | Modelo a utilizar | | CLAUDE_MAX_TOKENS | 8192 | Máximo de tokens de salida | | ANTHROPIC_API_URL | https://api.anthropic.com | URL base de la API | | CLAUDE_SH_PERMISSIONS | ask | Modo de permiso: ask, allow o deny |

Comandos

/help      — Show help
/cost      — Show session cost
/model     — Show/change model
/clear     — Clear conversation
/save      — Save current session
/resume    — List/resume saved sessions
/commit    — Auto-generate a git commit
/diff      — Show git diff
/quit      — Exit

Reanudar una sesión

# List saved sessions
./claude.sh
/resume
Resume by number
/resume 1
Resume from CLI
./claude.sh --resume 20240101-120000-12345

Arquitectura

claude.sh          # Main REPL loop, slash commands, process_turn()
lib/
  api.sh           # Anthropic API client, SSE streaming via FIFO, retry
  json.sh          # Message construction, session persistence, CLAUDE.md, git context
  tools.sh         # 6 tool implementations + permission system
  tui.sh           # ANSI colors, spinner, display helpers

Cómo Funciona

Leer la entrada del usuario
Construir la solicitud JSON con jq (mensajes, herramientas, prompt del sistema)
Transmitir la respuesta vía curl a través de una tubería FIFO
Analizar eventos SSE línea por línea, imprimir deltas de texto en tiempo real
Cuando lleguen bloques tool_use, ejecutar las herramientas
Alimentar los resultados de las herramientas como mensajes
Repetir hasta que Claude deje de llamar herramientas

Comparación

| | claude.sh | Claude Code (TypeScript) | | --- | --- | --- | | Líneas de código | ~1,500 | ~380,000 | | Dependencias | curl, jq | 266 paquetes npm | | Tamaño binario | 0 (script) | ~200MB node_modules | | Tiempo de inicio | Instantáneo | ~500ms |

Pruebas

Las pruebas usan bats (Sistema Automatizado de Pruebas Bash):

bats test/

License

MIT

--- Tranlated By Open Ai Tx | Last indexed: 2026-07-04 ---

claude-sh