Codewhale

Открытый агент для программирования в вашем терминале — модель приносите с собой.

Codewhale начинался как нативный клиент для DeepSeek. С тех пор он вырос в проект, которым руководит сообщество: единый каркас для программирования, подходящий растущему международному сообществу и поддерживающий как можно больше моделей и провайдеров — открытые модели в первую очередь, облачные или локальные, ни один не имеет привилегий перед остальными.

Дайте ему провайдера, модель и задачу. Он читает ваш код, правит файлы, запускает команды и проверяет собственную работу, а затем останавливается, когда задача выполнена или ему нужны вы. Переключайте модели прямо посреди задачи командой /model. Работайте интерактивно в TUI или запускайте codewhale exec в скриптах и CI. Он написан на Rust, распространяется по лицензии MIT и работает на вашей машине.

Мы всегда ищем участников и способы стать лучше. Если модели или провайдера, которым вы пользуетесь, не хватает, или что-то сломалось, сообщить нам об этом — одно из самых полезных действий с вашей стороны: см. Участие в проекте.

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Українська · codewhale.net · Docs · Changelog · Discord

Установка

npm install -g codewhale

Cargo, Docker, Nix, Scoop, готовые архивы, Android/Termux и зеркало CNB для тех, кто не может получить доступ к GitHub, описаны в docs/INSTALL.md. Переходите с deepseek-tui? Ваши настройки и сессии переносятся автоматически — см. docs/REBRAND.md.

Использование

codewhale auth set --provider deepseek   # or export ANTHROPIC_API_KEY, etc.
codewhale                                # open the TUI
codewhale exec "fix the failing test"    # headless
codewhale web                            # local browser client on 127.0.0.1

В TUI: /model переключает провайдера и модель одновременно, /fleet запускает команду воркеров, /undo отменяет последний ход, а /restore <N> откатывает рабочую копию к более раннему снимку (/restore без аргумента только выводит их список). Когда поле ввода пустое, Tab циклически переключает режимы Plan / Act / Operate; если в поле есть текст, Tab дополняет слэш-команды и упоминания @. Shift+Tab переключает уровни прав Ask / Auto-Review / Full Access в любой момент. ! запускает команду оболочки через обычный путь подтверждения.

Что он умеет

• Любая модель, любой провайдер. DeepSeek, Claude, GPT, Kimi, GLM и более 30 провайдеров, плюс ваши собственные vLLM, SGLang или Ollama без ключа — всё через единый рантайм и единый набор инструментов. Лимиты контекста и цены берутся из реального маршрута, а неизвестная цена отображается как неизвестная, а не как $0.
• Только чтение, пока вы не разрешите больше. Режим Plan не может изменять файлы, а рискованные команды требуют подтверждения. Когда команду действительно оборачивает песочница ОС, Codewhale сообщает об этом: Seatbelt на macOS, где он доступен, и опциональный bubblewrap на Linux. Файл constitution.json в репозитории компилируется в блокировки записи, которые не может обойти даже Full Access.
• Работа, которую можно продолжить. Флит записывает каждый шаг в журнал, доступный только на добавление, поэтому fleet resume продолжает с того места, где вы остановились.

Узнать больше

• docs/PROVIDERS.md — все маршруты провайдеров: облачные, шлюзы и локальные
• docs/FLEET.md — флиты, журнал и возобновление работы
• docs/WORKFLOW_EXPERIMENTAL_SEARCH.md — замороженный, нейтральный к провайдерам экспериментальный поиск внутри Workflow
• docs/CONFIGURATION.md — config.toml, хуки и constitution
• docs/AUTHORIZATION_ORDER.md — как сочетаются режимы, хуки, правила разрешений, минимальные требования безопасности, правила репозитория, подтверждения и песочница
• docs/HOOKS.md — одиннадцать событий хуков жизненного цикла TUI, их полезная нагрузка и три из них, способные направлять ход (codewhale exec и подкоманды CLI хуки не запускают)
• docs/WEB.md — браузерный клиент, работающий только на loopback, и его одноразовая граница аутентификации

Всё остальное — режимы, сочетания клавиш, подробности о песочнице, MCP, API рантайма и архитектура — находится в docs и на codewhale.net.

Участие в проекте

Задачи, PR, шаги воспроизведения, логи и запросы функций — всё это настоящая работа над проектом, и первые вклады приветствуются. Когда PR нельзя влить как есть, мейнтейнеры забирают работающие части, сохраняя авторство — в коммите, в списке изменений и в docs/CONTRIBUTORS.md.

• Открытые задачи — здесь живут хорошие задачи для первого вклада
• CONTRIBUTING.md — настройка среды разработки и процесс PR
• docs/CONTRIBUTORS.md — все, кто сформировал этот проект
• Buy me a coffee

Благодарим DeepSeek за модели и поддержку, с которых начался проект, DataWhale 🐋 за теплый приём в семью «Whale Brother», а также OpenWarp и Open Design за сотрудничество в создании терминального агента.

Лицензия

MIT. Независимый проект сообщества, не аффилированный ни с одним провайдером моделей.