标题：Claude Code Skills 配置保姆级教程：从 CLAUDE.md 到自定义命令，20 个 Skills 实测只留 6 个，收藏这篇就够了

正文：
上个月团队新来了两个后端，我让他们装 Claude Code，结果三个人折腾了大半天——不是 API Key 没生效，就是自定义命令死活找不到文件。后来我把踩过的坑整理了一遍，顺便把社区里传得最火的 20 个 Skills（主要是各种 CLAUDE.md 模板和自定义命令集）挨个测了一轮。

结论先放这儿：真正能让日常编码体感提升的只有 6 个，剩下 14 个要么太泛（写了跟没写一样），要么跟你的技术栈八竿子打不着。这篇把安装踩坑、Skills 筛选结果、自定义 Skill 的写法全部讲完，代码可以直接复制。

这篇适合谁

• 已经装了 Claude Code 但只会 claude 裸跑，没配过 CLAUDE.md 的
• 看到掘金热榜"2026编程圈很火的10个Skills"想跟风但不知道从哪下手的
• 团队里想统一 AI 编码规范，需要共享自定义命令的 Tech Lead
• 用 Claude Code 写代码觉得 token 烧得太快、想控成本的独立开发者

整体流程

graph TD
 A[1. 安装 Claude Code + 配置 API Key] --> B[2. 创建 CLAUDE.md 全局/项目级配置]
 B --> C[3. 安装社区 Skills 或自定义命令]
 C --> D[4. 配置权限白名单]
 D --> E[5. 设置默认模型控成本]
 E --> F[6. 验证 & 日常使用]

一共 6 步，前 2 步最容易翻车（90% 的问题出在环境变量和文件路径上），后面都是锦上添花。

先说结论：20 个 Skills 筛选结果

排名	Skill 名称	类型	提效感受	适合谁
⭐1	Karpathy CLAUDE.md	全局规范	代码风格一致性直接拉满	所有人
⭐2	/project:review	自定义命令	代码从 10 分钟→2 分钟	后端/全栈
⭐3	/project:test-gen	自定义命令	单元测试可用率约 75%（以能直接运行且逻辑基本正确为标准）	后端
⭐4	compact-context 规范	CLAUDE.md 片段	token 消耗降约 40%	高频用户
⭐5	/project:commit-msg	自定义命令	conventional commit 一键生成	团队协作
⭐6	security-audit 规范	CLAUDE.md 片段	自动标注常见漏洞模式	涉及鉴权的项目
7-20	省略	各类	效果一般或场景太窄	—

GitHub 上 multica-ai/andrej-karpathy-skills 是目前社区公认最值得参考的起点（注：该仓库为第三方整理，非 Karpathy 本人维护，Star 数及可用性请以访问时实际情况为准）。

第一步：安装 Claude Code + 配置 API Key

npm install -g @anthropic-ai/claude-code

装完之后不要直接跑 claude，先配环境变量，不然你会看到这个：

Error: ANTHROPIC_API_KEY is not set. 
Please set the ANTHROPIC_API_KEY environment variable.

把 Key 写进 shell 配置文件：

echo 'export ANTHROPIC_API_KEY="sk-ant-xxx"' >> ~/.zshrc
source ~/.zshrc

这里有几个坑：

• 如果你用的是 bash 而不是 zsh，写进 ~/.bashrc 才对。我见过有人写进了 .zshrc 结果 VSCode 终端是 bash，死活不生效。
• source ~/.zshrc 只对当前终端窗口生效。如果你习惯新开终端，直接开一个新窗口也能让配置生效，不必每次手动 source。
• VSCode 集成终端有时不会自动继承最新的 shell 配置，建议配完环境变量后重启 VSCode，或在集成终端里手动 source ~/.zshrc（或 ~/.bashrc），确认 echo $ANTHROPIC_API_KEY 能输出正确的值再继续。

如果你不想直连 Anthropic 官方（比如需要低延迟或者团队统一计费），可以通过 API 聚合网关来配。OpenRouter 收 5.5% 手续费，ofox.io 是 0% 加价对齐官方价格，改个 base_url 就行：

export ANTHROPIC_BASE_URL="https://api.ofox.io/v1"
export ANTHROPIC_API_KEY="your-ofox-key"

这样 Claude Code 的所有请求都走聚合网关，团队管理员能在后台看到每个人调了多少 token、花了多少钱。

第二步：创建 CLAUDE.md

CLAUDE.md 是 Claude Code 的"记忆文件"——不写这个，等于每次跟一个失忆的人聊天。

两个位置都能放：

# 全局配置（对你所有项目生效）
~/.claude/CLAUDE.md

# 项目级配置（仅当前项目）
./CLAUDE.md

