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。
三个场景,小时变分钟。
从全新 WSL 终端到 Claude Code 完整配置,不到 10 分钟。克隆、链接、完成。每条 rule、每个 skill、每项设置 — 原封不动。
办公室桌面、家里笔记本、SSH 远程服务器。相同 rules、相同 skills、相同 Claude Code 体验。自动同步保持一致。
新人克隆 ccprivate,运行 setup。即刻与团队一致。共享 rules、共享 skills、共享工作流。无需配置会议。
不是你运行的工具,是你克隆的基石。一切都是文件,一切都在 git,一切皆可组合。
10 项只读体检 + auto-sync 守护。bash maintain.sh status 查链接/依赖/PAT/仓库/MCP/飞书;日志跟踪、监控启停、高权限开启都在这里。
配置仓库更新(3 库)+ 工具版本升级(12 步)+ PAT 刷新 + 可选组件补装 + 一键修复。bash maintain.sh upgrade all 一个月维护 30 秒。
切预设、链路诊断、真实探测。bash maintain.sh llm 交互切换(DeepSeek/MiniMax/MiMo…),OpenAI-only 端点自动走 bridge,自定义预设随加随用。
MCP 服务器注册、Key 填写、状态检查。bash maintain.sh mcp 管理用户级 MCP 配置,从 conf/mcp-servers.json 同步进 .config.json。
外部知识源接入。lark 多账号列表/切换/OAuth 授权 + getnote(得到大脑)状态与授权。团队账号一键切。
SSH + Tailscale 远程连接。查看端口状态、设置 SSH 端口,笔记本直连桌面 tmux 里的 Claude Code 会话。
Rules、skills、agents、MCP 配置从 git 链接到 ~/.claude/。秘钥在 ccprivate、模板在 ccconfig,公开仓库零 token,升级不覆盖个性配置。
ccconfig 装好底层工具(lark-cli、OfficeCLI、MCP),独立 skill 仓库 提供 24 个 Claude Code 技能。装什么用什么,开箱即用。
初始化完成后,日常只需记住这几个命令。
bash maintain.sh 打开扁平菜单,6 个功能域各带字母项,选中即执行:maintain.sh fix 理解完整的 ~/.claude/ 目录结构,把每个组件接到正确位置。/plugin install。Rules 是独立文件 — 留你想要的,删掉不需要的。符号链接系统能干净地处理部分采用。