什么是 Craft Agents

  Craft Agents 是一个开源的桌面 AI 助手工具。和 ChatGPT 这类网页版 AI 最大的不同是，它可以直接读取和修改你电脑上的本地文件，还能连接你的 GitHub、Gmail、Slack 等各种工作软件。简单来说，你不需要再手动上传下载文件或者在不同页面之间复制粘贴了，AI 可以直接在你的电脑上帮你干活。

下载安装

官网：https://agents.craft.do
介绍文档：https://agents.craft.do/docs/getting-started/introduction
直接访问官网，根据你的操作系统下载对应的桌面版本。目前支持 Windows、macOS 和 Linux。下载完成后正常安装，和安装其他桌面软件没有区别。

初次启动配置

第一次打开 Craft Agents，会进入连接方式选择界面。你可以直接点击 Claude Pro/Max 使用 Claude 订阅登录，也可以选择 ChatGPT Plus或 GitHub Copilot 绑定现有账户，还可以选择使用其他提供商来输入自己的 API Key。

国内用户建议选择“使用其他提供商”这种方式，通过第三方 API 服务来调用模型，如 DeepSeek、智谱GLM等，本次为大家演示使用西柚云 AI 平台创建的 API KEY 时该如何配置（西柚云 AI 平台的Token获取方式见简介）

选择“使用其他提供商”后，在API配置中选择Custom自定义

Claude Code

如果你需要使用 Claude 模型，进入 API 配置页面后填写 API Key。Endpoint 地址填写：https://api.0daysci.com，协议选择 Anthropic Compatible。Default Model 中填入：xiyou-bio-ai-cc-sonnet

Codex

如果你需要使用 Codex 模型，进入 API 配置页面后填写 API KEY，Endpoint地址填写：https://api.0daysci.com/v1/，协议选择 OpenAI Compatible，Default Model中填入你要使用的模型ID，比如gpt-5.4

配置完成后点击继续，显示“一切就绪”界面就说明配置成功啦。

后续也可以在「设置 → AI → 连接」中管理已添加的 API KEY，支持新增、切换或删除连接

连接本地文件夹

这是 Craft Agents 最基础也最常用的功能。点击左上角 My Workspace，再点击添加按钮

点击“打开文件夹”，然后选中你电脑上的任意一个文件夹

添加成功后，AI 就能直接读取和修改这个文件夹里的所有内容，不再需要像网页版AI那样反复上传下载。同时可以看到，在你选择的本地目录里，Craft Agents 自动生成了一些配置文件

接着就可以新建对话了。在对话框中直接询问“当前目录里有什么文件”，Agent会自动列出当前目录下的所有文件和文件夹，方便随时查看和操作

权限控制

对话框底部有三个权限模式，用快捷键 Shift+Tab 可以快速切换。

• 探索模式：AI 只能查看文件内容，不能做任何修改，适合只用来阅读和分析代码。
• 询问模式：当 AI 需要写入或修改文件时，会先弹出确认框询问你，你同意后它才会继续执行，适合日常使用。
• 执行模式：AI 可以直接读写和修改文件，不需要每一步都确认，适合你已经完全信任它做批量操作的时候。
  刚开始使用建议保持在询问模式，这样每一步写操作都有你确认，比较安全。熟悉之后可以根据需要切换到执行模式提高效率。
  

让 AI 处理你的文件

添加了本地文件夹之后，你就可以直接在对话框里给 AI 下达指令了。
假设你的项目文件夹里有一个 README.md 文件，想把它翻译成中文，直接输入“把README.md翻译成中文”，AI 收到指令就会开始处理。
需要注意的是，如果你当前处于探索模式，AI 只能查看文件内容，无法直接写入文件，它会先把结果保存到会话数据目录中，并提示你如果需要正式保存到工作区根目录，需要切换到询问或执行模式。这时候用 Shift+Tab 切换到询问模式，AI 就会帮你把文件落盘到指定位置。

把常用流程做成Skill

如果你有某个经常重复的任务，比如每周写工作总结、定期整理文档，或者按固定格式处理一批文件，可以把它变成一个 Skill，以后一句话就能搞定。
在你工作空间目录下有一个 skills 文件夹，在里面新建一个 Markdown 文件，文件名就是你这个技能的名字，比如我们创建一个“翻译助手”技能，专门用来把英文文档翻译成中文。
首先在skills文件夹里新建一个文件，命名为“翻译助手.md”

接着，在文件里写下以下内容：

# 翻译助手

你是一个专业的翻译助手，负责将英文文档翻译成中文。

执行步骤：
1. 读取用户指定的英文文档
2. 保持原文的Markdown格式不变
3. 将内容翻译成流畅自然的中文
4. 将翻译结果保存为新文件，文件名在原文件名后加_CN后缀
5. 翻译完成后，列出主要术语的中英文对照表

写好之后保存，这个技能就创建好了。以后你在任何对话中只需要输入“@翻译助手 帮我翻译README.md”，AI就会按照你预设的流程自动执行，不需要每次重新描述一遍怎么做。
[图片]

进阶管理

自动化功能

当你熟悉了 Skill 的基本使用后，可以进一步探索 Craft Agents 的自动化能力。在界面左侧的导航菜单中，数据源和技能下方可以找到自动化选项，你可以设定定时任务或事件触发条件，让AI在特定时间或满足特定条件时主动执行任务，而不需要每次都手动@提及某个Skill。例如，你可以配置一个每天早上九点自动整理昨日工作日志的定时任务，AI到点就会自动执行，完全不需要人工干预。

状态管理

与此同时，Craft Agents 还内置了任务状态管理功能。在左侧的“所有会话”区域，你可以为每个对话任务标记状态，将其设置为待办、待审查、已完成或已取消。这样一来，当你同时处理多个任务时，可以像项目管理工具一样清晰追踪每个任务的进度，不至于在大量对话中迷失方向。

安全提醒

Craft Agents 的所有聊天记录和配置文件都存储在你本地电脑的~/.craft-agent/目录下，API凭证也是加密保存的，你可以随时备份或删除。权限方面建议不确定的时候用询问模式，等熟悉了再切换成执行模式提高效率。不同工作空间之间的数据和工具是完全隔离的，不用担心不同项目之间互相干扰。

结语

  相比 Claude Desktop 和 Codex Desktop，Craft Agents 的定位更像一个开放式工作台。Claude Desktop 和 Codex Desktop 主打命令行体验与代码开发，而 Craft Agents 则强调图形化界面下的多任务管理和工具集成。它不要求你把所有工作都塞进终端，而是通过可视化会话管理、状态流转（待办/进行中/已完成）以及灵活的权限控制，让 AI 的使用方式更接近日常办公软件。
  以上便是 Craft Agents 的基础用法，从安装配置、连接本地文件夹，到日常对话、权限控制，再到 Skill 和自动化，基本覆盖了日常使用的主要场景。