Claude 进阶使用笔记

Claude 更适合长上下文、需求整理、方案比较、文章润色和复杂问题拆解。Claude Code 则适合在终端里读项目、改文件、跑命令。我的用法是：让 Claude 负责把事情想清楚，让 Codex 或 Claude Code 负责把具体改动落到仓库里。

先看本地配置

这个项目已经有 CLAUDE.md，里面写了 Astro 项目结构、常用命令、主题系统、易踩坑和部署说明。对 Claude Code 来说，这比临时口头说明更稳定。

本地还有一个 .claude/settings.local.json：

{
  "permissions": {
    "allow": [
      "Skill(run)"
    ]
  }
}

意思是本机允许 Claude 使用 run skill。这个配置很克制，只放个人机器上的权限，不把本地偏好硬塞进团队共享文件。

安装和进入项目

Claude Code 可以通过 npm 安装：

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

检查环境：

claude doctor

进入项目：

claude

如果是第一次接手项目，可以运行：

/init

它会生成或更新 CLAUDE.md。生成后要人工删掉空话，只保留真实命令、目录结构、限制和常见坑。

CLAUDE.md 写什么

这个博客的 CLAUDE.md 里最值得保留的是这些内容：

npm run check、npm run build 等命令
src/pages、src/components、src/content/posts 的职责
内容变更优先改配置和 Markdown
不要编辑 dist/、.astro/、node_modules/
主题、overflow、grid 最容易出问题的地方

如果已经有 AGENTS.md，可以在 CLAUDE.md 里引用：

@AGENTS.md

## Claude Code

- 视觉改动要检查移动端。
- 文章 frontmatter 必须符合 content schema。
- preview 前必须先 build。

我常用 Claude 做什么

需求拆解：

把下面需求整理成开发任务。
分成：必做、可选、暂缓、风险。
每条都要能直接交给工程师执行。

把需求改成 Codex 任务：

把下面需求改写成适合 Codex 执行的提示词。
必须包含目标、修改范围、禁止修改目录、验证命令和预期输出。

文章润色：

润色下面这篇笔记。
要求：
- 保留技术含义
- 删除空泛句子
- 每一节都要有实际例子
- 语气像个人经验记录，不要营销腔

长文压缩：

把这篇文章压到 800 字以内。
保留最有用的命令、配置和结论。
删除重复解释。

settings 只放真正需要的权限

项目共享配置可以放 .claude/settings.json，个人机器配置放 .claude/settings.local.json。我的原则是：

团队共享：命令白名单、项目级规则
本地个人：自己常用 skill、个人偏好
敏感文件：用 deny 明确拦住

示例：

{
  "permissions": {
    "allow": [
      "Bash(npm run check)",
      "Bash(npm run build)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

什么时候用 Skill

重复三次以上的流程可以做成 skill，比如：

发布前检查
UI 回归检查
changelog 生成
文章压缩和润色
代码 review

这个项目当前只允许了 Skill(run)，所以先别急着加一堆 skill。等某个流程真的常用，再沉淀成 .claude/skills/<name>/SKILL.md。

参考资料

Claude Code Getting Started：https://code.claude.com/docs/en/getting-started
Claude Code Memory / CLAUDE.md：https://code.claude.com/docs/en/memory
Claude Code Settings：https://code.claude.com/docs/en/settings
Claude Code Skills：https://code.claude.com/docs/en/slash-commands