本文總結(jié)了一些 Claude Code 使用技巧，針對(duì)初學(xué)者的，“老司機(jī)”可劃走～

CLAUDE.md

用 claude 打開一個(gè)新項(xiàng)目，執(zhí)行 /init 命令，它會(huì)自動(dòng)話分析項(xiàng)目并創(chuàng)建一個(gè) CLAUDE.md 文件。

CLAUDE.md 是項(xiàng)目記憶文件，每次會(huì)話都會(huì)攜帶，它包含了項(xiàng)目中最重要的一些信息，例如格式、規(guī)范、命令、開發(fā)者癖好等。

CLAUDE.md 可放在項(xiàng)目根目錄，也可以放在 .claude 目錄，或一些二級(jí)目錄。二級(jí)目錄的，要等 Claude 加載當(dāng)前文件時(shí)，才會(huì)加載。

CLAUDE.md 盡量保持在 200 行以內(nèi)，如果內(nèi)容太多可能會(huì)影響 AI 輸出的效果，更容易出現(xiàn)幻覺。如果有按需加載的內(nèi)容，請(qǐng)使用 skill ，下文會(huì)介紹。

簡單示例：

# Todo List Project

## 常用命令
- 啟動(dòng): `npm run dev`
- 測試: `npm test`
- 構(gòu)建: `npm run build`

## 代碼規(guī)范
- 使用 ES Modules，不用 CommonJS
- 使用函數(shù)式組件 + Hooks
- 狀態(tài)管理用 Zustand（見 src/stores）

## 文件結(jié)構(gòu)
- src/components/ 放 UI 組件
- src/api/ 放接口調(diào)用

還有一個(gè) AGENTS.md 但它不是 Claude Code 原生的文件，而是來自整個(gè) AI 編程工具生態(tài)的一個(gè)開放標(biāo)準(zhǔn)。它的定位是：一個(gè)文件，兼容所有 AI 編程工具。

目前每個(gè)主流 AI 編程工具都有自己的配置文件：Claude Code 讀取 CLAUDE.md，Codex CLI 讀取 AGENTS.md，Gemini CLI 讀取 GEMINI.md，Cursor 用 .cursorrules，GitHub Copilot 用 copilot-instructions.md

Plan Mode

使用 Claude Code 一般是：先探索，再規(guī)劃，最后編碼。

使用 shift+tab 可切換到 Plan mode

此時(shí)輸入一些指令讓它去學(xué)習(xí)和探索，例如

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

然后，讓它根據(jù)探索的內(nèi)容做詳細(xì)規(guī)劃，例如

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

最后，切換回 Normal Mode 并讓 Claude 編碼，根據(jù)其計(jì)劃進(jìn)行驗(yàn)證。

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

常見命令

總結(jié)了一下 Claude Code 常見的命令。

會(huì)話管理（最常用）

功能類

代碼相關(guān)

在對(duì)話框中還有幾個(gè)特殊前綴：/ 觸發(fā) slash 命令，! 直接執(zhí)行 bash 命令，@ 引用文件（帶自動(dòng)補(bǔ)全）。

!npm test          # 直接執(zhí)行 shell 命令
!git status
@src/index.ts      # 把文件內(nèi)容加入上下文

Skill

Skill 現(xiàn)在已經(jīng)是 agent 非常成熟且常用的模塊了，在 claude code 同樣如此。
可以自己創(chuàng)建，也可以安裝第三方的，例如 vercel.com/blog/introd…

執(zhí)行命令

npx skills add vercel-labs/agent-skills

會(huì)創(chuàng)建在 .claude/skills 目錄下

如下圖，下面三個(gè)是我安裝的 skill ，上面幾個(gè)是 claude code 內(nèi)置的 skill

這樣 Cluade Code 在寫 React 或前端代碼時(shí)，就會(huì)參考這些 skill 寫的更好。

這些第三方的都是全世界開發(fā)者通用的技能，在你的實(shí)際工作中，你應(yīng)該還需要積累一些自己或公司內(nèi)部使用的 skill ，一般要一邊應(yīng)用一邊積累，慢慢改善。

MCP

MCP server 是 agent 聯(lián)通外部世界的方式。幾個(gè)推薦安裝的 MCP server

1. Context7 — 解決文檔過時(shí)問題 Context7 把版本精確的庫文檔直接注入 Claude Code 會(huì)話。Claude 不再靠訓(xùn)練數(shù)據(jù)猜 API，而是拿到你項(xiàng)目實(shí)際使用的 React、Next.js、Prisma 那個(gè)版本的真實(shí)文檔。有效解決 Claude 寫出已廢棄方法的問題。

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

