Codewhale/docs/i18n/README.uk.md

Агент для програмування з відкритим кодом у вашому терміналі, що працює з будь-якою моделлю.

Дайте Codewhale завдання, і він читатиме репозиторій, редагуватиме файли та виконуватиме команди, доки завдання не буде виконано або йому не знадобиться щось від вас. Він працює з понад 40 вбудованими провайдерами (за замовчуванням DeepSeek V4.1 Flash), а також із моделями, запущеними на вашій власній машині. /receipts перелічує змінені ним файли, виконані команди, а також вебзапити й виклики MCP.

Вебсайт · Документація · Журнал змін · Участь у проєкті

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

_{Збірка 0.10.2 для розробки з тестовою моделлю, що діє за сценарієм, з дозволом «Повний доступ» в одноразовому робочому просторі. Зміна, три тести й перевірка субагентом відбулися насправді.}

Переглянути пропозицію Codewhale × OrcaRouter. Codewhale отримує від OrcaRouter винагороду за рекомендації.

Встановлення

macOS і Linux:

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

Інсталятор встановлює в ~/.local/bin перевірені за контрольними сумами codewhale і його короткий псевдонім codew. Якщо після цього оболонка виводить command not found, виконайте рядок для PATH, який друкує інсталятор (докладніше). Оновлення виконує codewhale update. Ці команди встановлюють останній реліз. Ця сторінка відповідає гілці main, тож функція з позначкою версії з’явиться у відповідному релізі; що додає кожен реліз, дивіться в журналі змін.

Windows, npm, Cargo та інші способи встановлення

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  # crates.io; can trail GitHub Releases

Готові бінарні файли є для Linux, macOS і Windows на x64 та arm64. Nix, Homebrew у Linux, Android/Termux (попередня версія) і ручне завантаження описано в посібнику зі встановлення, а контейнери — у Docker. Використовуйте на одній машині лише один спосіб встановлення, інакше в PATH опиняться дві копії й спрацює та, що стоїть першою.

Швидкий старт

1. Закомітьте або відкладіть у stash свою роботу, потім запустіть codewhale з кореня git-репозиторію. За замовчуванням він застосовує там зміни у файлах без запиту й показує вам diff.
2. Виконайте /provider (або натисніть F3), виберіть провайдера, вставте його ключ API і виберіть модель. Провайдер за замовчуванням — DeepSeek. Якщо ключа немає, виберіть натомість локальний рантайм. Якщо жодного провайдера не налаштовано, а в Ollama вже запущено чат-модель, Codewhale автоматично використає її; починаючи з 0.10.2, він пропонує її, коли ви надсилаєте перше повідомлення.
3. Введіть завдання:

Fix the failing tests and explain what changed.

Команди лише для читання виконуються одразу. Перед будь-якою іншою командою оболонки Codewhale спершу питає: y виконує її один раз, a дозволяє подібні команди до кінця розмови, n відмовляє. /undo скасовує ваш останній запит разом із його змінами у файлах. /help показує команди й клавіші.

Для скриптів і CI codewhale exec виконує одне завдання без інтерфейсу. За замовчуванням --auto використовує «Повний доступ»: інструменти виконуються без запиту, команди оболонки працюють без пісочниці Codewhale, а режим довіри дозволяє файловим інструментам записувати файли поза робочим простором. Додайте --sandbox workspace-write, щоб зберегти пісочницю оболонки й обмежити файлові інструменти робочим простором, вимкнувши режим довіри:

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

Режими й дозволи

Після нового встановлення Codewhale запускається в режимі Work з дозволом «Запитувати».

	Як перемкнути	Варіанти
Режим	Tab (коли поле введення порожнє) або /mode	Plan читає й шукає, але нічого не змінює. Work редагує файли й виконує команди. Operate має той самий доступ, що й Work, сприймає ваш запит як ціль і продовжує роботу, доки досягнення цілі не буде перевірено або йому не знадобиться щось від вас.
Дозвіл	Shift+Tab	Запитувати (Ask) застосовує зміни у файлах вашого репозиторію без запиту й питає перед командами оболонки, які не є лише для читання. Автоперевірка (Auto-Review) дає правилам і моделі-рецензенту схвалювати рутинні виклики й відхиляє виклики з високим ризиком; щоб схвалювати їх самостійно, перейдіть на «Запитувати». Повний доступ (Full Access) ніколи не питає й вимикає пісочницю Codewhale; правила репозиторію та керована політика й далі діють.

