El agente de programación de código abierto para cualquier modelo
Codewhale lee tu proyecto, edita archivos y ejecuta tus pruebas desde la terminal. Conecta un modelo alojado o local y elige qué acciones necesitan tu aprobación.
curl -fsSL https://codewhale.net/install.sh | sh
Codewhale × OrcaRouterGet 30% extra DeepSeek V4.1 Flash credit on each OrcaRouter top-up. One claim per developer, open until November 21, 2026.Codewhale earns a referral fee from OrcaRouter.Claim on OrcaRouter▎ Local demo: add --json to export.py, run tests, and delegate a review. │╭ ✓ • tool done · 3/3 · 100% ││ ▏ checklist: todo_write ││ ▏ ☑ Inspect the export command ││ ▏ ☑ Add the --json flag │╰ ▏ ☑ Run tests and review the change │ │● JSON export is ready. │▏ │▏ Added --json while preserving CSV output. All 3 local tests passed, and the delegated review │▏ found no issues. ┃▏ ┃▏ Try: python3 export.py --json ┃▏ ┃▏ This session uses the local website-demo provider. ┃ ┃Note Workbar is off — no panel renders (/workbar bottom|top|left|right to show it) ┃╭──────────────────────────────────────────────────────────────────────────────────────────────────╮│❯ Type a message… ││ [·] │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ ● Full Access Shift+Tab to change work (Tab) Work bar (Ctrl+]) ← for agents · ↓ to manage website-demo · website-demo context 7%
New in v0.10.2
Read the changelog- /pet on
- Turns your terminal into an animated whale that shows what the agent is doing. The message box stays live.
- /workbar terminal
- Shows the shells the agent is running as they run. Type into one, or press Ctrl+N for your own. macOS and Linux.
- /undo
- Takes back your whole last request in one step, including every file it changed.
- Plan → Work
- When a plan ends with open steps, Codewhale asks whether to start Work with Ask or Auto-Review, or keep planning.
- curl / wget
- Outside Full Access, a curl or wget that would upload a credential never runs without your approval.
- DeepSeek Search
- web_search can use DeepSeek's new Search API: set [search] provider = "deepseek" with a DeepSeek key.
Crea y automatiza desde tu terminal
Describe lo que quieres crear o automatizar. Codewhale puede editar archivos, ejecutar comandos y comprobar el resultado, con un acceso que tú controlas.
Capacidades- Crea aplicaciones y herramientas
- Crea una aplicación, añade una función o escribe un script. Codewhale puede trabajar con los archivos del proyecto, ejecutar el código y probar lo que crea. Documentación
- Automatiza el trabajo repetitivo
- Ejecuta flujos de trabajo desde tu terminal, scripts o CI. Para tareas más grandes, delega partes del trabajo a una Fleet de agentes con distintos modelos. Documentación
- Conecta las herramientas que usas
- Añade herramientas mediante plugins y servidores MCP, o usa API desde tus propios scripts. Cada servicio necesita su propia configuración y autenticación. Documentación
Usa los modelos que elijas
Conecta tus cuentas de proveedores, un endpoint compatible con OpenAI o modelos locales y autoalojados. Elige un modelo para la sesión y para cada agente de una Fleet.
Ver modelos y proveedores- Tus cuentas de API
- Conecta proveedores como DeepSeek, OpenAI, Anthropic o Google con tus propias claves. El modelo predeterminado, deepseek-flash, ahora ejecuta DeepSeek-V4.1-Flash.
- Tu pasarela
- Usa un endpoint compatible con OpenAI y elige los modelos que ofrece.
- Tu inferencia
- Ejecuta modelos locales o autoalojados con Ollama, vLLM o SGLang.
- Tu plan de ChatGPT
- Inicia sesión con codewhale auth chatgpt para usar un plan de ChatGPT en lugar de una clave de API. Experimental.
Trabaja con archivos y herramientas
Explora herramientas e integraciones- Archivos y terminal
- Crea archivos, ejecuta comandos, examina datos y prueba lo que construyes. Tú defines la carpeta de trabajo y los permisos.
- Plugins y aplicaciones conectadas
- Añade habilidades y herramientas mediante plugins y MCP. Revisa y habilita las conexiones que quieras que use el agente.
- Navegador y ordenador · vista previa
- Usa herramientas de navegador y el plugin Computer Use para trabajar en aplicaciones y sitios web con el acceso que concedas.
- Sesiones que puedes retomar
- Mantén juntos la conversación, los resultados de las herramientas y el historial. Retoma la tarea en el terminal o en su cliente de navegador local.
- Equipos de agentes
- Usa Fleet para repartir un trabajo grande entre agentes con distintos roles y modelos, y seguir su progreso en un solo lugar.
Primeros pasos
Instala Codewhale, conecta un modelo y abre una carpeta de proyecto. Puedes añadir plugins y más agentes según los necesites.
Install Codewhale
Install the latest release on macOS or Linux. Follow any PATH instruction the installer prints, then open a folder where you want to work. The guide covers Windows and other install options.
Full install guidecurl -fsSL https://codewhale.net/install.sh | shConnect your model
Use a model API you already have, or connect local or self-hosted inference. The command below saves a DeepSeek key; local Ollama models do not need an API key.
Connect a providercodewhale auth set --provider deepseekDescribe your first task
Start Codewhale and describe the result: a small app, a script that saves you time, or a report from your data. Choose its permissions, review what it does and steer it as you go.
Set modes and approvalscodewhaleUse multiple agents
Split a larger job across agents with different roles and models. Inside Codewhale, save your team with /fleet setup, then check its runs with /fleet status.
Set up a Fleet/fleet setup /fleet status
Disponible ahora y en desarrollo
El terminal y el cliente de navegador local ya están disponibles. La aplicación nativa de escritorio y la aplicación web alojada reconstruida están en desarrollo.
- Terminal y navegador local
- PublicadoInstala en Linux, macOS o Windows y luego ejecuta codewhale, o codewhale web para el cliente de navegador local. npm y Cargo también funcionan; Android en Termux está en vista previa.
- CodeWhale GUI (VS Code)
- DisponibleUn proyecto aparte, mantenido por la comunidad: chat, hilos y cambios de archivos en una barra lateral de VS Code sobre el mismo Codewhale Runtime. Instálalo desde el VS Code Marketplace.
- Aplicación web alojada
- En desarrolloSe está reconstruyendo para igualar la aplicación de escritorio y aún no está abierta. Para usarla en el navegador hoy, ejecuta codewhale web en tu equipo.
- Escritorio
- Build de desarrolloUna aplicación nativa con el mismo motor. Revisa y confirma cambios, sigue el trabajo entre proyectos y edita un mensaje para volver a enviarlo como una nueva rama. Aún no hay descarga pública.
La terminal, el navegador local y la GUI no necesitan una cuenta de Codewhale. Si usas tu propia clave de proveedor, ese proveedor te factura el uso.
Contribuye a Codewhale
393 personas han contribuido a crear Codewhale. Informa de un error, mejora la documentación o contribuye con código en GitHub.
Instala en macOS o Linux
GitHub Releases (Binarios) · npm · Cargo · Docker · Windows · Android / Termux · Espejos en China
Leer la guía de instalacióncurl -fsSL https://codewhale.net/install.sh | sh