https://github.com/user-attachments/assets/6bceea0f-60b6-4c3e-a745-b891de00b8d0

[!TIP] ⭐ 给这个仓库点个赞，并在 X 上关注 @getAsterisk，抢先体验 asteria-swe-v0。

[!NOTE] 本项目与 Anthropic 无任何关联，未获其认可或赞助。Claude 是 Anthropic, PBC 的注册商标。本项目由独立开发者基于 Claude 进行开发。

🌟 概述

opcode 是一款功能强大的桌面应用，彻底革新了您与 Claude Code 的交互方式。基于 Tauri 2 构建，它提供了一个美观的图形界面，用于管理您的 Claude Code 会话、创建自定义智能体、跟踪使用情况等等。

您可以将 opcode 视为您管理 Claude Code 的指挥中心——它弥合了命令行工具与可视化体验之间的鸿沟，让 AI 辅助开发变得更加直观和高效。

📋 目录

• 🌟 概述
• ✨ 特性

  • 🗂️ 项目与会话管理

  • 🤖 CC 智能体

  • 📊 使用分析仪表盘

  • 🔌 MCP 服务器管理

  • ⏰ 时间线与检查点

  • 📝 CLAUDE.md 管理

• 📖 使用方法
  • 快速入门
  • 项目管理
  • 创建智能体
  • 使用情况跟踪
  • MCP 服务器操作
• 🚀 安装
• 🔨 从源码构建
• 🛠️ 开发
• 🔒 安全性
• 🤝 贡献
• 📄 许可证
• 🙏 致谢

✨ 特性

🗂️ 项目与会话管理

• 可视化项目浏览器：浏览您所有位于 ~/.claude/projects/ 中的 Claude Code 项目
• 会话历史：查看并恢复过去的编码会话，保留完整上下文
• 智能搜索：通过内置搜索快速找到项目和会话
• 会话概览：一目了然地查看首次消息、时间戳和会话元数据

🤖 CC 智能体

• 自定义 AI 智能体：创建具有自定义系统提示和行为的专用智能体
• 智能体库：构建针对不同任务的专业智能体集合
• 后台执行：在独立进程中运行智能体，实现非阻塞操作
• 执行历史：记录所有智能体的运行情况，附带详细日志和性能指标

📊 使用分析仪表盘

• 费用跟踪：实时监控您的 Claude API 使用量和费用
• Token 分析：按模型、项目和时间段进行详细拆解
• 可视化图表：展示使用趋势和模式的精美图表
• 数据导出：导出使用数据用于会计和分析

🔌 MCP 服务器管理

• 服务器注册表：通过中央 UI 管理 Model Context Protocol 服务器
• 轻松配置：可通过 UI 添加服务器，或从现有配置中导入
• 连接测试：在使用前验证服务器连通性
• Claude Desktop 导入：从 Claude Desktop 导入服务器配置

⏰ 时间线与检查点

• 会话版本控制：可在编码会话中的任意时刻创建检查点
• 可视化时间线：通过分支式时间线导航会话历史
• 即时恢复：一键跳转回任意检查点
• 分支会话：从现有检查点创建新分支
• 差异查看器：清晰显示检查点之间的具体变化

📝 CLAUDE.md 管理

• 内置编辑器：直接在应用内编辑 CLAUDE.md 文件
• 实时预览：即时查看 Markdown 渲染效果
• 项目扫描：查找您所有项目中的 CLAUDE.md 文件
• 语法高亮：全面支持 Markdown 并提供语法高亮

📖 使用方法

快速入门

1. 启动 opcode：安装完成后打开应用程序
2. 欢迎界面：选择 CC 智能体或项目
3. 首次设置：opcode 将自动检测您的 ~/.claude 目录

项目管理

项目 → 选择项目 → 查看会话 → 恢复或开始新会话

• 点击任意项目即可查看其会话
• 每个会话都会显示第一条消息和时间戳
• 可直接恢复会话，也可开始新的会话

创建智能体

CC 智能体 → 创建智能体 → 配置 → 执行

1. 设计您的智能体：设置名称、图标和系统提示
2. 选择模型：从可用的 Claude 模型中挑选
3. 设置权限：配置文件读写和网络访问权限
4. 执行任务：在任意项目上运行您的智能体

使用情况跟踪

菜单 → 使用仪表盘 → 查看分析

• 按模型、项目和日期监控费用
• 导出数据以生成报告
• 即将推出使用量警报功能

MCP 服务器操作

菜单 → MCP 管理器 → 添加服务器 → 配置

• 可手动添加服务器，也可通过 JSON 导入
• 支持从 Claude Desktop 配置中导入
• 在使用前测试连接

🚀 安装

先决条件

• Claude Code CLI：请从 Claude 官方网站 安装

正式发布版可执行文件即将上线

🔨 从源码构建

前置条件

在从源代码构建 opcode 之前，请确保已安装以下内容：

系统要求

