上個月我在文章里留了個留言區(qū)，說「你們在 Claude Code 上遇到的問題，盡管丟過來」。結(jié)果后臺收到了將近 200 條消息，很多問題反復(fù)出現(xiàn)——CLAUDE.md 到底怎么寫、Token 消耗太快怎么辦、MCP 是個什么東西。

與其在留言區(qū)逐條回復(fù)，不如把高頻問題集中回答一次。這 10 個問題覆蓋了從入門到進階的核心困惑，每個回答都附帶我自己用了半年的真實經(jīng)驗。

1. CLAUDE.md 到底怎么寫？寫了真的有用嗎？

這個問題被問的頻率排第一。幾乎所有用 Claude Code 的人第一個困惑就是：這個文件是干什么的？不寫行不行？

一句話回答：CLAUDE.md 就是你項目的「團隊公約」。 Claude Code 啟動時會自動讀取它，把你寫的規(guī)則當成團隊共同約定來遵守。不寫也能用，但等于你招了一個能力很強但完全不了解你們項目的新人，每次溝通都要從頭交代背景。

一個實用的 CLAUDE.md 模板長這樣：

# CLAUDE.md
## 項目簡介
用戶訂單系統(tǒng)，Spring Boot 3.2 + MyBatis-Plus + MySQL 8.0
## 常用命令
- 啟動: `mvn spring-boot:run`
- 測試: `mvn test`
- 構(gòu)建: `mvn clean package -DskipTests`
## 代碼規(guī)范
- 命名: 駝峰命名，表名用下劃線分隔
- 分層: Controller 只做參數(shù)校驗和路由，業(yè)務(wù)邏輯全部在 Service 層
- 數(shù)據(jù)庫: 禁止在代碼里寫 SQL，統(tǒng)一用 XML mapper
## 已知坑點
- 訂單表的 create_time 字段用的是 UTC，前端展示需要轉(zhuǎn)東八區(qū)
- 第三方支付回調(diào)地址必須用 HTTPS，本地調(diào)試用 ngrok

為什么有效？ Claude Code 的上下文窗口是有限的。如果你不寫 CLAUDE.md，它每次都要通過讀代碼、問你問題來理解項目。寫了之后，相當于把「新員工入職手冊」直接拍在桌上，省掉大量來回對話的 Token。

我在一個 12 萬行的 Java 項目里測試過：寫 CLAUDE.md 之前，每次讓 Claude Code 改代碼平均需要 3-4 輪對話交代背景；寫完之后，第一輪就能給出符合項目規(guī)范的方案。Token 消耗直接砍掉將近一半。

踩坑提醒： CLAUDE.md 不是越長越好。我見過有人寫了 800 行的 CLAUDE.md，結(jié)果 Claude Code 每次對話都先把這 800 行塞進上下文，反而占了大量空間。控制在 100-200 行，只寫 Claude Code 自己讀代碼讀不出來的東西。

CLAUDE.md 的作用范圍有三層，別搞混了：

全局的 ~/.claude/CLAUDE.md 我建議寫兩條：代碼注釋語言偏好（比如「注釋用中文」）和通用規(guī)則（比如「永遠不要在 main 分支上直接提交」）。項目級的放具體技術(shù)棧信息。這樣換項目不用每次都重寫。

2. Token 太貴了，怎么省？

成本焦慮是被問得第二多的問題。有讀者說「用了一天 Claude Code，Token 花了 20 美元，心在滴血」。

先說結(jié)論：正常用法下，一天大概 3-8 美元。 如果你一天花了 20 美元，大概率是以下幾種情況之一。

省錢的三個最有效手段：

第一，用好 /compact 命令。 這是最被低估的命令。當對話變長時，Claude Code 的上下文會越來越大，每次請求消耗的 Token 越來越多。/compact 會把歷史對話壓縮成摘要，Token 消耗立刻下降。

# 對話太長時，在終端里直接輸入
/compact

# 也可以加自定義提示，指定保留什么信息
/compact 保留最近的代碼修改記錄和當前的bug討論

一個真實的數(shù)字：我在一次重構(gòu)會話里，上下文從 50K Token 壓縮到 8K，單次請求成本從 0.3 美元降到 0.05 美元。

第二，大任務(wù)拆小。 別用一句話讓 Claude Code 做一整塊功能。比如「幫我重構(gòu)整個用戶模塊」這句話，Claude Code 會讀大量文件、生成大量輸出。改成「先幫我把 UserService 里的查詢方法抽到 UserQueryService」，每一步的 Token 消耗可控。

