【LLM】Claude Code使用指北

山顶夕景2026-03-16 17:02

note

文章目录

note
[一、Claude Code](#一、Claude Code)
二、完整的工程化布局参考
Reference

一、Claude Code

Claude Code 的核心不是"回答"，而是一个反复循环的代理过程：

python 复制代码

收集上下文 → 采取行动 → 验证结果 → [完成 or 回到收集]
     ↑                    ↓
  CLAUDE.md          Hooks / 权限 / 沙箱
  Skills             Tools / MCP
  Memory

把 Claude Code 拆成六层来看，如下图。只强化其中一层，系统就会失衡，CLAUDE.md 写太长，上下文先污染自己了；工具堆太多了，选择就搞不清楚了；subagents 开得到处都是，状态就漂移了；验证这步跳过了，出了问题根本不知道是哪里挂的。

二、完整的工程化布局参考

全局约束（CLAUDE.md）、路径约束（rules）、工作流（skills）和架构细节完全解耦，Claude Code 的执行稳定性会显著上升。假如你同时维护多个项目，可以把稳定的个人基线放在 ~/.claude/，各项目的差异放在项目级 .claude/，通过同步脚本分发，不同项目之间就不会互相污染了。

参考：

python 复制代码

Project/
├── CLAUDE.md
├── .claude/
│   ├── rules/
│   │   ├── core.md
│   │   ├── config.md
│   │   └── release.md
│   ├── skills/
│   │   ├── runtime-diagnosis/     # 统一收集日志、状态和依赖
│   │   ├── config-migration/      # 配置迁移回滚防污
│   │   ├── release-check/         # 发布前校验、smoke test
│   │   └── incident-triage/       # 线上故障分诊
│   ├── agents/
│   │   ├── reviewer.md
│   │   └── explorer.md
│   └── settings.json
└── docs/
    └── ai/
        ├── architecture.md
        └── release-runbook.md

Reference

$1$ Claude Code 快速上手核心指南：https://datawhalechina.github.io/easy-vibe/zh-cn/stage-3/core-skills/basics/

$2$ https://x.com/hitw93/status/2032091246588518683?s=46