ccpm 怎么安装？Claude Code/Codex 项目管理教程

很多人搜「ccpm 怎么安装」，其实第一步不是找命令，是先搞清楚你要装到哪——Claude Code 读取的是 .claude/skills/ 目录，Codex 目前读取仓库级或者用户级的 .agents/skills/。要是目录放错了，哪怕仓库克隆成功，Skill 也根本不会触发。

安装前要检查啥？

1. 电脑上能正常运行 git 和 gh 命令。
2. 当前项目已经是 GitHub 仓库。
3. 执行过 gh auth login 完成 GitHub 登录。

ccpm 本身不需要 API Key，也没有啥必须设置的专属环境变量。它依赖宿主 Agent、Git 和 GitHub CLI 运行；父子 Issue 功能可以选装 gh-sub-issue，没装的话会自动退化成普通任务清单。

官方仓库怎么克隆？

git clone https://github.com/automazeio/ccpm.git

仓库里真正要用的目标目录是 skill/ccpm/，别把整个仓库根目录当成 Skill 用。

Claude Code 要放到哪？

mkdir -p .claude/skills
ln -s /绝对路径/ccpm/skill/ccpm .claude/skills/ccpm

这样设置后，当前项目就能用 ccpm 了。要是你的系统不方便创建软链接，直接把这个目录复制过去也行。

Codex 要放到哪？

mkdir -p .agents/skills
ln -s /绝对路径/ccpm/skill/ccpm .agents/skills/ccpm

这是仓库级安装，只对当前项目生效。要是想所有项目都能用，把目标路径改成 ~/.agents/skills/ccpm 就行。Codex 会从当前目录往仓库根目录逐层扫描 .agents/skills，也支持软链接方式。

第一次用怎么判断它被识别了？

你就在项目里跟 Agent 说：「我想规划 notification-system，先帮我梳理需求」。正常表现不是上来就写代码，而是会先问你问题、目标用户、成功标准、约束和范围外事项，之后会生成 .claude/prds/notification-system.md 文件。

第一次触发就只验证规划入口好不好使，别直接要求「把功能全部做完」。先确认 PRD 文件能正常出现、问题能继续追问，再进入 Epic 解析；这样万一有目录错位、GitHub 没登录或者宿主没刷新的问题，排查范围也不会扩散到执行阶段，更好定位。

常见安装卡壳问题有哪些？

为啥装完完全没反应？

先检查是不是目录多套了一层 ccpm/skill/ccpm。Codex 没刷新的话重启一次就行；Claude Code 就确认下链接是不是在当前项目的 .claude/skills/ccpm 路径下。

Windows 能直接抄命令吗？

仓库里的脚本用的是 POSIX shell，原生 Windows 得先准备兼容的 shell，常用的是 WSL 或者 Git Bash；路径和软链接命令也要按你用的 shell 对应调整。

安装成功检查清单

1. Skill 目录内能看到 SKILL.md 与 references/。
2. git、gh 可正常运行，GitHub 已登录。
3. 发规划请求后先触发提问，而不是直接改代码。
4. 项目根目录出现 .claude/prds/ 后再继续解析 Epic。