第三，善用 --model 切換模型。 簡單任務(wù)用 Sonnet，復(fù)雜架構(gòu)設(shè)計用 Opus。

# 日常開發(fā)用 Sonnet（便宜 5 倍）
claude --model claude-sonnet-4-20250514

# 復(fù)雜架構(gòu)決策切 Opus
claude --model claude-opus-4-20250514

3. MCP 是什么？怎么配置？

MCP（Model Context Protocol）是 Anthropic 推出的一個開放協(xié)議，簡單說就是給 Claude Code 裝「外 掛工具」的標準接口。

你可以把它理解成 Claude Code 的「USB 接口」——通過這個協(xié)議，Claude Code 可以連接數(shù)據(jù)庫、調(diào)用 API、操作瀏覽器、搜索文檔等等。沒有 MCP，Claude Code 只能讀寫本地文件；有了 MCP，它能干的事成倍擴展。

配置方式是在 .claude/settings.json（項目級）或 ~/.claude/settings.json（全局）中添加 MCP 服務(wù)器：

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost:5432/mydb"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
    }
  }
}

踩坑提醒： MCP 服務(wù)器啟動失敗是最常見的報錯。90% 的情況是兩個原因——Node.js 版本太低（需要 v18+），或者參數(shù)里的路徑寫錯了。遇到問題先跑 node --version 檢查版本，再仔細核對路徑。

我目前日常用的 MCP 組合是：PostgreSQL（查數(shù)據(jù)庫）、Browser（測試頁面）、Fetch（調(diào)用 API）。三個覆蓋了后端開發(fā) 80% 的場景。

4. Skill 系統(tǒng)是什么？和 MCP 有什么區(qū)別？

這個問題特別好，因為很多人把 Skill 和 MCP 搞混了。

一句話區(qū)分：MCP 是「工具」，Skill 是「工作流」。

MCP 給 Claude Code 提供的是原子能力——查數(shù)據(jù)庫、讀文件、調(diào) API。Skill 則是一套預(yù)定義的指令模板，告訴 Claude Code 「遇到某類任務(wù)，按這個流程走」。

打個比方：MCP 是給你一把螺絲刀，Skill 是給你一套「如何組裝宜家書柜」的步驟說明書。螺絲刀可以拆任何東西，但只有說明書告訴你先裝哪塊板。

安裝 Skill 的方式：

# Skill 文件放在 ~/.claude/skills/ 目錄下
mkdir -p ~/.claude/skills
# 把 skill 文件夾放進去即可

一個最簡 Skill 文件夾的結(jié)構(gòu)：

~/.claude/skills/my-skill/
├── SKILL.md          # 必須，定義觸發(fā)條件和執(zhí)行流程
├── references/       # 可選，參考資料
└── templates/        # 可選，模板文件

什么時候用 MCP，什么時候用 Skill？ 簡單判斷標準：如果你的需求是「給我一個能力」（比如查數(shù)據(jù)庫），用 MCP；如果你的需求是「幫我按流程做某類事」（比如寫一篇技術(shù)文章、做一個代碼審查），用 Skill。

5. 權(quán)限管理怎么配？總彈權(quán)限確認太煩了

Claude Code 默認會在執(zhí)行任何有風(fēng)險的操作前彈出確認。剛開始用覺得安全，用久了覺得煩——特別是寫代碼寫到一半被打斷節(jié)奏。

最實用的配置是 allowlist（白名單），把你確認安全的操作加進去：

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run lint)",
      "Bash(mvn test)",
      "Bash(git status)",
      "Bash(git diff)",
      "Bash(git log:*)",
      "Read",
      "Edit"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force*)"
    ]
  }
}

三個安全原則：

1. 只放行你確定安全的命令。 git status 和 mvn test 可以放心放行，rm 和 git push --force 永遠不要放。
2. 用模糊匹配。 Bash(git log:*) 匹配所有 git log 相關(guān)命令，不用每條都寫。
3. 分層配置。 個人常用命令放在 ~/.claude/settings.json（全局），項目特有的放在項目的 .claude/settings.json。

一個真實數(shù)據(jù)： 我的全局 allowlist 大概 15 條規(guī)則，覆蓋了日常 90% 的操作。配合之后，一天的權(quán)限彈窗從 30+ 次降到 3-5 次，都是真正需要確認的操作（比如刪除文件、推送代碼）。

6. Claude Code 和 Cursor / Copilot 該選哪個？

這是選型類問題，我直接說我的判斷框架。

三者的核心差異不在能力，在交互模式。

我的建議不是三選一，而是組合用。

