它是什么
Sphinx 是 GitHub 用户 parthh01 做的本地 Git 钩子(Git hook),给用 AI 编程助手写代码的人用。你推送到受保护的分支(默认是 main 和 master)时,它会先拦下来,让另一个评审模型读这次提交的改动,出题问你这段改动会怎么运行、哪里可能出错。你可以一边看代码一边答,答错了会给解释,再换一道同类的题;答对了,推送自动继续。它的口号是“你可以把思考外包出去,但不能把理解外包出去”。它支持 Claude Code、Codex、Cursor、OpenCode 和 Pi,也可以在不用 AI 助手的普通 git push 上使用。
适合谁:经常让 AI 写代码、又想确认自己看懂了每次改动的开发者。不写代码的读者用不上。
使用前提:需要 Node.js 22.19 或更新版本和 Git,支持 macOS、Linux 和 WSL,原生 Windows 还不支持。用 npm install -g sphinx-understand 安装,再运行 sphinx install。sphinx install 会改全局 Git 设置,让这台电脑上所有仓库的推送都经过检查,还会改你所选 AI 助手的设置;不想检查的仓库可以用 sphinx yolo 关掉。出题要用你自己的模型账号:已登录的 Codex 或 Claude Code、OpenRouter 密钥,或兼容 OpenAI 的接口,费用另算,默认不限调用次数,作者说一次检查通常要 5 到 8 次请求,可以自己设上限。改动的代码、相关文件和你的回答会发给你选的评审模型;.env 和常见密钥文件默认排除,但写在普通代码里的秘密拦不住。作者说明这是练习,不是安全关卡,评审模型也可能出错。MIT 许可。
以上根据项目公开说明整理,本站没有实际测试。