两者会合并读取，项目级追加在全局之后，优先级更高。建议每个文件单独控制在 80 行以内（详见 FAQ），全局规范写通用原则，项目级只写当前技术栈的具体约束。

我的全局 CLAUDE.md 长这样（精简版，可直接复制）：

# 全局编码规范
- 使用 TypeScript strict mode
- 函数不超过 30 行，超过就拆
- 变量命名用 camelCase，常量用 UPPER_SNAKE
- 禁止 any 类型，必须显式标注
- commit message 遵循 conventional commits

项目级的就写具体技术栈：

# 项目：xx-backend
- 框架：NestJS + Prisma + PostgreSQL
- 测试：Jest，覆盖率要求 > 80%
- 部署：Docker + K8s
- 禁止：不要用 console.log，用 Logger

第三步：安装社区 Skills（自定义斜杠命令）

这是真正让效率翻倍的东西。在项目根目录创建命令文件：

mkdir -p .claude/commands

然后每个 .md 文件就是一个命令。比如代码命令：

touch .claude/commands/review.md

文件内容（内容格式为 prompt 加参数占位符）：

Review the following code for:
1. Security vulnerabilities (SQL injection, XSS, auth bypass)
2. Performance issues (N+1 queries, memory leaks)
3. Code style violations per our CLAUDE.md
Focus on: $ARGUMENTS

用的时候在 Claude Code 里输入 /project:review src/auth/login.ts 就行。$ARGUMENTS 会被替换成后面的所有内容（整体作为一个字符串传入，详见 FAQ）。

踩坑提醒： 文件名不能有空格，特殊字符仅允许连字符（-），否则你会看到这个报错：

Error: ENOENT: no such file or directory, 
open '.claude/commands/xxx.md'

我第一次用的时候文件名写了 code-review.md，结果调用时要用 /project:code-review 而不是 /project:code review——中间是连字符不是空格，这个文档里没写清楚，折腾了半天。

第四步：6 个真正提效的 Skills 详细配置

Skill 1：Karpathy 风格全局规范

直接参考 multica-ai/andrej-karpathy-skills 仓库的核心部分（该仓库为社区第三方整理，非 Karpathy 本人维护），我删掉了跟 Python ML 相关的内容，留下通用的：

# Code Quality Rules
- Write clean, readable code over clever code
- Every function needs a one-line docstring
- Error handling: fail fast, fail loud
- No magic numbers, extract to named constants

Skill 2：/project:review 代码

上面已经贴了。实测用 claude-sonnet-5 跑，一个 200 行的 controller 耗时约 8 秒，能找出 80% 的常规问题。

Skill 3：/project:test-gen 测试生成

Generate unit tests for $ARGUMENTS using Jest.
Requirements:
- Cover happy path + edge cases + error cases
- Mock external dependencies
- Each test should be independent
- Use describe/it structure
Output only the test file content.

Skill 4：compact-context 规范（写进 CLAUDE.md）

# Token Management
- When context exceeds 60%, use /compact automatically
- Prefer short answers unless asked for detail
- Don't repeat code that hasn't changed

这条写进 CLAUDE.md 之后，Claude Code 会主动在回答里控制长度。实测对话 token 消耗降了约 40%（从平均每轮约 3200 tokens 降到约 1900，5 天观察期的粗略统计，不同项目差异较大）。

Skill 5：/project:commit-msg

Generate a conventional commit message for the 
staged changes. Format: type(scope): description
Keep under 72 characters. No body needed.

Skill 6：security-audit 规范

# Security Checklist (auto-apply during review)
- Flag any raw SQL string concatenation
- Flag missing input validation on API endpoints
- Flag hardcoded secrets or API keys
- Flag missing rate limiting on auth endpoints

第五步：配置权限白名单 + 默认模型

每次 Claude Code 要执行文件操作都弹确认框，挺烦人的。在受信任的本地环境可以通过交互式命令添加白名单：

# 在 Claude Code 对话中输入
/allowed-tools

按提示勾选 Read、Write、Execute 等权限即可。也可以尝试通过 config 命令配置（具体字段名以官方文档为准，下方仅供参考）：

claude config set permissions.allow '["Read","Write","Execute"]'

或者直接加启动参数（CI/CD 场景用，仅在隔离容器环境下使用）：

claude --dangerously-skip-permissions

注意：--dangerously-skip-permissions 参数名称及 config set permissions.allow 字段格式请以 Anthropic 官方文档为准，如有变动以官方为准。

设置默认模型控成本——日常用 claude-sonnet-5 就够了，别上来就 Opus：

claude config set model claude-sonnet-5

