L’agent de codi obert que funciona amb qualsevol model.
Codewhale llegeix el teu projecte, edita fitxers, executa ordres i comprova la seva pròpia feina — al teu terminal, amb un model allotjat o local que tu tries.
Lloc web · Documentació · Registre de canvis · Contribuir
English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية
Captura real del terminal en una instal·lació nova — sense sortida preparada.
macOS i Linux:
curl -fsSL https://codewhale.net/install.sh | shL’instal·lador descarrega binaris amb suma de verificació a ~/.local/bin. Si
després codewhale respon "command not found", executa l’única línia de PATH que
mostra l’instal·lador, o consulta Afegir-lo al PATH.
Actualitza quan vulguis amb codewhale update.
Windows, npm, Cargo i altres vies
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.ioDocker, Nix, Homebrew a Linux, Android/Termux, les descàrregues manuals amb
verificació de la suma de control i el mirall opcional de CNB s’expliquen a la
guia d’instal·lació. Tria una sola via: diverses
instal·lacions a la mateixa màquina acaben disputant-se el PATH.
- Obre el teu projecte. Executa
codewhalea la carpeta on vols treballar. - Connecta un model. Executa
/provider(o premF3) per afegir una clau allotjada o triar un entorn local. Si Ollama ja s’està executant amb un model de xat, Codewhale hi canvia per si sol. Fes servir/modelper canviar de model. - Dona-li una tasca concreta.
Fix the failing tests and explain what changed.
La mateixa tasca es pot executar sense interfície des d’un script o una tasca de CI:
codewhale exec "fix the failing tests and explain what changed"Executa /help per veure les ordres i les dreceres de teclat.
Tots els clients fan servir el mateix Runtime local de Codewhale, de manera que les sessions, les eines i els permisos es comporten igual a tot arreu.
| Ordre | Què fa |
|---|---|
codewhale |
La interfície interactiva de terminal |
codewhale exec "…" |
Un torn sense interfície des d’un script o CI, amb sortida JSON en streaming |
codewhale web |
El client de navegador local inclòs, a 127.0.0.1 |
codewhale review --pr N |
Una revisió de pull request merament orientativa; publicar-la és opcional |
| Runtime API | Una API HTTP local per a fils, esdeveniments i aprovacions |
S’està desenvolupant una aplicació d’escriptori nativa (GPUI) com a client del producte amb sessió iniciada; consulta la pàgina del producte per veure’n la disponibilitat. L’extensió de VS Code, mantinguda per la comunitat, es connecta al mateix Runtime des d’una barra lateral (codi font).
- Qualsevol model, sense dependència d’un proveïdor. Més de 40 rutes de proveïdors integrades — Anthropic, DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI i més — a més de qualsevol endpoint compatible amb OpenAI i models locals mitjançant Ollama, vLLM o SGLang. Proveïdors
- Tu mantens el control. El mode Plan explora sense canviar res; Work i
Operate fan canvis. Les postures d’aprovació decideixen quan una crida a una
eina necessita el teu vistiplau,
/undoi/restorerecuperen els canvis de l’espai de treball, i/receiptsenumera cada fitxer, ordre i aprovació d’una sessió. Modes · Rebuts - Pensat per a feines llargues. Defineix un
/goaldurador, delega feina acotada a subagents, executa equips d’agents supervisats amb una comprovació prèvia de la despesa, o automatitza’ls com a fluxos de treball versionats al repositori. - Amplia el que ja fas servir. Connecta servidors MCP, instal·la skills i plugins, executa hooks en esdeveniments de sessió i d’eines, i carrega els plugins de Claude Code existents.
- Computer Use. Un plugin inclòs afegeix eines per observar i operar altres aplicacions. Revisa l’accés que sol·licita i habilita’l abans de fer-lo servir. Guia
| Es tria amb | Opcions | |
|---|---|---|
| Mode — el que fa l’agent | Tab o /mode |
Plan (explorar, sense canvis) · Work (editar i executar) · Operate (portar un objectiu endavant amb passos planificats i verificats) |
| Postura — quan pregunta abans | Shift+Tab |
Ask · Auto-Review · Full Access |
Full Access continua respectant els límits estrictes de les polítiques. La guia de modes i permisos explica cada opció.
Codewhale s’executa al teu equip amb l’accés que li concedeixis. Les postures
d’aprovació i les regles del repositori limiten el que l’agent pot fer, i les
ordres s’executen dins d’un sandbox del sistema operatiu on és compatible
(Seatbelt a macOS; bubblewrap a Linux és opcional). /preview-request mostra la
sol·licitud exacta, amb les dades sensibles ocultades, abans d’enviar res. Els
preus de models desconeguts continuen sent desconeguts en lloc de presentar-se
com a gratuïts.
Consulta l’ordre d’autorització, el
sandboxing i la telemetria: els
comptadors d’ús estan activats per defecte i codewhale config set telemetry false
els desactiva.
Els informes d’errors, les idees de funcionalitats i els pull requests són benvinguts, tant si fa mesos que fas servir Codewhale com si el proves per primera vegada. Si falta un proveïdor o un flux de treball resulta incòmode, obre un issue o envia un pull request. Les primeres contribucions són benvingudes, i qui contribueix conserva el crèdit pel treball que s’hi integra. L’estructura del repositori és un bon punt de partida.
Uneix-te al Discord, o afegeix Hunter a WeChat
(hunterbown) i demana entrar al grup Whale Brothers.
Codewhale va començar com a deepseek-tui i encara llegeix la configuració i les
sessions d’aquest projecte. Ara és neutral respecte dels proveïdors, es manté de
manera independent i no està afiliat a cap proveïdor de models. Gràcies a
tots els col·laboradors i a les comunitats de codi obert
que han ajudat que creixi.
MIT. Les parts adaptades d’altres projectes de codi obert es recullen als avisos de tercers.