Claude Code 使用者常見問題

問題

答案

1.1 我如何安裝它？

macOS/Linux： curl -fsSL https://claude.ai/install.sh | bash
​Windows PowerShell： irm https://claude.ai/install.ps1 | iex
​Homebrew： brew install --cask claude-code
​WinGet： winget install Anthropic.ClaudeCode
然後從任何儲存庫執行 claude。

參考資料：快速入門

1.2 已安裝，但出現「claude: command not found」

原生安裝程式將二進位檔案放在 ~/.local/bin/claude（Windows：%USERPROFILE%\.local\bin）。將該目錄新增到您的 PATH，例如在 ~/.zshrc 或 ~/.bashrc 中執行 export PATH="$PATH:$HOME/.local/bin"，然後重新啟動您的終端機。

參考資料：疑難排解：PATH

1.3 登入在錯誤的機器上開啟瀏覽器 / 我在 SSH 上

在登入提示處按 c 複製驗證 URL。在本機瀏覽器中開啟它，然後將代碼貼回終端機。

參考資料：疑難排解：驗證

1.4 登入後立即出現驗證錯誤，但我有存取權限

400「組織已停用」：多餘的 ANTHROPIC_API_KEY 環境變數正在覆蓋您的登入。取消設定它、從您的 shell 設定檔中移除、重新啟動。執行 /status 確認哪個驗證處於作用中。
​403 禁止存取：您的管理員尚未為您的工作區啟用 Claude Code，或公司代理正在干擾。

參考資料：疑難排解：驗證

1.5 Claude Code 包含在我的方案中嗎？

是的。它包含在 Team 和 Enterprise 座位以及 Console（API）存取中。使用您的工作帳戶登入；SSO 會自動處理。登入後的 403 通常表示您的管理員仍需要為工作區啟用它。

參考資料：驗證

1.6 Claude Code 與桌面應用程式與 claude.ai 的比較？

Claude Code：終端機代理，讀取您的儲存庫、編輯檔案、執行命令。
​桌面 / claude.ai：用於對話和一次性問題的聊天介面。
底層相同的模型系列，不同的工具形式。

參考資料：概述

1.7 它在我的 IDE 中運作嗎？

是的。VS Code 和 JetBrains IDE（IntelliJ、PyCharm 等）提供擴充功能。相同的功能，嵌入在編輯器中而不是單獨的終端機。

參考資料：VS Code · JetBrains

1.8 這與 Copilot/Cursor 自動完成有何不同？

自動完成建議接下來的幾行。Claude Code 是一個代理：給它一個任務（「修復失敗的測試」），它會讀取檔案、執行命令並進行多檔案編輯直到完成。較少「完成我的句子」，更多「這是一個問題，去處理它」。

參考資料：概述

1.9 我應該先嘗試什麼？

將其指向您一直在推遲的繁瑣但不困難的錯誤。範例：「[檔案] 中的測試不穩定，找出原因。」讓它讀取程式碼，而不是您解釋程式碼。

參考資料：常見用例

1.10 我如何更新它？

原生安裝在背景中自動更新。若要立即強制更新，請執行 claude update。
Homebrew/WinGet 不會自動更新：定期執行 brew upgrade claude-code 或 winget upgrade Anthropic.ClaudeCode。

參考資料：設定：更新

問題

答案

2.1 它一直要求相同命令的權限

核准預設情況下持續到目前工作階段。若要使其持續：
• 在提示處選擇「始終允許」
• 將模式新增到 .claude/settings.json 中的 permissions.allow
• 或執行 /permissions 以互動方式管理

參考資料：權限

2.2 權限模式及如何切換

按 Shift+Tab 循環模式：
• 預設 · 在進行風險編輯或命令前詢問
• 接受編輯 · 檔案編輯通過；仍在執行命令前詢問
• 計畫 · 唯讀；提出計畫並等待核准
• 自動（如果由您的組織啟用）· 使用背景安全檢查自動核准

參考資料：權限模式

2.3 什麼是 /init 以及何時執行它？

在您將使用超過一次的任何儲存庫中早期執行一次。它掃描專案並使用建置命令、架構和慣例寫入 CLAUDE.md。每個未來的工作階段都會自動載入它，因此 Claude 開始時具有上下文。

參考資料：記憶體和 CLAUDE.md

