企业官网建设流程全解析

opcode：Claude Code 桌面 GUI，统一管理会话、自定义 Agent 与检查点

【免费下载链接】opcodeA powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.项目地址: https://gitcode.com/GitHub_Trending/claudia1/opcode

opcode 是一款基于 Tauri 2 的 Claude Code 桌面应用，为会话管理、自定义 Agent 创建、检查点回滚和用量统计提供图形界面。适合已经安装 Claude Code CLI、希望减少终端切换的开发者和普通用户。

具体痛点：AI 改完五个文件，想退回半小时前

在终端里用 Claude Code，历史记录是散落的。会话记录存在~/.claude/projects/下，想找"上次让我做重构的那次对话"得逐个翻时间戳；让 Claude 连续改了五个文件、今天发现改出了 bug，git log 只记录你提交过的内容，两次对话之间 AI 改动的中间状态没有地方可查；想把"帮我写单测"固化成一个助手，系统提示词只能每次手打。

opcode 把这三件事放进了界面：项目列表里每条会话显示首条消息和时间戳，点一下即可恢复；会话进行中随时创建检查点，之后可以一键回到任意一个检查点，并查看两个检查点之间的文件差异；Agent 配置存成.opcode.json文件，导入一次就能反复用。

🛠️ 从 clone 到跑通：三条命令加一套系统依赖

环境要求来自 README 的 Build from Source 一节：

• Claude Code CLI：从 Claude 官方站点安装，确保claude在 PATH 中
• Rust（≥ 1.70.0，可用 rustup 安装）、Bun（最新版）、Git
• 系统：Windows 10/11、macOS 11+、Ubuntu 20.04+；内存 4GB 起（建议 8GB），磁盘 1GB
• Linux 还需 libwebkit2gtk-4.1-dev、libgtk-3-dev 等开发包；macOS 运行xcode-select --install；Windows 需要 MSVC C++ Build Tools 和 WebView2

git clone https://gitcode.com/GitHub_Trending/claudia1/opcode cd opcode

克隆仓库并进入项目目录。

bun install

安装前端依赖（React 18 + Vite 6 + TypeScript）。

bun run tauri dev

启动开发模式，前端支持热更新，Rust 编译完成后弹出桌面窗口。

需要可分发版本时执行bun run tauri build，产物位于src-tauri/target/release/，按平台生成 deb、AppImage、dmg、msi 等安装包。README 写明正式发布包"即将上线"，现阶段需自行构建。

四个值得先看的能力

项目与会话浏览器：按首条消息找回会话

启动后 opcode 自动检测~/.claude/目录，扫描~/.claude/projects/下的所有项目。列表里每条会话展示首条消息和时间戳，点击可恢复或新开。对应界面代码在 src/components/ProjectList.tsx 与 SessionList.tsx。

CC Agents：把自定义 Agent 存成文件

操作路径为 CC Agents → Create Agent：设置名称、图标、模型（opus/sonnet/haiku）、系统提示词，再配置文件读写与网络权限。仓库 cc_agents/ 目录下有三个现成示例，可用 Import → From File 导入：

• Git Commit Bot（sonnet）：先 fetch/pull 处理合并冲突，按 Conventional Commits 生成提交信息并 push
• Security Scanner（opus）：六个阶段从代码库情报收集、STRIDE 威胁建模到漏洞扫描（OWASP Top 10、CWE）、报告生成
• Unit Tests Bot（opus）：分析代码结构、制定测试计划、生成测试、验证执行、输出文档

每个 Agent 就是一个.opcode.json，包含 name、model、system_prompt、default_task 字段，自己调好的配置可以导出后分享给同事。

时间线与检查点：四种回滚策略

会话中可随时创建检查点，自动策略共四种：Manual（仅手动）、PerPrompt（每条提示词后）、PerToolUse（每次工具调用后）、Smart（破坏性操作后）。检查点支持一键恢复、从检查点 fork 出分支、两个检查点间看 diff。数据落在~/.claude/projects/<项目>/.timelines/<会话>/，Rust 实现见 src-tauri/src/checkpoint/。

用量仪表盘与 MCP 管理

Menu → Usage Dashboard 提供按模型、项目、日期维度的 Token 与成本统计，数据可导出。MCP Manager 集中管理 Model Context Protocol 服务器：手动添加或导入 JSON，支持从 Claude Desktop 导入已有配置，使用前先测试连接。

完整走一遍：从启动到一次 push 由 Agent 完成

以仓库自带的 Git Commit Bot 为例，时间线如下：

1. bun run tauri dev启动，欢迎页选择 CC Agents
2. Import → From File，选cc_agents/git-commit-bot.opcode.json
3. 在目标项目上运行该 Agent，默认任务是 "Push all changes."
4. Agent 先执行git fetch检查远端是否有未同步提交，必要时 pull 并解决冲突
5. 读取 git diff/status，判断变更性质（bug 修复、新功能、重构）
6. 生成 Conventional Commits 格式的提交信息（feat/fix/refactor 等类型加 scope）并 push
7. 在 Execution History 查看本次运行的日志与指标，再到 Usage Dashboard 核对 Token 花费

这套流程同时演示了"导入配置 → 独立进程执行 → 记录结果"，cc_agents/ 里另两个示例走同样的路径。

与 Claude Code CLI 的关系

opcode 不替代 CLI，它在后台以子进程方式调用 claude 二进制。差异集中在几处：

README 也注明项目由 Asterisk 独立开发，与 Anthropic 无隶属关系。

高频疑问

还需要单独配置 Claude Code 吗？不需要额外配置，只需claude在 PATH 中；CLI 缺失会报 "claude command not found"，用claude --version验证。

有现成安装包吗？README 写明发布包"即将上线"，目前需从源码构建。

数据会上传吗？README 的 Security 一节：Agent 运行在独立进程、按 Agent 配置文件与网络权限、数据留在本机、无遥测，许可证为 AGPL-3.0。

能连手机访问吗？justfile 提供web目标，在 8080 端口起服务供浏览器访问，但 web_server.design.md 记录会话隔离与进程取消尚未完成，当前仅建议单会话使用。

下一步

• 打开 cc_agents/ 看.opcode.json格式，改一改 Git Commit Bot 的 system_prompt 再导出
• 读 src-tauri/src/checkpoint/ 了解检查点数据结构与策略定义
• 开发流程见 README 的 Development 一节，贡献规范见 CONTRIBUTING.md

【免费下载链接】opcodeA powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.项目地址: https://gitcode.com/GitHub_Trending/claudia1/opcode