站点图标 高效码农

Craft Agents桌面安装全攻略：3分钟让Claude像软件一样帮你改代码查资料

高效码农

用 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 分钟配置

  1. 双击图标 → 选“使用自己的 Anthropic API Key”
    （没有 key 就去 Anthropic 控制台 申请，5 美元额度够用很久）
  2. 新建 workspace，名字随便写，比如“Blog写作”
    workspace 相当于项目文件夹，不同项目互不干扰。
  3. 跳过“添加数据源”，先体验裸聊。
    后面需要再补。

5. 界面速览：记住 3 个区域

┌── 侧边栏 ───────────────┐
│ 会话列表（Inbox/Archive）│
├──────────────────────┤
│ 新建会话 │ 设置 │ 主题 │
└──────────────────────┘
        │
┌── 中间区域 ─────────────┐
│ 聊天窗口               │
│ Shift+Enter 换行       │
│ Enter 直接发送         │
└──────────────────────┘
        │
┌── 右下角 ─────────────┐
│ 权限模式指示灯         │
│ 绿色=只读 黄=需确认 红=自动│
└──────────────────────┘

快捷键先记 3 个：

快捷键 作用
Cmd/Ctrl + N 新建会话
Shift + Tab 切换权限模式
Cmd/Ctrl + / 查看全部快捷键

6. 实战 1：让 Claude 改写 README

目标：把项目 README 改成中文，并生成表格对比新旧版本。

步骤：

  1. 把项目文件夹拖进左侧“Sources”→选“本地文件系统”。
  2. 在聊天框输入：

    请把 README.md 翻译成中文，用 Markdown 表格列出“原文/译文”两栏，并保存为 README.zh.md。

  3. 权限灯变黄时，按 Y 确认写入。
  4. 完成后点“文件差异”图标，可看到逐行 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 拉到本地生成日报

  1. Sources → Add → GitHub MCP → 填 token → Save
  2. 新建会话 → 输入：

获取 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. 多人协作：把会话打包发给同事

  1. 在会话列表右键 → Export → 生成 .craftsession 文件
  2. 同事拖进他的 Inbox → 立刻还原完整上下文，包括文件差异、运行结果
  3. 对方无需再配 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 秒快速复查：今天该记住什么？

  1. 安装：一条 curl / irm 命令
  2. 配置：API key → workspace → 数据源
  3. 权限：绿/黄/红 三档，Shift+Tab 秒切
  4. 写盘：大于 60 KB 自动摘要，可 diff 可回滚
  5. 数据：全在 ~/.craft-agent，离线可用
  6. 协作：导出 .craftsession，同事一键导入

14. 下一步做什么？

  • 把日常工作里最重复的那件“复制→改→粘贴”写成一句话，丢给 Craft Agents，测 5 分钟。
  • 如果爽到了，再去 GitHub 给项目点个星，顺便翻翻 Issues，很多现成脚本直接抄。

祝你早日把 Claude 变成真正的“桌面副驾”。

退出移动版