AI导哈

Claude和Codex工作流管理工具

CC Paw是一个桌面GUI工具，用于集中管理Claude Code和Codex的工作流，提供多项目会话、实时状态和通知等功能，适用于需要管理多个项目的开发者和非技术人员。

  • by HyacinH
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 HyacinH/cc-paw

使用说明

CC爪子

英语| 中文

用于管理您的桌面GUI 克劳德代码 以及食品法典委员会的工作流程。

CC Paw是为在许多项目中运行Claude Code和Codex的人而构建的，他们希望有一个清晰、可视化的工作空间，而不是分散的终端和配置文件。它为每个项目提供了一个持久的会话、实时状态和及时的通知，这样您就可以专注于决策而不是流程。

它还将Claude Code和Codex设置变成了一个可视化的工作流程：系统提示(CLAUDE.md)，技能、MCP服务器、插件、项目文档和使用分析都是从UI管理的。无论您是非技术性的还是高度技术性的，CC Paw都能使项目管理和可视化更快、更清晰、更容易维持。

获取该应用

  • 安装人员（推荐）： 下载最新 DMG （macOS）或 安装程序.exe （Windows）来自 GitHub 发布.
  • macOS安装提示（网守）： 如果macOS显示“CC Paw 已损坏，无法打开”，安装到 Applications 首先，然后运行：
sudo xattr -rd com.apple.quarantine "/Applications/CC Paw.app"
  • 从源代码运行： 克隆仓库，运行 npm install那么 npm run dev （参见 快速开始 详细信息）。你需要 克劳德代码 和 法典 CLI安装时已填充 ~/.claude/ 和 ~/.codex/ 使用所有功能的目录。
  • 在本地构建安装程序： npm run package 在下输出特定于平台的工件 release/ （仅主机操作系统）。

核心功能

项目工作区（多项目、会话、文档、设置）

面向核心项目的工作流集中在一个工作区中（下图）：

  • 多项目会议： 每个项目都有一个持久的CLI终端（Claude Code或Codex），因此切换项目永远不会丢失上下文。
  • 会话生命周期： 需要时开始新的聊天，并重新打开存档的对话以进行后续工作。
  • 项目组织： 重命名项目，在侧边栏中快速切换，并使用每个项目的状态指示器跟踪状态。
  • 项目文档(docs/): 使用实时预览和自动保存编辑Markdown，然后将项目引用保存在一个地方。
  • 项目设置： 编辑共享CLI设置(~/.claude/settings.json, ~/.codex/config.toml)直接从UI。
  • CLI运行时切换： 在设置中选择Claude Code或Codex来控制活动会话运行时和配置范围。

设置中的CLI切换

使用设置页面选择活动的CLI运行时（Claude Code或Codex）。这控制了在项目会话中应用哪个终端环境和配置范围。

插件市场

插件工作流分组在一个地方（下面的屏幕截图）：

  • 发现/过滤官方市场插件
  • 一键安装，终端输出实时
  • 安装范围选择： 用户 (~/.claude)或 项目
  • 管理已安装的插件（启用/禁用/卸载）
  • 跑 claude plugin 和 npx skills 来自应用程序的命令

令牌使用分析

使用情况和成本洞察显示在专用仪表板中（下图）：

  • 从以下位置读取Claude代码JSONL日志 ~/.claude/projects/ 和食品法典委员会会议日志 ~/.codex/sessions/
  • 总计（输入/输出/缓存）和估计成本
  • 自定义日期范围筛选
  • 按小时、天、周或月的条形图
  • 按项目细分，可扩展详细信息

系统提示和设置

