高效能智慧程式設計：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 進行高效、可靠的智慧程式設計。