opcode 是一个用于 Claude Code 的桌面应用程序,官方将其定位为「Claude Code 的命令中心」,目标是在命令行工具与可视化体验之间建立衔接,让 AI 辅助开发更直观、更高效。项目使用 Tauri 2 构建,提供图形界面。需要说明的是,官方明确声明该独立开发者项目与 Anthropic 无隶属、认可或赞助关系,Claude 为 Anthropic, PBC 的商标。
【主要能力】 根据官方 README,opcode 提供以下功能模块:
- 项目与会话管理
- 可视化项目浏览器:浏览 ~/.claude/projects/ 下的所有 Claude Code 项目。
- 会话历史:查看并恢复包含完整上下文的过往编码会话。
- 智能搜索:通过内置搜索快速定位项目与会话。
- 会话洞察:一览首条消息、时间戳和会话元数据。
- CC Agents(自定义智能体)
- 自定义 AI 智能体:创建带自定义系统提示词与行为的专用智能体。
- 智能体库:为不同任务建立专用智能体集合。
- 后台执行:在独立进程中运行智能体,实现非阻塞操作。
- 执行历史:通过详细日志和性能指标追踪所有智能体运行。
- 用量分析仪表盘
- 成本追踪:实时监控 Claude API 用量与成本。
- Token 分析:按模型、项目和时间段进行细分统计。
- 可视化图表:展示用量趋势与模式。
- 数据导出:导出用量数据以用于对账与分析。
- MCP 服务器管理
- 服务器注册表:在中心化 UI 中管理 Model Context Protocol 服务器。
- 便捷配置:通过 UI 添加服务器,或从现有配置导入。
- 连接测试:使用前验证服务器连通性。
- Claude Desktop 导入:从 Claude Desktop 导入服务器配置。
- 时间线与检查点
- 会话版本化:在编码会话的任意点创建检查点。
- 可视化时间线:通过分支时间线浏览会话历史。
- 即时恢复:一键跳回任意检查点。
- 会话分叉:从已有检查点创建新分支。
- 差异查看器:查看检查点之间的具体变更。
- CLAUDE.md 管理
- 内置编辑器:在应用内直接编辑 CLAUDE.md 文件。
- 实时预览:实时查看 Markdown 渲染效果。
- 项目扫描器:查找项目中的所有 CLAUDE.md 文件。
- 语法高亮:完整的 Markdown 支持与语法高亮。
【使用方式】
- 安装后启动 opcode,进入欢迎界面,可在 CC Agents 或 Projects 之间选择。
- 首次设置时,opcode 会自动检测 ~/.claude 目录。
- 点击任意项目可查看其会话,每个会话显示首条消息与时间戳,可直接恢复会话或开始新会话。
- 创建智能体时:设计名称、图标与系统提示词;选择可用的 Claude 模型;配置文件读写与网络访问权限;随后可在任意项目上运行该智能体。
- 用量方面可按模型、项目与日期监控成本并导出数据用于报告;官方标注用量告警功能为「coming soon」(即将推出)。
- MCP 服务器可手动添加或通过 JSON 添加,也可从 Claude Desktop 配置导入,使用前可测试连接。
【从源码构建】 官方说明发布版可执行文件将很快发布(Release Executables Will Be Published Soon)。构建前需满足:
- 操作系统: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(最新版): curl -fsSL https://bun.sh/install | bash
- Git(通常已预装)
- Claude Code CLI:从 Claude 官方网站下载安装,并确保 claude 在 PATH 中可用
构建步骤:
- 克隆仓库: git clone https://github.com/getAsterisk/opcode.git cd opcode
- 安装前端依赖: bun install
- 开发构建(带热重载): bun run tauri dev
- 生产构建: bun run tauri build 构建产物位于:Linux/macOS/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 减少并行任务并关闭其他应用)。
构建产物包括主可执行程序,以及使用 tauri build 时生成的安装包:Linux 的 .deb 与 .AppImage、macOS 的 .dmg、Windows 的 .msi 与 .exe。
【技术栈】
- 前端:React 18 + TypeScript + Vite 6
- 后端:Rust 与 Tauri 2
- UI 框架:Tailwind CSS v4 + shadcn/ui
- 数据库:SQLite(通过 rusqlite)
- 包管理器:Bun
【隐私与安全】(官方说明)
- 进程隔离:智能体在独立进程中运行
- 权限控制:可按智能体配置文件与网络访问权限
- 本地存储:所有数据保留在用户本机
- 无遥测:不收集或追踪数据
- 开源:代码开源,完全透明
【许可证与贡献】 项目采用 AGPL 许可证。官方欢迎贡献,贡献方向包括缺陷修复与改进、新功能与增强、文档改进、UI/UX 增强、测试覆盖与国际化。
【限制与未提供信息】 官方资料未提供具体的价格与收费模式、支持的 Claude 模型具体清单、平台支持细节之外的运行限制等;部分功能(如用量告警)标注为即将推出。以上未在资料中明确的信息暂未提供。