对于刚刚开始使用 AI 编程的人，我刚刚分享了我的 CLAUDE.md（它也适用于 Gemini 和 Codex，哦对了——见使用说明）。自从使用这个文件后，我的效率大幅提升。很多想法来自 @garrytan 和 @karpathy，其他则是我根据自己的经验总结的。请务必根据你的情况个性化调整，添加/删除适合你的部分。如果你有改进的想法，请告诉我，我永远乐于学习更多 :) 下载地址：https://github.com/jbarbier/CLAUDE.md…

jbarbier/CLAUDE.md

来源：https://github.com/jbarbier/CLAUDE.md

CLAUDE.md —— 一份面向编程代理的工作契约

这个仓库只有一个文件：CLAUDE.md。这是我在每次会话开始时给 Claude Code（以及任何其他编程代理）的指令集。它告诉代理如何思考、何时编写代码而非猜测、什么算“完成”，以及如何与我沟通。

它有意带有主观倾向。大部分想法来自 Andrej Karpathy (https://x.com/karpathy) 和 Garry Tan (https://x.com/garrytan)，还有一些是我自己的。

你应该复制这个文件，把自己的名字放进去，删除与你的技术栈不符的部分，然后让它变得更好。下面提供了三种工具的说明。

它实际做什么

如果没有指令，编程代理会默认采用它见过所有内容的平均值。这个平均值很平庸：它会过早停止、跳过测试、发明库，以及为那些本该直接做的事请求许可。

CLAUDE.md 会在每次会话开始时加载到模型的上下文中，作为一个覆盖默认行为的常设契约。代理在读你的请求之前会先读它。

可以把这想象成雇佣一个没有任务简介的承包商，与雇佣一个墙上贴着一页规格说明的承包商之间的区别。同一个承包商，但产出截然不同。

安装（3分钟）

Claude Code

Claude Code 会自动读取项目根目录下名为 CLAUDE.md 的文件（以及全局版本 ~/.claude/CLAUDE.md）。

# 在你的项目内
curl -O https://raw.githubusercontent.com//CLAUDE_MD/main/CLAUDE.md
# 或者直接手动复制文件

搞定。在该目录下启动 claude，规则就生效了。

OpenAI Codex CLI、Cursor、Gemini CLI 及其他

大多数其他代理会读取名为 AGENTS.md 的文件，而不是 CLAUDE.md。AGENTS.md 是一个新兴的跨工具标准（Codex CLI、Cursor、Gemini CLI、Jules 等都支持）。内容完全相同，只是文件名不同。

你肯定不想让两个副本彼此偏离。保持一个真实源，其余都用符号链接：

# CLAUDE.md 是真正的文件；其他所有文件都指向它
ln -s CLAUDE.md AGENTS.md   # Codex CLI、Cursor 和 AGENTS.md 标准
ln -s CLAUDE.md GEMINI.md   # Gemini CLI

现在 Claude 读 CLAUDE.md，Codex 读 AGENTS.md，Gemini 读 GEMINI.md，三个都是同样的字节。编辑一次，所有代理都更新。

如果你的工具不支持符号链接，直接复制文件并重命名即可。规则不关心文件叫什么名字。

把它变成你的（替换我的名字）

文件中有多处提及我的名字（如“impress Julien”、“ask Julien”、“tell Julien what to restart”）。代理会把这个名字当作它需要对应的人。把它替换成你的名字：

# macOS
sed -i '' 's/Julien/YOUR_NAME/g' CLAUDE.md

# Linux
sed -i 's/Julien/YOUR_NAME/g' CLAUDE.md

顺便决定还要修改什么：

• food_vision/classifier.py:47 在“谈话风格”部分只是一个示例。可以留着，它只展示代理在指向代码时应使用的格式。
• LLM 访问规则（“通过本地 Claude Code 路由，绝不通过外部 API”）是我个人配置特有的。如果你直接调用 Anthropic 或 OpenAI API，请删除整个块或颠倒其含义。
• gstack / skills 引用 假设你已安装 Garry Tan 的 gstack (https://github.com/garrytan/gstack)。如果没有，“检查 skills”规则仍然有效，只是能找到的 skills 更少。