日常寫代碼用 Cursor（或 Copilot），因為補全速度快、不需要切換窗口。遇到大任務(wù)——比如「重構(gòu)整個認證模塊」「給項目加上單元測試」「排查一個跨 5 個文件的 bug」——切到 Claude Code，用對話式交互逐步推進。

打個比方：Copilot 是自動鉛筆，隨手記筆記用；Cursor 是智能筆記本，日常辦公主力；Claude Code 是一個坐在你旁邊的資深工程師，復(fù)雜問題拉他過來 pair programming。

7. Hooks 怎么用？能做什么？

Hooks 是 Claude Code 的「自動化鉤子」——在特定事件發(fā)生時自動執(zhí)行你的腳本。

最實用的兩個場景：

場景一：每次修改代碼后自動跑 lint。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "cd $CLAUDE_PROJECT_DIR && npm run lint -- --fix"
          }
        ]
      }
    ]
  }
}

這樣每次 Claude Code 修改文件后，自動跑一遍 lint 并修復(fù)格式問題，不用你手動提醒。

場景二：對話開始時自動加載環(huán)境信息。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo '當前分支:' $(git branch --show-current) '最新commit:' $(git log --oneline -1)"
          }
        ]
      }
    ]
  }
}

踩坑提醒： Hook 腳本的執(zhí)行會影響 Claude Code 的響應(yīng)速度。如果腳本跑超過 3 秒，會覺得 Claude Code 變慢了。建議把耗時操作異步化或者只在必要時觸發(fā)。我在 PostToolUse 里加了一個跑測試的 Hook，結(jié)果每次改一個文件都要等 15 秒跑全量測試，差點以為網(wǎng)絡(luò)卡了。后來改成只跑受影響的測試文件，才恢復(fù)正常速度。

Hook 的事件類型一共四種，搞清楚觸發(fā)時機就不會亂用：

我見過一個很巧的用法：有人在 Notification 事件里接了 Bark（iOS 推送），Claude Code 跑長時間任務(wù)時，完成后會自動推送到手機上。這樣你可以去干別的事，不用盯著終端等。

配置文件放在哪里也有講究。 項目級的 Hook 放在 .claude/settings.json，全局的放 ~/.claude/settings.json。兩者會合并，同名事件的 Hook 按項目優(yōu)先級執(zhí)行。

8. 上下文太長 / 被截斷怎么辦？

這個問題的本質(zhì)是：Claude Code 的上下文窗口是有限的。

以 Claude Sonnet 4 為例，上下文窗口 200K tokens。聽起來很多，但如果你讓它讀了一個 5000 行的文件，光文件內(nèi)容就占了 15K+ tokens；加上對話歷史、系統(tǒng)提示、工具輸出，很快就會逼近上限。

四招解決：

第一，/compact 是急救藥。 感覺響應(yīng)變慢或者開始出現(xiàn)遺漏之前信息的情況，立刻執(zhí)行 /compact。

第二，.claudeignore 是預(yù)防藥。 把不需要 Claude Code 關(guān)注的大文件排除掉：

# .claudeignore
node_modules/
dist/
*.lock
*.min.js
coverage/
test/fixtures/

我在一個前端項目里加了 .claudeignore 之后，Claude Code 的初始掃描從 8 秒降到 2 秒，上下文占用少了 40%。

第三，精確指定文件。 別說「幫我看看這個項目的問題」，而是說「幫我看看 src/services/order.ts 和 src/models/order.ts 里的錯誤處理」。范圍越小，上下文越夠用。

第四，新開對話處理新問題。 很多人習(xí)慣一個 Claude Code 對話窗口從早用到晚，上下文里混著三四段不相關(guān)的討論。改完一個 bug，/clear 清一下，再開始新話題。

9. IDE 集成怎么配？VS Code / JetBrains 怎么用？

Claude Code 目前支持四種形態(tài)：CLI 終端、Desktop App、Web App、IDE 插件。

對于大多數(shù)開發(fā)者，IDE 插件是最自然的接入方式。

VS Code 配置（最成熟）：

# 安裝 Claude Code VS Code 擴展
# 在 VS Code 擴展商店搜索 "Claude Code" 安裝即可
# 或者用命令行
code --install-extension anthropic.claude-code

安裝后在 VS Code 底部終端面板會出現(xiàn) Claude Code 的輸入框。好處是可以直接引用編輯器中選中的代碼、跳轉(zhuǎn)到文件、同步光標位置。

JetBrains 配置：

# JetBrains IDE (IntelliJ IDEA / WebStorm / PyCharm 等)
# 在 Plugins 市場搜索 "Claude Code" 安裝
# 安裝后重啟 IDE，在 Tools 菜單找到 Claude Code

