Claude Code 完整指南

安裝與上手

官方推薦用原生安裝程式，裝好會在背景自動更新。npm 版不再是建議的安裝方式。

1. 安裝

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

也可以用 brew install --cask claude-code 或 winget install Anthropic.ClaudeCode，這兩種不會自動更新，要自己定期 upgrade。Windows 建議先裝 Git for Windows，Claude 才能用 Bash；沒裝的話會改用 PowerShell。裝完開新的終端機，跑 claude --version 看到版本號就是成功。

2. 第一次進專案

cd your-project
claude # 第一次會開瀏覽器請你登入
/init # 分析專案，產生 CLAUDE.md

接著直接用中文問「這個專案在做什麼？」或交代任務。檔案不用自己貼，它會視需要去讀。

3. 先記這些按鍵

4. 終端機指令

5. Session 內的常用指令

權限模式與設定

權限模式決定 Claude 哪些動作可以不問你就做。按 Shift+Tab 切換，狀態列會顯示目前是哪個模式；從 Auto 按第一下回到 Manual，之後依序是 Manual → Accept edits → Plan。

同一個任務，換個模式，要你按同意的次數就不一樣：

全部六種模式

Claude Code v2.1.283 起，新開的終端機與 VS Code session 預設就是 Auto 模式。dontAsk 不在 Shift+Tab 循環裡，要用 --permission-mode dontAsk 啟動。

用 settings.json 寫死規則

常用又安全的指令可以預先允許，危險的直接拒絕。規則寫在 permissions 底下的 allow、ask、deny 三個陣列：

{
 "permissions": {
 "allow": ["Bash(npm run *)", "Bash(git diff *)"],
 "ask": ["Bash(git push *)"],
 "deny": ["Read(./.env)", "Bash(curl *)"]
 }
}

比對順序固定是 deny → ask → allow，先符合的算數；deny 在任何模式都有效，包括 bypassPermissions。Bash(npm run *) 的 * 是萬用字元，舊寫法 Bash(npm run:*) 仍然可以用。舊版的 allowedTools / disallowedTools 設定已經改成上面的 permissions 格式。

記憶與 Context 管理

每個 session 都從空白的 context 開始。能帶到下一個 session 的只有兩種：你寫給它的 CLAUDE.md，和 Claude 自己記下的 auto memory。

記憶檔放在哪

記憶檔一共六層，範圍由大到小疊起來。重點是分清楚哪幾層會跟著 repo 給團隊，哪幾層只留在你的電腦：

這些檔案不會互相覆蓋，而是全部疊起來給 Claude 讀，離你工作目錄越近的越晚讀到。子目錄裡的 CLAUDE.md 要等 Claude 讀到那個目錄的檔案時才載入。專案裡只有 AGENTS.md、沒有 CLAUDE.md 時，Claude 會直接讀 AGENTS.md。

CLAUDE.md 可以用 @path/to/file 引入其他檔案，最多往下四層。/init 產生初稿，/memory 編輯記憶檔、開關 auto memory。

Context 快滿時會發生什麼

Context window 裝著對話、讀過的檔案、指令輸出、CLAUDE.md、載入的 skill。快滿時 Claude Code 會先清掉舊的工具輸出，再把對話摘要；你的需求和關鍵程式碼會留下，但前面交代的細節可能不見。按左邊的動作把 context 填滿，看壓縮後剩下什麼：

一定要記住的規則寫進 CLAUDE.md，不要只講在對話裡；壓縮時要保留的東西，也可以在 CLAUDE.md 加一段「Compact Instructions」。

模型與思考深度

思考深度用 /effort 調，從 low、medium、high、xhigh 到 max；也可以在啟動時加 --effort high。只想讓某一句多想一點，在 prompt 裡寫 ultrathink，只影響那一輪。以前流傳的 think、think hard、think harder 現在都只會被當成一般文字。

擴充：Skills、Subagents、MCP、Hooks

內建工具已經能處理大部分開發工作。擴充用來補三種缺口：Claude 不知道的事、它碰不到的系統、每次都要你提醒的動作。不用一開始全部裝，遇到下面的情況再加。

遇到什麼情況，加什麼

每種擴充的差別，在於它佔不佔主對話的 context、什麼時候被載入。挑一個你遇到的情況：

MCP：接上外部服務

MCP（Model Context Protocol）是讓 Claude 連外部服務的標準介面，連上之後它就多了那個服務的工具可用。遠端服務用 HTTP，本機程式用 stdio：

# 遠端 HTTP server（以 Context7 文件查詢為例）
claude mcp add --transport http context7 https://mcp.context7.com/mcp

# 本機 stdio server：-- 後面是要執行的指令
claude mcp add --env API_KEY=你的金鑰 my-server -- npx -y @example/mcp-server

SSE 傳輸已經 deprecated，新的 server 一律用 --transport http。用 --scope（或 -s）決定設定存在哪：

project scope 會在專案根目錄產生 .mcp.json，也可以直接手寫：

{
 "mcpServers": {
 "context7": {
 "type": "http",
 "url": "https://mcp.context7.com/mcp"
 }
 }
}

claude mcp list # 列出所有 server
claude mcp get context7 # 看單一 server 設定
claude mcp remove context7 # 移除
claude mcp reset-project-choices # 重設 .mcp.json 的核准紀錄
/mcp # session 內看連線狀態