前置准备¶
安装前确保本机满足以下条件。Windows / macOS 均可（工具脚本是跨平台 Node，命令一致）。
1. 软件清单¶
| 软件 | 版本 | 用途 |
|---|---|---|
| Claude Code 或 Codex | 最新 | AI 协作 Agent（两者均兼容，见 04_multi-agent.md） |
| Node.js | 22.x+ | 工具脚本 / MCP 运行时 / 前端 |
| Git | ≥ 2.40 | 仓库管理 |
| JDK + Maven | JDK 17+ / Maven 3.8+ | 后端（IDEA 2025+） |
| pnpm（npm 10+） | 最新 | 前端（czerp-console） |
| kubectl + argocd-cli | — | 运维 |
| OpenSpec | 最新 | 新功能 spec |
| WireGuard VPN | 客户端 | 访问内网 Gitee/Nacos/中间件/MCPJungle；凭证联系 @张谦（详见 config/environments.md） |
2. 账号 / 凭证（个人初始配置）¶
详见 config/personal-setup.md。要点：
| 凭证 | 谁给 |
|---|---|
| MCPJungle 网关授权 token | 团队负责人 |
| Gitee 个人 token | 自助（gitee 个人设置） |
| Notion integration token（PM） | 自助 |
| VPN / 共享账号 | IT / 见 config/environments.md |
共享环境信息/账号已固化在
config/environments.md；个人 token 留本地，不进仓库。
3. 安装 plugin（无需 clone）¶
Claude Code：
/plugin marketplace add anthropics/claude-plugins-official
/plugin install superpowers@claude-plugins-official # 全员
/plugin marketplace add https://gitee.com/finmate/czerp-ai-enablement.git
/plugin install czerp-context@czerp-ai-enablement
/plugin install czerp-workflow@czerp-ai-enablement
# 按角色追加 czerp-backend / czerp-frontend / czerp-pm / czerp-qa / czerp-ops / czerp-manager
Codex：
codex plugin marketplace add https://gitee.com/finmate/czerp-ai-enablement.git
codex plugin add czerp-context@czerp-ai-enablement
codex plugin add czerp-workflow@czerp-ai-enablement
# 按角色追加 …
接入团队 MCP 网关见 02_configure-mcp.md；多 Agent 细节见 04_multi-agent.md。
4. 本地代码仓库¶
按角色 clone（见 config/personal-setup.md 的角色→仓库表）：
mkdir -p ~/Documents/CZERP && cd ~/Documents/CZERP
git clone https://gitee.com/finmate/ifinmate-document.git
# 后端: ifinmate-library / ifinmate-support / czerp-api / czerp_data_hub
# 前端: czerp-console 运维: czerp-gitops
各代码仓库根的 AGENTS.md / CLAUDE.md 需由维护者一次性部署（node tools/sync-legacy-agents.mjs --apply 后在各仓库提交）；已部署的仓库 clone 后自动具备、普通成员无需操作，尚未部署的仓库 AI 暂读不到仓库级约定。（维护者流程见 legacy-onboarding/README.md。）
5. 下一步¶
01_install-marketplace.md → 02_configure-mcp.md → 03_verify-setup.md →（多 Agent）04_multi-agent.md。