| 1 | <!-- source: README.md sha256:a87c9f323f35 --> |
| 2 | # Codewhale |
| 3 | |
| 4 | Открытый агент для программирования в вашем терминале — модель приносите с собой. |
| 5 | |
| 6 | Codewhale начинался как нативный клиент для DeepSeek. С тех пор он вырос в проект, |
| 7 | которым руководит сообщество: единый каркас для программирования, подходящий |
| 8 | растущему международному сообществу и поддерживающий как можно больше моделей и |
| 9 | провайдеров — открытые модели в первую очередь, облачные или локальные, ни один не |
| 10 | имеет привилегий перед остальными. |
| 11 | |
| 12 | Дайте ему провайдера, модель и задачу. Он читает ваш код, правит файлы, запускает |
| 13 | команды и проверяет собственную работу, а затем останавливается, когда задача |
| 14 | выполнена или ему нужны вы. Переключайте модели прямо посреди задачи командой |
| 15 | `/model`. Работайте интерактивно в TUI или запускайте `codewhale exec` в скриптах |
| 16 | и CI. Он написан на Rust, распространяется по лицензии MIT и работает на вашей |
| 17 | машине. |
| 18 | |
| 19 | Мы всегда ищем участников и способы стать лучше. Если модели или провайдера, |
| 20 | которым вы пользуетесь, не хватает, или что-то сломалось, сообщить нам об этом — |
| 21 | одно из самых полезных действий с вашей стороны: см. |
| 22 | [Участие в проекте](#участие-в-проекте). |
| 23 | |
| 24 | [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.uk.md) · [codewhale.net](https://codewhale.net/) · [Docs](docs) · [Changelog](CHANGELOG.md) · [Discord](https://discord.gg/37gfS3ksug) |
| 25 | |
| 26 | [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) |
| 27 | [](https://crates.io/crates/codewhale-cli) |
| 28 | [](https://www.npmjs.com/package/codewhale) |
| 29 | [](https://discord.gg/37gfS3ksug) |
| 30 | |
| 31 |  |
| 32 | |
| 33 | ## Установка |
| 34 | |
| 35 | ```bash |
| 36 | npm install -g codewhale |
| 37 | ``` |
| 38 | |
| 39 | Cargo, Docker, Nix, Scoop, готовые архивы, Android/Termux и зеркало CNB для тех, |
| 40 | кто не может получить доступ к GitHub, описаны в |
| 41 | [docs/INSTALL.md](docs/INSTALL.md). Переходите с `deepseek-tui`? Ваши настройки и |
| 42 | сессии переносятся автоматически — см. [docs/REBRAND.md](docs/REBRAND.md). |
| 43 | |
| 44 | ## Использование |
| 45 | |
| 46 | ```bash |
| 47 | codewhale auth set --provider deepseek # or export ANTHROPIC_API_KEY, etc. |
| 48 | codewhale # open the TUI |
| 49 | codewhale exec "fix the failing test" # headless |
| 50 | codewhale web # local browser client on 127.0.0.1 |
| 51 | ``` |
| 52 | |
| 53 | |
| 54 | В TUI: `/model` переключает провайдера и модель одновременно, `/fleet` запускает |
| 55 | команду воркеров, `/undo` отменяет последний ход, а `/restore <N>` откатывает |
| 56 | рабочую копию к более раннему снимку (`/restore` без аргумента только выводит их |
| 57 | список). Когда поле ввода пустое, `Tab` циклически переключает режимы Plan / |
| 58 | Act / Operate; если в поле есть текст, `Tab` дополняет слэш-команды и упоминания |
| 59 | `@`. `Shift+Tab` переключает уровни прав Ask / Auto-Review / Full Access в любой |
| 60 | момент. `!` запускает команду оболочки через обычный путь подтверждения. |
| 61 | |
| 62 | ## Что он умеет |
| 63 | |
| 64 | - **Любая модель, любой провайдер.** DeepSeek, Claude, GPT, Kimi, GLM и более 30 |
| 65 | провайдеров, плюс ваши собственные vLLM, SGLang или Ollama без ключа — всё |
| 66 | через единый рантайм и единый набор инструментов. Лимиты контекста и цены |
| 67 | берутся из реального маршрута, а неизвестная цена отображается как неизвестная, |
| 68 | а не как $0. |
| 69 | - **Только чтение, пока вы не разрешите больше.** Режим Plan не может изменять |
| 70 | файлы, а рискованные команды требуют подтверждения. Когда команду действительно |
| 71 | оборачивает песочница ОС, Codewhale сообщает об этом: Seatbelt на macOS, где он |
| 72 | доступен, и опциональный bubblewrap на Linux. Файл `constitution.json` в |
| 73 | репозитории компилируется в блокировки записи, которые не может обойти даже |
| 74 | Full Access. |
| 75 | - **Работа, которую можно продолжить.** Флит записывает каждый шаг в журнал, |
| 76 | доступный только на добавление, поэтому `fleet resume` продолжает с того места, |
| 77 | где вы остановились. |
| 78 | |
| 79 | ## Узнать больше |
| 80 | |
| 81 | - [docs/PROVIDERS.md](docs/PROVIDERS.md) — все маршруты провайдеров: облачные, |
| 82 | шлюзы и локальные |
| 83 | - [docs/FLEET.md](docs/FLEET.md) — флиты, журнал и возобновление работы |
| 84 | - [docs/WORKFLOW_EXPERIMENTAL_SEARCH.md](docs/WORKFLOW_EXPERIMENTAL_SEARCH.md) — |
| 85 | замороженный, нейтральный к провайдерам экспериментальный поиск внутри |
| 86 | Workflow |
| 87 | - [docs/CONFIGURATION.md](docs/CONFIGURATION.md) — `config.toml`, хуки и |
| 88 | constitution |
| 89 | - [docs/AUTHORIZATION_ORDER.md](docs/AUTHORIZATION_ORDER.md) — как сочетаются |
| 90 | режимы, хуки, правила разрешений, минимальные требования безопасности, правила |
| 91 | репозитория, подтверждения и песочница |
| 92 | - [docs/HOOKS.md](docs/HOOKS.md) — одиннадцать событий хуков жизненного цикла |
| 93 | TUI, их полезная нагрузка и три из них, способные направлять ход (`codewhale |
| 94 | exec` и подкоманды CLI хуки не запускают) |
| 95 | - [docs/WEB.md](docs/WEB.md) — браузерный клиент, работающий только на loopback, |
| 96 | и его одноразовая граница аутентификации |
| 97 | |
| 98 | Всё остальное — режимы, сочетания клавиш, подробности о песочнице, MCP, API |
| 99 | рантайма и архитектура — находится в [docs](docs) и на |
| 100 | [codewhale.net](https://codewhale.net/). |
| 101 | |
| 102 | ## Участие в проекте |
| 103 | |
| 104 | Задачи, PR, шаги воспроизведения, логи и запросы функций — всё это настоящая |
| 105 | работа над проектом, и первые вклады приветствуются. Когда PR нельзя влить как |
| 106 | есть, мейнтейнеры забирают работающие части, сохраняя авторство — в коммите, в |
| 107 | списке изменений и в [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md). |
| 108 | |
| 109 | - [Открытые задачи](https://github.com/Hmbown/CodeWhale/issues) — здесь живут |
| 110 | хорошие задачи для первого вклада |
| 111 | - [CONTRIBUTING.md](CONTRIBUTING.md) — настройка среды разработки и процесс PR |
| 112 | - [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md) — все, кто сформировал этот проект |
| 113 | - [Buy me a coffee](https://www.buymeacoffee.com/hmbown) |
| 114 | |
| 115 | Благодарим [DeepSeek](https://github.com/deepseek-ai) за модели и поддержку, с |
| 116 | которых начался проект, [DataWhale](https://github.com/datawhalechina) 🐋 за |
| 117 | теплый приём в семью «Whale Brother», а также |
| 118 | [OpenWarp](https://github.com/zerx-lab/warp) и |
| 119 | [Open Design](https://github.com/nexu-io/open-design) за сотрудничество в |
| 120 | создании терминального агента. |
| 121 | |
| 122 | ## Лицензия |
| 123 | |
| 124 | [MIT](LICENSE). Независимый проект сообщества, не аффилированный ни с одним |
| 125 | провайдером моделей. |
| 126 | |
| 127 | [](https://www.star-history.com/?repos=Hmbown%2FCodeWhale&type=date) |
| 128 |