這里的 project 是安裝在項(xiàng)目里，也可以改為 user
安裝以后會(huì)在項(xiàng)目根目錄 .mcp.json 文件中看到

2. Playwright — 瀏覽器自動(dòng)化測試 Playwright MCP 讓 Claude Code 可以打開瀏覽器、點(diǎn)擊頁面、截圖驗(yàn)證 UI，這個(gè)反饋閉環(huán)能捕獲單元測試發(fā)現(xiàn)不了的問題。

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

3. GitHub — 無縫 PR 和 issue 管理 GitHub MCP 消除了編輯器和 GitHub 網(wǎng)頁之間最多的上下文切換，創(chuàng)建分支、開 PR、搜索代碼、管理 issue 和 Actions workflow 全在對(duì)話里完成。

claude mcp add -s project github npx @modelcontextprotocol/server-github
# 需要設(shè)置 GITHUB_PERSONAL_ACCESS_TOKEN

安裝以后，啟動(dòng) claude 時(shí)候需要選擇

可以讓 claude code 幫我打開網(wǎng)頁訪問 localhost:3000 來測試網(wǎng)頁，它會(huì)自動(dòng)分析網(wǎng)頁元素，進(jìn)行測試。

現(xiàn)在 claude code 有 tool search 功能，默認(rèn)只家在 tool name ，其他內(nèi)容都是按需加載，不會(huì)占用太多 token

Hooks

Hooks 是用戶定義的 shell 命令，在 Claude Code 生命周期中的特定點(diǎn)執(zhí)行。它們對(duì) Claude Code 的行為提供確定性控制，確保某些操作始終發(fā)生，而不是依賴 LLM 選擇運(yùn)行它們。使用 hooks 來強(qiáng)制執(zhí)行項(xiàng)目規(guī)則、自動(dòng)化重復(fù)任務(wù)，并將 Claude Code 與現(xiàn)有工具集成。

例如，阻止受保護(hù)的文件被編輯，如 .env、package-lock.json 或 .git/ 中的任何內(nèi)容。

編輯 .claude/settings.json 文件，增加

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

其中 PreToolUse 就是在工具使用增加 Hook ，這里的 sh 文件內(nèi)容如下

#!/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 多種行為的開始和結(jié)束增加監(jiān)測機(jī)制，保障安全穩(wěn)定。

SubAgents

sub agent 單獨(dú)的環(huán)境，單獨(dú)的上下文，運(yùn)行單獨(dú)的任務(wù)，不影響主 agent 。
例如代碼審查、單元測試、排查 bug 等。

使用 /agents 命令查看當(dāng)前 sub agents （cc 內(nèi)置了幾個(gè) agent），或者創(chuàng)建一個(gè)新的

創(chuàng)建以后會(huì)在 .claude/agents/ 目錄下創(chuàng)建一個(gè) md 文件，描述這個(gè) agent ，你可以修改

運(yùn)行一個(gè) sub agent 讓它幫我寫單元測試

Context Window

一次聊天太長，上下文內(nèi)容過多，就會(huì)消耗過多 token，且讓 AI 產(chǎn)生幻覺。這是所有 Agent 都無法避免的事情。
所以，開發(fā)新的功能時(shí)，要及時(shí)清理聊天記錄，使用 /clear 命令。
恢復(fù)上次會(huì)話 claude --continue ，選擇會(huì)話 claude --resume

下圖是 claude code 各個(gè)功能對(duì)于上下文的影響，可以看到

• CLAUDE.md 是每次請(qǐng)求都攜帶
• MCP servers 是只攜帶工具名稱，其他按需 —— 但如果 base_url 不是官方 claude ，這里就不確定了?。?！
• Skills 只寫代碼 name desc ，內(nèi)容按需加載

最后

之前和同學(xué)溝通，有人提到一句話非常好：如果 AI 寫錯(cuò)了，不是糾正他，而是考慮自己的環(huán)境、規(guī)則和計(jì)劃是否合理，這也是 harness 編程和 vibe coding 的區(qū)別。

Claude Code 的功能和使用就很契合這一點(diǎn)，Plan Mode + Skill + Hook 就是環(huán)境、規(guī)則和計(jì)劃。

到此這篇關(guān)于Claude Code初學(xué)者的一些使用技巧總結(jié)的文章就介紹到這了,更多相關(guān)Claude Code使用技巧內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論