Edición 2026-08-12
v0.9.5
Codewhalecualquier modelo, en tu máquina
★ 40.7k
Código abierto · Trae tu propio modelo · Se ejecuta en tu terminal

Codewhale se sumerge en las profundidades
para que tú no tengas que hacerlo.

Codewhale es un agente de programación de código abierto para tu terminal. Dale un modelo y una tarea: lee tu código, edita archivos, ejecuta sus propias comprobaciones y se detiene cuando el trabajo está hecho o te necesita. Trae cualquier modelo, o combínalos: asigna un modelo distinto a cada rol.

Instalar Documentación GitHub
instalación en una línea
npm install -g codewhale
requiere Node 18+ — no hace falta Rustotras formas →

cwÚltimo lanzamiento v0.9.6Fuente actual v0.9.640 rutas de proveedorMIT

Codewhale TUISesión actual
Sesión de terminal actual de Codewhale con el modo Operate, la ballena, el compositor y el pie de página
Sesión actual de Codewhale · modo Operate · postura de permisos Ask
En vivoLIVE
abierto#5337Web: finish the #4934 dictionary spine — retire every isZh branch and …por @Lstarsky0hace 1 hcerrado#5320fix(session): separate snapshot reads from crash recoverypor @h3c-hexinhace 2 hfusionado#5330fix(session): separate snapshot reads from crash recoverypor @Hmbownhace 2 habierto#5336fix(mcp): omit nextCursor when there are no further pagespor @xiaoray-bliphace 2 habierto#5335serve --mcp responds to tools/list and resources/list with "nextCursor…por @xiaoray-bliphace 2 habierto#5334docs(i18n): retire the stale zh-Hant partial-pack declarationpor @Lstarsky0hace 2 hcerrado#5321feat: register OrcaRouter as a named providerpor @XiaoHuo888-huehace 3 hfusionado#5332feat(config): register OrcaRouter as a named providerpor @Hmbownhace 3 hcerrado#5314Copy message from context menu includes rail decorations (● ▏) — make …por @maimikhace 4 hcerrado#5319fix(tui): copy messages without visual railspor @XhesicaFrosthace 4 hfusionado#5331fix(tui): copy messages without visual railspor @Hmbownhace 4 hcerrado#5267v0.9.5: turn-stop honesty (status that says ending must end)por @Hmbownhace 4 habierto#5333feat(tui): pin host terminal window as an always-on-top mini windowpor @Hmbownhace 4 hpublicadov0.9.6hace 7 habierto#5323**Regression in v0.9.5: Auto-Review mode silently blocks every Bash ca…por @USTHzhangluhace 14 habierto#5322Regression: output area doesn't fill wide terminals (worked in v0.8.65…por @M-Maciejhace 20 habierto#5316EPIC-005: CodeWhale TUI Crate Decomposition (Umbrella)por @aboimpintoanteayerabierto#4949Discussion: The Chinese Translation of "Constitution" — "宪法", "协作准则", …por @SparkofSpikehace 15 días

Un shell de terminal submarino. Cualquier modelo. En tu máquina.

Trae el modelo que ya usas: alojado, de gateway o local. Plan / Act / Operate y las posturas de permisos explícitas mantienen la inmersión bajo tu control.

Mira cómo decide

Reglas que puedes ver en la traza

Extractos de sesiones reales: la jerarquía de reglas del proyecto se observa en el razonamiento del modelo, no es solo una afirmación de esta página.

codewhale — thinking
traza de razonamiento
# When the prior session's summary didn't match the repo…
› Per Article II (truth) and V (verification), I report what's actually in the tree — not what the previous agent claimed.
Article II · TruthArticle V · Verification
→ Reported the uncommitted work the summary left out, instead of repeating the claim.
›

De la tarea al cambio verificado.

  1. 01

    Inspeccionar

    Lee el repositorio, sus instrucciones y la tarea.

  2. 02

    Actuar

    Edita archivos dentro de límites de aprobación explícitos.

  3. 03

    Verificar

    Ejecuta las comprobaciones e inspecciona el resultado.

  4. 04

    Reportar

    Deja un recibo conciso y duradero.

$ codewhale exec "fix the failing test"inspect   repositorio e instruccionesact       editar según la postura de permisos elegidaverify    cargo test --lockedreport    comprobaciones superadas · recibo guardado

¿Nuevo en Codewhale? Cuatro pasos de principio a fin.

Instalar → primera sesión sin claves → conectar un proveedor → primer Workflow de Fleet. Los términos se definen en la página de vocabulario.

  1. Install Codewhale

    One npm command installs the dispatcher and terminal runtime. Cargo, archives, Docker, Nix, and China mirrors are documented alternatives — published releases only.

    npm install -g codewhale
codewhale doctor
    Full install guide →

  2. Open a first session — no key needed

    Launches without any API key: short constitution-first setup, then the full interface. Explore in Plan mode — always read-only. Model replies need a provider; that's the next step.

    codewhale
    Learn the product nouns first →

  3. Connect a provider

    Pick a supported route — hosted key, gateway, or keyless local runtime (Ollama, vLLM, SGLang). Provider and model stay explicit; reasoning and routing provenance stay separate, and unavailable values stay unavailable.

    codewhale auth set --provider deepseek
    Providers and models →

  4. Run a first Fleet workflow

    For durable workers, ordered phases, or receipts, author a reusable agent-team profile and launch a run. Fleet state lives in the workspace ledger; ordinary single tasks need none of this.

    codewhale fleet init
codewhale fleet run tasks.json --max-workers 4
    Fleet and Workflow docs →
Leer la guía de primeros pasos →Ver el vocabulario del producto →

Tu modelo.
Tus límites.

Elige explícitamente el modelo, el modo de trabajo y la postura de permisos. El costo desconocido se declara desconocido, y las interfaces en vista previa se marcan como tales.

40 rutas de proveedor
Modelos alojados, de gateway y locales
Plan · Act · Operate
De la planificación de solo lectura a la operación autónoma
Ask · Auto-Review · Full Access
Elige la postura de permisos para el trabajo
TUI · exec · web · API
Interfaces de runtime interactivas y headless

Usa el runtime donde ocurre el trabajo.

TUITrabajo interactivo en la terminal
codewhale execScripts y CI
Cliente webCliente de navegador, solo loopback
Runtime API + MCPIntegraciones locales
FleetTrabajo multiagente duradero
Ver las interfaces de runtime y las notas de estabilidad →

Empieza con un solo comando.

npm install -g codewhale

CargoBinariosDockerNixWindowsAndroid / TermuxEspejos en China

Leer la guía de instalación →

Construido en público

Con licencia MIT y moldeado por colaboradores en runtimes, proveedores, plataformas, documentación y pruebas.