O agente de programação de código aberto para qualquer modelo

Codewhale lê seu projeto, edita arquivos e executa seus testes pelo terminal. Conecte um modelo hospedado ou local e escolha quais ações precisam da sua aprovação.

curl -fsSL https://codewhale.net/install.sh | sh
Último lançamento v0.10.2Código-fonte v0.10.2MIT
Codewhale × OrcaRouter: The whales are teaming up. +30% DeepSeek v4.1 Flash usage.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
Prévia do terminal · Não publicado v0.10.2

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.

Crie e automatize pelo seu terminal

Descreva o que você quer criar ou automatizar. Codewhale pode editar arquivos, executar comandos e verificar o resultado, com acesso controlado por você.

Capacidades
Crie aplicativos e ferramentas
Crie um aplicativo, adicione uma funcionalidade ou escreva um script. Codewhale pode trabalhar com os arquivos do projeto, executar o código e testar o que cria. Documentação
Automatize o trabalho repetitivo
Execute fluxos de trabalho pelo terminal, scripts ou CI. Para tarefas maiores, delegue partes do trabalho a uma Fleet de agentes com modelos diferentes. Documentação
Conecte as ferramentas que você usa
Adicione ferramentas por meio de plugins e servidores MCP ou use APIs nos seus próprios scripts. Cada serviço precisa de configuração e autenticação próprias. Documentação

Use os modelos que você escolher

Conecte suas contas de provedores, um endpoint compatível com OpenAI ou modelos locais e hospedados por você. Escolha um modelo para a sessão e para cada agente de uma Fleet.

Ver modelos e provedores
Suas contas de API
Conecte provedores como DeepSeek, OpenAI, Anthropic ou Google com suas próprias chaves. O modelo padrão, deepseek-flash, agora executa DeepSeek-V4.1-Flash.
Seu gateway
Use um endpoint compatível com OpenAI e escolha os modelos que ele oferece.
Sua inferência
Execute modelos locais ou auto-hospedados com Ollama, vLLM ou SGLang.
Seu plano do ChatGPT
Entre com codewhale auth chatgpt para usar um plano do ChatGPT no lugar de uma chave de API. Experimental.

Trabalhe com arquivos e ferramentas

Explore ferramentas e integrações
Arquivos e terminal
Crie arquivos, execute comandos, examine dados e teste o que constrói. Você define a pasta de trabalho e as permissões.
Plugins e aplicativos conectados
Adicione habilidades e ferramentas por plugins e MCP. Revise e habilite as conexões que deseja que o agente use.
Navegador e computador · prévia
Use ferramentas de navegador e o plugin Computer Use em aplicativos e sites, com o acesso que conceder.
Sessões que você pode retomar
Mantenha conversa, resultados das ferramentas e histórico juntos. Retome a tarefa no terminal ou no cliente de navegador local.
Equipes de agentes
Use Fleet para dividir um trabalho maior entre agentes com funções e modelos diferentes e acompanhar seu progresso em um só lugar.

Comece a usar

Instale Codewhale, conecte um modelo e abra uma pasta de projeto. Você pode adicionar plugins e mais agentes conforme precisar.

  1. 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.

    curl -fsSL https://codewhale.net/install.sh | sh
    Full install guide
  2. Connect 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.

    codewhale auth set --provider deepseek
    Connect a provider
  3. Describe 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.

    codewhale
    Set modes and approvals
  4. Use 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.

    /fleet setup
    /fleet status
    Set up a Fleet

Disponível agora e em desenvolvimento

O terminal e o cliente de navegador local já estão disponíveis. O aplicativo desktop nativo e o novo aplicativo web hospedado estão em desenvolvimento.

Terminal e navegador local
LançadoInstale no Linux, macOS ou Windows e depois execute codewhale, ou codewhale web para o cliente de navegador local. npm e Cargo também funcionam; Android no Termux é uma prévia.
CodeWhale GUI (VS Code)
DisponívelUm projeto separado, mantido pela comunidade: chat, threads e alterações de arquivos em uma barra lateral do VS Code sobre o mesmo Codewhale Runtime. Instale pelo VS Code Marketplace.
Aplicativo web hospedado
Em desenvolvimentoEstá sendo reconstruído para acompanhar o aplicativo desktop e ainda não está aberto. Para usá-lo no navegador hoje, execute codewhale web na sua máquina.
Desktop
Build de desenvolvimentoUm aplicativo nativo com o mesmo mecanismo. Revise e faça commit de alterações, acompanhe o trabalho entre projetos e edite uma mensagem para reenviá-la como uma nova ramificação. Ainda não há download público.

O terminal, o navegador local e a GUI não precisam de uma conta do Codewhale. Se você usar sua própria chave de provedor, esse provedor cobra pelo uso.

Contribua com Codewhale

393 pessoas ajudaram a construir o Codewhale. Relate um bug, melhore a documentação ou contribua com código no GitHub.

Instale no macOS ou Linux

GitHub Releases (Binários) · npm · Cargo · Docker · Windows · Android / Termux · Espelhos da China

Ler o guia de instalação
curl -fsSL https://codewhale.net/install.sh | sh