Докладніше — у посібнику з режимів і дозволів.

Що він уміє

Нове в 0.10.2

• /pet on перетворює ваш термінал на анімованого кита, який показує, що робить агент, а поле повідомлення при цьому лишається активним. Його 980 частинок складаються в назву поточного кроку англійською, китайською або японською.
• /workbar terminal показує оболонки, які запускає агент, просто під час їхньої роботи. У будь-яку з них можна вводити текст, а Ctrl+N відкриває вашу власну оболонку (macOS і Linux).
• /undo за один крок скасовує весь ваш останній запит разом з усіма зміненими ним файлами, а /diff працює в теках без Git.
• Коли план готовий, Codewhale питає, чи почати Work із дозволом «Запитувати» або «Автоперевірка», чи продовжити планування.
• /color дає кожному чату власний колір поля введення, що зберігається разом із сесією.
• web_search може використовувати новий Search API від DeepSeek: задайте [search] provider = "deepseek" і ключ DeepSeek.
• Поза «Повним доступом» curl або wget, що надіслали б облікові дані, ніколи не виконуються без вашого схвалення, а команду, що приховує невидимі символи Unicode, буде відхилено. write більше не замінює файл, який агент не читав або який змінився після того, як агент його прочитав.

Моделі

Вбудовано понад 40 провайдерів, серед них Anthropic, OpenAI, DeepSeek, Google, Mistral, Moonshot, OpenRouter і xAI. Працює будь-яка OpenAI-сумісна кінцева точка, а також локальні моделі через Ollama, vLLM або SGLang. За замовчуванням використовується deepseek-flash від DeepSeek, який DeepSeek 2026-10-17 переключив на DeepSeek-V4.1-Flash-1017; 0.10.1 працює з ним без оновлення (докладніше).

/model перемикає модель між ходами, а /model auto вибирає модель для кожного ходу (як саме, налаштовує /router). /turn inspect показує, яку модель використав хід, скільки він коштував і скільки тривав. codewhale auth chatgpt дає змогу користуватися підпискою ChatGPT замість ключа API (експериментально). Див. Провайдери.

Квитанції та скасування

/receipts (або codewhale receipts --last після виходу) перелічує змінені файли, виконані команди, вебзапити й виклики MCP, запущених агентів, підтвердження і те, хто їх дав, а також збої. /undo скасовує ваш останній запит і зміни у його файлах за один крок, без режиму довіри. /restore повертає весь робочий простір до раніше збереженого знімка; оскільки це перезаписує пізніші зміни, потрібен /trust on або «Повний доступ». Див. Квитанції.

Запуски exec, у яких доступні інструменти, зберігаються за будь-якого формату виводу, тому codewhale receipts --last працює після exec --auto, зокрема з --json. Запуски без інструментів із текстовим виводом або --json зберігаються лише при відновленні або коли починається стиснення розмови; використовуйте --output-format stream-json, щоб завжди зберігати їх для квитанцій або exec --continue.

Довші завдання

/goal задає ціль, яка зберігається між ходами. Codewhale може розподіляти роботу між субагентами, запускати групу агентів або виконувати робочий процес, збережений у репозиторії.

Перехід з іншого агента

Codewhale сам читає AGENTS.md. Файли інструкцій, написані для інших інструментів, як-от CLAUDE.md, .cursorrules або .github/copilot-instructions.md, завантажуються лише тоді, коли ви явно ввімкнете це через project_instruction_imports = ["claude"] (або "cursor", "cline", "windsurf", "copilot", "all") у своїй конфігурації; див. config.example.toml. Codewhale попереджає, коли знаходить такий файл, але не завантажує його.

/import-claude готує імпорт ваших налаштувань Claude Code і MCP-серверів, щоб ви його переглянули. /plugin install приймає плагіни Claude Code, що містять навички, команди, профілі агентів і MCP-сервери, і відхиляє плагіни, яким потрібні гуки або LSP-сервери (докладніше).

Розширення

