macOS/Linux快速安装Craft Agents5分钟从零到第一个AI会话完整指南【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-ossCraft Agents 是一款开源 AI 智能体桌面应用主打多会话收件箱、多模型连接Anthropic、Google AI Studio、ChatGPT 等、MCP 数据源接入与文档中心工作流。本文将带你用一行命令完成 macOS/Linux 安装并在 5 分钟内发起你的第一个 AI 会话。⚡ 30秒了解Craft Agents 能做什么在动手安装前先看看这款 AI Agent 工具的核心能力多会话收件箱会话按状态流转Todo → In Progress → Done支持置顶、归档与 AI 自动命名多模型自由切换Anthropic API Key / Claude Max、Google AI Studio、ChatGPT Plus、GitHub Copilot 均可接入即连即用直接告诉 Agent「接入 Slack」它会自行查找 API、读取文档并完成配置无需手写配置文件文件附件拖入图片、PDF、Office 文档自动转换供模型理解三档权限控制Explore只读/ Ask to Edit默认/ Auto自动放行SHIFTTAB一键切换 一键安装macOS/Linux 通用命令官方提供了一行安装脚本自动检测系统macOS / Linux与 CPU 架构arm64 / x64下载对应安装包并校验 SHA-512 后完成安装curl -fsSL https://agents.craft.do/install-app.sh | bash脚本源码位于scripts/install-app.sh可先阅读再执行安全透明。macOS 与 Linux 的安装差异一览项目macOSLinux安装包ZIP内含 .appAppImage目前仅支持 x64安装位置/Applications/Craft Agents.app~/.craft-agent/app/启动方式应用程序文件夹或open -a Craft Agents终端输入craft-agents额外依赖无需要 FUSE 组件macOS 脚本会自动移除隔离属性quarantine首次打开不会触发系统拦截Linux 若缺少 FUSE按提示安装即可sudo apt install fuse libfuse2 # Debian/Ubuntu 从源码构建clone 仓库完整步骤如果你想体验最新功能或参与开发从源码构建只需 4 步需要 Bun 运行时如未安装可访问 bun.sh 获取git clone https://gitcode.com/GitHub_Trending/cr/craft-agents-oss cd craft-agents-oss bun install bun run electron:start桌面应用源码位于apps/electron/架构说明见apps/electron/README.md日常开发推荐热重载模式bun run electron:dev。 首次启动连接 AI 并创建第一个工作区安装完成后启动应用按向导操作 4 步即可选择 API 连接新手推荐 AnthropicAPI Key 或 Claude Max 登录已有 ChatGPT Plus / Copilot 订阅也可直接 OAuth 登录创建工作区Workspace工作区用于组织会话还能为其单独设置默认模型与主题连接数据源可选支持 MCP 服务器、REST APIGmail、Slack 等与本地文件目录开始对话新建会话发出你的第一句话 创建你的第一个 AI 会话进入主界面后几个高频操作帮你快速上手快捷键功能CmdNLinux 为CtrlN新建会话Enter/ShiftEnter发送消息 / 换行SHIFTTAB切换权限模式Cmd/打开全部快捷键列表会话支持拖拽图片、PDF 等附件自动转换后交给模型处理例如拖入一张风景照让 Agent 描述画面内容默认权限模式为Ask to EditAgent 执行写操作前会弹出确认框新手可安心使用熟悉后再切到 Auto 模式提升效率。⌨️ 进阶命令行 10 秒验证环境仓库自带终端客户端run命令完全自包含——自动拉起无头服务器、创建会话、流式输出响应后退出无需任何额外配置ANTHROPIC_API_KEYsk-xxx bun run apps/cli/src/index.ts run Hello, world!更多 CLI 用法会话管理、流式发消息、21 步服务器体检可查阅 docs/cli.md。 你的数据都存放在哪里所有配置与会话数据统一保存在~/.craft-agent/目录config.json— 工作区与 LLM 连接配置credentials.enc— 凭据文件AES-256-GCM 加密存储workspaces/— 各工作区的会话记录、数据源与技能Skills 常见问题排查症状原因解决方法Linux 启动后闪退缺少 FUSEsudo apt install fuse libfuse2提示craft-agents: command not found~/.local/bin未加入 PATHecho export PATH$HOME/.local/bin:$PATH ~/.bashrc后重开终端macOS 首次打开被拦截系统隔离属性重新执行安装脚本会自动处理无法与 AI 对话未配置 API 连接进入设置页填写 API Key 或完成 OAuth 登录遇到其他问题时可开启调试模式查看详细日志# macOS /Applications/Craft\ Agents.app/Contents/MacOS/Craft\ Agents -- --debug # Linux ./craft-agents -- --debug日志位置macOS 为~/Library/Logs/craft-agent/electron/main.logLinux 为~/.config/craft-agent/electron/logs/main.log。总结Craft Agents 把「和 AI 智能体协作」做成了开箱即用的桌面体验一行命令安装 macOS/Linux 客户端首次启动选择模型连接、创建工作区5 分钟即可开启第一个 AI 会话。从此多任务并行、数据源即连即用全部交给 Agent 自己搞定。【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-oss创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 macOS/Linux快速安装Craft Agents：5分钟从零到第一个AI会话完整指南
macOS/Linux快速安装Craft Agents5分钟从零到第一个AI会话完整指南【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-ossCraft Agents 是一款开源 AI 智能体桌面应用主打多会话收件箱、多模型连接Anthropic、Google AI Studio、ChatGPT 等、MCP 数据源接入与文档中心工作流。本文将带你用一行命令完成 macOS/Linux 安装并在 5 分钟内发起你的第一个 AI 会话。⚡ 30秒了解Craft Agents 能做什么在动手安装前先看看这款 AI Agent 工具的核心能力多会话收件箱会话按状态流转Todo → In Progress → Done支持置顶、归档与 AI 自动命名多模型自由切换Anthropic API Key / Claude Max、Google AI Studio、ChatGPT Plus、GitHub Copilot 均可接入即连即用直接告诉 Agent「接入 Slack」它会自行查找 API、读取文档并完成配置无需手写配置文件文件附件拖入图片、PDF、Office 文档自动转换供模型理解三档权限控制Explore只读/ Ask to Edit默认/ Auto自动放行SHIFTTAB一键切换 一键安装macOS/Linux 通用命令官方提供了一行安装脚本自动检测系统macOS / Linux与 CPU 架构arm64 / x64下载对应安装包并校验 SHA-512 后完成安装curl -fsSL https://agents.craft.do/install-app.sh | bash脚本源码位于scripts/install-app.sh可先阅读再执行安全透明。macOS 与 Linux 的安装差异一览项目macOSLinux安装包ZIP内含 .appAppImage目前仅支持 x64安装位置/Applications/Craft Agents.app~/.craft-agent/app/启动方式应用程序文件夹或open -a Craft Agents终端输入craft-agents额外依赖无需要 FUSE 组件macOS 脚本会自动移除隔离属性quarantine首次打开不会触发系统拦截Linux 若缺少 FUSE按提示安装即可sudo apt install fuse libfuse2 # Debian/Ubuntu 从源码构建clone 仓库完整步骤如果你想体验最新功能或参与开发从源码构建只需 4 步需要 Bun 运行时如未安装可访问 bun.sh 获取git clone https://gitcode.com/GitHub_Trending/cr/craft-agents-oss cd craft-agents-oss bun install bun run electron:start桌面应用源码位于apps/electron/架构说明见apps/electron/README.md日常开发推荐热重载模式bun run electron:dev。 首次启动连接 AI 并创建第一个工作区安装完成后启动应用按向导操作 4 步即可选择 API 连接新手推荐 AnthropicAPI Key 或 Claude Max 登录已有 ChatGPT Plus / Copilot 订阅也可直接 OAuth 登录创建工作区Workspace工作区用于组织会话还能为其单独设置默认模型与主题连接数据源可选支持 MCP 服务器、REST APIGmail、Slack 等与本地文件目录开始对话新建会话发出你的第一句话 创建你的第一个 AI 会话进入主界面后几个高频操作帮你快速上手快捷键功能CmdNLinux 为CtrlN新建会话Enter/ShiftEnter发送消息 / 换行SHIFTTAB切换权限模式Cmd/打开全部快捷键列表会话支持拖拽图片、PDF 等附件自动转换后交给模型处理例如拖入一张风景照让 Agent 描述画面内容默认权限模式为Ask to EditAgent 执行写操作前会弹出确认框新手可安心使用熟悉后再切到 Auto 模式提升效率。⌨️ 进阶命令行 10 秒验证环境仓库自带终端客户端run命令完全自包含——自动拉起无头服务器、创建会话、流式输出响应后退出无需任何额外配置ANTHROPIC_API_KEYsk-xxx bun run apps/cli/src/index.ts run Hello, world!更多 CLI 用法会话管理、流式发消息、21 步服务器体检可查阅 docs/cli.md。 你的数据都存放在哪里所有配置与会话数据统一保存在~/.craft-agent/目录config.json— 工作区与 LLM 连接配置credentials.enc— 凭据文件AES-256-GCM 加密存储workspaces/— 各工作区的会话记录、数据源与技能Skills 常见问题排查症状原因解决方法Linux 启动后闪退缺少 FUSEsudo apt install fuse libfuse2提示craft-agents: command not found~/.local/bin未加入 PATHecho export PATH$HOME/.local/bin:$PATH ~/.bashrc后重开终端macOS 首次打开被拦截系统隔离属性重新执行安装脚本会自动处理无法与 AI 对话未配置 API 连接进入设置页填写 API Key 或完成 OAuth 登录遇到其他问题时可开启调试模式查看详细日志# macOS /Applications/Craft\ Agents.app/Contents/MacOS/Craft\ Agents -- --debug # Linux ./craft-agents -- --debug日志位置macOS 为~/Library/Logs/craft-agent/electron/main.logLinux 为~/.config/craft-agent/electron/logs/main.log。总结Craft Agents 把「和 AI 智能体协作」做成了开箱即用的桌面体验一行命令安装 macOS/Linux 客户端首次启动选择模型连接、创建工作区5 分钟即可开启第一个 AI 会话。从此多任务并行、数据源即连即用全部交给 Agent 自己搞定。【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-oss创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考