L’agent de code open source qui fonctionne avec n’importe quel modèle.

Codewhale lit votre projet, modifie des fichiers, exécute des commandes et vérifie son propre travail — dans votre terminal, avec un modèle hébergé ou local de votre choix.

Site web · Documentation · Journal des modifications · Contribuer

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

_{Capture réelle du terminal Codewhale dans une session de démonstration locale configurée.}

Installation

macOS et Linux :

curl -fsSL https://codewhale.net/install.sh | sh

L’installeur télécharge des binaires dont la somme de contrôle est vérifiée dans ~/.local/bin. Si codewhale répond ensuite « command not found », exécutez l’unique ligne PATH que l’installeur affiche, ou consultez Ajouter au PATH. Mettez à jour à tout moment avec codewhale update.

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

Démarrage rapide

Les clés API de vos fournisseurs, au même endroit. Créez un compte Codewhale ou lancez codewhale login pour vous connecter. Enregistrez et mettez à jour vos clés API dans votre compte, puis utilisez-les via le routage des modèles Codewhale sur vos appareils connectés à ce compte. Configurer les clés du compte. La connexion ne transfère pas les clés locales existantes ; l’utilisation locale reste possible sans compte.

1. Ouvrez votre projet. Lancez codewhale dans le dossier sur lequel vous voulez travailler.
2. Connectez un modèle. Lancez /provider (ou appuyez sur F3) pour ajouter une clé hébergée ou choisir un runtime local. Si Ollama est déjà en cours d’exécution avec un modèle de chat, Codewhale bascule dessus automatiquement. Utilisez /model pour changer de modèle.
3. Donnez-lui une tâche concrète.

Fix the failing tests and explain what changed.

La même tâche s’exécute sans interface depuis un script ou un job CI :

codewhale exec --auto "fix the failing tests and explain what changed"

Lancez /help pour les commandes et les raccourcis clavier.

Façons de l’exécuter

Chaque client pilote le même Runtime Codewhale local ; les sessions, les outils et les permissions se comportent donc de la même façon partout.

Une application de bureau native (GPUI) est en cours de développement comme client du produit pour les utilisateurs connectés ; consultez la page produit pour sa disponibilité. L’extension VS Code maintenue par la communauté se connecte au même Runtime depuis une barre latérale (source).

Ce qu’il fait

• N’importe quel modèle, sans enfermement. Plus de 40 routes de fournisseurs intégrées — Anthropic, DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI et d’autres — ainsi que tout point d’accès compatible OpenAI et des modèles locaux via Ollama, vLLM ou SGLang. Fournisseurs
• Vous gardez le contrôle. Le mode Plan explore sans rien modifier ; Work et Operate apportent des modifications. Les postures d’approbation décident quand un appel d’outil nécessite votre accord, /undo et /restore récupèrent les modifications de l’espace de travail, et /receipts liste chaque fichier, commande et approbation d’une session. Modes · Reçus
• Conçu pour les longues tâches. Fixez un /goal durable, déléguez un travail délimité à des sous-agents, lancez des équipes d’agents supervisées avec une vérification avant dépense, ou scriptez-les sous forme de workflows versionnés.
• Prolongez ce que vous utilisez déjà. Connectez des serveurs MCP, installez des skills et des plugins, exécutez des hooks sur les événements de session et d’outil, et chargez les plugins Claude Code existants.
• Computer Use. Un plugin inclus ajoute des outils pour observer et utiliser d’autres applications. Examinez ses accès et activez-le avant de l’utiliser. Guide

Modes et permissions

Full Access respecte toujours les limites impératives des politiques. Le guide des modes et des permissions explique chaque option.

Sécurité

Codewhale s’exécute sur votre machine avec les accès que vous lui accordez. Les postures d’approbation et les règles du dépôt limitent ce que l’agent peut faire, et les commandes s’exécutent dans un bac à sable du système d’exploitation lorsqu’il est pris en charge (Seatbelt sur macOS ; bubblewrap sous Linux lorsqu’il est installé et fonctionnel). /preview-request affiche la requête exacte, expurgée, avant tout envoi. Le prix d’un modèle inconnu reste inconnu au lieu d’être présenté comme gratuit.

Consultez l’ordre d’autorisation, le bac à sable et la télémétrie — les compteurs d’utilisation sont activés par défaut et codewhale config set telemetry false les désactive.

Documentation

Communauté

Les signalements de bugs, les idées de fonctionnalités et les pull requests sont les bienvenus, que vous utilisiez Codewhale depuis des mois ou que vous l’essayiez pour la première fois. S’il manque un fournisseur ou si un workflow est peu pratique, ouvrez une issue ou envoyez une pull request. Les premières contributions sont les bienvenues, et les personnes qui contribuent restent créditées pour le travail intégré. L’organisation du dépôt est un bon point de départ.

Rejoignez le Discord, ou ajoutez Hunter sur WeChat (hunterbown) et demandez à rejoindre le groupe Whale Brothers.

Historique et licence

Codewhale a commencé sous le nom de deepseek-tui et lit toujours la configuration et les sessions de ce projet. Il est désormais indépendant de tout fournisseur, maintenu de manière autonome, et n’est affilié à aucun fournisseur de modèles. Merci à toutes les personnes qui contribuent et aux communautés open source qui l’ont aidé à grandir.

MIT. Les parties adaptées d’autres projets open source sont indiquées dans les mentions tierces.