Cc Paw

CC爪子

英语| 中文

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

](package.json)     

______________________________________________________________________

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

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

获取该应用

• 安装人员（推荐）： 下载最新 DMG （macOS）或 安装程序.exe （Windows）来自 .
• 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来控制活动会话运行时和配置范围。

Project workspace: sessions, docs, and settings

设置中的CLI切换

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

Settings: switch active CLI runtime

插件市场

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

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

Plugin marketplace and plugin management

令牌使用分析

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

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

Token usage dashboard with breakdowns

系统提示和设置

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

技能经理

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

MCP服务器配置

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

______________________________________________________________________

平台支持

先决条件

所有平台：

• 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 
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.

______________________________________________________________________

许可证

麻省理工学院