Claude Code,
一键配置。

$ git clone https://github.com/mengfanchun2017/ccconfig.git ~/git/ccconfig && cd ~/git/ccconfig
✅ ccconfig 已 clone
$ bash bootstrap-gh-auth.sh
✅ gh 已装 + GitHub 已登录
$ bash init-ccprivate-repo.sh
✅ ccprivate 已创建(API key + 符号链接)
$ bash init.sh all
✅ Node / Claude Code / LLM / MCP / Skills / 收尾
$ bash init-option.sh
bat / glow / nano / Bridge / Cloudflare / Remote(按需)
$ bash maintain.sh status
✅ 14 项检查:配置链接 / 版本 / auto-sync / MEMORY / Example 同步 / MCP
$ bash maintain.sh monitor status
✅ Monitor loop running — 文件改动自动 commit + push
⚠️
Windows + WSL 用户前置步骤

确保能访问 GitHub 后,在 PowerShell(普通用户)运行以下命令配置 WSL 镜像网络,让 WSL 走 Windows VPN:

@"
[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
firewall=true
memory=8GB
"@ | Out-File -FilePath "$env:USERPROFILE\.wslconfig" -Encoding UTF8

运行后执行 wsl --shutdown 重启 WSL 使配置生效,再继续以下步骤。

你的配置不该困在一台机器里。

Claude Code 很强大。但每台新机器都要重来一遍。每次改动都要手动复制。每个队友都要临时配置。

🖥️

新机器,从零开始

花几个小时找旧配置、重装 skills、凭记忆重写 rules。每次如此。

🔄

配置漂移

桌面有新 rules,笔记本用旧的。两台都不完整。越走越远。

👥

团队混乱

五个人,五套手工拼凑的 Claude 配置。无共享 rules,无统一 skills。

为你真实的工作流而建。

三个场景,小时变分钟。

01

新装机

从 macOS 设置向导到 Claude Code 完整配置,不到 10 分钟。克隆、链接、完成。每条 rule、每个 skill、每项设置 — 原封不动。

02

多设备同步

办公室桌面、家里笔记本、SSH 远程服务器。相同 rules、相同 skills、相同 Claude Code 体验。自动同步保持一致。

03

团队入职

新人克隆 ccprivate,运行 setup。即刻与团队一致。共享 rules、共享 skills、共享工作流。无需配置会议。

Claude Code 环境的基础设施。

不是你运行的工具,是你克隆的基石。一切都是文件,一切都在 git,一切皆可组合。

🔗

智能符号链接

Rules、skills、agents、MCP 配置 — 全部从 git 仓库链接到 ~/.claude/。运行时文件在 ccprivate,模板在 ccconfig。升级不覆盖个性配置。

🔐

公开/私密分离

ccconfig 开源可 fork。秘钥、运行时 rules、agents 存在 ccprivate。符号链接桥接两者。公开仓库零 token,零运行时文件。

🔄

自动同步

systemd 监控你的配置。有改动自动推送到 GitHub。另一台机器下拉更新。始终一致。

📌

版本锁定

conf/versions.json 锁定每个工具版本 — Node、gh、Claude Code CLI、lark-cli。升级不会突然炸掉。

一键升级

bash maintain.sh update all — 月度维护 30 秒搞定。更新工具、重建链接、全量检查。

🔄

智能 LLM 切换

交互菜单切后端(DeepSeek/MiniMax/Gateway)。Gateway 自动按高峰/非高峰切路由。Custom 临时接任何端点。OpenAI-only 自动桥接。

📦

Skills 市场就绪 →

15+ Claude Code skills 可用。按条安装 /plugin install。按需取用。底层工具 ccconfig 已装好,技能开箱即用。

🧪

完整测试套件

45 个 init 测试用例,mock 隔离秒级完成。覆盖配置校验、placeholder 检测、sync 容错。改完脚本跑一遍,不引入回归。

装好了,然后呢?

初始化完成后,日常只需记住这几个命令。

🛠 日常维护
切换 LLM
bash lib/init-llm.sh

更新系统
bash maintain.sh update all

状态检查
bash maintain.sh status

模板同步
bash maintain.sh example
📦 可选组件
飞书 Bridge
bash option-bridge/init.sh

Cloudflare 插件
bash option-cloudflare/init.sh

OfficeCLI
bash option-officecli/init.sh

Python 包更新
bash maintain.sh update python
🧩 Skill 生态
ccconfig 装好底层工具(lark-cli、officecli、PyMuPDF、MCP),skill 提供 16 个 Claude Code 技能。装了 ccconfig 再装技能,每个都开箱即用。

你可能会问。

和 dotfiles 有什么不同?
Dotfiles 同步文件。ccconfig 管理版本、依赖、自动更新,并用符号链接桥接公开/私密仓库。它是带构建系统的 dotfiles — maintain.sh fix 理解完整的 ~/.claude/ 目录结构,把每个组件接到正确位置。
我需要 ccprivate 吗?
只有当你需要存 API key、token 或私有配置时才需要。ccconfig 可独立运行 — 克隆、运行 setup、搞定。ccprivate 是给不想放进公开仓库的秘钥准备的。
可以只取部分用吗?
可以。一切都是可选的。Skills 按条安装 /plugin install。Rules 是独立文件 — 留你想要的,删掉不需要的。符号链接系统能干净地处理部分采用。
支持哪些操作系统?
Linux 和 WSL2(Windows)完整支持且每日测试。macOS 支持计划中 — 大部分脚本已可用,但 auto-sync 需 launchd 等价实现。欢迎 PR。
稳定吗?能用于生产吗?
ccconfig 由维护者在多台机器上每天使用。Release 分支只接收打过 tag 的测试版本。Auto-sync 已连续运行数月。话虽如此,这是个人基础设施项目 — 不是企业产品。读代码,都是 bash 脚本和符号链接。