Edició del 2026-08-17
v0.9.9
Codewhalequalsevol model, a la teva màquina
★ 40.8k
Codi obert · Porta el teu model · Al teu terminal

Codewhale s’immergeix a les profunditats
perquè tu no ho hagis de fer.

Codewhale és un agent de programació de codi obert per al teu terminal. Dóna-li un model i una tasca: llegeix el teu codi, edita fitxers, executa les seves pròpies comprovacions i s’atura quan la feina és feta o quan et necessita. Porta el model que vulguis, o barreja’ls: fixa un model diferent per a cada rol.

Instal·la Documentació GitHub
instal·lació en una línia
npm install -g codewhale
cal Node 18+ — sense cadena d’eines Rustaltres mètodes →

cwÚltima versió v0.9.8Font candidata v0.9.945 rutes de proveïdorsMIT

Codewhale TUISessió actual
Sessió de terminal actual de Codewhale amb el mode Operate, la balena, el compositor i el peu de pàgina
Sessió actual de Codewhale · mode Operate · postura de permisos Ask
En directeLIVE
obert#5485fix(models): bring first-party model rows and pricing current as of 20…per @Hmbownfa 16 minobert#5484feat(dsh): ambient ocean scene — whales and glyph fish behind the DSH …per @Hmbownfa 26 minobert#5483web: de-slop the site copy (voice sheet + rewritten surfaces)per @Hmbownfa 28 minobert#5482EPIC(docs): review, partially restructure, and fully localize document…per @SparkofSpikefa 32 minobert#5480feat(tui): show and open the live /rc session link; send a stable devi…per @Hmbownfa 38 minobert#5479Fleet/agents: first-class sub-agent and workflow management in the TUI…per @Hmbownfa 40 minobert#5478TUI: /rename mid-turn leaves the in-flight shell tool row stuck at "ru…per @Hmbownfa 1 hfusionat#5475fix(config): resolve owned direct model casing safelyper @h3c-hexinfa 1 hobert#5477release: 0.9.9 CHANGELOG addendum for #5474/#5475 + contributor credit…per @Hmbownfa 1 hfusionat#5474perf(context): compact all noisy web tool resultsper @h3c-hexinfa 1 htancat#5424v0.9.7: Codewhale TUI crashingper @Hixacfa 1 hobert#5473perf(skills): keep configured skill prompts stableper @h3c-hexinfa 5 hpublicatv0.9.8fa 17 hobert#4170v0.9.3 architecture D-6: add MCP capability metadataper @Hmbownel mes passatobert#3957v0.9.3 Refactor: split shared modal infrastructure and owned viewsper @Hmbownfa 2 mesosobert#2369CodeWhale Config Paths Fragmented Across OS and Cygwin (Plus Silent Mi…per @bukofa 3 mesosobert#1829SSH 连接失败：exit code 255（疑似 DeepSeek TUI shell 沙箱 TCP 22 出站阻断）per @fodudu1226fa 3 mesosobert#1651VS Code crashes or exits unexpectedly when YOLO Agent is running test …per @HubgitCCLfa 3 mesosobert#1425执行大文本处理工程后会话中断卡死per @AiurArtanisfa 3 mesos

Un intèrpret d’ordres submarí. Qualsevol model. A la teva màquina.

Porta el model que ja utilitzes — allotjat, via gateway o local. Plan / Work / Operate i les postures de permisos explícites mantenen la immersió sota el teu control.

Mira com decideix

Regles que pots veure a la traça

Extractes de sessions reals: la jerarquia de regles del projecte es veu al raonament del model, no és només una afirmació de la portada.

codewhale — thinking
traça de raonament
# 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 tasca al canvi verificat.

  1. 01

    Inspeccionar

    Llegir el repositori, les seves instruccions i la tasca.

  2. 02

    Actuar

    Editar fitxers dins de límits d’aprovació explícits.

  3. 03

    Verificar

    Executar les comprovacions i inspeccionar el resultat.

  4. 04

    Reportar

    Deixar un resguard concís i durable.

$ codewhale exec "fix the failing test"inspect   repositori i instruccionsact       edició segons la postura de permisos triadaverify    cargo test --lockedreport    comprovacions superades · resguard desat

Nou a Codewhale? Quatre passos de principi a fi.

Instal·lar → primera sessió sense claus → connectar un proveïdor → configurar la teva Fleet. Els termes es defineixen a la pàgina de vocabulari.

  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. Set up your ideal fleet

    Add every provider you use — one auth set per hosted route; keyless local runtimes need nothing — then author the team: /fleet setup walks one role at a time (a model from any configured provider, a thinking tier, permissions) and saves a reusable profile for this repo or every repo on this machine. Fleet state lives in the workspace ledger; ordinary single tasks need none of this.

    /fleet setup
codewhale fleet status
    Fleet and Workflow docs →
Llegeix la guia d’inici →Consulta el vocabulari del producte →

El teu model.
Els teus límits.

Tria explícitament el model, el mode de treball i la postura de permisos. El cost desconegut es declara desconegut, i les superfícies en previsualització es marquen com a tals.

45 rutes de proveïdors
Models allotjats, de gateway i locals
Plan · Work · Operate
De la planificació de només lectura a l’operació autònoma
Ask · Auto-Review · Full Access
Tria la postura de permisos per a la feina
TUI · exec · web · API
Superfícies de runtime interactives i sense interfície

Fes servir el runtime on passa la feina.

TUITreball interactiu al terminal
codewhale execScripts i CI
Client webClient de navegador, només loopback
Runtime API + MCPIntegracions locals
FleetFeina multiagent durable
Veure les superfícies del runtime i les notes d’estabilitat →

Comença amb una sola ordre.

npm install -g codewhale

CargoBinarisDockerNixWindowsAndroid / TermuxMirrors a la Xina

Llegeix la guia d’instal·lació →

Construït en públic

Amb llicència MIT i format per col·laboradors de runtimes, proveïdors, plataformes, documentació i tests.