高性能智能編程：Claude Code 初學者設置指南

大多數人的 Claude Code 設置從未超越第一天。他們運行安裝程序，登錄，輸入提示，得到一些有用的結果，然後就不再碰配置文件。幾周後，會話開始丟失早期決策，相同的權限提示每天出現五十次，每個長任務都以同樣的方式結束：一堵上下文警告牆，對話不得不放棄並從零開始重新啓動。

這些都不是模型的限制，而是設置的限制。Claude Code 默認設置合理，但合理默認值和高性能是不同的標準，它們之間的差距幾乎完全由初學者從未打開的幾個文件組成。本指南旨在彌合這一差距，介紹實際配置、權限、鈎子和命令習慣，這些將區分全新安裝和能經受真實、持續智能工作的設置，並根據 Anthropic 當前文檔進行驗證。

正確安裝 Claude Code

Claude Code 作為獨立命令行界面（CLI）安裝，當前推薦路徑是原生安裝器，但 npm 仍可作為備用。安裝完成後，在首次運行 claude 之前，請先進入實際項目目錄。這一點比聽起來更重要：Claude Code 將會話記憶和設置限定在啓動它的目錄中，因此從主文件夾或桌面啓動會導致上下文錯誤。

首次運行將引導你完成認證：使用 Claude 訂閲（Pro、Max 或 Team）的 OAuth 登錄，或使用與控制台賬户綁定的 API 密鑰。除了終端，Claude Code 還通過 VS Code 擴展、JetBrains 插件、桌面應用和基於網頁的版本提供，所有這些都讀取相同的底層設置和項目文件。

三個關鍵文件

Claude Code 從兩個位置讀取配置：項目中的 .claude/ 目錄（以及項目根目錄的 CLAUDE.md）和全局的 ~/.claude/ 目錄。理解它們的區別是決定工具性能的關鍵。

CLAUDE.md 是項目記憶——Claude 在每個倉庫會話開始時讀取的指令：架構筆記、構建和測試命令、代碼風格規則等。使用 /init 命令生成初始文件，然後用 /memory 細化。保持簡潔，Anthropic 建議將其控制在約 2500 個 token 以內，並將長內容放入 .claude/rules/*.md 文件中。

settings.json 位於 .claude/settings.json（項目級別）或 ~/.claude/settings.json（個人默認設置），負責權限、鈎子、環境變量和模型默認值。這是大多數初學者從未打開的文件，直接導致兩個常見問題：持續的權限中斷和 Claude 使用比任務所需更昂貴的模型。

自動記憶是較新的靜默層：Claude 可以在會話中讀寫自己的工作筆記，無需直接管理文件。通過 autoMemoryEnabled 設置或 CLAUDE_CODE_DISABLE_AUTO_MEMORY 環境變量切換。

實用規則：穩定的規則應放在 CLAUDE.md 中，因為僅存儲在對話歷史中的指令會在長會話觸發自動壓縮時丟失。如果一個規則需要在本次會話之外繼續存在，請將其寫下來。

權限與鈎子設置

Claude Code 運行在三種權限模式之一：默認（每次有風險的工具調用前詢問）、自動接受編輯（允許文件編輯而不提示，但仍限制其他工具）和計劃模式（只讀，直到你批准計劃）。對於不熟悉的代碼庫，建議默認使用計劃模式。

settings.json 允許編寫實際的權限規則，避免手動批准相同安全命令。例如，可以允許 npm test:* 等模式，拒絕 rm -rf /* 等危險命令。拒絕規則優先於允許規則。

鈎子超越權限規則：規則只能允許或阻止調用，而鈎子可以響應調用執行操作。PostToolUse 鈎子可在每次 Claude 編輯文件後自動格式化（如使用 Prettier）。PreToolUse 鈎子可在命令執行前阻止危險命令，提供更強保障。例如，可以使用 Python 腳本檢查命令是否包含遞歸刪除、sudo rm、chmod 777 或強制推送到主分支等模式，並阻止它們。

值得首先學習的命令

Claude Code 目前有超過 60 個內置命令，但初學者無需全部記憶。優先掌握 /compact（總結對話歷史以釋放上下文）、/plan（切換計劃模式）和 /diff（查看所有更改的交互式差異），這三個命令能解決大多數早期挫折。其他命令如 /init、/memory、/clear、/context、/model、/effort 等可在需要時學習。

創建自己的 /truth 命令

雖然 /truth 不是官方命令，但你可以通過自定義技能實現類似功能：讓 Claude 在信任其聲明之前對照實際代碼庫進行驗證。創建 .claude/skills/truth/SKILL.md 文件，定義描述和允許的工具（如 Read、Grep、Glob、Bash）。然後使用該技能來檢查 Claude 最近的聲明是否準確。

通過本指南的設置，你將能夠充分利用 Claude Code 進行高效、可靠的智能編程。