README.es-419.md

El agente de código abierto que funciona con cualquier modelo.

Codewhale lee tu proyecto, edita archivos, ejecuta comandos y comprueba su propio trabajo — en tu terminal, con un modelo alojado o local que tú eliges.

Sitio web · Documentación · Registro de cambios · Contribuir

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

_{Captura real de la terminal de Codewhale en una sesión de demostración local configurada.}

Instalación

macOS y Linux:

curl -fsSL https://codewhale.net/install.sh | sh

El instalador descarga binarios con suma de verificación en ~/.local/bin. Si después codewhale responde "command not found", ejecuta la única línea de PATH que muestra el instalador, o consulta Agregarlo al PATH. Actualiza cuando quieras con codewhale update.

Windows, npm, Cargo y otras vías

winget install HunterBown.CodeWhale  # Windows x64 (or Scoop, or the installer from GitHub Releases)
npm install -g codewhale            # wraps the same release binaries
cargo install codewhale-cli --locked  # build from crates.io

Docker, Nix, Homebrew en Linux, Android/Termux, las descargas manuales con verificación de suma de control y el espejo opcional de CNB se explican en la guía de instalación. Elige una sola vía: varias instalaciones en la misma máquina terminan disputándose el PATH.

Inicio rápido

Las claves API de tus proveedores, en un solo lugar. Crea una cuenta de Codewhale o ejecuta codewhale login para iniciar sesión. Guarda y actualiza tus claves API en tu cuenta y úsalas a través de la ruta de modelos de Codewhale en los dispositivos donde hayas iniciado sesión. Configura las claves de tu cuenta. Iniciar sesión no sube las claves locales existentes; puedes seguir usando Codewhale localmente sin una cuenta.

1. Abre tu proyecto. Ejecuta codewhale en la carpeta en la que quieres trabajar.
2. Conecta un modelo. Ejecuta /provider (o presiona F3) para agregar una clave alojada o elegir un entorno local. Si Ollama ya se está ejecutando con un modelo de chat, Codewhale cambia a él por sí solo. Usa /model para cambiar de modelo.
3. Dale una tarea concreta.

Fix the failing tests and explain what changed.

La misma tarea se puede ejecutar sin interfaz desde un script o un trabajo de CI:

codewhale exec --auto "fix the failing tests and explain what changed"

Ejecuta /help para ver los comandos y los atajos de teclado.

Formas de ejecutarlo

Todos los clientes usan el mismo Runtime local de Codewhale, así que las sesiones, las herramientas y los permisos se comportan igual en todas partes.

Comando	Qué hace
codewhale	La interfaz interactiva de terminal
codewhale exec "…"	Un turno sin interfaz desde un script o CI; --auto permite las herramientas de archivos y de shell, --output-format stream-json transmite JSON
codewhale web	El cliente de navegador local incluido, en 127.0.0.1
codewhale review --pr N	Una revisión de pull request de carácter orientativo; publicarla es opcional
Runtime API	Una API HTTP local para hilos, eventos y aprobaciones

Se está desarrollando una aplicación de escritorio nativa (GPUI) como cliente del producto con sesión iniciada; consulta la página del producto para ver su disponibilidad. La extensión de VS Code, mantenida por la comunidad, se conecta al mismo Runtime desde una barra lateral (código fuente).

Qué hace

• Cualquier modelo, sin dependencia de un proveedor. Más de 40 rutas de proveedores integradas — Anthropic, DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI y más — además de cualquier endpoint compatible con OpenAI y modelos locales mediante Ollama, vLLM o SGLang. Proveedores
• Tú mantienes el control. El modo Plan explora sin cambiar nada; Work y Operate hacen cambios. Las posturas de aprobación deciden cuándo una llamada a una herramienta necesita tu visto bueno, /undo y /restore recuperan los cambios del espacio de trabajo, y /receipts enumera cada archivo, comando y aprobación de una sesión. Modos · Recibos
• Pensado para trabajos largos. Define un /goal duradero, delega trabajo acotado a sub-agentes, ejecuta equipos de agentes supervisados con una verificación previa del gasto, o automatízalos como flujos de trabajo versionados en el repositorio.
• Amplía lo que ya usas. Conecta servidores MCP, instala skills y plugins, ejecuta hooks en eventos de sesión y de herramientas, y carga los plugins de Claude Code existentes.
• Computer Use. Un plugin incluido agrega herramientas para observar y operar otras aplicaciones. Revisa el acceso que solicita y habilítalo antes de usarlo. Guía

Modos y permisos

	Se elige con	Opciones
Modo — lo que hace el agente	Tab o /mode	Plan (explorar, sin cambios) · Work (editar y ejecutar) · Operate (llevar un objetivo adelante con pasos planificados y verificados)
Postura — cuándo pregunta antes	Shift+Tab	Ask · Auto-Review · Full Access

Full Access sigue respetando los límites estrictos de las políticas. La guía de modos y permisos explica cada opción.

Seguridad

Codewhale se ejecuta en tu equipo con el acceso que le otorgues. Las posturas de aprobación y las reglas del repositorio limitan lo que el agente puede hacer, y los comandos se ejecutan dentro de un sandbox del sistema operativo donde es compatible (Seatbelt en macOS; bubblewrap en Linux cuando está instalado y funciona). /preview-request muestra la solicitud exacta, con los datos sensibles redactados, antes de enviar nada. Los precios de modelos desconocidos siguen siendo desconocidos en lugar de presentarse como gratuitos.

Consulta el orden de autorización, el sandboxing y la telemetría: los contadores de uso están activados por defecto y codewhale config set telemetry false los desactiva.

Documentación

Empieza aquí	Profundiza
Instalación	Configuración
Proveedores y modelos locales	Arquitectura
Modos y permisos	Runtime API
Atajos de teclado	Creación de plugins
Revisión de PR en GitHub	Toda la documentación

Comunidad

Los reportes de errores, las ideas de funciones y los pull requests son bienvenidos, ya uses Codewhale desde hace meses o lo pruebes por primera vez. Si falta un proveedor o un flujo de trabajo resulta incómodo, abre un issue o envía un pull request. Las primeras contribuciones son bienvenidas, y quienes contribuyen conservan el crédito por el trabajo que se integra. La estructura del repositorio es un buen punto de partida.

Únete a Discord, o agrega a Hunter en WeChat (hunterbown) y pide entrar al grupo Whale Brothers.

Historia y licencia

Codewhale comenzó como deepseek-tui y todavía lee la configuración y las sesiones de ese proyecto. Ahora es neutral respecto de los proveedores, se mantiene de forma independiente y no está afiliado a ningún proveedor de modelos. Gracias a cada colaborador y a las comunidades de código abierto que ayudaron a que crezca.

MIT. Las partes adaptadas de otros proyectos de código abierto se registran en los avisos de terceros.