开源 · MIT · v0.20.1 Open Source · MIT · v0.20.1

把 Claude Code 的本地配置管起来 Take control of your Claude Code setup

Code Manager 把配置、供应商、~/.claude 目录、记忆、Skills、历史、统计、Token 用量与费用、项目状态、系统托盘和诊断日志集中到一个 Tauri 2 桌面应用——让本地配置可见、可预览、可验证。 Code Manager brings profiles, providers, your ~/.claude directory, memory, skills, history, stats, token usage & cost, project status, the system tray and diagnostic logs into one Tauri 2 desktop app — so your local setup is visible, previewable and verifiable.

下载应用Download GitHub 仓库View on GitHub
macOS Windows Linux · 完全本地 · 双语界面 · 100% local · Bilingual UI
解决的问题 The problem

配置散落，越用越难管 Config sprawl that gets worse over time

从三个角度看：痛点 → Code Manager 能力 → 价值收益。它不替代 Claude Code，而是它的本机管理层——让配置可见、可预览、可验证。 Seen from three angles: pain → what Code Manager does → the payoff. It doesn't replace Claude Code — it's the local management layer that makes config visible, previewable and verifiable.

1团队配置复用Team config reuse
现状痛点Pain today
  • 每人手攒一套配置Everyone keeps their own config
  • 新人上手慢、标准不一Slow onboarding, inconsistent standards
  • 配置易漂移、难对齐Config drifts and is hard to align
Code Manager 能力What Code Manager does
  • 配置可复用，内置供应商只读可选Reusable profiles, read-only built-in providers
  • 常用选项 / 市场 / 插件一键同步到其余配置One-click sync of options, marketplaces & plugins to other profiles
  • 导入现有 settings 起步Bootstrap by importing existing settings
价值收益The payoff
  • 团队共享同一套标准配置One shared standard across the team
  • 开箱即用、版本对齐Works out of the box, versions aligned
  • 不再各搞各的No more siloed setups
2配置最佳实践Config best practices
现状痛点Pain today
  • 手改 JSON 容易出错Hand-editing JSON is error-prone
  • 切换时漏写环境变量Env vars dropped when switching
  • 配置能否用全靠试"Does it work?" is trial and error
Code Manager 能力What Code Manager does
  • 图形化编辑 + Schema 校验Visual editing + schema validation
  • 内置 Provider / 状态行预设Built-in provider & statusline presets
  • 模型连通性测试Model connectivity test
  • 一键全量应用，不漏项One-click full apply, nothing missed
价值收益The payoff
  • 配置可预览、可验证Config is previewable & verifiable
  • 按最佳实践落地Best practices by default
  • 切换不丢项Switch without losing anything
3问题排查Troubleshooting
现状痛点Pain today
  • 出问题时日志四处找Hunting logs everywhere when things break
  • 会话历史难追溯Session history is hard to trace
  • Token 花费不透明Token spend is opaque
Code Manager 能力What Code Manager does
  • 脱敏日志查看 + 轮转Redacted log viewer + rotation
  • 会话历史 / Plan 追溯Session history & plan trace
  • 用量按项目 / 模型 / 日期聚合Usage by project, model and date
  • 系统信息一处可见System info in one place
价值收益The payoff
  • 快速定位行为异常Pinpoint anomalies fast
  • 异常花费一目了然Cost spikes at a glance
  • 排障路径统一高效One efficient debugging path
核心功能 Features

一个应用，覆盖整条本地工作流 One app for your whole local workflow

从配置切换到费用审计，从记忆到诊断，全部在本地完成。 From switching configs to auditing cost, from memory to diagnostics — all done locally.

~/.claude 总览~/.claude overview

树形浏览、Markdown 预览、编辑、新建、重命名和定位整个 Claude Code 用户目录，边界安全。Browse, preview, edit, create, rename and locate your whole Claude Code user directory — with safe boundaries.

配置 / 供应商管理Profiles & Providers

分层管理最终写入 settings.json 的配置：Provider、模型、环境变量、权限、Sandbox、Hooks、插件、状态行；支持预览、复制、模型测试、一键应用与差异对比。Layered control over what lands in settings.json: providers, models, env, permissions, sandbox, hooks, plugins, statusline — with preview, copy, model test, one-click apply and diffing.

