Skip to content

README.uk.md

Latest commit

 

History

History
188 lines (144 loc) · 13.5 KB

README.uk.md

File metadata and controls

188 lines (144 loc) · 13.5 KB
Raw
Codewhale

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

Codewhale читає ваш проєкт, редагує файли, виконує команди та перевіряє власну роботу — у вашому терміналі, з хмарною чи локальною моделлю на ваш вибір.

CI crates.io npm License: MIT Discord

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

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

Сесія Codewhale в терміналі

Справжній знімок терміналу Codewhale з налаштованого локального демонстраційного сеансу.

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

macOS і Linux:

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

Інсталятор завантажує бінарні файли з перевіркою контрольних сум у ~/.local/bin. Якщо після цього codewhale виводить "command not found", виконайте рядок для PATH, який друкує інсталятор, або див. Додавання до PATH. Оновлюватися можна в будь-який момент командою codewhale update.

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  # build from crates.io

Docker, Nix, Homebrew у Linux, Android/Termux, ручне завантаження з перевіркою контрольних сум і необов’язкове дзеркало CNB описано в посібнику зі встановлення. Оберіть один спосіб: кілька встановлень на одній машині починають конфліктувати через PATH.

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

Ключі API ваших провайдерів — в одному місці. Створіть обліковий запис Codewhale або виконайте codewhale login, щоб увійти. Зберігайте й оновлюйте ключі API в обліковому записі, а потім використовуйте їх через маршрут моделей Codewhale на пристроях, де ви ввійшли. Налаштування ключів облікового запису. Вхід не завантажує наявні локальні ключі до облікового запису; локальна робота доступна й без нього.

  1. Відкрийте проєкт. Запустіть codewhale у теці, з якою хочете працювати.
  2. Підключіть модель. Виконайте /provider (або натисніть F3), щоб додати ключ хмарного провайдера чи вибрати локальний рантайм. Якщо Ollama вже запущено з чат-моделлю, Codewhale сам перемкнеться на неї. Змінити модель можна командою /model.
  3. Дайте конкретне завдання.
Fix the failing tests and explain what changed.

Те саме завдання можна виконати без інтерфейсу — зі скрипту чи завдання CI:

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

Команди й комбінації клавіш показує /help.

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

Кожен клієнт працює з одним і тим самим локальним Runtime Codewhale, тож сесії, інструменти й дозволи всюди поводяться однаково.

Команда Що робить
codewhale Інтерактивний термінальний інтерфейс
codewhale exec "…" Один хід без інтерфейсу зі скрипту чи CI; --auto дозволяє інструменти роботи з файлами та оболонкою, --output-format stream-json виводить JSON потоком
codewhale web Вбудований локальний браузерний клієнт на 127.0.0.1
codewhale review --pr N Рекомендаційний огляд pull request; публікація вмикається окремо
Runtime API Локальний HTTP API для тредів, подій і підтверджень

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

Що він уміє

  • Будь-яка модель, без прив’язки. Понад 40 вбудованих маршрутів до провайдерів — Anthropic, DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI та інші — плюс будь-яка OpenAI-сумісна кінцева точка й локальні моделі через Ollama, vLLM або SGLang. Провайдери
  • Контроль залишається за вами. Режим Plan досліджує проєкт, нічого не змінюючи; Work і Operate вносять зміни. Режими підтвердження визначають, коли виклик інструмента потребує вашої згоди, /undo і /restore повертають зміни в робочому каталозі, а /receipts перелічує кожен файл, команду й підтвердження в сесії. Режими · Квитанції
  • Для довгих завдань. Задайте довготривалу /goal, доручайте обмежені частини роботи субагентам, запускайте контрольовані команди агентів з перевіркою перед витратами або описуйте їх як версійовані робочі процеси.
  • Розширюйте те, чим уже користуєтеся. Підключайте MCP-сервери, встановлюйте навички і плагіни, запускайте гуки на події сесії та інструментів і завантажуйте наявні плагіни Claude Code.
  • Computer Use. Плагін, що входить до комплекту, додає інструменти для спостереження за іншими застосунками та керування ними. Перед використанням перевірте його доступ і ввімкніть його. Посібник

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

Вибір Варіанти
Режим — чим зайнятий агент Tab або /mode Plan (дослідження, без змін) · Work (редагування й запуск) · Operate (веде мету через заплановані й перевірювані кроки)
Підтвердження — коли він питає заздалегідь Shift+Tab Ask · Auto-Review · Full Access

Full Access, як і раніше, дотримується жорстких меж політики. Кожен варіант пояснює посібник з режимів і дозволів.

Безпека

Codewhale працює на вашій машині з тими правами доступу, які ви йому надали. Режими підтвердження та правила репозиторію обмежують дії агента, а команди виконуються всередині пісочниці ОС там, де вона підтримується (Seatbelt у macOS; bubblewrap у Linux, якщо встановлений і працює). /preview-request показує точний запит із вилученими секретами до того, як щось буде надіслано. Невідомі ціни моделей лишаються невідомими, а не видаються за безкоштовні.

Див. порядок авторизації, пісочницю і телеметрію — лічильники використання ввімкнені за замовчуванням, а codewhale config set telemetry false їх вимикає.

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

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

Спільнота

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

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

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

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

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