claude-config-manager

# Claude 配置管理器 [](https://www.npmjs.com/package/claude-config-ui) [](https://github.com/HarshitSingh-PM/claude-config-manager/releases/latest) [](LICENSE) [](#requirements) 一个本地、开源的 UI，用于从一个地方编辑所有的 Claude Code 配置文件 — `settings.json`、`CLAUDE.md`、`.mcp.json`、子代理、斜杠命令、输出样式、按键绑定 — 以及一个内置的**凭证管理器**，您可以一次性设置 GitHub / AWS / Vercel / Stripe / 等凭证，然后在所有项目中使用。 <p align="center"> <a href="https://github.com/HarshitSingh-PM/claude-config-manager/releases/latest"><img alt="Download for macOS — Apple Silicon" src="https://img.shields.io/badge/download-macOS%20Apple%20Silicon%20%E2%86%93-7c3aed?style=for-the-badge&logo=apple&logoColor=white"></a> &nbsp; <a href="https://github.com/HarshitSingh-PM/claude-config-manager/releases/latest"><img alt="Download for macOS — Intel" src="https://img.shields.io/badge/download-macOS%20Intel%20%E2%86%93-6d28d9?style=for-the-badge&logo=apple&logoColor=white"></a> &nbsp; <a href="https://github.com/HarshitSingh-PM/claude-config-manager/releases/latest"><img alt="Download for Windows" src="https://img.shields.io/badge/download-Windows%20%E2%86%93-5b21b6?style=for-the-badge&logo=windows&logoColor=white"></a> </p> <p align="center"> <em>或，在任何终端：</em>&nbsp;&nbsp;<code>npx claude-config-ui</code> </p> <img width="800" height="387" alt="Image" src="https://github.com/user-attachments/assets/a88af615-a4d2-450e-bc11-6accd6644bf5" /> > 此工具保存的文件位于 Claude Code 的标准位置。Claude Code 会在下一次会话启动时自动拾取它们。无需守护进程，无需符号链接，无需特殊集成步骤。 ## 安装 ### Mac 应用 从 [最新版本](https://github.com/HarshitSingh-PM/claude-config-manager/releases/latest) 下载： - **`Claude Config-X.Y.Z-arm64.dmg`** — Apple Silicon (M1 / M2 / M3 / M4 Macs, 2020+) - **`Claude Config-X.Y.Z-x64.dmg`** — Intel Macs (2019 及更早) 打开 `.dmg` 文件，将 **Claude Config** 拖到 **Applications** 目录， Spotlight 或 Launchpad 启动。 > **首次启动（一次性）：** macOS Gatekeeper 将阻止未签名的应用。**右键 → 打开**，然后点击 **打开** 对话框。之后它将正常启动。（或运行 `xattr -dr com.apple.quarantine "/Applications/Claude Config.app"` 一次。） ### Windows 应用 从 [最新版本](https://github.com/HarshitSingh-PM/claude-config-manager/releases/latest) 下载 `Claude-Config-X.Y.Z-x64-setup.exe`，运行安装程序，然后从开始菜单启动 **Claude Config**。 > **首次启动（一次性）：** Windows SmartScreen 将阻止未签名的安装程序。点击 **更多信息** → **继续运行**。独立/开源应用的标准做法，无代码签名证书。 ### 命令行（任意操作系统） ```bash npx claude-config-ui ``` 启动器选择一个空闲端口，打开您的浏览器，并自动检测您的操作系统路径。按 `Ctrl+C` 停止。 --- ## 为什么 Claude Code 从 30+ 个可能的文件中读取配置，涵盖用户、项目、项目本地和企业范围。人们通过反复试验或复制社区 gist 来学习该系统。该工具将这些内容转化为一个有指导的表单。 - **自动检测路径** — `~/.claude/` 在 macOS/Linux 上，`%APPDATA%\Claude\` 在 Windows 上，项目路径从您的仓库，企业路径从 `/Library/Application Support/ClaudeCode/` 或 `/etc/claude-code/`。 - **每个字段都有提示**，解释其作用以及为什么重要。 - **内置社区预设** — Karpathy 的 4 条规则 CLAUDE.md，HumanLayer 的骨架，Trail of Bits 凭证锁定，热门钩子配方 — 只需单击一下即可应用。 - **自动备份** — 每次保存都会在原始文件旁边写入一个 `*.bak-<timestamp>` 文件。不会丢失任何内容。 - **自动保存** — 1.2 秒防抖，智能备份策略，不会用数百个 `.bak` 文件污染您的文件夹。 - **路径沙盒** — API 拒绝读取或写入家目录、当前工作目录或已知 Claude Code 企业目录以外的任何内容。 - **凭证目录** — 28 个服务，涵盖云/部署/SCM/数据库/协作/AI/支付/电子邮件/可观察性。一次性在用户范围内设置，导出到每个项目。 --- ## 四个范围 这反映了 Claude Code 实际解析配置的方式： | 标签 | 内容 | 路径 | | --- | --- | --- | | **全局 Claude** | 个人用户级配置（所有项目） | `~/.claude/` | | **全局项目** | 团队共享项目配置（提交到 git） | `<project>/.claude/` + `<project>/CLAUDE.md` + `<project>/.mcp.json` | | **本地 Claude** | 一个项目的个人覆盖（gitignored） | `<project>/.claude/settings.local.json` + `<project>/CLAUDE.local.md` | | **项目本地（企业）** | IT 部署的组织策略（最高优先级） | `/Library/Application Support/ClaudeCode/` (mac)，`C:\Program Files\ClaudeCode\` (win)，`/etc/claude-code/` (linux) | 优先级（从低到高，后者优先）：用户 → 项目共享 → 项目本地 → 企业。 --- ## 编辑内容 对于每个范围，相关文件作为侧边栏列表显示。单击一个文件进行编辑： - **`settings.json`** — 模型，权限（允许/拒绝/询问），钩子，状态行，环境，沙盒，遥测，输出样式，主题。 - **凭证** *(仅全局 Claude)* — AWS，GCP，Azure，DigitalOcean，Cloudflare，Fly，Vercel，Netlify，Heroku，Railway，GitHub，GitLab，Bitbucket，Postgres，Supabase，Neon，MongoDB，Redis，Slack，Linear，Notion，Atlassian，OpenAI，Anthropic，Mistral，Hugging Face，Stripe，Resend，SendGrid，Sentry，Datadog — 掩码输入，眼形切换，深度链接到获取每个令牌的位置，写入 `env` 块的 `~/.claude/settings.json`。 - **`CLAUDE.md`** （和 `CLAUDE.local.md`）— 带有行/字符计数和 12 个章节模板的 Markdown 编辑器（概述，堆栈，命令，结构，约定，测试，架构，硬规则，工作流程，工具，@imports，个人风格）。另外四个完整的文档预设（Karpathy，HumanLayer，Trail of Bits，Minimal personal）。 - **`.mcp.json`** — 带有类型特定字段的 MCP 服务器列表（stdio 命令/参数；http URL/头部；环境，始终加载）。 - **`keybindings.json`** — 上下文范围的按键绑定（聊天/全局/确认）。 - **`agents/`** — 子代理 Markdown 文件的列表视图；编辑前置信息（名称/描述/模型/工作量/工具/隔离）+ 正文。模板：`code-reviewer`，`security-auditor`，`test-writer`，`debugger`，`docs-writer`。 - **`commands/`** — 斜杠命令。模板：`/review`，`/commit`，`/tdd`，`/explore`，`/security-scan`。 - **`output-styles/`** — 前置信息 + 正文用于语气预设。模板：`terse`，`explanatory`，`pr-review-mode`。 - **`managed-settings.json`** — 企业策略。 --- ## MCP 服务器 一个专用的 **MCP** 标签管理 Claude Code 连接到的模型上下文协议服务器，涵盖所有三个范围（用户 → `~/.claude.json`，项目 → `.mcp.json`，本地 → `~/.claude.json` 项目条目）。您可以： - **查看** 每个配置的服务器及其范围、传输（stdio/http/sse/ws）、身份验证模型和 `alwaysLoad` 状态 - **启用/禁用** 服务器以保存上下文 — 由于 Claude Code 没有原生每服务器禁用标志，该应用可逆地将配置从实时文件中隐藏，并在启用时恢复（保留其他 `~/.claude.json` 状态，并带有备份） - **添加/删除/编辑** 服务器（引导字段 + JSON 正文编辑器） - **解决问题的诊断** 检测身份验证模型（OAuth / header token / `headersHelper` / env-var）并给出确切的修复 — 包括复制粘贴 `/mcp`（身份验证和重新连接），`claude mcp get <name>` 和 `claude mcp reset-project-choices`。机密值被掩码。 > 在标签中显示上下文提示：工具搜索默认情况下会延迟 MCP 工具，因此服务器几乎不消耗上下文；`alwaysLoad: true` 就是强制它们进入。 --- ## 代理编排器 **编排器** 标签是一个实时的视觉团队面板，用于运行 Claude 代理。启动一个代理执行任务，或一次启动多个代理 — 每个代理并发运行为自己的卡片，您可以实时看到工作过程。 - **查看正在运行的内容** — 面板的“此机器上运行”部分通过计算 live `claude` 进程并跟踪最近的会话记录，发现您在此处未启动的 claude 会话，显示每个会话的当前活动、模型、项目和 `claude --resume` 命令。这些被观察到的是只读的。 - **单独启动代理** — 选择通用代理或任何子代理定义（来自 `~/.claude/agents` 和项目 `.claude/agents`），选择模型、权限模式、工作目录和回合上限，然后给它一个任务。您可以启动任意多个。 - **启动团队** — 将面板切换到 **团队** 模式，选择一个模板（Build squad / Ship crew / Research pod / Bug hunt）或自定义角色集。运行它 **编排** （一个领导代理委托给角色，显示为一个带有层次结构的卡片）或 **并行** （每个角色一个代理，编组在面板上）。 - **活动** — 用于多周工作的活动，创建一个带有目标和自我更新计划的活动。点击 **运行下一个会话**，您喜欢随时；每个会话都会启动一个带有保存的计划 + 最新进展的新代理，完成一个区块并将计划写回 — 因此它在应用重启后存活并从中断的地方继续。 - **继续/恢复** — 任何完成的运行（以及任何观察到的终端会话）都有一个 **继续** 操作，使用 `claude -p --resume <session>` 恢复它，携带完整的上下文。 - **查看层次结构** — 每个工具调用、技能、MCP 调用和 **生成的子代理** 都以颜色编码的树形结构显示（子代理嵌套在其委托的代理下）。选择启动时的子代理，它被委托，因此层次结构显示在面板上。 - **实时跟踪每个代理** — 当前活动、已用时间、运行成本、令牌、回合数和每个卡片的子代理计数；全局 **技能活动** 馈流显示所有代理正在使用哪些技能/工具。 - **测量** — 指标视图聚合已完成的运行：成功率、总成本和令牌数、按代理和模型划分的明细以及 top 技能/工具。运行历史记录在重启后持续存在。 在后台，它会启动无头 `claude -p … --output-format stream-json` 进程并解析事件流 — 无需额外依赖，使用您已验证的 `claude` CLI。停止任意代理中间，获取 `claude --resume <session>` 命令以恢复运行。 > 权限模式映射到 CLI：**计划**（只读，不做更改），**接受编辑**（执行工作 — 默认），**自动**（模型根据调用决定），或 **全自动**（跳过所有检查 — 仅适用于完全受信任的任务）。需要 `claude` CLI 在您的 `PATH` 上（或设置 `CLAUDE_BIN`）。 --- ## 转移 — 将您的设置转移到另一台机器 **转移** 标签将您的整个 Claude 世界打包成一个加密的 `.ccsync` 文件，并在另一台笔记本电脑上恢复。 - **内容** — 从类别中选择：`~/.claude.json`（带有 API 密钥的 MCP 服务器）、设置、全局 `CLAUDE.md`、代理、技能、命令、按键绑定、每个项目的自动内存以及此应用自己的数据（编排器历史记录、活动）。添加任意额外的文件或文件夹到您的家目录 — `.env` 文件也随行。 - **实际加密** — 包使用 AES-256-GCM 加密；密钥从您的口令使用 scrypt 派生。没有任何可读内容离开您的机器，因此该文件可以安全地通过 AirDrop、iCloud Drive 或 USB 移动。 - **安全恢复** — 在另一台笔记本电脑上，运行 `npx claude-config-ui`，打开转移并解锁包。您会看到每个文件的预览（新建/更改/相同）并预选新建的文件；任何覆盖的文件首先备份到 `~/.claude-config-ui/transfer-backups/<timestamp>/`。恢复拒绝路径超出您的家目录。 - **登录故意不在** — Claude OAuth 令牌是每台机器的，并且会刷新，因此不会被捆绑。运行 `claude` 并 `/login` 一次在新笔记本电脑上；您的订阅涵盖多个机器。 --- ## 界面和运动 整个应用都设计成有生命力和可读性：动画视图转换、交错入口、悬停提升卡片、计数器指标、动画展开/折叠以及骨架加载器 — 所有这些都尊重 `prefers-reduced-motion`。状态以交通灯颜色编码 — **绿色** 为实时/运行/健康，**红色** 为错误/失败，**琥珀色** 为待定/需要审查 — 以便您一目了然地了解状态。 --- ## 首页仪表盘 应用打开一个 **首页** 仪表盘 — 一个控制中心，因此您不会直接进入密集的全局 Claude 配置。它显示 KPI 卡片（项目、会话 + 磁盘使用量、配置健康度、上下文保险库覆盖度）、“概览”面板和 **推荐的下一步骤**，基于您的实际设置（例如锁定凭证读取、启用沙盒、审查 `bypassPermissions` 默认值、将 `logic.md` 添加到项目、清理小会话）。每个卡片和步骤都链接到相关部分。 --- ## 项目 **项目** 标签为您提供您正在使用的每个项目的鸟瞰视图 — 通过扫描您的常用代码根目录（`~`、`~/projects`、~/Developer、~/Documents，...）并解码您的最近的 Claude Code 会话（`~/.claude/projects/`）。您实际使用的 Claude 项目被标记并按最近使用时间排序。 还显示文件夹，它们不是 git 仓库且没有 `CLAUDE.md`，但您的 Claude 会话明显有效（例如，快速原型） — 自动推广到列表中。 选择一个项目并直接编辑其项目级本地文件： - `CLAUDE.md` · `CLAUDE.local.md` · `summary.md` · `AGENTS.md` - `.claude/settings.json` · `.claude/settings.local.json` · `.mcp.json` 如果文件尚不存在，显示 **新建** 徽章 — 从模板或空白创建它们。每次保存仍然会写入时间戳 `.bak`，并且相同的路径沙盒适用。 ### Claude 会话 项目和全局 **所有会话** 列表，您可以查看每个 Claude Code 会话（与 `/resume` 显示的相同）及其第一个提示、最后工作时间、消息计数、大小和它工作的项目（从每个会话触摸的文件路径自动检测）。您可以： - **排序** 按最后工作时间、开始时间、消息计数、大小或名称 - **重命名** 会话以易于引用的友好标签 - **重新分配** 会话到不同的项目，如果自动检测出错 - **删除** 小型或临时会话以清理（这会释放磁盘并从 `/resume` 中删除它们） ### logic.md — 每项目的决策日志 每个项目都有一个 `logic.md`: 决策、规则和推理的长期内存，以便它们不会在会话之间被重新审议。这些文件存放在一个中央 **上下文保险库**（默认为 ` **~/ClaudeContext/<project>/`，可配置），并在每次会话开始时自动将决策（和决策摘要）注入其中 — 将该上下文带回范围。 切换 **自动维护 logic.md** 以将一个小而受控的区块注入您的全局 `~/.claude/CLAUDE.md`，告诉 Claude 读取每个项目的 `logic.md` 并在您做出决策时追加决策（以及您给出的逻辑指令摘要） — 清洁地将其关闭。 ### credentials.md — 跟踪和轮换密钥 每个项目还会在同一个保险库中获得一个 `credentials.md`: 一个本地的库存，记录项目使用的 API 密钥、令牌和密码，您可以看到存在哪些令牌以及何时需要轮换。由于它位于保险库中（在任何 git 仓库之外），因此它不会被意外提交。相同的自动维护切换告诉 Claude 记录您共享到它的任何凭证 — 作为一个 **掩码** 值（前缀 + 最后 4 位），以及存储位置和轮换状态。它是纯文本，旨在作为跟踪器，而不是秘密存储；对于高价值秘密，请使用加密存储。 --- ## 需求 - Node.js 20.9 或更新版本 - macOS、Windows 或 Linux --- ## 替代安装路径 ### 从源代码（用于开发或贡献） ```bash git clone https://github.com/HarshitSingh-PM/claude-config-manager.git cd claude-config-manager npm install npm run dev # → http://localhost:3000 ``` ### 全局安装（跳过 `npx`） ```bash npm install -g claude-config-ui claude-config-ui # 或： ccm ``` > npm 包名为 `claude-config-ui`（bare `claude-config-manager` 已被占用）。GitHub 仓库保留 `claude-config-manager` 名称。 --- ## 配置 所有内容均由操作系统自动检测。您在 UI 中唯一需要设置的是 **项目目录**，用于项目范围的选项卡（默认为启动工具的位置）。无需 `.env`，无需配置文件，无需设置。 指向不同项目的路径，请在页面顶部输入其绝对路径。 **环境变量**: - `PORT` — 覆盖默认的 `3737`。 - `CCM_NO_OPEN=1` — 启动时不要自动打开浏览器。 ## 自动检测的工作原理 - **macOS / Linux**: `~/.claude/` 用于用户范围； `/Library/Application Support/ClaudeCode/` 或 `/etc/claude-code/` 用于企业。 - **Windows**: `%APPDATA%\Claude\` 用于用户范围； `C:\Program Files\ClaudeCode\` 用于企业。 - **项目**: 任意您指向的目录。该工具会在文件存在时读取它们，并在文件不存在时创建它们。 该工具在编辑器中将每个文件标记为 `git-tracked` 或 `gitignored`，以便您始终知道 `.gitignore` 的状态。 --- ## 安全 - 每次写入操作都会首先创建现有文件的带有时间戳的 `.bak-*` 副本（自动保存每个文件每个会话只创建一个 `.bak` — 手动保存按钮是安全阀）。 - 文件 API 拒绝 `~`、 `cwd` 和已知的 Claude Code 企业目录之外的路径。 - 删除子代理或斜杠命令也会在删除原始文件之前写入备份。 - JSON 输出采用 2 空格缩进的格式化输出。 - Markdown 前置元数据通过 `js-yaml` 进行双向转换（保留键，删除空值）。 - 凭证写入 `~/.claude/settings.json` 的 `env` 块 — **磁盘上的明文**。个人笔记本电脑 API 密钥可以使用；对于高风险生产环境机密，请改用 Claude Code 的 `apiKeyHelper`（一个 shell 命令，在运行时从您的密钥链中获取值）。 --- ## 技术栈 - Next.js 16（应用路由器、Turbopack、React 19.2）— npx 的独立服务器输出 - TypeScript 严格模式 - Tailwind CSS 4 - Framer Motion（动画） - Radix UI Tooltip（无障碍提示） - Lucide 图标 - `js-yaml` 用于前置元数据解析 - Electron（仅限 Mac `.dmg` 分发 — npm 包是纯 Node） ## 自己构建桌面应用 ```bash npm install npm run dmg # macOS arm64 .dmg → dist-electron/ npm run exe # Windows x64 NSIS .exe → dist-electron/ # 显式架构： npx electron-builder --mac dmg --x64 # Intel Mac .dmg npx electron-builder --win nsis --x64 # Windows x64 .exe ``` > **从 Apple Silicon Macs 跨编译到 Windows** 需要安装 Rosetta（electron-builder 使用 x86_64 `wine64` 二进制文件来设置 .exe 的图标和版本元数据）。一次性设置： `sudo softwareupdate --install-rosetta --agree-to-license`。 默认情况下，构建是不签名的。要进行分发签名，请在 `package.json#build.mac` 中将 `mac.identity` 设置为您的 Apple 开发者证书名称（并将 `mac.hardenedRuntime` 设为 `true`）；对于 Windows，请添加 `win.certificateFile` + `certificatePassword`（或使用 Azure SignTool）。 --- ## 贡献 参见 [CONTRIBUTING.md](./CONTRIBUTING.md)。最简单的贡献： - 在凭证目录中添加新的服务（`src/lib/credentialsCatalog.ts`） - 添加新的 CLAUDE.md 章节模板（`src/lib/presets/claudemdSections.ts`） - 添加新的子代理 / 斜杠命令模板（`src/lib/presets/agents.ts`、`commands.ts`） --- ## 许可证 MIT。参见 [LICENSE](./LICENSE)。 --- ## 致谢 架构和预设来源于： - 官方 Claude Code 文档（docs.claude.com） - [hesreallyhim/awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) - [trailofbits/claude-code-config](https://github.com/trailofbits/claude-code-config) - [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) - [wshobson/commands](https://github.com/wshobson/commands) - HumanLayer 的“编写良好的 CLAUDE.md” - Karpathy 的 trending CLAUDE.md 代码片段 - [disler/claude-code-hooks-mastery](https://github.com/disler/claude-code-hooks-mastery)