Token 用量与费用Token usage & cost

扫描 projects/**/*.jsonl，按日期、项目、会话、模型聚合 Token 与费用，SQLite 增量缓存，支持消息级明细与缓存节省；还可开启置顶桌面浮窗，随时盯今日花费与 Token。Scans projects/**/*.jsonl and aggregates tokens & cost by date, project, session and model — SQLite-cached, down to per-message detail and cache savings; an optional always-on-top desktop widget keeps today's spend in view.

记忆管理Memory management

管理用户级 CLAUDE.md 与 rules/*.md（glob 路径），内置 Karpathy 行为指南预设，支持导入、启停、复制、预览。Manage user-level CLAUDE.md and rules/*.md (glob paths), with a built-in Karpathy preset, import, enable/disable, copy and preview.

Skills 管理Skills management

新建、编辑、启停、删除 Claude Code Skills，支持软链接 Skill，并可一键同步为 ~/.codex/skills 软链接。Create, edit, enable/disable and delete Claude Code skills, support symlinked skills, and sync to ~/.codex/skills in one click.

历史与统计History & stats

读取 history.jsonl 按项目/会话查看历史详情与热力图；从 ~/.claude.json 读取本地统计快照与最近会话。Read history.jsonl for per-project/session detail and a heatmap; read local stats and recent sessions from ~/.claude.json.

项目管理Project management

展示项目 Git 状态、分支、worktree、项目级 .claude/、AGENTS.md/CLAUDE.md、Skills 配对与项目自动记忆；可打开终端/编辑器、跳转历史/用量、清理分支与 worktree。Shows git status, branches, worktrees, project .claude/, AGENTS.md/CLAUDE.md, skills pairing and project auto-memory; open terminal/editor, jump to history/usage, prune branches and worktrees.

系统托盘与会话聚焦Tray & session focus

菜单栏显示当前配置与活跃会话状态，支持计数样式与待处理呼吸灯；macOS 可聚焦原终端 tab 并把会话状态镜像到 ANTICATER LED 设备。The tray shows your active profile and live session status with count styles and a pending pulse; on macOS it can refocus the original terminal tab and mirror session state to an ANTICATER LED device.

设置与诊断Settings & diagnostics

语言、主题、默认终端/编辑器、登录启动、第三方模型计价开关、会话聚焦快捷键与 LED（macOS）、会话等待提示音、桌面用量浮窗；脱敏日志查看、系统信息一键复制。Language, theme, default terminal/editor, launch-at-login, third-party pricing toggle, focus shortcut & LED (macOS), session waiting sound, desktop usage widget; redacted log viewer and one-click system info.

按三大功能域组织 Organised into three domains

1配置与资产管理Config & assets
配置管理Profiles 记忆管理Memory Skills 管理Skills
2数据与用量洞察Data & usage insight
会话历史History 统计概览Stats 用量与费用Usage & cost
3项目 · 目录 · 系统Projects · dir · system
项目管理Projects 共享树总览Overview 系统集成与设置Tray & settings
工作原理 How it works

本地优先，数据源分明 Local-first, with clear data sources

React 19 前端经类型化 IPC 调用 Rust 后端，配置合并、目录扫描、用量聚合和日志查看都在本地完成；模型价格优先用本地缓存与内置兜底，仅在启动后尝试从 models.dev 刷新。 A React 19 frontend calls the Rust backend over typed IPC; config merge, directory scan, usage aggregation and log viewing all happen locally. Model prices use local cache and built-in fallbacks first, refreshed from models.dev only after launch.

前端Frontend
配置工作台Config workbench 记忆 · SkillsMemory · Skills 项目 · 历史Projects · History 统计 · 用量Stats · Usage ~/.claude 总览~/.claude overview

React 19 · Vite · Tailwind v4 · shadcn/ui · CodeMirror · Recharts

类型化 IPC · tauri-specta（invoke ↓ / event ↑） Typed IPC · tauri-specta (invoke ↓ / event ↑)
后端Backend
config.rs memory · skills history · stats · usage project · native_open claude_directory · watcher tray · led · widget

Rust · Tauri 2 · ≈ 90 个类型化命令 + 公共 utils.rs / logging.rs Rust · Tauri 2 · ≈90 typed commands + shared utils.rs / logging.rs

读取 / 原子写入 read / atomic write
数据源Data
~/.claude/ history.jsonl ~/.claude.json projects/**/*.jsonl usage.db · SQLite ~/.config/code-manager/

