Claude Code,
一键配置。

$ git clone https://github.com/mengfanchun2017/ccconfig.git ~/git/ccconfig && cd ~/git/ccconfig
✅ ccconfig 已 clone
$ bash init-bootstrap.sh
✅ gh 认证 + ccprivate(建仓/clone + API key + 符号链接)
$ bash init-base.sh all
✅ Ubuntu / LLM / 链接/服务(3 步;--yes 全非交互)
$ bash init-option.sh
✅ 可选组件(MCP / Skills / CLI,按需安装)
$ bash maintain.sh status
✅ 全量状态:链接 / 版本 / auto-sync / MEMORY / MCP
$ bash maintain.sh monitor status
✅ Monitor 运行中 — 文件改动自动 commit + push
🪟
Windows 用户前置四步

1. 升级 PowerShell 7(管理员 PowerShell):

winget install --id Microsoft.PowerShell --source winget

2. 安装 WSL2 + Ubuntu 26.04 LTS(PowerShell 7 管理员):

wsl --install -d Ubuntu-26.04 --location C:\wsl\u26claude --name u26claude

文件装在 C:\wsl\u26claude(需提前 mkdir C:\wsl,WSL 2.5+ 支持 --location)。换盘改 --location D:\wsl\u26claude 即可。旧版 WSL(< 2.5)不支持 --location,仍需 --export + --unregister + --import 三步法。

3. 进入 Ubuntu,升级系统包:

sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

4. 配置 WSL 镜像网络(PowerShell,让 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 使配置生效。
详细步骤:BOOTSTRAP.md → 阶段 0

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

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

🖥️

新机器,从零开始

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

🔄

配置漂移

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

👥

团队混乱

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

为你真实的工作流而建。

三个场景,小时变分钟。

01

新装机

从全新 WSL 终端到 Claude Code 完整配置,不到 10 分钟。克隆、链接、完成。每条 rule、每个 skill、每项设置 — 原封不动。

02

多设备同步

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

03

团队入职

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

Claude Code 环境的基础设施。

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

🩺

状态/同步

10 项只读体检 + auto-sync 守护。bash maintain.sh status 查链接/依赖/PAT/仓库/MCP/飞书;日志跟踪、监控启停、高权限开启都在这里。

⬆️

更新

配置仓库更新(3 库)+ 工具版本升级(12 步)+ PAT 刷新 + 可选组件补装 + 一键修复。bash maintain.sh upgrade all 一个月维护 30 秒。

🧠

LLM

切预设、链路诊断、真实探测。bash maintain.sh llm 交互切换(DeepSeek/MiniMax/MiMo…),OpenAI-only 端点自动走 bridge,自定义预设随加随用。

🔌

MCP

MCP 服务器注册、Key 填写、状态检查。bash maintain.sh mcp 管理用户级 MCP 配置,从 conf/mcp-servers.json 同步进 .config.json。

📚

rag

外部知识源接入。lark 多账号列表/切换/OAuth 授权 + getnote(得到大脑)状态与授权。团队账号一键切。

🌐

远程

SSH + Tailscale 远程连接。查看端口状态、设置 SSH 端口,笔记本直连桌面 tmux 里的 Claude Code 会话。

🔗

符号链接 + 公私分离

Rules、skills、agents、MCP 配置从 git 链接到 ~/.claude/。秘钥在 ccprivate、模板在 ccconfig,公开仓库零 token,升级不覆盖个性配置。

📦

Skills 生态 →

ccconfig 装好底层工具(lark-cli、OfficeCLI、MCP),独立 skill 仓库 提供 24 个 Claude Code 技能。装什么用什么,开箱即用。

装好了,然后呢?

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

🛠 日常维护
切换 LLM
bash maintain.sh llm

升级工具
bash maintain.sh upgrade all

状态检查
bash maintain.sh status

一键修复
bash maintain.sh fix
📦 可选组件
组件菜单(装/补装)
bash init-option.sh

飞书 lark-cli
bash option-larkcli/init.sh

MCP 配置
bash maintain.sh mcp

远程 SSH 状态
bash maintain.sh → 6A
🩺 六大维护模块
运行 bash maintain.sh 打开扁平菜单,6 个功能域各带字母项,选中即执行:

① 状态/同步   ② 更新
③ LLM   ④ MCP
⑤ rag   ⑥ 远程


每项右侧灰列就是可直接复制的命令。
🪟 WSL 手动安装
不想用一键脚本?WSL 手动部署教程 从 PowerShell 配置到 WSL 安装到 Claude Code 初始化,每一步都有详细说明。

你可能会问。

和 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 脚本和符号链接。