用 Craft Agents 把 Claude 装进桌面：从安装到第一行代码的完整指南
“我不想再切浏览器、再复制粘贴，只想让 Claude 像本地软件一样，帮我改文档、查资料、跑脚本。”
—— 一位刚下班的产品经理
如果你也有同样的念头，这篇文章就是答案。下面我会用问答+步骤的方式，带你把 Craft Agents 装到电脑里，并让它真正替你干活。全文 3 000 字以上，照着做就能跑起来，不需要补任何外部知识。
1. Craft Agents 到底是什么？
一句话：
Craft Agents = 桌面版 Claude + 可视化工具箱 + 本地文件管家。
它把 Claude 的聊天能力封装成桌面应用，再把“连 API、读本地文件、改代码、做任务”这些动作做成按钮。你只管说话，它帮你跑腿。
2. 我为什么不用网页版 Claude？
| 场景 | 网页版 Claude | Craft Agents |
|---|---|---|
| 一次性上传 20 张截图 | 手动一张张传 | 拖进去自动转文字 |
| 让 Claude 改本地代码 | 复制→粘贴→再复制回来 | 直接保存到硬盘 |
| 连续问 10 个任务 | 聊天记录混在一起 | 每个任务独立会话，可归档、可标记 |
| 公司内网文档 | 传不上去 | 本地 MCP 服务器直接读 |
3. 安装：一条命令搞定
3.1 macOS / Linux
打开终端，复制下面这行，回车：
curl -fsSL https://agents.craft.do/install-app.sh | bash
看到“Craft Agents 已安装”即可。
3.2 Windows
按 Win+R → 输入 powershell → 粘贴：
irm https://agents.craft.do/install-app.ps1 | iex
安装完在开始菜单找到图标。
3.3 常见问题（FAQ）
Q: 公司电脑没管理员权限能装吗？
A: 安装器默认写 $HOME/Applications，无需 sudo。若公司策略限制 curl，可让同事传压缩包给你，解压即用。
Q: 装完打不开？
A: 90% 是杀毒软件误报。把执行文件加入白名单即可，源码完全开源，可自查。
4. 第一次启动：3 分钟配置
-
双击图标 → 选“使用自己的 Anthropic API Key”
（没有 key 就去 Anthropic 控制台 申请，5 美元额度够用很久） -
新建 workspace，名字随便写，比如“Blog写作”
workspace 相当于项目文件夹，不同项目互不干扰。 -
跳过“添加数据源”，先体验裸聊。
后面需要再补。
5. 界面速览：记住 3 个区域
┌── 侧边栏 ───────────────┐
│ 会话列表（Inbox/Archive）│
├──────────────────────┤
│ 新建会话 │ 设置 │ 主题 │
└──────────────────────┘
│
┌── 中间区域 ─────────────┐
│ 聊天窗口 │
│ Shift+Enter 换行 │
│ Enter 直接发送 │
└──────────────────────┘
│
┌── 右下角 ─────────────┐
│ 权限模式指示灯 │
│ 绿色=只读 黄=需确认 红=自动│
└──────────────────────┘
快捷键先记 3 个：
| 快捷键 | 作用 |
|---|---|
| Cmd/Ctrl + N | 新建会话 |
| Shift + Tab | 切换权限模式 |
| Cmd/Ctrl + / | 查看全部快捷键 |
6. 实战 1：让 Claude 改写 README
目标：把项目 README 改成中文，并生成表格对比新旧版本。
步骤：
-
把项目文件夹拖进左侧“Sources”→选“本地文件系统”。 -
在聊天框输入： 请把 README.md 翻译成中文，用 Markdown 表格列出“原文/译文”两栏，并保存为 README.zh.md。
-
权限灯变黄时，按 Y确认写入。 -
完成后点“文件差异”图标，可看到逐行 diff。
注意：
-
文件大于 60 KB 时，Craft 先用 Claude Haiku 自动摘要，再交给 Claude 3.5 处理，速度更快。 -
如果提示“无权限”，把灯切到红色“allow-all”即可，用完再切回黄色。
7. 实战 2：批量改 50 个 JSON 文件
场景：把目录里所有 config*.json 的 "version": "1.0.0" 改成 "1.0.1"。
一句话指令：
递归查找当前 workspace 下所有 config*.json，把 version 字段改成 1.0.1，并输出修改了哪些文件。
Claude 会：
-
列出文件清单 -
逐个改写 -
生成回滚脚本 rollback.sh，万一出错可一键恢复
8. 进阶：连外部 API 拿数据
Craft 支持 3 类数据源，配置入口统一在“Sources”：
| 类型 | 举例 | 配置难度 |
|---|---|---|
| MCP 服务器 | GitHub、Notion、Obsidian | 最简，填 token 即可 |
| REST API | Gmail、Slack、Google Calendar | 需 OAuth，一次配好长期有效 |
| 本地文件夹 | 任意硬盘路径 | 零配置，拖进去就行 |
例：把 GitHub 最近 5 条 issue 拉到本地生成日报
-
Sources → Add → GitHub MCP → 填 token → Save -
新建会话 → 输入：
获取 craft-do/craft-agents-oss 最近 5 条 open issue，按“标题/作者/标签”三列输出 Markdown 表格，并保存为 daily.md
9. 权限模式：安全阀到底怎么用？
| 模式 | 灯颜色 | 行为 | 适用 |
|---|---|---|---|
| safe | 绿 | 只读，禁止写盘 | 浏览、问答 |
| ask | 黄 | 每次写盘前弹窗 | 默认，推荐 |
| allow-all | 红 | 直接写盘 | 批处理、CI 场景 |
小技巧：
-
批量大改前，先复制 workspace，搞坏了不心疼。 -
按 Shift+Tab可实时切换，无需进设置。
10. 数据存哪了？能不能离线？
-
所有聊天记录、配置文件都在本地：
~/.craft-agent/
会话以 JSONL 形式保存，可 grep、可备份、可删除。 -
密钥单独加密：
credentials.enc采用 AES-256-GCM，密码丢失无法找回。 -
完全离线运行：
只要 Claude API key 有效，不联网也能用；MCP 服务器在本地跑，无需外网。
11. 多人协作：把会话打包发给同事
-
在会话列表右键 → Export → 生成 .craftsession文件 -
同事拖进他的 Inbox → 立刻还原完整上下文，包括文件差异、运行结果 -
对方无需再配 API，直接用你的 key（权限可控）
12. 常见问题合集（持续更新）
Q: 能同时开多个 workspace 吗？
A: 可以，每个 workspace 独立进程，资源互不干扰。大型项目建议“一个仓库一个 workspace”。
Q: 支持 Windows 7 吗？
A: 不支持，最低 Windows 10 1903，因 Electron 依赖。
Q: 会偷传我的文件到云端吗？
A: 源码开放，网络监控只访问：
-
api.anthropic.com（ Claude 接口） -
你自配的 API（如 Google、Slack）
其余流量为零。
Q: 想自己写 MCP 服务器？
A: 官方模板已放在 GitHub，语言不限，只要实现 stdio 协议即可。Craft 会自动过滤敏感环境变量，防止 token 泄露。
13. 30 秒快速复查：今天该记住什么？
-
安装：一条 curl / irm 命令 -
配置：API key → workspace → 数据源 -
权限：绿/黄/红 三档，Shift+Tab 秒切 -
写盘：大于 60 KB 自动摘要，可 diff 可回滚 -
数据：全在 ~/.craft-agent，离线可用 -
协作：导出 .craftsession，同事一键导入
14. 下一步做什么？
-
把日常工作里最重复的那件“复制→改→粘贴”写成一句话，丢给 Craft Agents，测 5 分钟。 -
如果爽到了，再去 GitHub 给项目点个星，顺便翻翻 Issues，很多现成脚本直接抄。
祝你早日把 Claude 变成真正的“桌面副驾”。