一個容易忽略的點： IDE 插件和 CLI 是共享同一個工作目錄的。如果你在 VS Code 的 Claude Code 插件里配置了 .claude/settings.json，在終端里用 claude 命令也會讀取同一份配置。這意味著你只需要配一次。

實際體感： 我平時寫 Java 用 IntelliJ，寫前端用 VS Code。兩個 IDE 都裝了 Claude Code 插件，日常體驗差異不大。JetBrains 的插件啟動比 VS Code 版慢 2-3 秒，但編輯器集成做得更好——可以直接在代碼行旁邊看到 Claude 的修改建議。

10. 怎么寫好 Prompt 讓 Claude Code 更準？

最后一個問題是「元問題」——怎么和 Claude Code 有效溝通。

三個立竿見影的技巧：

第一，給上下文，不要猜它知道什么。 差的 prompt：「這個接口有 bug，幫我修」。好的 prompt：「src/api/order.ts 的 createOrder 方法，當商品庫存為 0 時應(yīng)該返回 400 錯誤，但現(xiàn)在返回了 200 并且創(chuàng)建了一個庫存為 0 的訂單」。差別在于后者給了文件路徑、方法名、期望行為和實際行為。

第二，用指令鏈拆復(fù)雜任務(wù)。 一次性讓 Claude Code 做 5 件事，它可能會漏掉第 3 件。拆成步驟更可靠：

# 不推薦
"幫我給項目加上單元測試、集成測試、CI/CD 配置、文檔更新"

# 推薦
# 第 1 步
"先幫 UserService 的核心方法寫單元測試"
# 第 2 步（確認上一步?jīng)]問題后）
"現(xiàn)在幫我配 GitHub Actions，跑剛才寫的測試"

第三，用 CLAUDE.md 減少重復(fù)指令。 如果你發(fā)現(xiàn)自己每次都告訴 Claude Code「代碼要寫注釋」「用 async/await 不用 callback」「提交信息用 conventional commits 格式」，把這些寫進 CLAUDE.md。一次配置，永久生效。

一個被忽視的高級技巧： 讓 Claude Code 自己生成 CLAUDE.md。在項目根目錄執(zhí)行：

claude "分析這個項目的代碼結(jié)構(gòu)、技術(shù)棧和編碼規(guī)范，生成一份 CLAUDE.md 文件"

它會掃描你的代碼，推斷出項目規(guī)范，生成一個初始版本。你再人工審核和修改，比自己從零寫快得多。

常見問題

Q1：Claude Code 需要聯(lián)網(wǎng)嗎？ 需要。Claude Code 的 AI 推理在云端完成，必須保持網(wǎng)絡(luò)連接。但你操作的是本地文件，代碼本身不上傳到 Anthropic 的訓(xùn)練數(shù)據(jù)（除非你手動開啟了數(shù)據(jù)共享）。

Q2：一個 Claude Pro 訂閱夠用嗎？ 個人開發(fā)夠用。Claude Pro（20 美元/月）包含 Claude Code 的使用額度，日常編碼足夠。如果是重度使用（每天 4 小時以上），建議用 API 計費模式，按量付費更可控。

Q3：Claude Code 支持哪些編程語言？ 理論上支持所有語言——它本質(zhì)上是讀寫文本文件。但實際體驗上，Python、JavaScript/TypeScript、Java、Go 這幾種主流語言的體驗最好，因為訓(xùn)練數(shù)據(jù)充足，生成的代碼質(zhì)量更高。小眾語言（比如 Rust、Elixir）也能用，但偶爾需要你手動修正生成的代碼。

Q4：可以用 Claude Code 做代碼審查嗎？ 可以，而且效果不錯。用法：git diff main | claude "審查這些改動，指出潛在的 bug 和代碼風(fēng)格問題"。配合 Hooks 還可以在 PR 提交時自動觸發(fā)審查。

Q5：離線環(huán)境下怎么辦？ 目前沒有離線方案。如果你在無網(wǎng)絡(luò)的環(huán)境工作，Claude Code 無法使用。這種場景下建議用本地模型方案（Ollama + Continue），但效果和 Claude Code 有明顯差距。

說真的，這 10 個問題覆蓋了 Claude Code 從「裝上到用順」的全過程。如果你現(xiàn)在還在猶豫要不要開始用，我的建議是——裝上之后先花 20 分鐘寫一份 CLAUDE.md，這一步的投入產(chǎn)出比最高，后面所有操作都會更順暢。

以上就是一次答清楚Claude Code新手必問的10個問題的詳細內(nèi)容，更多關(guān)于Claude Code新手必問的10個問題的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論