🚀 进阶：让 AI 编程助手更懂你

已经能跑起 Claude Code 或 Codex，下一步就是让它少猜一点、多记一点～ 先看Maru Code 接入教程，术语不熟再翻AI 名词小词典。

📝 给项目留一张「说明书」

把固定约定写进文件，AI 每次进项目都能先读到。适合写这些：

• 构建、开发、测试命令
• 代码风格和目录用途
• 不要碰的目录或文件
• 项目里常见的坑

短一点更好。长篇大论反而记不住，关键规则写清楚就行。

Claude Code：CLAUDE.md

Claude Code 会读项目根目录的 ./CLAUDE.md 或 ./.claude/CLAUDE.md，也会读个人全局的 ~/.claude/CLAUDE.md。只给自己看的项目约定可以放在 ./CLAUDE.local.md，记得把它加进 .gitignore。

在会话里输入 /init，可以自动生成一份起始的 CLAUDE.md；输入 /memory 查看和编辑记忆。Claude Code 也支持读 AGENTS.md。

Codex：AGENTS.md

Codex 会读全局的 ~/.codex/AGENTS.md，再从 Git 根目录一路往下读到当前目录的 AGENTS.md。越靠近当前目录的说明，越适合写这个子目录的特殊规则。

🧩 Skills：把常用套路做成技能

技能就是一套专门做事的说明。Claude Code 的技能放在：

范围	位置
个人，所有项目	~/.claude/skills/<名字>/SKILL.md
当前项目	.claude/skills/<名字>/SKILL.md

SKILL.md 开头用两个 --- 包住 YAML frontmatter，里面写 name 和 description，下面再写具体步骤。相关任务出现时会自动加载，也可以输入 /技能名 手动调用。旧的 .claude/commands/xxx.md 自定义命令仍然能用。

Codex 的技能放在仓库的 .agents/skills，从当前目录到仓库根目录都会扫描。Codex 自带 Skill Installer，可以从 openai/skills 等仓库安装精选技能。两边都遵循 Agent Skills 开放标准。

比如做一个「写提交说明」技能，最小可以这样写：

---
name: commit-message
description: 根据暂存区改动写一条清楚的提交说明
---

# 写提交说明

先查看暂存区改了什么，再用中文写一句动词开头的说明。
不要编造没有发生的改动；不确定时先问我。

🎁 现成的技能包

不想自己写？先装别人写好的，挑一两个用顺了再加，装太多反而占上下文。

技能包	适合	地址
Anthropic Skills	Claude 官方技能库：文档、表格、PPT、前端设计等	anthropics/skills
OpenAI Skills	Codex 官方技能目录，可用 Skill Installer 安装	openai/skills
Superpowers	一整套「先想清楚再动手」的开发流程：头脑风暴、写计划、测试驱动	obra/superpowers
Matt Pocock Skills	工程师日常技能：需求澄清、TDD、代码审查	mattpocock/skills
Impeccable	让 AI 做的界面更好看：设计审查、去掉「AI 味」	pbakaus/impeccable

技能也是代码

技能里可以带脚本，装之前看一眼仓库是否可信、最近有没有人维护。更多新项目看 开源项目精选。

🔌 MCP：让 AI 连接外部工具

MCP 可以让 AI 连接资料库、笔记等外部工具。Claude Code 常用命令：

claude mcp add --transport http <名字> <网址>
claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add <名字> -- npx -y <包名>
claude mcp list
claude mcp remove <名字>

在会话里输入 /mcp 看连接状态。Codex 可以这样添加：

codex mcp add context7 -- npx -y @upstash/context7-mcp

也可以在 config.toml 写 [mcp_servers.<名字>] 表，使用 command、args、env 配置。MCP 服务器可能读写你的数据，只安装可信来源的；装太多还会占用上下文。

🐾 子智能体：把大任务分给小帮手

查资料、看日志这类容易塞满上下文的活，可以交给子智能体。Claude Code 在 ~/.claude/agents/ 或项目 .claude/agents/ 放 md 文件定义，会话里用 /agents 管理；也可以直接说「用一个子智能体去调查 xxx」。Codex 有 /agents、/subagents 命令。

⏸️ 先计划，再动手

Claude Code 按 Shift+Tab 切到 plan mode，状态栏会显示 ⏸ plan mode on；启动时也可以用 claude --permission-mode plan，先出计划，不改文件。Codex 输入 /plan。

💬 会话别硬撑到满

需求	Claude Code	Codex
说明文件	CLAUDE.md，也支持 AGENTS.md	AGENTS.md
技能位置	~/.claude/skills 或项目 .claude/skills	仓库 .agents/skills
添加 MCP	claude mcp add ...	codex mcp add ... 或 config.toml
计划模式	Shift+Tab 或 claude --permission-mode plan	/plan
恢复会话	claude --continue、claude --resume	/resume
压缩上下文	/compact	/compact

Claude Code 还可以用 /clear 清空、/context 看上下文占用。Codex 可以用 /new 新开对话、/review 审代码、/model 换模型、/status 看状态、/permissions 改权限。

🌱 省钱省心小贴士

1. 一次只设一个目标，先让它读项目，再开始改。
2. 大任务先 plan，确认步骤后再执行。
3. 长对话阶段性 /compact，或者开新对话并让它先读 CLAUDE.md / AGENTS.md。
4. 重要约定写进说明文件，不要只依赖聊天记忆。
5. 改完让它运行项目已有的测试和检查。

📚 官方文档

Claude Code 中文文档 记忆 Skills MCP 子智能体 Codex AGENTS.md Codex Skills Codex MCP Codex 命令

想系统地从零学 Claude Code，可以看社区写的中文手册：Claude Code 手册（CC BY-SA 4.0，内容以官方文档为准）。