• 操作系统：Windows 10/11、macOS 11+ 或 Linux（Ubuntu 20.04+）
• 内存：至少 4GB（建议 8GB）
• 存储空间：至少 1GB 可用空间

必需工具

1. Rust（1.70.0 或更高版本）

   # 使用 rustup 安装
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

2. Bun（最新版本）

   # 安装 bun
   curl -fsSL https://bun.sh/install | bash
   

3. Git

   # 通常已预装，若未安装：
   # Ubuntu/Debian：sudo apt install git
   # macOS：brew install git
   # Windows：从 https://git-scm.com 下载
   

4. Claude Code CLI

   • 从 Claude 官方网站 下载并安装
   • 确保 claude 已添加到您的 PATH 中

平台特定依赖

Linux（Ubuntu/Debian）

# 安装系统依赖
sudo apt update
sudo apt install -y \
  libwebkit2gtk-4.1-dev \
  libgtk-3-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev \
  patchelf \
  build-essential \
  curl \
  wget \
  file \
  libssl-dev \
  libxdo-dev \
  libsoup-3.0-dev \
  libjavascriptcoregtk-4.1-dev

macOS

# 安装 Xcode 命令行工具
xcode-select --install

# 通过 Homebrew 安装额外依赖（可选）
brew install pkg-config

Windows

• 安装 Microsoft C++ 构建工具
• 安装 WebView2（通常 Windows 11 已预装）

构建步骤

1. 克隆仓库

   git clone https://github.com/getAsterisk/opcode.git
   cd opcode
   

2. 安装前端依赖

   bun install
   

3. 构建应用程序

   开发模式（支持热重载）

   bun run tauri dev
   

   生产构建

   # 构建应用程序
   bun run tauri build
   
   # 构建后的可执行文件位于：
   # - Linux：src-tauri/target/release/
   # - macOS：src-tauri/target/release/
   # - Windows：src-tauri/target/release/
   

4. 平台特定构建选项

   调试构建（编译更快，二进制文件更大）

   bun run tauri build --debug
   

   适用于 macOS 的通用二进制文件（Intel + Apple Silicon）

   bun run tauri build --target universal-apple-darwin
   

故障排除

常见问题

1. “cargo not found” 错误

   • 确保 Rust 已安装，并且 ~/.cargo/bin 在您的 PATH 中
   • 运行 source ~/.cargo/env 或重启终端

2. Linux：“webkit2gtk not found” 错误

   • 安装上述列出的 webkit2gtk 开发包
   • 在较新的 Ubuntu 版本中，可能需要 libwebkit2gtk-4.0-dev

3. Windows：“MSVC not found” 错误

   • 安装包含 C++ 支持的 Visual Studio 构建工具
   • 安装后重启终端

4. “claude command not found” 错误

   • 确保 Claude Code CLI 已安装并位于 PATH 中
   • 使用 claude --version 测试

5. 构建因“内存不足”失败

   • 尝试使用较少的并行任务进行构建：cargo build -j 2
   • 关闭其他应用程序以释放 RAM

验证构建结果

构建完成后，您可以验证应用程序是否正常运行：

# 直接运行构建后的可执行文件
# Linux/macOS
./src-tauri/target/release/opcode

# Windows
./src-tauri/target/release/opcode.exe

构建产物

构建过程会生成多个产物：

• 可执行文件：主 opcode 应用程序
• 安装程序（使用 tauri build 时）：
  • .deb 包（Linux）
  • .AppImage（Linux）
  • .dmg 安装程序（macOS）
  • .msi 安装程序（Windows）
  • .exe 安装程序（Windows）

所有产物均位于 src-tauri/target/release/ 目录下。

🛠️ 开发

技术栈

• 前端：React 18 + TypeScript + Vite 6
• 后端：Rust 与 Tauri 2
• UI 框架：Tailwind CSS v4 + shadcn/ui
• 数据库：SQLite（通过 rusqlite）
• 包管理器：Bun

项目结构

opcode/
├── src/                   # React 前端
│   ├── components/        # UI 组件
│   ├── lib/               # API 客户端及实用工具
│   └── assets/            # 静态资源
├── src-tauri/             # Rust 后端
│   ├── src/
│   │   ├── commands/      # Tauri 命令处理器
│   │   ├── checkpoint/    # 时间线管理
│   │   └── process/       # 进程管理
│   └── tests/             # Rust 测试套件
└── public/                # 公共资源

开发命令

# 启动开发服务器
bun run tauri dev

# 仅运行前端
bun run dev

# 类型检查
bunx tsc --noEmit

# 运行 Rust 测试
cd src-tauri && cargo test

# 格式化代码
cd src-tauri && cargo fmt

🔒 安全性

opcode 优先考虑您的隐私与安全：

1. 进程隔离：代理在独立进程中运行
2. 权限控制：可为每个代理配置文件和网络访问权限
3. 本地存储：所有数据均保存在您的设备上
4. 无遥测：不收集或追踪任何数据
5. 开源：通过开源代码实现完全透明

