1. 项目定位与用途
Agent Cowork 是一款开源的桌面 AI 协作应用，定位为 Claude Code 的图形界面替代方案。它作为桌面 AI 助手，帮助用户进行编程、文件管理以及任何可描述的任务。项目核心价值在于将终端 AI 工具转变为持久化的桌面协作伙伴，提供可视化交互体验，无需学习 Claude Agent SDK，只需创建任务并选择执行路径即可。应用复用用户现有的 ~/.claude/settings.json 配置，实现与 Claude Code 的完全兼容。
项目档案应用项目
Agent Cowork 开源桌面 AI 协作工具：Claude Code 图形界面替代方案，支持编程与文件管理
Agent Cowork 是基于 Electron 的开源桌面 AI 助手，作为 Claude Code 的图形化替代方案，提供可视化会话管理、任务跟踪与文件操作能力。本页包含项目介绍、核心特性、安装指南、使用方法和架构说明，支持 macOS 与 Linux 平台。
AI 总结
Agent Cowork 是一款开源桌面 AI 协作应用，作为 Claude Code 的图形界面替代方案，提供可视化会话管理、任务跟踪与文件操作能力，将终端 AI 助手转变为持久化的桌面协作伙伴。
中文项目介绍
Agent Cowork 是一款开源的桌面 AI 协作应用，旨在将 Claude Code 的终端能力转化为可视化、持久化的桌面体验。它帮助用户进行编程协作、文件管理以及任何可描述的任务，充当真正的 AI 合作者。
项目解决了 Claude Code 仅限于终端运行的核心痛点：缺乏复杂任务的可视化反馈、难以跟踪和管理多个会话、工具输出查看不便。通过原生桌面应用界面，Agent Cowork 提供了直观的会话管理、流式输出展示和工具调用审批面板。
适用场景包括：与 Claude AI 进行编程开发、可视化跟踪 AI 任务执行进度、管理多个 AI 会话项目、通过 AI 助手执行文件操作，以及任何需要桌面形式 AI 协作工具的生产力场景。
技术实现上，项目采用 Electron 主进程与 React 渲染进程架构，使用 Vite 进行前端构建，TypeScript 提供类型安全。状态管理通过 Zustand 实现，会话数据由 better-sqlite3 持久化存储。核心集成 @anthropic-ai/claude-agent-sdk，并完全复用用户现有的 ~/.claude/settings.json 配置，无需额外开发环境或 Claude Code 安装。
详细信息与使用说明
2. 解决的问题
Agent Cowork 主要解决 Claude Code 仅限于终端运行的三大局限性：第一，缺乏复杂任务的可视化反馈，用户无法直观看到任务执行状态；第二，难以跟踪和管理多个会话，终端环境不适合并行任务监控；第三，工具输出查看不便，文本终端难以呈现结构化信息。通过原生桌面应用形式，项目提供直观的会话列表、流式输出展示、工具调用审批面板和文件操作界面，使 AI 协作过程透明化、可控化。
3. 适用场景
该应用适用于多种 AI 协作场景：编程协作开发，用户可直观跟踪 Claude 的代码生成和修改过程；任务进度可视化，实时查看 AI 执行步骤和中间结果；多会话管理，同时处理不同项目的 AI 任务；文件系统操作，通过 AI 助手创建、编辑、组织文件；以及任何需要桌面形式、持久化 AI 助理的生产力场景。特别适合希望摆脱终端限制、获得更丰富交互体验的开发者与知识工作者。
4. 安装方式
安装方式有两种：一是直接下载预编译的 Release 版本，从 GitHub Releases 页面获取对应平台（macOS 或 Linux）的可执行文件直接运行；二是从源码构建，需先安装 Bun 或 Node.js 22+ 环境，并确保已安装并认证 Claude Code，然后克隆仓库运行 bun install 安装依赖。开发模式下使用 bun run dev 启动，生产构建可通过 bun run dist:mac-arm64（mac Apple Silicon）、bun run dist:mac-x64（mac Intel）、bun run dist:win（Windows）或 bun run dist:linux（Linux）生成平台特定安装包。
5. 使用方式
使用方式分为开发和生产模式：开发模式下，运行 bun run dev 会并行启动 React 开发服务器和 Electron 应用，支持热重载；生产模式下，先构建再运行生成的应用。应用启动后自动复用 ~/.claude/settings.json 配置，无需额外设置。用户可通过图形界面创建新会话、恢复历史会话、查看 AI 流式输出、审批工具调用、管理文件操作。会话数据通过 better-sqlite3 持久化存储，确保跨启动保留历史记录。
6. 实现特点
项目实现上采用 Electron 主进程处理应用生命周期和系统集成，React 渲染进程提供响应式 UI。前端使用 Vite 构建，集成 Tailwind CSS 实现样式，Zustand 管理全局状态。核心通过 @anthropic-ai/claude-agent-sdk 与 Claude AI 通信，并应用补丁 patches/@anthropic-ai%[email protected] 进行定制。数据存储使用 better-sqlite3 以 WAL 模式持久化会话，确保性能与可靠性。项目完全开源（MIT 许可），欢迎 Pull Request 贡献。
思维导图
当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。
常见问题
Agent Cowork 与 Claude Code 的主要区别是什么？
Claude Code 仅在终端运行，缺乏可视化界面；Agent Cowork 提供原生桌面应用，具备会话列表、流式输出展示、工具审批面板等图形化功能，同时复用相同的 ~/.claude/settings.json 配置，无需额外学习成本。
使用前需要准备哪些环境？
需要安装 Bun 或 Node.js 22+ 环境，并提前安装并认证 Claude Code。然后通过 bun install 安装项目依赖，即可运行 bun run dev 启动开发模式或构建生产版本。
支持哪些操作系统平台？
根据仓库发布信息，正式支持 macOS（含 Apple Silicon 和 Intel 架构）和 Linux。Windows 平台的构建脚本存在，但发布页面未明确标注，建议查看最新 Releases 确认可用性。
如何启动开发模式或构建生产版本？
开发模式执行 bun run dev 会并行启动前端与 Electron 并支持热重载；生产构建使用 bun run dist:mac-arm64、bun run dist:mac-x64、bun run dist:win 或 bun run dist:linux 生成对应平台安装包，命令在 package.json 中明确定义。
AI 会话数据如何保存？
项目使用 better-sqlite3 数据库在本地持久化存储会话历史与状态，采用 WAL 模式确保性能与可靠性。具体存储路径由应用内部管理，用户无需手动干预，数据在应用启动间自动保留。