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：找不到命令」

原生安裝程式將二進位檔案放在 ~/.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 延伸思考

預設開啟。推理本身在正常檢視中是隱藏的；按 Ctrl+O 切換到詳細記錄，如果你想閱讀它。使用 /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/skills/ship/SKILL.md，資料夾名稱就變成命令：/ship。純英文，無特殊語法。最簡單的方式：要求 Claude 為你寫。（舊版 .claude/commands/ship.md 路徑仍然有效。）

參考資料：技能

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 的捆綁副本，因此您無需安裝它。捆綁的二進位檔案在 Alpine/musl 系統上可能會失敗；在這種情況下，安裝系統副本 (apk add ripgrep) 並設定 USE_BUILTIN_RIPGREP=0，以便 Claude 改用它。

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

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 模式的行為不同

對於非互動式/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 「acceptEdits」模式在不詢問我的情況下可以做什麼？

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

參考資料：權限

資源

用途

/help

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

/feedback

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

完整文件

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

您團隊的 #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