CodeWhale Web客户端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 编写的开源终端编码 Agentcoding agent而它的Web 客户端——一条codewhale web命令——就能把这位终端 Agent直接搬进你的浏览器无需安装任何前端依赖客户端页面内嵌在二进制里启动即开。本教程带你 3 步跑通并讲清它的安全边界。适合人群已经或刚刚安装好 CodeWhale 的新手用户。一、先认识 CodeWhale 的终端 Agent在启动 Web 客户端之前先看一眼 CodeWhale 在终端里的样子——深色主题、鲸鱼 ASCII 艺术、顶部实时显示模型与 token 用量底部输入框随时待命Web 客户端并不是第二个 Agent而是同一本地 Runtime 的另一副视图浏览器里看到的会话、工具回执、审批请求和终端里看到的完全一致。相关实现位于 runtime_web/app.mjs 与 runtime_web/index.html。二、安装 CodeWhale前置条件如果你还没装好 CodeWhale两种方式任选其一源码安装适合开发者git clone https://gitcode.com/GitHub_Trending/de/CodeWhale cd CodeWhale cargo build --release下载预编译发布包项目每个版本都会发布预编译二进制选择对应平台的压缩包解压即可发布页如下所示验证安装成功codewhale --version能打印出版本号就说明终端 Agent 已就位。三、三步启动 codewhale web 浏览器客户端第 1 步进入你的工作目录Web 客户端会操作当前目录下的仓库所以先进入你要让 Agent 干活的项目cd /path/to/your/project第 2 步运行 codewhale webcodewhale web这条命令会同时做四件事启动 Runtime API 服务默认地址http://127.0.0.1:7878端口参数见 lib.rs从二进制中释放内嵌的无依赖浏览器客户端在终端打印一个一次性启动 URL调用系统默认浏览器打开该 URL。如果端口 7878 被占用换个回环端口即可codewhale web --port 8788第 3 步在浏览器里开始对话打开后你会看到左侧的会话轨道Threads 面板和右侧的对话区可以New thread新建线程、搜索历史线程、查看保存的会话。界面风格如下深色 Web 客户端主题⚠️ 注意如果浏览器没有自动弹出请在10 分钟内手动复制终端里打印的那个 URL一次性引导凭证 10 分钟后失效。四、浏览器里能做什么Agent 常用操作清单这个内嵌客户端提供了和终端对等的核心能力操作说明 新建 / 选择 / 重命名 / 归档线程左侧会话轨道一键完成▶️ 发起或引导对话轮次在底部输入框描述任务即可⏹️ 中断正在执行的任务点击 Stop 按钮✅ 处理审批请求Agent 执行敏感命令前的 approval 可直接在页面批准/拒绝❓ 回答 Runtime 的用户输入请求Agent 提问时页面会弹出待办直接作答它还能实时呈现工具调用的回执receipts与完整转录。多个任务并行分发时的扇出效果动画演示如下五、为什么它是安全的只属于本地的本地很多用户担心把 Agent 放进浏览器会不会泄密。CodeWhale 的设计答案很干脆——本地即本地Local means local服务永远绑定127.0.0.1codewhale web只提供--port没有--host选项无法重绑到局域网浏览器启动 URL 里是随机、短效、一次性的引导凭证绝不含 Runtime 令牌访问后凭证立即作废会话升级为进程本地的HttpOnlyCookie浏览器不创建第二套云账号不往浏览器存储里拷贝模型密钥也不削弱你已配置的审批与沙箱策略请勿把它当作公网网站不要通过路由器端口转发、公网反向代理或隧道暴露该端口。完整认证边界说明见官方文档 docs/WEB.md 与 docs/RUNTIME_API.md。六、常见问题速查TroubleshootingQ1提示端口 7878 被占用换一个空闲端口codewhale web --port 8788。Q2浏览器没自动打开把终端打印的一次性 URL 复制到同一台机器的浏览器里10 分钟内有效已用过或过期的 URL 需重新运行codewhale web生成新的。Q3页面能打开但提示某个模型供应商provider不可用Web 命令不负责配置模型密钥。运行codewhale doctor体检并检查/provider接口输出按提示补全供应商凭证。Q4提示会话已过期CtrlC停掉旧进程重新运行codewhale web即可铸造新的进程本地会话旧引导 URL 复用失败是预期行为。七、延伸阅读 Web 客户端完整文档docs/WEB.md Runtime API 集成契约端点、请求头、事件流docs/RUNTIME_API.md 沙箱与审批策略docs/SANDBOX.md️ 项目架构总览docs/ARCHITECTURE.md现在打开终端敲下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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CodeWhale Web客户端：codewhale web浏览器操作终端Agent完整教程
CodeWhale Web客户端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 编写的开源终端编码 Agentcoding agent而它的Web 客户端——一条codewhale web命令——就能把这位终端 Agent直接搬进你的浏览器无需安装任何前端依赖客户端页面内嵌在二进制里启动即开。本教程带你 3 步跑通并讲清它的安全边界。适合人群已经或刚刚安装好 CodeWhale 的新手用户。一、先认识 CodeWhale 的终端 Agent在启动 Web 客户端之前先看一眼 CodeWhale 在终端里的样子——深色主题、鲸鱼 ASCII 艺术、顶部实时显示模型与 token 用量底部输入框随时待命Web 客户端并不是第二个 Agent而是同一本地 Runtime 的另一副视图浏览器里看到的会话、工具回执、审批请求和终端里看到的完全一致。相关实现位于 runtime_web/app.mjs 与 runtime_web/index.html。二、安装 CodeWhale前置条件如果你还没装好 CodeWhale两种方式任选其一源码安装适合开发者git clone https://gitcode.com/GitHub_Trending/de/CodeWhale cd CodeWhale cargo build --release下载预编译发布包项目每个版本都会发布预编译二进制选择对应平台的压缩包解压即可发布页如下所示验证安装成功codewhale --version能打印出版本号就说明终端 Agent 已就位。三、三步启动 codewhale web 浏览器客户端第 1 步进入你的工作目录Web 客户端会操作当前目录下的仓库所以先进入你要让 Agent 干活的项目cd /path/to/your/project第 2 步运行 codewhale webcodewhale web这条命令会同时做四件事启动 Runtime API 服务默认地址http://127.0.0.1:7878端口参数见 lib.rs从二进制中释放内嵌的无依赖浏览器客户端在终端打印一个一次性启动 URL调用系统默认浏览器打开该 URL。如果端口 7878 被占用换个回环端口即可codewhale web --port 8788第 3 步在浏览器里开始对话打开后你会看到左侧的会话轨道Threads 面板和右侧的对话区可以New thread新建线程、搜索历史线程、查看保存的会话。界面风格如下深色 Web 客户端主题⚠️ 注意如果浏览器没有自动弹出请在10 分钟内手动复制终端里打印的那个 URL一次性引导凭证 10 分钟后失效。四、浏览器里能做什么Agent 常用操作清单这个内嵌客户端提供了和终端对等的核心能力操作说明 新建 / 选择 / 重命名 / 归档线程左侧会话轨道一键完成▶️ 发起或引导对话轮次在底部输入框描述任务即可⏹️ 中断正在执行的任务点击 Stop 按钮✅ 处理审批请求Agent 执行敏感命令前的 approval 可直接在页面批准/拒绝❓ 回答 Runtime 的用户输入请求Agent 提问时页面会弹出待办直接作答它还能实时呈现工具调用的回执receipts与完整转录。多个任务并行分发时的扇出效果动画演示如下五、为什么它是安全的只属于本地的本地很多用户担心把 Agent 放进浏览器会不会泄密。CodeWhale 的设计答案很干脆——本地即本地Local means local服务永远绑定127.0.0.1codewhale web只提供--port没有--host选项无法重绑到局域网浏览器启动 URL 里是随机、短效、一次性的引导凭证绝不含 Runtime 令牌访问后凭证立即作废会话升级为进程本地的HttpOnlyCookie浏览器不创建第二套云账号不往浏览器存储里拷贝模型密钥也不削弱你已配置的审批与沙箱策略请勿把它当作公网网站不要通过路由器端口转发、公网反向代理或隧道暴露该端口。完整认证边界说明见官方文档 docs/WEB.md 与 docs/RUNTIME_API.md。六、常见问题速查TroubleshootingQ1提示端口 7878 被占用换一个空闲端口codewhale web --port 8788。Q2浏览器没自动打开把终端打印的一次性 URL 复制到同一台机器的浏览器里10 分钟内有效已用过或过期的 URL 需重新运行codewhale web生成新的。Q3页面能打开但提示某个模型供应商provider不可用Web 命令不负责配置模型密钥。运行codewhale doctor体检并检查/provider接口输出按提示补全供应商凭证。Q4提示会话已过期CtrlC停掉旧进程重新运行codewhale web即可铸造新的进程本地会话旧引导 URL 复用失败是预期行为。七、延伸阅读 Web 客户端完整文档docs/WEB.md Runtime API 集成契约端点、请求头、事件流docs/RUNTIME_API.md 沙箱与审批策略docs/SANDBOX.md️ 项目架构总览docs/ARCHITECTURE.md现在打开终端敲下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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考