Claude Code Web 2.0 发布：把 Claude Code 变成更顺手的本地 Web 工作台
项目地址：GitHub - heng1234/claude-web: Web UI for Claude Code CLI - token streaming, tool visualization, checkpoint, multi-session management · GitHub
PyPI：Client Challenge
安装命令：pip install --upgrade claude-web-ui
Claude Code Web 2.0 已经发布。
如果你之前用过 1.x 版本，可以把 2.0 理解成一次比较大的“使用体验重构”：它不再只是把 Claude Code CLI 包一层网页，而是把日常聊天、代码任务、本地执行、手机访问、浏览器插件这些场景重新整理了一遍。
一句话概括：
普通问题就像聊天工具一样轻量；需要处理项目时，再切到 Code 工作区。
这也是 2.0 最大的变化。
1. 为什么要做 2.0？
Claude Code 本身很强，但 CLI 形态对很多使用场景并不够舒服：
- 想看历史会话，不方便；
- 想上传图片、文档、PDF，不够直观；
- 想在手机上看结果，不够顺手；
- 想知道 Claude 到底跑了哪些命令，需要翻终端输出；
- 想把网页内容直接丢给 Claude，还要复制粘贴；
- 想让它改代码、跑测试、看 diff，希望有一个更清楚的工作台。
Claude Code Web 的目标一直很简单：
不替代 Claude Code，而是给 Claude Code 加一个本地 Web UI。
2.0 继续保持这个原则：
- 后端仍然调用本机
claudeCLI； - 数据仍然默认保存在本机；
- 不接触 Anthropic API Key；
- 不把会话、图片、文档上传到额外第三方服务；
- 沿用你本地 Claude Code 的登录状态。
2. 安装和升级
前提是你已经安装并登录 Claude Code CLI：
npm install -g @anthropic-ai/claude-code
claude
然后安装或升级 Claude Code Web：
pip install --upgrade claude-web-ui
claude-web --open
默认地址：
http://127.0.0.1:8765
查看版本：
claude-web --version
如果你是从 1.x 升级，建议刷新网页；如果用了 Chrome 插件，也建议到 chrome://extensions 里重新加载一次扩展。
3. 2.0 最大变化：普通聊天和 Code 工作区分开
1.x 版本里，很多“代码开发相关的信息”会一直出现在界面里，比如项目目录、Git 分支、权限模式、工具状态等。
但实际使用时，并不是每一轮都在写代码。
有时候只是问个问题、解释一段文字、整理思路、分析文档。如果界面一直堆着项目和权限信息，就会显得重。
所以 2.0 把入口拆成了两层：
普通聊天
普通聊天保持轻量：
- 不显示项目；
- 不显示 Git 分支；
- 不显示权限模式；
- 不显示代码工作区控件；
- 适合问答、写作、解释资料、联网查询。
Code 工作区
当你需要处理项目，再进入「代码工作区」：
- 显示当前项目；
- 显示 Git 分支；
- 显示运行模式；
- 显示模型和推理强度；
- 显示 Token 上下文；
- 显示代码审查、解释报错、生成补丁、写测试等快捷入口。
这个设计会更接近现在大家熟悉的 Codex / Claude Code 工作流：
普通聊天轻一点，代码任务专注一点。
4. Code 工作区：更像一个本地代码任务面板
2.0 的 Code 工作区主要围绕“让 Claude 处理项目”重新做了一遍。
4.1 工具调用更清楚
以前 Claude 执行 Bash、Read、Write、Edit、Grep、Glob 这类工具时，信息会比较散。
2.0 里工具调用会集中展示：
- 执行了多少步；
- 哪些工具已经完成；
- 当前进度到哪里；
- 命令内容是什么；
- 是否有文件变更。
如果 Claude 修改了文件，界面会显示文件修改摘要，可以打开查看 diff。
这对于代码任务很重要。因为你不只是想知道“它说了什么”，更想知道：
它到底动了哪些文件？为什么动？改了什么？
4.2 项目绑定会话
2.0 里普通聊天和项目会话分开显示。
项目绑定的会话不会混进普通聊天列表里，代码工作区里会按项目归类。这样长期使用时，历史会话不会越堆越乱。
4.3 上下文自动压缩
代码会话很容易越聊越长，尤其是连续分析项目、跑测试、改 bug 的时候。
2.0 增加了自动上下文压缩：
- 接近 Token 上限时先提示“压缩中”；
- 压缩完成后继续执行用户任务；
- 尽量减少因为上下文过长导致的新任务失败。
5. 手机访问：局域网更顺手，公网更谨慎
很多时候 Claude 在电脑上跑任务，人却不一定一直坐在电脑前。
2.0 对手机端做了不少优化：
- 侧栏改成抽屉式；
- 输入框适配手机安全区；
- 搜索浮层恢复完整宽度；
- 代码块、表格、工具结果支持窄屏滚动；
- 手机端不再出现一堆桌面端才需要的复杂控件。
局域网访问可以这样启动：
claude-web --host 192.168.x.x
然后手机打开：
http://192.168.x.x:8765
2.0 会把这些来源视为本地 / 私有来源：
127.0.0.110.0.0.0/8172.16.0.0/12192.168.0.0/16100.64.0.0/10- 链路本地地址
- IPv6 本地 / 私有地址
也就是说，同一个局域网内访问，正常不应该再误要求访问码。
但如果你要公网访问，仍然建议开启访问控制：
- 一次性 6 位访问码；
- 或 Authenticator 动态验证码；
- 配合 HTTPS 反向代理；
- 不建议直接把服务裸露到公网。
因为 Claude Code Web 可以读写本地文件、执行命令、消耗 Claude 配额，所以安全边界必须认真看。
6. 浏览器插件：把当前网页交给 Claude
2.0 继续升级了 Chrome MV3 插件。
它适合这类场景：
- 看一篇技术文章，让 Claude 总结；
- 选中一段代码，让 Claude 解释；
- 在网页里选中报错，让 Claude 分析；
- 读取当前页面正文，然后继续追问；
- 把插件里的草稿转到完整 Web 会话。
安装方式：
- 启动 Claude Code Web；
- 打开「设置 → 浏览器插件」；
- 复制插件目录，或下载 ZIP；
- 在设置里生成插件 Token；
- 打开
chrome://extensions； - 启用开发者模式；
- 加载已解压的扩展；
- 在插件设置页填写服务地址和 Token。
命令行也可以直接查看插件目录：
claude-web --extension-path
注意：chrome://、Chrome Web Store 这类浏览器受限页面不能读取正文，这是 Chrome 扩展机制限制。
7. CLI 会话导入
如果你平时也直接使用 Claude Code CLI，2.0 里可以导入本机 CLI 会话。
侧栏里有「CLI 导入」入口，会扫描 ~/.claude/projects/ 下的历史记录。
2.0 默认先显示最近 10 条，继续滚动再按需加载，避免一次性把历史全部塞进界面。
这对已经积累很多 Claude Code 会话的人比较有用：过去的 CLI 讨论可以接进 Web UI 继续看、继续整理。
8. 设置中心：配置集中一点
2.0 把很多分散功能收到了设置中心：
- 通知；
- 手机访问；
- Authenticator；
- 浏览器插件；
- 费用统计；
- 记忆。
以前有些入口散在不同地方，用久了会找不到。现在更像一个集中控制台。
费用统计也放到了设置里，不再长期占用主界面。
9. 适合哪些人？
我觉得 Claude Code Web 2.0 比较适合这几类用户：
1. 已经在用 Claude Code，但想要 Web UI
如果你已经习惯 Claude Code CLI，又希望有历史会话、图片上传、文档解析、工具可视化和 diff 查看，Claude Code Web 会比较合适。
2. 想让 Claude 长时间处理本地项目
比如：
- 分析一个项目结构；
- 修一个 bug；
- 解释一段报错；
- 生成补丁；
- 写测试；
- 看 Git diff；
- 跑命令验证。
这类任务用纯聊天界面不够清楚，用纯 CLI 又不够直观。Code 工作区就是为这个中间地带做的。
3. 想在手机上看任务结果
比如电脑在跑 Claude，自己拿手机在沙发上看结果，或者局域网里临时访问一下。
2.0 的手机端比 1.x 轻很多。
4. 经常阅读网页、文档、技术文章
浏览器插件可以少很多复制粘贴。
10. 需要注意的边界
Claude Code Web 不是一个云服务，它是本地工具。
这带来两个特点：
优点
- 数据默认留在本机；
- 沿用本机 Claude Code 登录状态；
- 不需要你额外配置 Anthropic API Key；
- 可以处理本地项目、Git、文件和命令。
风险
- 它可以读写本地文件；
- 它可以执行命令；
- 自动模式只适合可信项目；
- 不建议在公网裸奔；
- 插件 Token、访问码、Authenticator Secret 不要泄露。
建议：
- 本地使用：默认
127.0.0.1； - 局域网使用：绑定明确的
192.168.x.x； - 远程使用：优先 Tailscale / ZeroTier 这类私有网络；
- 公网使用：必须 HTTPS + 访问控制 + 限速。
11. 快速命令汇总
安装：
pip install --upgrade claude-web-ui
启动：
claude-web --open
指定端口：
claude-web --port 9000
局域网访问：
claude-web --host 192.168.x.x
查看版本：
claude-web --version
查看浏览器插件目录：
claude-web --extension-path
终端配置 Authenticator：
claude-web --setup-totp
12. 最后
Claude Code Web 2.0 的重点不是堆功能，而是把几个常用场景拆清楚：
- 普通聊天就是普通聊天；
- 写代码就进 Code 工作区；
- 手机访问就保持轻；
- 浏览器插件就负责把网页交给 Claude；
- 设置、费用、授权这些东西集中管理。
如果你正在用 Claude Code，或者想给 Claude Code 加一个更直观的本地界面，可以试一下 2.0。
项目地址：
PyPI：
安装：
pip install --upgrade claude-web-ui
claude-web --open
欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。
更多推荐
4
0- 0
已为社区贡献2条内容
所有评论(0)