本地文件 / SQLite · Projects / Stats / Usage 三套数据源互不混用 Local files / SQLite · Projects / Stats / Usage stay three separate sources

为什么不是 cc-switch Why not just cc-switch

有了 cc-switch，为什么还需要 Code Manager？ Why Code Manager when cc-switch exists?

两者解决的是不同维度的问题，定位互补，甚至可以共存。 They solve different axes of the same space — complementary, and they can coexist.

Code Manager 纵向深耕Depth

深耕 Claude Code 单一生态的配置治理：配置/供应商分层 + JSON Schema 校验、Token 用量与费用分析、记忆 / Skills / 状态行、项目级文件配对。适合主力在 Claude Code、想把配置和成本彻底管清楚的人。 Deep config governance for the Claude Code ecosystem: layered profiles & providers with JSON-Schema validation, token/cost analytics, memory / skills / statusline, project-level file pairing. For people who live in Claude Code and want config & cost fully under control.

cc-switch 横向广度Breadth

横跨多个 CLI 工具的供应商切换中枢：50+ 内置供应商一键热切、内置本地代理与故障转移。适合需要在 Claude Code / Codex / Gemini 等工具间频繁切供应商、追求高可用的人。 A cross-tool provider-switching hub: 50+ presets for one-click hot switching, plus a built-in local proxy and failover. For people who switch providers across Claude Code / Codex / Gemini and want high availability.