🤝 贡献

我们欢迎您的贡献！请参阅我们的 贡献指南 以获取详细信息。

贡献领域

• 🐛 Bug 修复与改进
• ✨ 新功能与增强
• 📚 文档改进
• 🎨 UI/UX 优化
• 🧪 测试覆盖率提升
• 🌐 国际化支持

📄 许可证

本项目采用 AGPL 许可证授权——详情请参阅 LICENSE 文件。

🙏 致谢

• 基于 Tauri 构建——用于构建桌面应用的安全框架
• Anthropic 的 Claude

---

星标历史

opcode 快速上手指南

opcode 是一款基于 Tauri 2 构建的强大桌面应用，旨在为 Claude Code 提供图形化界面（GUI）。它可以帮助你管理项目会话、创建自定义 AI 代理、监控 API 用量以及配置 MCP 服务器，让 AI 辅助开发更加直观高效。

1. 环境准备

在开始之前，请确保你的系统满足以下要求并安装了必要的依赖。

系统要求

• 操作系统: Windows 10/11, macOS 11+, 或 Linux (Ubuntu 20.04+)
• 内存: 最低 4GB (推荐 8GB)
• 存储: 至少 1GB 可用空间

前置依赖安装

1. 安装 Claude Code CLI (必需)

opcode 依赖官方的 Claude Code 命令行工具。

• 访问 Claude 官网 下载并安装。
• 确保安装后可以在终端运行 claude --version。

2. 安装基础开发工具

你需要安装 Rust, Bun, 和 Git。

• Rust (后端核心):

  curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  # 安装完成后重启终端或运行：source ~/.cargo/env
  

  💡 国内加速: 如果下载缓慢，可配置国内镜像源：

  export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
  export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup
  curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  

• Bun (前端包管理器):

  curl -fsSL https://bun.sh/install | bash
  

  💡 国内加速:

  curl -fsSL https://mirrors.sdu.edu.cn/misc/bun.sh/install | bash
  

• Git:

  • macOS: brew install git
  • Ubuntu/Debian: sudo apt install git
  • Windows: 从 git-scm.com 下载安装。

3. 平台特定依赖 (仅 Linux 用户需要)

如果你使用 Ubuntu/Debian，需安装以下系统库以支持 Tauri 构建：

sudo apt update
sudo apt install -y \
  libwebkit2gtk-4.1-dev \
  libgtk-3-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev \
  patchelf \
  build-essential \
  curl \
  wget \
  file \
  libssl-dev \
  libxdo-dev \
  libsoup-3.0-dev \
  libjavascriptcoregtk-4.1-dev

2. 安装步骤 (源码构建)

目前官方尚未发布预编译安装包，请通过源码构建安装。

第一步：克隆项目

git clone https://github.com/getAsterisk/opcode.git
cd opcode

第二步：安装前端依赖

bun install

💡 国内加速: 如果遇到依赖下载慢，可临时设置 Bun 的 registry：

bun config set registry https://registry.npmmirror.com
bun install

第三步：构建应用

选项 A：开发模式运行 (带热重载) 适合调试或首次体验：

bun run tauri dev

选项 B：生产环境构建 (生成可执行文件) 构建完成后，可执行文件位于 src-tauri/target/release/ 目录下：

bun run tauri build

• Linux/macOS 运行: ./src-tauri/target/release/opcode
• Windows 运行: .\src-tauri\target\release\opcode.exe

3. 基本使用

构建完成并启动应用后，你将看到欢迎界面。以下是核心功能的最简操作流程：

🚀 快速开始

1. 启动 opcode。
2. 应用会自动检测本地的 ~/.claude 目录。
3. 在主界面选择进入 Projects (项目管理) 或 CC Agents (代理管理)。

📂 管理项目与会话

• 浏览项目: 点击左侧项目列表，查看该目录下所有的 Claude Code 会话历史。
• 恢复会话: 点击任意历史会话，查看上下文消息，点击 "Resume" 继续之前的工作，或 "Start New" 开启新对话。
• 时间轴回溯: 在会话视图中，利用时间轴功能创建检查点 (Checkpoints)，随时一键回滚代码状态或分支出新会话。

🤖 创建自定义 Agent

1. 进入 CC Agents 标签页，点击 Create Agent。
2. 配置: 输入名称、上传图标、编写 System Prompt (系统提示词)。
3. 权限: 设定该代理的文件读写范围及网络访问权限。
4. 运行: 选择目标项目，点击执行，代理将在后台独立进程中运行任务。

📊 查看用量统计

• 点击菜单中的 Usage Dashboard。
• 实时查看不同模型、不同项目的 Token 消耗和成本估算。
• 支持导出数据进行财务分析。

🔌 配置 MCP 服务器

• 进入 MCP Manager。
• 手动添加服务器配置或通过 JSON 导入。
• 支持直接从 Claude Desktop 导入现有配置，并提供连接测试功能。