模型	输入价格	输出价格	适合场景
claude-opus-4.8	$15/M tokens	$75/M tokens	架构设计、复杂重构
claude-sonnet-5	$3/M tokens	$15/M tokens	日常编码、代码
claude-haiku-4.5	$0.8/M tokens	$4/M tokens	简单补全、commit msg

价格仅供参考，以 Anthropic 官网实时定价为准，随时可能调整。按表中数据，Opus 输入端约为 Haiku 的 18.75 倍（$15 ÷ $0.8），日常写代码完全没必要用 Opus。

第六步：验证一切正常

claude --print 'What model are you using?'

如果返回了模型名和正常响应，说明整个链路已经跑通了。

不同场景怎么选

你的情况	推荐配置	原因
个人独立开发	全局 CLAUDE.md + 3-4 个自定义命令	够用，别过度工程化
团队 3-8 人	项目级 CLAUDE.md + .claude/commands/ 提交 Git	统一规范，新人上手快
开源项目维护	CLAUDE.md 写贡献规范 + /project:review	PR 效率翻倍
重度 token 消耗	compact-context 规范 + 默认 Haiku	先省钱再说
需要团队用量审计	走聚合网关统一 Key	管理员后台按人/模型/Key 维度看消耗

踩坑记录 / 报错对照表

报错信息	原因	解法
ANTHROPIC_API_KEY is not set	环境变量没生效	检查 shell 类型（bash/zsh），source 配置文件或新开终端；VSCode 集成终端需重启或手动 source
401 Unauthorized - Invalid API key	Key 错误或过期	去 console.anthropic.com 重新生成
429 Too Many Requests	触发速率限制	等 60 秒重试，或切聚合网关分流
spawn git ENOENT	系统没装 git	apt install git 或 brew install git
Permission denied - Tool execution requires approval	权限没配	/allowed-tools 添加白名单
ENOENT: .claude/commands/xxx.md	命令文件路径错误或文件名有特殊字符	检查目录结构，文件名只用字母数字和连字符

常见问题 FAQ

Q: CLAUDE.md 写多长合适？超过多少行会影响性能？

建议每个单独的 CLAUDE.md 文件控制在 80 行以内（全局和项目级各自计算，不是合计）。太长的话每次对话都会把 CLAUDE.md 全文塞进 context，白白消耗 token。核心规范写清楚就行，别把整个 Wiki 搬进去。

Q: 自定义命令能传多个参数吗？

$ARGUMENTS 仅支持整体字符串传入，即命令后面的所有内容作为一个字符串传给 prompt，这是 Claude Code 当前的设计方式。如果需要结构化输入，在 prompt 里写清楚格式要求（比如"第一行是文件路径，第二行是关注点"），然后调用时换行传入。

Q: 团队里不同人用不同模型，怎么统一管理成本？

通过 ofox.io 这类聚合网关给每个人分配独立 Key，管理员后台能按 Model / User / API Key 维度看消耗明细——谁用了 Opus 跑了一晚上，一眼就能定位到。

Q: Claude Code 和 Cline 的 Skills 能互通吗？

不能直接互通。Claude Code 的 Skills 是 CLAUDE.md + .claude/commands/*.md，Cline 用的是 .clinerules 和自己的 prompt 模板格式。但核心 prompt 内容可以手动搬，改改格式就行。

Q: 我配了 CLAUDE.md 但感觉 Claude Code 没读到？

先确认文件位置对不对——必须是项目根目录（git rev-parse --show-toplevel 的结果）或 ~/.claude/CLAUDE.md。然后在对话里问一句"你读到了哪些 CLAUDE.md 规则？"，它会告诉你实际加载了什么。

Q: --dangerously-skip-permissions 安全吗？

本地开发环境问题不大，但如果你的项目里有 rm -rf 或者网络请求相关的操作，Claude Code 可能在你没注意的时候执行。CI/CD 里用的话确保是隔离容器环境。名字里 "dangerously" 三个字已经把话说明白了。

小结

Claude Code Skills 的核心就两个东西：CLAUDE.md 负责定义上下文规范，commands 负责定义可调用操作。社区那些花里胡哨的 Skills 合集，拆开来看都是这两样的组合。

别贪多——先把 Karpathy 那套全局规范抄过来，再根据自己的技术栈加 2-3 个高频命令（review、test-gen、commit-msg），跑一周看看效果。等你摸清了 $ARGUMENTS 的玩法，再慢慢扩展也不迟。

这套配完之后日常写代码的流程确实变了。以前是"写完代码→人肉 review→写测试→想 commit message"，现在是"写完代码→/project:review→/project:test-gen→/project:commit-msg"，三个命令串起来，省下来的时间够多喝两杯咖啡。