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/CodewhaleCodeWhale 是用 Rust 编写的开源终端编码 Agent。一条codewhale web命令即可释放内置的Web 客户端无需构建、启动即开任务跑起来后你能在浏览器里随时盯住进度。本文从安装讲到启动顺带讲清它的安全边界。为什么需要 codewhale web 浏览器客户端想象一个场景你把一个长任务交给 Agent起身去接了杯水回来发现终端窗口被误关任务到底跑到哪一步无从确认。再比如你人已经坐到工位想跟进昨晚在另一台机器上发起的任务却只开着一个浏览器。浏览器客户端补的就是这个缺口。它不是第二个 Agent而是同一个本地Runtime的另一道入口浏览器里看到的线程、转录、审批请求和终端里是同一份数据。关掉浏览器不影响 Agent 干活Agent 也不会因为多了个窗口就换个性格。底层逻辑很直白codewhale web把 Runtime API 拉起来浏览器页面只是一份跟这个 API 说话的本地页面。前端是个无依赖的单文件客户端直接嵌在二进制里runtime_web/app.mjs。一句话收束终端是驾驶位浏览器是副驾——同一台车两副方向盘。如何启动 codewhale web从安装到打开浏览器如果你还没装 CodeWhale最快的路子是去发布页下载预编译二进制挑与你平台匹配的那个包解压即可偏好源码构建的开发者也可以走这条路git clone https://gitcode.com/GitHub_Trending/de/Codewhale cd Codewhale cargo build --release装完后验证一下codewhale --version能打印版本号就齐活了。接下来是真正启动的部分注意顺序Web 客户端操作的是当前目录下的仓库所以先进项目再起服务cd /path/to/your/project codewhale web这一条命令连做四件事拉起 Runtime API默认http://127.0.0.1:7878、从二进制里放出内嵌客户端、在终端打印一个一次性 URL、请求系统用默认浏览器打开它。要是 7878 正好被别的本地服务占着换个回环端口就行codewhale web --port 8788一句话收束装、进目录、敲命令5 分钟内你就能在浏览器里看见自己的 Agent。界面导览codewhale web 各区域能做什么页面打开后大致分四块每块各管一摊左侧会话轨道新建、搜索、重命名、归档线程都在这里完成历史会话一栏不少。中间对话区Agent 的完整转录和每次工具调用的回执实时呈现它每动一步你都能追溯。底部输入框写一段任务描述就发起一轮任务执行中也可以继续给它引导。弹窗与按钮Agent 要执行敏感命令前审批请求会以弹窗形式出现你直接批准或拒绝它向你提问时页面弹出待办照答即可想叫停点 Stop 就能中断进行中的任务。一句话收束终端上的核心操作在浏览器里一个不少只是从敲键盘换成了点鼠标。安全边界codewhale web 碰得到什么、碰不到什么让 Agent 住进浏览器安全吗拿能 / 不能两条清单来对能碰到的与终端同一套线程、转录和工具回执看什么都是一致的审批请求、Agent 的用户提问、任务中断全都能在页面上处置。碰不到的127.0.0.1以外的一切该命令只提供--port没有任何改绑网卡的选项端口永远只听回环地址局域网里的其他设备看不见它长效凭证浏览器 URL 里只装随机生成的一次性引导凭证10 分钟失效用完即焚浏览器换回的是进程本地的HttpOnly CookieRuntime 令牌既不出现在 URL 里也不落在页面和浏览器存储里第二套账号体系不会在浏览器侧创建云账号不会把模型密钥拷进浏览器存储你已配置的审批与沙箱策略一分不松。⚠️ 还有一点要自己守住别把它当公网站点路由器端口转发、公网反向代理、隧道都别碰——端口一旦朝外本地承诺全部作废。完整的认证边界见 docs/WEB.md。一句话收束这扇门只朝你自己这台机器开钥匙也只有一把。踩坑速查codewhale web 四个常见问题启动后浏览器没自动弹出。引导凭证只有 10 分钟有效期错过基本作废。→ 10 分钟内把终端打印的 URL 复制到同一台机器的浏览器里已过期就重启生成新的。页面提示会话已过期。会话绑定在那次进程上旧进程没了会话也就没了。→CtrlC停掉旧进程重跑codewhale web旧 URL 复用失败属于预期行为。启动时报 codewhale web 端口占用7878 被别的本地服务占了。→ 加--port换个空闲回环端口比如codewhale web --port 8788。页面正常但提示某个 provider 不可用。web 命令只负责开门不管钥匙。→ 跑codewhale doctor体检按/provider的提示补齐供应商凭证。一句话收束页面出的问题八成在终端那一侧——把进程理顺页面自然就好。延伸阅读docs/WEB.mdWeb 客户端完整契约与认证边界docs/RUNTIME_API.md端点、请求头与事件流集成参考docs/ARCHITECTURE.md项目架构总览docs/SANDBOX.md沙箱与审批策略下次给 Agent 派长任务时记得把浏览器标签页也留一份——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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考