维度Dimension Code Manager cc-switch
定位Focus 深耕 Claude Code 的本地配置治理Deep local config governance for Claude Code 横跨多 CLI 工具的供应商切换中枢Provider-switching hub across many CLI tools
配置抽象Config model 完整配置/供应商分层 + JSON Schema 校验Full Profile/Provider layering + JSON-Schema validation 「供应商卡片」为单位，50+ 内置预设一键热切Provider cards, 50+ presets, one-click hot switch
覆盖工具Tool coverage 聚焦 Claude Code（Skills 可同步 Codex）Focused on Claude Code (skills sync to Codex) Claude Code / Codex / Gemini / OpenCode 等多工具Claude Code / Codex / Gemini / OpenCode and more
Token 用量与费用Usage & cost 按日期/项目/会话/模型聚合，SQLite 缓存，消息级明细By date/project/session/model, SQLite-cached, per-message detail Usage Dashboard，按供应商/模型统计Usage dashboard by provider/model
状态行 (statusline)Statusline ✓ 内置预设脚本一键安装（三平台，Windows 走 PowerShell 版免 jq）Built-in preset, one-click install (all 3 platforms; PowerShell on Windows, no jq) 未见Not found
记忆体系Memory 通用 CLAUDE.md + rules/*.md（glob）全生命周期Full lifecycle for CLAUDE.md + rules/*.md (glob) workspace/memory 偏向其他 Agent 生态workspace/memory geared to other agents
项目级配对Project-level pairing ✓ CLAUDE.md↔AGENTS.md、skills 配对、分支/worktree 清理CLAUDE.md↔AGENTS.md, skills pairing, branch/worktree pruning —
供应商代理 / 故障转移Provider proxy / failover —（不接管流量）— (no traffic takeover) ✓ 内置本地代理、自动 failover、熔断、健康监控Built-in local proxy, failover, breaker, health monitor
系统托盘与会话Tray & sessions 切配置 + 实时会话状态 + macOS 聚焦/LEDSwitch profile + live session status + macOS focus/LED 切供应商 + 轻量模式Switch provider + lightweight mode
技术栈Stack Tauri 2 · React 19 · Tailwind v4 Tauri 2 · React 18 · Tailwind v3
许可License ✓ 开源 (MIT)Open source (MIT) 开源Open source

怎么选：主力在 Claude Code、想要深度配置治理 + 成本透明 → Code Manager 更顺手；需要在多个 CLI 工具间频繁切供应商、要代理高可用 → cc-switch 更全面。两者可以共存。cc-switch 信息基于其公开 README / Release（约 2026-06），标注「未见」表示在公开资料中未找到，并非官方否认；如有出入以官方为准。 How to choose: live in Claude Code and want deep config governance + cost transparency → Code Manager fits better; switch providers across many CLI tools and need proxy/high availability → cc-switch is broader. The two can coexist. cc-switch details come from its public README / releases (≈2026-06); "Not found" means not located in public docs, not an official denial — defer to upstream if it differs.

使用说明 Getting started

几分钟跑通第一个配置 Your first profile in minutes

  1. 下载并安装Download & install

    从 Releases 下载对应平台安装包并打开。应用会读取本机 ~/.claude、~/.claude.json 和 ~/.claude/projects/。Grab the installer for your platform and open it. The app reads your local ~/.claude, ~/.claude.json and ~/.claude/projects/.

  2. 设置基础项Set the basics

    在「设置」中选择界面语言、主题、默认终端和默认编辑器。In Settings, pick language, theme, default terminal and default editor.

  3. 查看供应商Browse providers

    在配置编辑器的「供应商」选项处选择内置供应商（内置 Anthropic、DeepSeek、智谱 GLM、Kimi、火山方舟、阿里云百炼等十余个），点「查看内置供应商」可打开只读一览。Pick a built-in provider from the provider option in the profile editor (Anthropic, DeepSeek, GLM, Kimi, Volcengine, Bailian and 10+ more); the "view built-in providers" link opens a read-only list.

  4. 新建或导入配置Create or import a profile

    在「配置」页新建配置并填写认证密钥、API 地址和模型，或一键导入现有 ~/.claude/settings.json。On the Profiles page, create one with your token, API endpoint and model — or import your existing ~/.claude/settings.json.

  5. 测试模型Test the model

    点击「测试模型」确认请求地址、状态码、耗时和响应都正常。Hit "Test model" to confirm the endpoint, status code, latency and response look right.

  6. 启用并核对Enable & verify

    点击启用，将配置应用到 ~/.claude/settings.json，再到「~/.claude 总览」确认最终配置符合预期。Enable to apply the profile to ~/.claude/settings.json, then check the ~/.claude overview to verify the result.

常见工作流Common workflows

切换 ProviderSwitch provider

  1. 新建配置并选择内置供应商New profile, pick a built-in provider
  2. 填密钥、调模型与常用选项Add the key, tune model & options
  3. 测试模型后启用Test model, then enable
  4. 在总览确认 settings.jsonVerify settings.json in overview

排查费用异常Investigate cost

  1. 用量页选日期/项目/模型Filter usage by date/project/model
  2. 查看总花费与构成Inspect total spend & breakdown
  3. 按会话表点开消息级明细Drill into per-message detail
  4. 必要时刷新价格 / 查价目表Refresh prices / check the price table

新建 Skill 并同步 CodexNew skill → Codex

  1. 填写合法 ID、名称与描述Set a valid id, name and description
  2. 编写 SKILL.mdWrite SKILL.md
  3. 保存并启用Save and enable
  4. 同步到 ~/.codex/skillsSync to ~/.codex/skills

更完整的页面说明、费用统计口径与 FAQ 见 For full page docs, cost methodology and FAQ, see docs/user-manual.md · 平台差异platform support

下载 Download

选择你的平台 Pick your platform

跨平台支持 macOS、Windows 与 Linux，核心配置管理功能对等可用。 Cross-platform on macOS, Windows and Linux, with core config management at parity.

macOS

Apple Silicon / Intel · .dmg / HomebrewApple Silicon / Intel · .dmg / Homebrew

下载 .dmgDownload .dmg
brew install --cask maguowei/tap/code-manager

Windows

.msi / .exe

下载安装包Download installer

Linux

.deb / .rpm / .AppImage

下载安装包Download package
下载按钮指向 Releases / latest，会自动解析到最新版本的各平台安装包；需要历史版本时可前往 全部 Releases。macOS 发布包未经过 Apple 公证：用 Homebrew 安装会自动移除隔离属性，手动下载 .dmg 首次打开被拦截时执行下方的 xattr 命令即可。 Download buttons point to Releases / latest and resolve to the newest per-platform installers automatically; for older versions, see all releases. macOS builds aren't Apple-notarized: installing via Homebrew removes the quarantine attribute automatically; for a manual .dmg, run the xattr command below if the first launch is blocked.
# macOS：若首次打开被 Gatekeeper 拦截，移除隔离属性即可# macOS: if Gatekeeper blocks the first launch, remove the quarantine attribute
xattr -rd com.apple.quarantine /Applications/code-manager.app
FAQ

常见问题Frequently asked

我的数据会上传吗？Is my data uploaded anywhere?
不会。Code Manager 主要读写本机文件，配置合并、目录扫描、用量聚合和日志查看都在本地完成。只有模型价格会在启动后尝试从 models.dev 官方 provider 刷新，且优先使用本地缓存与内置兜底。日志查看默认脱敏，隐藏密钥与 Token。No. Code Manager mostly reads and writes local files; config merge, scanning, usage aggregation and log viewing all happen locally. Only model prices are refreshed from models.dev after launch, with local cache and built-in fallbacks first. The log viewer is redacted by default, hiding keys and tokens.
它和 cc-switch 能共存吗？Can it coexist with cc-switch?
可以。两者定位不同：Code Manager 偏深度配置治理与成本分析，cc-switch 偏多工具供应商切换与代理高可用。它们都作用于本地配置文件，按需各取所长即可。Yes. They target different axes: Code Manager leans into deep config governance and cost analytics, while cc-switch leans into multi-tool provider switching and proxy availability. Both act on local config files; use whichever fits the task.
支持哪些 Provider？Which providers are supported?
内置十余个供应商(只读、不可自定义)，包括 Anthropic、DeepSeek、智谱 GLM、Kimi、MiniMax、小米 MiMo、OpenRouter、火山方舟、阿里云百炼、万界方舟、Ollama；在配置编辑器的供应商选项处选择即用。A dozen+ built-in, read-only providers (no custom providers): Anthropic, DeepSeek, GLM, Kimi, MiniMax, Xiaomi MiMo, OpenRouter, Volcengine, Bailian, Wanjie, Ollama — pick one from the provider option in the profile editor.
macOS 提示「已损坏 / 无法打开」怎么办？macOS says the app is "damaged / can't be opened"?
当前发布包未经过 Apple 公证。在终端执行 xattr -rd com.apple.quarantine /Applications/code-manager.app 移除隔离属性后即可打开。Builds aren't Apple-notarized yet. Run xattr -rd com.apple.quarantine /Applications/code-manager.app in a terminal to remove the quarantine attribute, then open it.
各平台功能一致吗？Is functionality the same on every platform?
核心配置管理在三平台对等，状态行预设也三平台都支持（Windows 用 PowerShell 版，免 jq）。差异集中在系统集成层：终端会话聚焦、可点击通知、LED 灯效目前仅 macOS。详见平台差异文档。Core config management is at parity, and statusline presets work on all three platforms (PowerShell on Windows, no jq). Differences sit in system integration: terminal focus, clickable notifications and LED are macOS-only for now. See the platform-support doc.
是开源的吗？Is it open source?
是，采用 MIT 许可。技术栈为 Tauri 2 + React 19 + TypeScript + Vite + Tailwind CSS v4 + Rust。欢迎在 GitHub 提交 Issue 与反馈。Yes, under the MIT license. Built with Tauri 2 + React 19 + TypeScript + Vite + Tailwind CSS v4 + Rust. Issues and feedback are welcome on GitHub.

把 Claude Code 的配置交给一个地方管理 Manage your Claude Code setup from one place

可见、可预览、可验证——而且完全在本地。 Visible, previewable, verifiable — and fully local.

立即下载Download now 在 GitHub 上查看Star on GitHub