2.4 CLAUDE.md 中應該包含什麼？

工具無法強制執行的事項，新隊友在第一天會出錯的內容：「從 release 部署，而不是 main」、「所有 ID 都是字串」、「永遠不要直接從路由處理程式呼叫資料庫」。保持在兩個螢幕以內；更長的內容會被略過。

參考資料：記憶體和 CLAUDE.md

2.5 Claude 沒有遵循我的 CLAUDE.md

• 太長或太模糊：精簡到真正重要的規則
• 埋在文章中：將硬性規則放在頂部，使用祈使語氣（「永遠不要 X。始終 Y。」）

參考資料：最佳實踐

2.6 指向特定檔案而不貼上它

輸入 @ 然後輸入路徑（支援 Tab 自動完成）。提及的檔案會在 Claude 回應前被讀取。

參考資料：常見工作流程

2.7 將螢幕截圖貼到提示中

將影像拖入終端機，或按 Ctrl+V。在 Mac 上是 Ctrl，不是 Cmd（Cmd+V 貼上文字）。適用於錯誤對話框、UI 模型、白板照片。

參考資料：使用影像

2.8 從終端機複製 Claude 的回應

/copy 將最後的回應放到剪貼簿。/export 將整個對話寫入檔案。

2.9 取回之前的工作階段

claude --continue 繼續最近的一個。claude --resume 開啟清單供選擇。工作階段按專案目錄本地儲存。

參考資料：常見工作流程：繼續

2.10 切換模型

/model 開啟選擇器。如果想在每個工作階段使用相同的模型，可在 .claude/settings.json 中設定預設值。

參考資料：模型配置

2.11 延伸思考

預設開啟；在更難的答案前，你會看到 Claude 的推理過程。使用 /effort 調整深度。對於棘手的除錯或架構決策，額外的延遲是值得的。

參考資料：延伸思考

2.12 在任務中途停止

按 Ctrl+C 取消目前的生成，然後告訴它改做什麼。無需重新開始對話。

問題

答案

3.1 什麼是 MCP？

MCP 將 Claude Code 連接到你的外部工具：GitHub、Linear、Slack、你的資料庫、你的可觀測性堆疊。一個 .mcp.json 配置，Claude 就能讀取你的問題、查詢你的資料，並使用與你相同的工具。常見的第一個連接器：你的問題追蹤器。

參考資料：MCP

3.2 連接你的第一個 MCP 伺服器

• 在專案根目錄新增 .mcp.json，或使用 claude mcp add
• 每個條目命名一個伺服器套件加上任何環境變數（通常是驗證令牌）
• 重新啟動 Claude Code 並執行 /mcp 以確認已連接

參考資料：MCP 設定

3.3 掛鉤有什麼用？

在事件發生時觸發的 Shell 指令碼（工具執行前、檔案編輯後、Claude 等待你時）。常見的第一個掛鉤：**通知**掛鉤，在 Claude 需要輸入時 ping 你的桌面。相同的機制可以在每次編輯後執行 linter、發佈到 Slack，或阻止編輯受保護的路徑。

參考資料：掛鉤指南

3.4 製作可重複使用的提示 / 斜線命令

在 .claude/commands/ 中放置 markdown 檔案。檔案名稱變成命令：.claude/commands/ship.md 變成 /ship。純英文，無特殊語法。最簡單的方式：要求 Claude 為你寫。

參考資料：斜線命令

3.5 技能與斜線命令

相同的機制；命令已合併到技能中。.claude/commands/foo.md 和 .claude/skills/foo/SKILL.md 都會建立 /foo。技能形式為你提供一個資料夾來存放支援檔案（參考文件、範本、輔助指令碼）。

參考資料：技能

3.6 子代理有什麼用？

平行工作：搜尋程式碼庫的不同部分、從不同維度審查差異，或同時生成競爭實現。主工作階段彙總結果。

參考資料：子代理

3.7 無頭執行（CI / 指令碼）

claude -p "your prompt" 執行一次並列印結果。適合 CI 掛鉤、提交前檢查，或管道到其他工具。透過已登入的工作階段或 ANTHROPIC_API_KEY 進行驗證。

參考資料：Unix 風格用法

3.8 撤銷它所做的

