# Codewhale Агент для програмування з відкритим кодом у вашому терміналі — модель приносите ви. Codewhale починався як нативний інструмент для DeepSeek. Відтоді він виріс у проєкт, яким керує спільнота: єдине середовище для програмування, яке підходить міжнародній спільноті, що зростає, і підтримує якнайбільше моделей та провайдерів — відкриті моделі насамперед, хмарні чи локальні, жодна не має переваги перед іншими. Дайте йому провайдера, модель і завдання. Він читає ваш код, редагує файли, виконує команди й перевіряє власну роботу, а потім зупиняється, коли робота завершена або коли йому потрібні ви. Перемикайте моделі в розпалі завдання командою `/model`. Працюйте інтерактивно в TUI або запускайте `codewhale exec` у скриптах і CI. Він написаний на Rust, поширюється за ліцензією MIT і працює на вашому комп'ютері. Чим це не схоже на інші harness: **ви самі обираєте модель для кожної ролі, і вони не мусять збігатися.** Fleet закріплює провайдера, модель і рівень міркувань окремо для кожної ролі — тож дешева і швидка модель може керувати дорогою міркувальною, а builder на GLM може працювати над тим самим завданням, що й reviewer на Kimi. Опишіть свої ролі та свою constitution — і harness стане вашим, а не нашим. Ми завжди шукаємо учасників і способи стати кращими. Якщо моделі чи провайдера, якими ви користуєтесь, бракує, або щось ламається, повідомити про це — одна з найкорисніших речей, які ви можете зробити — див. [Участь у проєкті](#участь-у-проєкті). [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [codewhale.net](https://codewhale.net/) · [Документація](docs) · [Журнал змін](CHANGELOG.md) · [Discord](https://discord.gg/37gfS3ksug) [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) [](https://crates.io/crates/codewhale-cli) [](https://www.npmjs.com/package/codewhale) [](https://discord.gg/37gfS3ksug)  ## Встановлення ```bash npm install -g codewhale ``` Cargo, Docker, Nix, Scoop, готові архіви, Android/Termux, а також дзеркало CNB для тих, хто не може отримати доступ до GitHub, описані в [docs/INSTALL.md](docs/INSTALL.md). Переходите з `deepseek-tui`? Ваші налаштування й сесії переносяться — див. [docs/REBRAND.md](docs/REBRAND.md). ## Використання ```bash 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 ` відкочує робочу копію до давнішого знімка (`/restore` без аргументу лише виводить їхній список). Коли поле введення порожнє, `Tab` циклічно перемикає Plan / Work / Operate; якщо в полі є текст, `Tab` доповнює слеш-команди та згадки `@`. `Shift+Tab` перемикає режими дозволів Ask / Auto-Review / Full Access будь-коли. `!` виконує команду оболонки через звичайний шлях затвердження. ## Що він уміє - **Будь-яка модель, будь-який провайдер.** DeepSeek, Claude, GPT, Kimi, GLM та понад 30 провайдерів, а також власні vLLM, SGLang чи Ollama без жодного ключа — усе через одне середовище виконання й один набір інструментів. Ліміти контексту й ціни беруться з реального маршруту, а невідома ціна показується як невідома, а не як $0. - **Harness, який пишете ви.** Ролі — це файли, які можна прочитати й змінити: для кожної ролі своя модель, своя позиція щодо інструментів і постійні інструкції. Тримайте їх у проєкті, щоб ними користувалася команда, або поруч з особистими налаштуваннями, щоб вони йшли за вами між репозиторіями. Constitution фіксує, як ви хочете, щоб агент поводився в кожній сесії, — тож harness підлаштовується під вашу практику, а не під нашу. - **Лише читання, доки ви не дозволите більше.** Режим Plan не може змінювати файли, а ризиковані команди проходять через затвердження. Коли пісочниця ОС справді обгортає команду, Codewhale каже про це: Seatbelt на macOS, де він доступний, і bubblewrap за бажанням на Linux. `constitution.json` репозиторію компілюється у блокування запису, які не може обійти навіть Full Access. - **Робота, яку можна відновити.** Флот записує кожен крок до журналу, що лише доповнюється, тож `fleet resume` підхоплює роботу з місця, де ви зупинились. ## Дізнатися більше - [docs/PROVIDERS.md](docs/PROVIDERS.md) — кожен маршрут провайдера: хмарний, шлюзовий і локальний - [docs/FLEET.md](docs/FLEET.md) — флоти, журнал і відновлення - [docs/WORKFLOW_EXPERIMENTAL_SEARCH.md](docs/WORKFLOW_EXPERIMENTAL_SEARCH.md) — заморожений, нейтральний до провайдерів експериментальний пошук у Workflow - [docs/CONFIGURATION.md](docs/CONFIGURATION.md) — `config.toml`, хуки й конституція - [docs/AUTHORIZATION_ORDER.md](docs/AUTHORIZATION_ORDER.md) — як поєднуються режими, хуки, правила дозволів, мінімальні вимоги безпеки, правила репозиторію, затвердження та пісочниця - [docs/HOOKS.md](docs/HOOKS.md) — одинадцять подій хуків життєвого циклу TUI, їхні корисні навантаження та три з них, що можуть скеровувати хід (`codewhale exec` і підкоманди CLI хуків не запускають) - [docs/WEB.md](docs/WEB.md) — браузерний клієнт, доступний лише через loopback, і його межа одноразової автентифікації Усе решта — режими, комбінації клавіш, деталі пісочниці, MCP, API середовища виконання й архітектура — знаходиться в [docs](docs) і на [codewhale.net](https://codewhale.net/). ## Участь у проєкті Звіти про проблеми, PR, кроки відтворення, журнали й побажання щодо функцій — усе це справжня робота над проєктом, і перші внески вітаються. Коли PR не можна злити як є, супровідники забирають те, що працює, і зберігають авторство — у коміті, в журналі змін і в [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md). - [Відкриті issues](https://github.com/Hmbown/CodeWhale/issues) — тут живуть хороші перші внески - [CONTRIBUTING.md](CONTRIBUTING.md) — налаштування середовища розробки й процес PR - [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md) — усі, хто сформував цей проєкт - [Buy me a coffee](https://www.buymeacoffee.com/hmbown) Дякуємо [DeepSeek](https://github.com/deepseek-ai) за моделі й підтримку, з яких почався проєкт, [DataWhale](https://github.com/datawhalechina) 🐋 за те, що прийняли нас у родину Китових Братів, а також [OpenWarp](https://github.com/zerx-lab/warp) і [Open Design](https://github.com/nexu-io/open-design) за співпрацю над досвідом термінального агента. ## Ліцензія [MIT](LICENSE). Незалежний проєкт спільноти, не пов'язаний із жодним провайдером моделей. [](https://www.star-history.com/?repos=Hmbown%2FCodeWhale&type=date)