Codewhale Web 客户端完整教程：把终端 Agent 搬进浏览器-开发者社区

Codewhale Web 客户端完整教程：把终端 Agent 搬进浏览器

【免费下载链接】CodewhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/Codewhale

Codewhale 是用 Rust 写的开源终端编码 Agent：它读你的代码、改文件、跑命令、自我检查。而codewhale web一条命令，就能把这个终端 Agent 原样搬进你的浏览器——客户端页面就内嵌在二进制里，不装任何前端依赖，启动即用。

适合人群：已安装或准备安装 Codewhale、会基本终端操作的新手用户。

装好 Codewhale：预编译包与源码构建

两种装法任选其一。优先去官方发布页下载对应平台的预编译包，解压即用；想自己构建的开发者，克隆仓库后编译：

# 克隆 Codewhale 仓库 git clone https://gitcode.com/GitHub_Trending/de/Codewhale # 从源码构建发布版二进制 cd CodeWhale && cargo build --release # 验证安装：能打印版本号即代表终端 Agent 已就位 codewhale --version

三步把 Agent 搬进浏览器

第 1 步：进入你的项目目录。Web 客户端会操作当前目录下的仓库，所以先cd到要让 Agent 干活的项目里，再运行：

# 启动本地 Runtime API 服务并释放内嵌的浏览器客户端 codewhale web

这条命令一次干四件事：在http://127.0.0.1:7878启动 Runtime API、从二进制里释放无依赖的浏览器客户端、在终端打印一个一次性启动 URL，然后调用系统默认浏览器打开它。

第 2 步：打开浏览器页面。正常情况下浏览器会自动弹出；没弹出来的话，手动把终端打印的 URL 复制进同一台机器的浏览器——这个凭证10 分钟内有效，用过即作废。

第 3 步：在浏览器里和 Agent 对话。左侧是线程轨道：New thread 新建、搜索历史、重命名、归档；右侧是对话区，底部输入框直接描述任务。Agent 跑起来后，Stop 按钮随时能中断任务；它请求审批、向你要输入时，会以待办的形式直接弹在页面上，当场作答即可。工具回执（receipts）和完整转录都实时呈现——浏览器里看到的会话，和终端里看到的是同一个 Runtime。

看懂浏览器端的核心操作

内嵌客户端提供的不是"缩水版"，而是与终端对等的核心能力：

操作	说明
🧵 线程管理	新建、选择、重命名、归档
▶️ 发起或引导对话	底部输入框描述任务
⏹️ 中断任务	Stop 按钮随时叫停
✅ 处理审批请求	敏感操作批准或拒绝
❓ 回答 Runtime 提问	Agent 提问时直接作答
📋 查看回执与转录	工具调用全程可审计

看懂"本地即本地"的安全边界

很多人会问：把 Agent 放进浏览器，会不会泄密？Codewhale 的答案干脆——本地即本地：

服务永远绑定127.0.0.1；Web 命令只提供--port，没有--host，你连"重绑到局域网"这个选项都找不到；
浏览器启动 URL 里只有随机、短效、一次性的引导凭证，绝不含 Runtime 令牌；访问后凭证立即作废，会话升级为进程本地的HttpOnlyCookie；
浏览器不创建第二套云账号、不往浏览器存储里拷贝模型密钥，你配置的审批与沙箱策略原样生效；
所以别把它当公网网站：不要通过路由器端口转发、公网反向代理或隧道暴露这个端口。