Codewhale 是一款面向终端的开源编程智能体，使用 Rust 构建，并与用户一起在公开协作中不断改进。
English · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català
macOS / Linux：推荐安装官方 GitHub Release。
curl -fsSL https://codewhale.net/install.sh | sh
"$HOME/.local/bin/codewhale"Windows 请使用 GitHub Releases
中的安装器或压缩包。已有的直接安装使用 codewhale update；它会显示当前可执行文件路径，
并保留比已发布版本更新的构建。npm 和 Cargo 是次要打包选项。
迁移与 PATH 排查见安装指南。
首次运行会帮助你连接提供商，也可以选择保持离线。Codewhale 还支持 Cargo、Docker、Nix、Scoop、预构建压缩包、Android/Termux 和 CNB 镜像。请参阅安装指南。
每种 shell 只需一条命令即可启用 Tab 补全——codewhale completion bash|zsh|fish|powershell|elvish。请参阅 shell 补全。
像与队友交流一样向 Codewhale 描述任务：
Fix the failing tests and explain what changed.
也可以不打开 TUI，直接运行任务：
codewhale exec "fix the failing tests and explain what changed"Codewhale 可以读取你的代码仓库、编辑文件、运行命令、检查结果，并持续推进目标。由你决定授予它多少访问权限。
更喜欢图形界面？社区维护的 CodeWhale for VS Code 扩展把同一个智能体放进 VS Code 侧边栏——聊天、线程会话、实时 diff 与任务管理，全部基于同一个 Runtime API，会话与终端保持同步。可从 VS Code Marketplace 安装；源码见 GitHub。
- 使用你想要的模型。 连接托管提供商，或通过 Ollama、vLLM、SGLang 使用本地模型。使用
/model切换提供商和模型。 - 掌控始终在你手中。 Plan 模式为只读。Ask、Auto-Review 和 Full Access 会清晰展示审批行为。
/undo可撤销上一轮操作，/restore可将工作区恢复到较早的快照。 - 让长时间任务井然有序。 保存会话、设置持久的
/goal、在工作流运行前进行审查，并协调多个智能体，同时不让其内部指令混入你的对话记录。 - 扩展你已有的智能体。 连接 MCP 服务器和技能、配置钩子，并将智能体角色作为可读文件保存在项目或个人设置中。
在 TUI 中运行 /help 可查看命令和键盘快捷键。
Codewhale 在你的机器上运行，并仅拥有你授予的访问权限。审批模式和仓库规则会限制智能体的行为；在支持的平台上，可选的操作系统沙箱可提供更强的执行边界。未知的模型价格会保持显示为未知，而不会被误报为免费。
当人们使用 Codewhale、反馈不顺手之处并帮助修复问题时，它就会变得更好。如果缺少某个提供商、工作流体验不佳，或终端界面妨碍了你，请提交 issue。如果你知道如何改进，请提交 pull request。我们欢迎首次贡献，贡献者也会保留已合入工作的署名。
加入 Discord，或在微信添加 Hunter（hunterbown）并申请加入 Whale Brothers 群。
Codewhale 起初名为 deepseek-tui，至今仍保留与其配置和会话的兼容性。如今它已不偏向任何提供商，由社区独立维护，也不隶属于任何模型提供商。
感谢每一位贡献者，以及帮助项目成长的开源社区。请参阅贡献者记录。