Claude Code初学者的一些使用技巧整理总结

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Claude Code初学者的一些使用技巧整理总结”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。

在这个场景下，本文总结了一些 Claude Code 采用技巧，针对初学者的，“老司机”可划走～

CLAUDE.md

结合项目来看，用 claude 打开一个新项目，执行 /init 命令，它会自动话分析项目同时新建一个 CLAUDE.md 文件。

落到代码里，CLAUDE.md 是项目记忆文件，每次会话都会携带，它包含了项目中最重要的一些信息，比如格式、规范、命令、开发者癖好等。

从实现思路看，CLAUDE.md 可放在项目根目录，也可以放在 .claude 目录，或一些二级目录。二级目录的，要等 Claude 加载当前文件时，才会加载。

理解这一步时，CLAUDE.md 尽量保持在 200 行以内，如果内容太多可能会影响 AI 输出的效果，更容易出现幻觉。如果有按需加载的内容，请采用 skill，下文会介绍。

轻松示例：

# Todo List Project

## 常用命令
- 启动: `npm run dev`
- 测试: `npm test`
- 构建: `npm run build`

## 代码规范
- 使用 ES Modules，不用 CommonJS
- 使用函数式组件 + Hooks
- 状态管理用 Zustand（见 src/stores）

## 文件结构
- src/components/ 放 UI 组件
- src/api/ 放接口调用

还有一个 AGENTS.md 但它不是 从实现思路看，Claude Code 原生的文件，而是来自整个 AI 编程工具生态的一个开放标准。它的定位是：一个文件，兼容所有 AI 编程工具。

在这个场景下，目前每个主流 AI 编程工具都有自己的设置文件：Claude Code 读取 CLAUDE.md，Codex CLI 读取 AGENTS.md，Gemini CLI 读取 GEMINI.md，Cursor 用 .cursorrules，GitHub Copilot 用 copilot-instructions.md

Plan Mode

采用 Claude Code 一般是：先探索，再规划，最后编码。

采用 shift+tab 可切换到 Plan mode

此时输入一些指令让它去学习和探索，比如

read /src/auth and understand how we handle sessions and login.
also look at how we manage environment variables for secrets.

然后，让它根据探索的内容做详细规划，比如

I want to add Google OAuth. What files need to change?
What's the session flow? Create a plan.

从实现思路看，最后，切换回 Normal Mode 同时让 Claude 编码，根据其计划进行验证。

implement the OAuth flow from your plan. write tests for the
callback handler, run the test suite and fix any failures.

常用命令

总结了一下 Claude Code 常用的命令。

会话管理（最常用）

功能类

代码相关

在对话框中还有几个特殊前缀：/ 触发 slash 命令，! 直接执行 bash 命令，@ 引用文件（带自动补全）。

!npm test          # 直接执行 shell 命令
!git status
@src/index.ts      # 把文件内容加入上下文

Skill

在这个场景下，Skill 现在已经是 agent 很成熟且常用的模块了，在 claude code 同样如此。
落到代码里，可以自己新建，也可以安装第三方的，比如 vercel.com/blog/introd……

执行命令

npx skills add vercel-labs/agent-skills

会新建在 .claude/skills 目录下

落到代码里，如下所示图，接下来三个是我安装的 skill，上面几个是 claude code 内置的 skill

理解这一步时，这样 Cluade Code 在写 React 或前端代码时，就会参考这些 skill 写的更好。

实际处理时，这些第三方的都是全世界开发者通用的技能，在你的实际工作中，你应该还需积累一些自己或公司内部采用的 skill，一般要一边应用一边积累，慢慢改善。

MCP

实际处理时，MCP server 是 agent 联通外部世界的方式。几个建议安装的 MCP server

1. Context7 实际处理时，— 解决文档过时问题 Context7 把版本精确的库文档直接注入 Claude Code 会话。Claude 不再靠训练数据猜 API，而是拿到你项目实际采用的 React、Next.js、Prisma 那个版本的真实文档。有效解决 Claude 写出已废弃方法的问题。