在Monaco Editor中维护全局和项目级指令文件(CLAUDE.md 对于克劳德代码， AGENTS.md 食品法典委员会）。

技能经理

管理技能档案 ~/.claude/skills/ 和 ~/.codex/skills/，包括URL导入。

MCP服务器配置

编辑和验证两个运行时的MCP服务器条目(~/.claude.json 和 ~/.codex/config.toml)在储蓄之前。

平台支持

平台 状态 注释
macOS ✅ 完全支持 原生 hiddenInset 标题栏，登录shell PATH捕获
视窗 ✅ 支持 本地系统标题栏、ConPTY终端、NSIS安装程序
Linux 🔧 未经测试 可能有效；PTY和文件路径是跨平台的

先决条件

所有平台：

  • Node.js 18+
  • npm 9+
  • 克劳德代码 和 法典 已安装CLI(~/.claude/ 和 ~/.codex/ 应该存在）

仅限Windows — node-pty 是一个本机C++模块，需要编译器工具链。运行以下命令 管理员 PowerShell：

winget install Microsoft.VisualStudio.2022.BuildTools
winget install Python.Python.3.11

安装构建工具后，打开 Visual Studio安装程序→ 修改:

  • 工作量 选项卡：检查 用C进行桌面开发++
  • 独立组件 选项卡：搜索 Spectre 并检查 MSVC v143-VS 2022 C++x64/x86 Spectre缓解库

Spectre缓解的libs是 默认情况下未选择 但被要求 node-gyp没有它们， npm install 将以Spectre失败，或 node-gyp 错误。

然后跑进去 CMD或PowerShell （不是Git Bash——路径处理不同）：

npm install

最低Windows版本： Windows 10 1903（内部版本18362）或更高版本——ConPTY需要。

快速开始

# Clone the repository
git clone <repo-url>
cd cc-paw

# Install dependencies (also compiles the node-pty native module)
npm install

# Launch in development mode with hot reload
npm run dev

应用程序打开后，单击 + 在侧边栏中添加项目目录，然后单击其名称打开CLI会话。

建筑与包装

npm run build      # Compile TypeScript + bundle all assets

npm run package    # Package as a platform-native installer:
                   #   macOS  → release/CC Paw-x.x.x.dmg
                   #   Windows → release/CC Paw Setup x.x.x.exe

npm run package 为当前主机平台构建。不支持交叉编译。

建筑

CC Paw是一款具有严格流程分离的标准Electron应用程序。所有文件系统和shell访问都存在于 主进程 渲染器进程 （React）是一个纯UI层，没有直接的Node.js访问。

┌──────────────────────────────────────────────────────────────────────┐
│  Renderer Process  (React + TypeScript, Chromium sandbox)            │
│                                                                      │
│   Pages / Components  →  src/api/*  →  window.electronAPI.*         │
└────────────────────────────────┬─────────────────────────────────────┘
                                 │  contextBridge (allowlist only)
┌────────────────────────────────▼─────────────────────────────────────┐
│  Preload Script  (electron/preload.ts)                               │
│  contextIsolation=true · nodeIntegration=false                       │
└────────────────────────────────┬─────────────────────────────────────┘
                     ┌───────────┴────────────┐
              invoke (request/response)    on/send (push events)
                     │                         │
┌────────────────────▼─────────────────────────▼───────────────────────┐
│  Main Process  (Node.js, electron/ipc/*.handler.ts)                  │
│                                                                      │
│  ┌──────────────┐  ┌──────────────┐  ┌───────────────┐              │
│  │  File I/O    │  │  node-pty    │  │  shell runner │              │
│  │  (~/.claude, │  │  (terminal)  │  │  (plugins,    │              │
│  │   ~/.codex)  │  └──────────────┘  │   skills)     │              │
│                                      └───────────────┘              │
└──────────────────────────────────────────────────────────────────────┘

所有IPC通道名称都在后面 domain:action 公约(skills:write, mcp:read等等）。每个处理程序都返回一个键入的结果信封-- { success: true; data: T } 或 { success: false; error: string } --哪一个 src/api/ 图层展开，以便页面接收 data 直接或直接出错。平台特定的逻辑（PATH解析、外壳检测、二进制查找）集中在 electron/services/platform.ts.

许可证

麻省理工学院

相关 MCP