opcode

Claude Code 的强大 GUI 应用程序和工具包

创建自定义 AI 代理，管理交互式 Claude Code 会话，运行安全的后台代理等等。

opcode-demo.mp4

Tip

⭐ 为仓库点星并关注 @getAsterisk 获取 asteria-swe-v0 的早期访问权限。

Note

本项目与 Anthropic 无关联、未获授权或赞助。Claude 是 Anthropic, PBC 的商标。这是一个使用 Claude 的独立开发者项目。

Important

本版本说明：这是基于 getAsterisk/opcode 的改进版本，主要包含以下增强功能：

🌐 完整中文界面：全面的中文本地化支持
⌨️ IME 输入优化：改进了中文输入法的兼容性
🎨 界面优化：针对中文用户习惯的 UI 调整
🐛 问题修复：解决了一些影响中文用户的问题
🔧 配置改进：优化了 Claude 二进制检测和 NVM 环境支持

Important

最新版本：v0.3.3（2025-10-04）

CI 已额外产出未签名的 Windows 便携版可执行文件（opcode-windows-x86_64-portable.exe），与 MSI/NSIS 安装包一同发布。
is_batch_wrapper_on_windows 仅在 Windows 目标编译，确保跨平台执行 cargo clippy -D warnings 时保持通过。
所有安装包、便携版与校验文件请前往 GitHub Releases 获取。

🌟 概述

opcode 是一个强大的桌面应用程序，彻底改变了您与 Claude Code 的交互方式。基于 Tauri 2 构建，为管理 Claude Code 会话、创建自定义代理、跟踪使用情况等提供了美观的 GUI。

把 opcode 想象成您的 Claude Code 控制中心——在命令行工具和可视化体验之间架起桥梁，让 AI 辅助开发更加直观高效。

✨ 功能

🗂️ 项目与会话管理

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

🤖 CC 代理

自定义 AI 代理：创建具有自定义系统提示和行为的专业代理
代理库：为不同任务构建专用代理集合
后台执行：在独立进程中运行代理，实现非阻塞操作
执行历史：跟踪所有代理运行，包含详细日志和性能指标

📊 使用分析仪表板

成本跟踪：实时监控 Claude API 使用量和成本
Token 分析：按模型、项目和时间段详细分析
可视化图表：美观的图表显示使用趋势和模式
数据导出：导出使用数据用于会计和分析

🔌 MCP 服务器管理

服务器注册表：从中央 UI 管理模型上下文协议服务器
简易配置：通过 UI 添加服务器或从现有配置导入
连接测试：使用前验证服务器连通性
Claude Desktop 导入：从 Claude Desktop 导入服务器配置

⏰ 时间线与检查点

会话版本控制：在编程会话的任意时点创建检查点
可视化时间线：通过分支时间线浏览会话历史
即时恢复：一键跳转到任意检查点
会话分支：从现有检查点创建新分支
差异查看器：查看检查点之间的具体变化

📝 CLAUDE.md 管理

内置编辑器：在应用内直接编辑 CLAUDE.md 文件
实时预览：实时查看渲染的 markdown 效果
项目扫描器：查找项目中的所有 CLAUDE.md 文件
语法高亮：完整的 markdown 支持和语法高亮

📖 使用方法

快速开始

启动 opcode：安装后打开应用程序
欢迎界面：在 CC 代理和项目之间选择
首次设置：opcode 将自动检测您的 ~/.claude 目录

管理项目

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

点击任意项目查看其会话
每个会话显示首条消息和时间戳
直接恢复会话或开始新会话

创建代理

CC 代理 → 创建代理 → 配置 → 执行

设计您的代理：设置名称、图标和系统提示
配置模型：在可用的 Claude 模型中选择
设置权限：配置文件读写和网络访问权限
执行任务：在任意项目上运行您的代理

跟踪使用情况

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

按模型、项目和日期监控成本
导出数据生成报告
设置使用提醒（即将推出）

使用 MCP 服务器

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

手动添加服务器或通过 JSON 配置
从 Claude Desktop 配置导入
使用前测试连接

🚀 安装

前提条件

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

发布下载

可在 v0.3.3 发布页获取安装包与便携版。
Windows 支持选择 MSI/NSIS 安装包，或下载未签名的便携式 opcode-windows-x86_64-portable.exe。
macOS 提供通用架构的 .dmg，Linux 则包含 .AppImage 与 .deb，所有产物均附带 checksums.txt 供校验。

