## 项目概述

opcode 是一个为 Claude Code 打造的强大桌面 GUI 应用与工具包，基于 Tauri 2 构建。它旨在弥合命令行工具与可视化体验之间的差距，让 AI 辅助开发更加直观和高效。通过 opcode，用户可以创建自定义智能体、管理交互式 Claude Code 会话、运行安全的后台智能体，并跟踪使用情况。该项目由 Asterisk 团队开发，与 Anthropic 无关联。

## 核心功能

- **项目与会话管理**：可视化浏览 `~/.claude/projects/` 下的项目，查看和恢复历史会话，支持智能搜索和会话元数据展示。
- **CC Agents（自定义智能体）**：创建具有自定义系统提示词和行为的专用智能体，支持后台执行、执行历史记录和性能指标。
- **用量分析仪表盘**：实时监控 Claude API 使用量和成本，按模型、项目和时间段进行令牌分析，提供可视化图表和数据导出功能。
- **MCP 服务器管理**：集中管理 Model Context Protocol 服务器，支持 UI 添加、配置导入（包括从 Claude Desktop 导入）和连接测试。
- **时间线与检查点**：在编码会话中创建检查点，通过可视化时间线导航历史，支持一键恢复、分支会话和差异查看器。
- **CLAUDE.md 管理**：内置编辑器，支持实时预览、项目扫描和语法高亮。

## 适用与不适用场景

**适用场景**：
- 希望以图形化方式管理 Claude Code 会话和项目的开发者。
- 需要创建和运行多个自定义 AI 智能体以完成不同任务的团队。
- 需要监控 Claude API 使用成本和令牌消耗的个人或组织。
- 需要集中管理 MCP 服务器配置的用户。
- 希望利用检查点和时间线功能进行代码版本回溯和分支实验的开发者。

**不适用场景**：
- 不需要 GUI、偏好纯命令行操作的用户。
- 未安装 Claude Code CLI 的环境。
- 对数据隐私要求极高、不允许任何本地数据存储的场景（尽管 opcode 强调本地存储，但需自行评估）。
- 需要与 Anthropic 官方支持或认证的场景（项目明确声明非官方）。

## 技术架构与依赖

- **前端**：React 18 + TypeScript + Vite 6，UI 使用 Tailwind CSS v4 和 shadcn/ui。
- **后端**：Rust 与 Tauri 2，负责进程管理、检查点管理和命令处理。
- **数据库**：SQLite（通过 rusqlite）。
- **包管理器**：Bun。
- **系统依赖**：Rust 1.70.0+、Bun、Git、Claude Code CLI，以及各平台特定的 WebView 和 GTK 等依赖。

## 安装与快速开始

**预编译可执行文件**：仓库资料显示“Release Executables Will Be Published Soon”，即尚未发布正式安装包，需从源码构建。

**从源码构建**：
1. 安装 Rust、Bun、Git 和 Claude Code CLI。
2. 克隆仓库：`git clone https://github.com/getAsterisk/opcode.git`（注意：仓库 URL 为 winfunc/opcode，但 README 中为 getAsterisk/opcode，请以实际为准）。
3. 安装前端依赖：`bun install`。
4. 开发模式：`bun run tauri dev`；生产构建：`bun run tauri build`。
5. 构建产物位于 `src-tauri/target/release/`。

**快速开始**：安装后启动应用，首次设置会自动检测 `~/.claude` 目录，然后可选择项目或创建智能体开始使用。

## 典型使用方法

- **管理项目**：在 Projects 界面选择项目，查看会话列表，恢复或新建会话。
- **创建智能体**：在 CC Agents 中创建智能体，设置名称、图标、系统提示词、模型和权限，然后执行任务。
- **跟踪用量**：通过菜单进入 Usage Dashboard，查看成本、令牌分析，并可导出数据。
- **管理 MCP 服务器**：在 MCP Manager 中添加服务器，支持手动配置或从 Claude Desktop 导入，并可测试连接。
- **使用检查点**：在会话中创建检查点，通过时间线导航，一键恢复或分支。

## 配置与部署要点

- **配置文件**：opcode 依赖 `~/.claude` 目录，包括项目、会话和 CLAUDE.md 文件。
- **环境要求**：需要 Claude Code CLI 在 PATH 中可用。
- **权限控制**：每个智能体可配置文件读写和网络访问权限，确保安全。
- **构建配置**：Linux 需安装 webkit2gtk 等系统库；macOS 需 Xcode 工具；Windows 需 MSVC 和 WebView2。
- **部署**：目前无官方安装包，需自行构建或等待后续发布。

## 限制、风险与许可证

- **限制**：尚未发布预编译安装包；项目处于早期版本（v0.2.0）；部分功能（如用量提醒）标记为“即将推出”。
- **风险**：项目非 Anthropic 官方产品，使用 Claude 商标但无关联；依赖 Claude Code CLI，其可用性和稳定性可能影响 opcode；AGPL-3.0 许可证可能对商业使用有严格要求。
- **许可证**：AGPL-3.0，详见 LICENSE 文件。

## 官方链接

- GitHub 仓库：https://github.com/winfunc/opcode
- 最新版本：v0.2.0（https://github.com/winfunc/opcode/releases/tag/v0.2.0）
- Discord 社区：https://discord.com/invite/KYwhHVzUsY
- 项目官网（Asterisk）：https://asterisk.so/

## 信息来源和分析时间

- 信息来源：GitHub 仓库 README、CONTRIBUTING.md、最新发布信息。
- 分析时间：2025-04-08（基于当前日期）。