Підключайте MCP-сервери, додавайте навички і плагіни та запускайте гуки на події сесії та інструментів. Code mode (експериментальний, увімкнений за замовчуванням) дає моделі змогу написати одну програму execute_tools, яка викликає кілька інструментів MCP і плагінів; кожен виклик і далі проходить через ваші правила підтвердження й отримує свою квитанцію. Окремо встановлюваний плагін Computer Use (експериментальний, лише для macOS), може спостерігати за іншими застосунками й керувати ними. Він залишається вимкненим, доки ви не перевірите його доступ і не ввімкнете його (посібник).

Способи запуску

Команда	Що робить
codewhale	Інтерактивний термінальний застосунок
codewhale exec "…"	Одне завдання без інтерфейсу. Без додаткових прапорців він відповідає, не використовуючи інструментів; --auto за замовчуванням вмикає інструменти з «Повним доступом», --sandbox workspace-write обмежує їх, а --output-format stream-json передає події потоком у форматі JSON
codewhale web	Локальний вебінтерфейс на 127.0.0.1 (посібник)
codewhale review --pr N	Рекомендаційний огляд pull request у GitHub. Налаштування бота GitHub створює закріплений workflow для автоматичних оглядів і @codewhale review, використовуючи власний ключ моделі та необов'язкову ідентифікацію App
codewhale app-server --http	Runtime API — локальний HTTP API для тредів, подій, підтверджень і змін у файлах кожного ходу
codewhale serve --acp	Agent Client Protocol через stdio для редакторів, як-от Zed

Термінальний застосунок, exec, web і Runtime API використовують один рушій (архітектура). Підтримуване спільнотою розширення для VS Code підключається до нього з бічної панелі (вихідний код). Нативний настільний застосунок на основі Runtime API в розробці; публічного завантаження для нього поки немає.

Вартість і облікові записи

Codewhale безкоштовний і поширюється за ліцензією MIT. З власним ключем API ви платите провайдерові напряму; локальним моделям ключ не потрібен. Нижній рядок і /cost показують, скільки коштувала сесія, якщо ціна відома; невідома ціна показується як невідома і ніколи — як безкоштовна.

Обліковий запис не обов’язковий. Ключі, які ви додаєте через /provider, залишаються на вашій машині.

Безпека й конфіденційність

З дозволами «Запитувати» й «Автоперевірка» команди виконуються в пісочниці ОС, якщо система її має: Seatbelt у macOS і bubblewrap у Linux, якщо його встановлено. У Windows пісочниці ОС поки немає, а «Повний доступ» вимикає пісочницю. Усередині пісочниці команди оболонки не можуть читати сховища облікових даних, як-от ~/.ssh, ~/.aws і файли .env; починаючи з 0.10.2, те саме правило поширюється на термінальні сесії та більше файлових інструментів. /preview-request показує наступний запит із прихованими чутливими даними, не надсилаючи його.

Телеметрію ввімкнено за замовчуванням. Вона надсилає агреговані лічильники (версія й платформа, тривалість і результат сесії, які вбудовані провайдери ви використовували, лічильники функцій і помилок) разом із випадковим ідентифікатором встановлення, який змінюється кожні 90 днів, і ніколи не надсилає розмови, код, промпти, назви моделей, назви файлів чи репозиторіїв або облікові дані. codewhale config set telemetry false її вимикає. Під час запуску Codewhale також перевіряє на GitHub, чи вийшов новий реліз; щоб пропустити цю перевірку, задайте CODEWHALE_NO_UPDATE_CHECK=1. Докладніше: порядок авторизації, пісочниця і телеметрія.

Документація

З чого почати	Довідка
Встановлення	Конфігурація
Провайдери та локальні моделі	Архітектура
Режими й дозволи	Runtime API
Комбінації клавіш	Створення плагінів
Огляд PR у GitHub	Уся документація

Спільнота

Якщо бракує провайдера або якийсь сценарій роботи незручний, відкрийте issue або надішліть pull request. Автори зберігають визнання за прийняту роботу, а структура репозиторію показує, де що лежить.

Спілкуйтеся в Discord або додайте супровідника проєкту, Гантера, у WeChat (hunterbown) і попросіть додати вас до групи Whale Brothers.

Історія та ліцензія

Codewhale починався як deepseek-tui і досі читає конфігурацію та сесії того проєкту. Він розвивається незалежно й не пов’язаний ні з DeepSeek, ні з жодним іншим провайдером моделей. Дякуємо усім, хто долучився до проєкту.

MIT. Код, адаптований з інших проєктів із відкритим кодом, перелічено в повідомленнях про сторонні компоненти.