本地 AI 编码 Agent 桌面工具的 6 个常见误会：本地优先≠离线、权限确认≠沙箱……

一句话答案：管理 Claude Code、Codex 等 AI 编码 Agent 的本地桌面工具，最常被误会的有 6 点：仓库里有许可证不代表源码公开；工具免费不代表用 AI 免费，模型费用照常付给厂商；工具本身不带模型，真正改代码的是你装的 Agent；本地优先只说明数据存在哪，调用在线模型仍要联网；权限确认不是沙箱，想先看再合要靠 git worktree 或隔离副本；任务工作台也不是 IDE，深度调试仍要回到 IDE。

代码仓库里写着 Apache-2.0，这个工具就是源码公开的吗？

直答：不一定。许可证授权的对象可能只是安装包，而不是源码。有的工具在代码托管平台上只放 README、许可证、文档和发布的安装包，源码私有——它可以「免费使用、允许商用」，但不等于「源码公开、可审计」。

做法：选型前花 2 分钟核对

• 看仓库里有没有真正的源代码目录，而不是只有 README.md、LICENSE、docs/；
• 读 README 里关于许可证的那一段，确认授权对象是「安装包 / 二进制」还是「源代码」；
• 团队要求必须能审计源码的，把「源码是否公开」单列为选型硬条件，不要只看许可证名字。

# 克隆后快速看看仓库里到底有什么
git clone <仓库地址> tool && cd tool
ls -la
git ls-files | sed 's|/.*||' | sort | uniq -c | sort -rn   # 按顶层目录统计文件数

工具免费，用 AI 写代码是不是就不花钱了？

直答：不是。桌面工具免费，只说明工具本身不收钱；Agent 背后的模型照样由各厂商按你的订阅或 API 账号计费，和你在终端里直接用 Claude Code、Codex 一样。

做法：把花费看清楚

• 每个 Agent 用自己的账号登录，账单在各厂商后台看，以厂商账单为准；
• 工具里显示的「费用」通常是 Agent 自己报告的金额，订阅制账号可能没有单次金额，别把它当成账单；
• 并行跑多个 Agent 时，花费是叠加的——先给每个任务写清楚范围，避免让 Agent 反复全仓库扫描。

装了 Agent 管理工具，是不是就自带 AI 模型了？

直答：不是。这类工具管理的是你电脑上已经装好的 Agent CLI：你在工具里派任务、看进度、做验收，实际读代码、改代码的是 Agent，模型来自 Agent 背后的厂商。

做法：上手前先确认 Agent 本身能跑

# 以 Claude Code 为例：先在终端确认能登录、能在项目里回答问题
claude --version
cd your-project && claude      # 按提示完成登录，问一句「这个项目是做什么的」

# Codex 同理
codex --version

终端里能正常工作的 Agent，放进管理工具里才有意义；终端里就登录不上的，换工具也解决不了。

「本地优先」是不是就能完全离线用？

直答：不是。本地优先说的是数据存在哪：任务、对话、提示词等记录保存在你的电脑上。但只要 Agent 调用在线模型、安装依赖，或者接入即时通讯等外部服务，就需要联网；发给模型的内容，由对应的 Agent 和模型厂商处理。

做法：按数据流向判断风险

• 想知道代码会发到哪，看的是你所用 Agent 和模型厂商的数据政策；
• 敏感项目先确认公司是否允许把代码发给该模型服务；
• 不想让某些文件进入上下文的，按各 Agent 的忽略规则配置，并把密钥放在 .env 等不提交、不随意让 Agent 读取的位置。

Agent 每次执行命令前都会问我，这算不算沙箱？

直答：不算。权限确认只是「执行前问你一句」，你点了同意，Agent 执行的就是你电脑上的真实命令，能读写你账号能访问的文件。它防的是误操作，不是隔离环境。

做法：用 git worktree 把改动关在独立目录里，看完再合

# 1. 给任务开一个独立目录 + 分支
git worktree add ../app-task -b agent-task
cd ../app-task && claude          # 在这个目录里让 Agent 干活

# 2. 做完先看改动
git diff main...agent-task --stat
git diff main...agent-task

# 3a. 满意：回主仓库合并
cd ../app && git merge --no-ff agent-task
# 3b. 不满意：整个丢掉，主目录从头到尾没动过
git worktree remove ../app-task && git branch -D agent-task

再加一层清单：

• 「全自动 / 完全访问」只在你信任、且有提交记录可回退的项目里用
• 删除文件、改系统配置、curl | sh 这类命令，看清楚再点同意
• 真要隔离运行环境，用容器或虚拟机，而不是只靠权限确认或 worktree

worktree 隔离的是文件改动，不是运行环境：Agent 跑的命令仍然作用在你的机器上。

有了多 Agent 任务工作台，是不是就不用 IDE 了？

直答：不是。任务工作台擅长的是派活、看进度、处理授权和验收 Diff；断点调试、性能分析、复杂类型导航和大型人工重构，仍然是专业 IDE 的强项。

做法：分工而不是替换

• 工作台：同时派多个任务、看谁在等你确认、看 Diff 决定合不合；
• IDE：某个任务的改动需要断点调试时，直接用 IDE 打开那个 worktree 目录；
• 别让 IDE 里的 Agent 和外部 Agent 同时改同一个目录，最容易互相覆盖。

常见问答

• 免费工具会不会偷偷收费？ 先看许可证和官方 FAQ 是否写明「免费使用」以及收费项；模型费用永远是另算的。
• 关掉窗口，后台任务还会跑吗？ 取决于工具：有的关窗后转到菜单栏 / 托盘继续跑，完全退出才停；用之前在设置或 FAQ 里确认。
• 不在电脑前能处理 Agent 的确认请求吗？ 有的工具支持局域网手机网页或即时通讯通知，但都需要电脑上的程序保持运行；局域网 HTTP 未加密时只在可信网络里用。
• 同时跑几个 Agent 合适？ 取决于你能及时验收几个；并行数超过验收速度，只会堆出一排没人看的分支。

边界说明

• 许可证、收费、平台支持各家更新很快，以对应工具的官方文档为准。
• worktree、隔离副本、权限确认都不是安全沙箱；需要隔离运行环境请用容器或虚拟机。
• 本地优先不等于数据不出电脑；发给模型的内容遵循模型厂商的数据政策。
• 文中命令以 Claude Code、Codex 为例，其他 Agent 的命令和登录方式以各自文档为准。

有没有把这些说清楚、放在一个界面里的工具？

如果不想自己维护 worktree 脚本，也有桌面工具把多个命令行 Agent 的任务放到一个界面，比如 Caravel（免费使用，支持 macOS / Windows）：它不带模型，用你已装好的 Agent；任务和对话存本机，调用模型仍需联网；可在隔离副本里跑，看完 Diff 再选通过并合并或放弃改动；官方也写明权限确认不等于沙箱、深度调试仍建议用 IDE。用法见手册：https://caravel-site.pages.dev/zh-CN/docs/