claude mcp add -s project context7 npx @upstash/context7-mcp

这里的 project 是安装在项目里，也可以改为 user
安装以后会在项目根目录 .mcp.json 文件中看到

2. Playwright 结合项目来看，— 浏览器自动化测试 Playwright MCP 让 Claude Code 可以打开浏览器、点击页面、截图验证 UI，这个反馈闭环能捕获单元测试发现不了的问题。

claude mcp add -s project playwright npx @playwright/mcp@latest

3. GitHub 落到代码里，— 无缝 PR 和 issue 管理 GitHub MCP 消除了编辑器和 GitHub 网页之间最多的上下文切换，新建分支、开 PR、搜索代码、管理 issue 和 Actions workflow 全在对话里完成。

claude mcp add -s project github npx @modelcontextprotocol/server-github
# 需要设置 GITHUB_PERSONAL_ACCESS_TOKEN

安装以后，启动 claude 时候需选择

从实现思路看，可以让 claude code 帮我打开网页访问 localhost:3000 来测试网页，它会自动分析网页元素，进行测试。

结合项目来看，现在 claude code 有 tool search 功能，默认只家在 tool name，其他内容都是按需加载，不会占用太多 token

Hooks

结合项目来看，Hooks 是用户定义的 shell 命令，在 Claude Code 生命周期中的特定点执行。它们对 Claude Code 的行为提供确定性控制，确保某些操作始终发生，而不是依赖 LLM 选择运行它们。采用 hooks 来强制执行项目规则、自动化重复任务，同时将 Claude Code 与现有工具集成。

结合项目来看，比如，阻止受保护的文件被编辑，如 .env、package-lock.json 或 .git/ 中的任何内容。

编辑 .claude/settings.json 文件，增加

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ""$CLAUDE_PROJECT_DIR"/.claude/hooks/protect-files.sh"
          }
        ]
      }
    ]
  }
}

其中 PreToolUse 就是在工具采用增加 Hook，这里的 sh 文件内容如下所示

#!/bin/bash
# protect-files.sh

INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/")

for pattern in "${PROTECTED_PATTERNS[@]}"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blocked: $FILE_PATH matches protected pattern '$pattern'" >&2
    exit 2
  fi
done

exit 0

结合项目来看，Hook 事件类型有很多，比如 SessionStart SessionEnd PreToolUse PostToolUse 具体看文档 code.claude.com/docs/zh-CN/……

从实现思路看，总之，Hook 允许用户在 claude code 多种行为的开始和结束增加监测机制，保障安全稳定。

SubAgents

从实现思路看，sub agent 单独的环境，单独的上下文，运行单独的任务，不影响主 agent。
比如代码审查、单元测试、排查 bug 等。

采用 /agents 命令查看当前 sub agents （cc 内置了几个 agent），或者新建一个新的

新建以后会在 .claude/agents/ 目录下新建一个 md 文件，描述这个 agent，你可以修改

运行一个 sub agent 让它帮我写单元测试

Context Window

从实现思路看，一次聊天太长，上下文内容过多，就会消耗过多 token，且让 AI 产生幻觉。这是所有 Agent 都无法避免的事情。
从实现思路看，所以，开发新的功能时，要及时清理聊天记录，采用 /clear 命令。
恢复上次会话 claude --continue，选择会话 claude --resume

下图是 claude code 各个功能对于上下文的影响，可以看到

• CLAUDE.md 是每次请求都携带
• 实际处理时，MCP servers 是只携带工具名称，其他按需 —— 但如果 base_url 不是官方 claude，这里就不确定了！！！
• Skills 只写代码 name desc，内容按需加载

最后

在这个场景下，之前和同学沟通，有人提到一句话很好：如果 AI 写错了，不是纠正他，而是考虑自己的环境、规则和计划是否合理，这也是 harness 编程和 vibe coding 的区别。

在这个场景下，Claude Code 的功能和采用就很契合这一点，Plan Mode + Skill + Hook 就是环境、规则和计划。

从实现思路看，总的来说，claude这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。