桌面端的本地 agent

桌面客户端的聊天面板除了云端 AI，还能用跑在你电脑上的编程 agent。它们在连接了本地文件夹的工作区里干活：直接读写那个文件夹里的文件，有完整的 shell、Python 与 Node.js，改动由客户端在后台同步上去。

选一个 agent

在聊天面板底部的 agent 选择器里选：

工作区没有连接本地文件夹时，本地 agent 是灰的，点「连接到本地文件夹…」连接一个就能用。

安装与登录 Claude Code、Codex

选择器里显示「未安装」时，展开它能看到官方的安装命令（可以直接复制）与安装文档。装好后点「重新检测」。

第一次使用前，在终端里运行一次 claude 或 codex 并按提示登录。VizChat 用的就是你装的那一份和你的登录，不另外保存你的密码或 key。

内置 Pi 与模型

Pi 的模型选择与网页端的云端 AI 相同：官方模型扣 VizChat 积分，你在「设置 → 自定义模型」里添加的 key 用你自己的账户。自定义接口（「其他（OpenAI 兼容）」）可以填任意地址，包括公司内网或局域网里的模型服务——桌面端直接连它，请求不经过 VizChat 的服务器。

离线时官方模型与经服务端转发的 key 用不了；自定义接口如果在本机或局域网里，断网也照样能用。

agent 能做什么

agent 带着 VizChat 的 skill 与 vizchat 命令行，能读写 board 与 widget、校验与渲染（在你电脑上渲染，不用先推送，离线也能用）、检索网页。它要修改文件或运行命令时，按 agent 自己的权限设置请示你，确认框出现在聊天里。

关掉面板不会打断正在进行的一轮：agent 会做完，结果在对话记录里。退出客户端则会停止所有进行中的对话。

对话记录

本地 agent 的对话保存在你的电脑上，并同步到你的账号：在别的设备、网页端都能看到，但只能在原来那台电脑上接着聊。某个对话接不上时（agent 那边的记录没了，或它来自别处），可以「总结并在新会话中继续」——总结由你选的本地 agent 生成。

在终端里用同一个命令

macOS 上点菜单「VizChat → 安装 vizchat 命令…」，之后任何终端里的 vizchat 都是随客户端的那一份：用客户端登录的账号，连接了的文件夹由客户端同步。见本地工作区命令行。