Edizione del 2026-08-17
v0.9.9
Codewhalequalsiasi modello, sulla tua macchina
★ 40.8k
Open source · Porta il tuo modello · Nel tuo terminale

Codewhale si tuffa negli abissi
così non devi farlo tu.

Codewhale è un agente di coding open source per il tuo terminale. Dagli un modello e un compito: legge il tuo codice, modifica i file, esegue i suoi controlli e si ferma quando il lavoro è finito o quando serve te. Porta qualsiasi modello, o mescolali: fissa un modello diverso per ciascun ruolo.

Installa Documentazione GitHub
installazione in una riga
npm install -g codewhale
serve Node 18+ — nessuna toolchain Rustaltri modi →

cwUltima release v0.9.8Sorgente candidato v0.9.945 route di providerMIT

Codewhale TUISessione corrente
Sessione corrente di Codewhale nel terminale: modalità Operate, la balena, il compositore e il piè di pagina
Sessione corrente di Codewhale · modalità Operate · postura di permessi Ask
In direttaLIVE
unito#5484feat(dsh): ambient ocean scene — whales and glyph fish behind the DSH …di @Hmbown17 min faunito#5483web: de-slop the site copy (voice sheet + rewritten surfaces)di @Hmbown17 min faunito#5480feat(tui): show and open the live /rc session link; send a stable devi…di @Hmbown36 min faunito#5477release: 0.9.9 CHANGELOG addendum for #5474/#5475 + contributor credit…di @Hmbown57 min faaperto#5485fix(models): bring first-party model rows and pricing current as of 20…di @Hmbown1 h faaperto#5482EPIC(docs): review, partially restructure, and fully localize document…di @SparkofSpike2 h faaperto#5479Fleet/agents: first-class sub-agent and workflow management in the TUI…di @Hmbown2 h faaperto#5478TUI: /rename mid-turn leaves the in-flight shell tool row stuck at "ru…di @Hmbown2 h faunito#5475fix(config): resolve owned direct model casing safelydi @h3c-hexin2 h faunito#5474perf(context): compact all noisy web tool resultsdi @h3c-hexin2 h fachiuso#5424v0.9.7: Codewhale TUI crashingdi @Hixac2 h faaperto#5473perf(skills): keep configured skill prompts stabledi @h3c-hexin6 h fapubblicatov0.9.818 h faaperto#4170v0.9.3 architecture D-6: add MCP capability metadatadi @Hmbownmese scorsoaperto#3957v0.9.3 Refactor: split shared modal infrastructure and owned viewsdi @Hmbown2 mesi faaperto#2369CodeWhale Config Paths Fragmented Across OS and Cygwin (Plus Silent Mi…di @buko3 mesi faaperto#1829SSH 连接失败：exit code 255（疑似 DeepSeek TUI shell 沙箱 TCP 22 出站阻断）di @fodudu12263 mesi faaperto#1651VS Code crashes or exits unexpectedly when YOLO Agent is running test …di @HubgitCCL3 mesi faaperto#1425执行大文本处理工程后会话中断卡死di @AiurArtanis3 mesi fa

Una shell sottomarina. Qualsiasi modello. Sulla tua macchina.

Porta il modello che già usi — hosted, via gateway o locale. Plan / Work / Operate e le posture di permessi esplicite tengono l'immersione sotto il tuo controllo.

Guarda come decide

Regole che vedi nella traccia

Stralci di sessioni reali: la gerarchia di regole del progetto è visibile nel ragionamento del modello, non è solo la promessa di una landing.

codewhale — thinking
traccia di ragionamento
# 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.
›

Dal compito alla modifica verificata.

  1. 01

    Ispezionare

    Leggere il repository, le sue istruzioni e il compito.

  2. 02

    Agire

    Modificare i file entro confini di approvazione espliciti.

  3. 03

    Verificare

    Eseguire i controlli ed esaminare il risultato.

  4. 04

    Riferire

    Lasciare una ricevuta concisa e durevole.

$ codewhale exec "fix the failing test"inspect   repository e istruzioniact       modifiche con la postura di permessi sceltaverify    cargo test --lockedreport    controlli superati · ricevuta salvata

Nuovo su Codewhale? Quattro passi dall'inizio alla fine.

Installare → prima sessione senza chiavi → collegare un provider → configurare la tua Fleet. I termini sono definiti nella pagina del vocabolario.

  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 →
Leggi la guida introduttiva →Vedi il vocabolario del prodotto →

Il tuo modello.
I tuoi confini.

Scegli esplicitamente modello, modalità di lavoro e postura di permessi. Un costo sconosciuto resta dichiarato sconosciuto, e le superfici in anteprima restano etichettate come tali.

45 route di provider
Modelli hosted, via gateway e locali
Plan · Work · Operate
Dalla pianificazione in sola lettura all'operazione autonoma
Ask · Auto-Review · Full Access
Scegli la postura di permessi per il lavoro
TUI · exec · web · API
Superfici di runtime interattive e headless

Usa il runtime dove avviene il lavoro.

TUILavoro interattivo nel terminale
codewhale execScript e CI
Client webClient browser, solo in loopback
Runtime API + MCPIntegrazioni locali
FleetLavoro multi-agente durevole
Vedi le superfici del runtime e le note di stabilità →

Inizia con un solo comando.

npm install -g codewhale

CargoBinariDockerNixWindowsAndroid / TermuxMirror in Cina

Leggi la guida d'installazione →

Costruito in pubblico

Con licenza MIT e plasmato da contributor su runtime, provider, piattaforme, documentazione e test.