/rewind 回滾到較早的檢查點。檢查點會在您傳送的每個提示時自動建立。對於已提交的任何內容，請使用一般的 git revert。

參考資料：檢查點

3.9 與團隊分享您的設定

將 .claude/ 簽入儲存庫（CLAUDE.md、命令、MCP 設定）。任何複製儲存庫的人都會自動獲得相同的設定。技能也可以打包為 外掛程式，團隊可以透過 /plugin 安裝。

參考資料：外掛程式

問題

答案

4.1 找不到檔案 / 搜尋沒有結果

Claude Code 在幕後使用 ripgrep。如果缺少它，搜尋會降級。安裝它（brew install ripgrep 或 apt install ripgrep）並設定 USE_BUILTIN_RIPGREP=0 以使用系統副本。

參考資料：疑難排解：搜尋

4.2 透過 SSH 或在 tmux 中複製/貼上和捲動損壞

終端機 UI 會擷取滑鼠事件。選取時按住 Shift 以略過它，或設定 tmux 以傳遞滑鼠事件。/copy 和 /export 完全規避了這個問題。

4.3 WSL 上速度緩慢

透過 /mnt/c/ 讀取 Windows 檔案是已知的效能損失。將儲存庫移到 WSL 檔案系統（~/ 而不是 /mnt/c/...）。速度差異很明顯。

參考資料：疑難排解：WSL

4.4 Mac 上的影像貼上無法運作

使用 Ctrl+V，而不是 Cmd+V。Cmd+V 貼上文字；Ctrl+V 是從剪貼簿取得影像的路徑。

4.5 萬用字元權限規則不符合

逐步建立規則：先以互動方式核准命令，檢查寫入設定的內容，然後進行概括。

參考資料：權限模式

4.6 無頭 -p 模式的行為不同

• 需要 OAuth 的 MCP 伺服器無法在無頭模式中提示
• 互動式核准不會延續
對於無頭/CI，偏好 API 金鑰驗證和使用環境變數權杖設定的 MCP 伺服器。

4.7 在任務中途用完上下文

/compact 總結較早的對話以釋放空間。/clear 在保持 CLAUDE.md 和設定載入的情況下重新開始。對於長期任務，將其分解為步驟，在各階段之間使用 /clear。

參考資料：管理上下文

問題

答案

5.1 Anthropic 會在我的程式碼上進行訓練嗎？

否。根據您組織的團隊/企業條款，您的程式碼和對話不會用於訓練模型。

參考資料：資料使用

5.2 我的程式碼實際上去哪裡了？

Claude Code 在您的機器上執行。原始檔案在本地讀取，只有目前任務所需的部分才會傳送到 API 以產生回應。沒有任何內容被索引、作為整個儲存庫上傳或用於訓練。

參考資料：資料使用

5.3 其他人可以看到我的對話嗎？

否。工作階段儲存在您機器上的本地，按專案目錄，不會與隊友共享或在任何儀表板中可見。如果您 想要 分享對話，請使用 /export。

參考資料：資料使用

5.4 我如何將機密和 .env 檔案排除在對話之外？

Claude 只讀取任務所需的檔案；它不會掃描您的整個儲存庫。若要硬性封鎖特定檔案，請在 .claude/settings.json 中新增讀取拒絕規則（例如 "Read(.env*)"）。即使您不小心要求，被拒絕的檔案也無法讀取。

參考資料：權限

5.5 「接受編輯」模式在不詢問我的情況下可以做什麼？

檔案編輯無需提示即可進行。它仍然會在執行 shell 命令、進行網路呼叫或觸及工作目錄外的任何內容之前詢問。為了更嚴格的控制，請保持預設模式。

參考資料：權限

資源

用途

/help

內建命令，列出您工作階段中可用的內容

/bug

從終端機提交問題（/feedback 的別名）

完整文件

此處的所有內容，詳細說明

您的團隊的 #claude-code 頻道

小成就和奇怪的錯誤都應該在那裡

頁面

連結

快速入門

code.claude.com/docs/en/quickstart

疑難排解

code.claude.com/docs/en/troubleshooting

權限

code.claude.com/docs/en/permissions

記憶體和 CLAUDE.md

code.claude.com/docs/en/memory

MCP

code.claude.com/docs/en/mcp

資料使用

code.claude.com/docs/en/data-usage