🔨 从源码构建

前提条件

在从源码构建 opcode 之前，请确保已安装以下软件：

系统要求

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

必需工具

Rust（1.70.0 或更高版本）

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

Bun（最新版本）

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

Git

# 通常已预装，如果没有：
# Ubuntu/Debian: sudo apt install git
# macOS: brew install git
# Windows: 从 https://git-scm.com 下载

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++ Build Tools
安装 WebView2（Windows 11 通常预装）

构建步骤

克隆仓库

git clone https://github.com/lusipad/claudia.git
cd claudia

安装前端依赖
```
bun install
```

构建应用程序

开发模式（支持热重载）

bun run tauri dev

生产构建

# 构建应用程序
bun run tauri build

# 构建的可执行文件将位于：
# - Linux: src-tauri/target/release/
# - macOS: src-tauri/target/release/
# - Windows: src-tauri/target/release/

平台特定构建选项

调试构建（编译更快，二进制文件更大）
```
bun run tauri build --debug
```
macOS 通用二进制文件（Intel + Apple Silicon）
```
bun run tauri build --target universal-apple-darwin
```

故障排除

常见问题

"cargo not found" 错误
- 确保已安装 Rust 且 ~/.cargo/bin 在 PATH 中
- 运行 source ~/.cargo/env 或重启终端
Linux: "webkit2gtk not found" 错误
- 安装上面列出的 webkit2gtk 开发包
- 在较新的 Ubuntu 版本上，您可能需要 libwebkit2gtk-4.0-dev
Windows: "MSVC not found" 错误
- 安装带 C++ 支持的 Visual Studio Build Tools
- 安装后重启终端
"claude command not found" 错误
- 确保 Claude Code CLI 已安装并在 PATH 中
- 用 claude --version 测试
构建因"内存不足"失败
- 尝试用更少的并行作业构建：cargo build -j 2
- 关闭其他应用程序释放内存

验证构建

构建后，您可以验证应用程序是否正常工作：

# 直接运行构建的可执行文件
# 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，NSIS）
- opcode-windows-x86_64-portable.exe（Windows 便携版，未签名）

所有产物位于 src-tauri/target/release/ 目录中。CI 发布还会将 Windows 产物复制到 dist/windows-x86_64/，并附带 checksums.txt 校验文件。

🛠️ 开发

技术栈

前端：React 18 + TypeScript + Vite 6
后端：Rust with 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 优先考虑您的隐私和安全：

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

🤝 贡献

我们欢迎贡献！详情请参阅我们的贡献指南。

贡献领域

🐛 错误修复和改进
✨ 新功能和增强
📚 文档改进
🎨 UI/UX 增强
🧪 测试覆盖
🌐 国际化

📄 许可证

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

🙏 致谢

使用 Tauri 构建 - 构建桌面应用的安全框架
Claude by Anthropic

由 Asterisk 用 ❤️ 制作

报告错误 · 请求功能

Star 历史

📚 English Version

For the English version of this README, please see README_EN.md.

Name		Name	Last commit message	Last commit date
Latest commit History 251 Commits
.cargo		.cargo
.github/workflows		.github/workflows
cc_agents		cc_agents
claudedocs		claudedocs
docs		docs
scripts		scripts
src-tauri		src-tauri
src		src
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CHANGELOG_EN.md		CHANGELOG_EN.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
README_EN.md		README_EN.md
bun.lock		bun.lock
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

Folders and files

Latest commit

History

Repository files navigation

opcode

🌟 概述

📋 目录

✨ 功能

🗂️ 项目与会话管理

🤖 CC 代理

📊 使用分析仪表板

🔌 MCP 服务器管理

⏰ 时间线与检查点

📝 CLAUDE.md 管理

📖 使用方法

快速开始

管理项目

创建代理

跟踪使用情况

使用 MCP 服务器

🚀 安装

前提条件

发布下载

🔨 从源码构建

前提条件

系统要求

必需工具

平台特定依赖

构建步骤

故障排除

常见问题

验证构建

构建产物

🛠️ 开发

技术栈

项目结构

开发命令

🔒 安全性

🤝 贡献

贡献领域

📄 许可证

🙏 致谢

Star 历史

📚 English Version

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 2

Packages 0

Uh oh!

Contributors 0

Languages

Packages

Contributors