[AI 分享] Claude Code 零基礎入門：安裝、權限與常用命令
摘要：從安裝、權限模式到專案記憶與常用命令，帶新手安全上手 Claude Code。
內容:
Claude Code 是 Anthropic 官方推出的 AI 程式設計工具，主要透過終端操作。即使沒有程式基礎，也能用自然語言請它查看檔案、修改內容、修正問題、撰寫腳本、處理資料及生成文件。
終端可以簡單理解為一個輸入框，不必因為它看起來像程式設計工具而感到害怕。Claude Code 不只會回答問題，還能圍繞任務查看檔案、拆解步驟、執行命令，並在需要時等待使用者確認。
目前不少人開始改用 Codex，但 Claude Code 仍有其優勢。它的 Agent 架構相對成熟，能妥善處理上下文、權限與工具呼叫；Claude 模型面對複雜任務時，也較擅長先分析、再規劃，最後才執行。強模型搭配工程化完善的 Agent 工具，通常能帶來更穩定的結果。
安裝 Claude Code
Mac、Linux，以及透過 WSL 使用 Windows 的使用者，可以開啟終端，貼上官方提供的安裝命令並執行。若直接使用 Windows 終端，則要先確認目前使用的是 PowerShell 還是 CMD，因為兩者的安裝命令不同。
安裝完成後，在終端輸入：
claude
若能進入 Claude Code 的對話介面，代表安裝成功。也可以輸入：
claude --version
如果終端顯示版本號，同樣表示安裝完成。
若安裝時出現紅色錯誤訊息、找不到命令或其他問題，不必慌張。可以完整複製錯誤內容，交給其他可用的 AI 工具協助判斷。常見問題多半與網路、權限、終端環境或系統路徑尚未更新有關。
如果安裝後顯示找不到 claude，可以先關閉終端再重新開啟，然後再次執行命令。
用自然語言開始操作
安裝完成後，可以先進入任意資料夾，再啟動 Claude Code，直接用日常語言提問，例如：
這個資料夾是做什麼的？
幫我看看裡面有哪些檔案。
這個專案要怎麼啟動？
幫我整理這個專案目錄的內容。
Claude Code 在修改檔案、執行命令或存取外部資源前，通常會詢問是否批准。這並不是發生錯誤，而是它的安全機制，讓使用者知道它準備執行什麼操作。
選擇適合的工作模式
可以按下 Shift + Tab 切換工作模式。新手最常接觸的模式包括：
Default
預設的手動確認模式，設定較保守。Claude Code 可以直接讀取檔案，但修改檔案或執行命令時，通常會先徵求同意。
Accept Edits
適合已經大致信任執行方向的情況。它會自動批准專案目錄內的檔案編輯，以及建立資料夾、複製或移動檔案等常見操作。遇到複雜命令、敏感操作或專案範圍外的路徑，仍可能要求確認。
Plan
計畫模式非常適合新手。Claude Code 會先檢查專案、查閱檔案並提出方案，但不會立即修改內容。使用者看完計畫並確認後，再讓它繼續執行。
另外還有較積極或特殊的模式，例如 Auto 與 Bypass Permissions。Auto 會透過背景安全檢查減少頻繁確認，但不一定適用於所有帳號、模型及環境。
Bypass Permissions 則會大幅減少權限確認，只適合完全隔離的測試環境、容器或虛擬機器。新手不建議在日常電腦或正式專案中使用。
剛開始使用時，只要記住：不熟悉的任務使用 Default，重要或範圍較大的專案先使用 Plan。
新手安全操作四步驟
第一次使用 Claude Code，可以遵循以下流程：
先開啟 Plan 模式，讓它說明準備做什麼。
看懂並確認方案後，再允許它修改。
修改完成後，使用 /diff 查看實際變更。
如果結果不滿意，使用 /revert 或 /undo 回退。
重要檔案最好事先備份，或納入 Git 版本控制。如此一來，即使結果不理想，也能放心還原與反覆嘗試。
使用 CLAUDE.md 建立專案說明
在專案資料夾中輸入：
/init
Claude Code 會掃描專案並生成 CLAUDE.md。這份檔案就像提供給新同事的入職說明，可以記錄：
專案使用的技術與工具。
專案如何安裝及啟動。
應遵守的開發規範。
哪些檔案或區域不能任意修改。
修改後必須執行哪些測試。
文案應採用何種風格。
腳本應放在哪個目錄。
之後每次在該專案中啟動 Claude Code，它都會先讀取這份說明，省去重複交代背景與規則的時間。
不過，CLAUDE.md 比較像專案囑咐，而不是百分之百強制執行的規則。Claude Code 會參考內容，但不保證絕對服從。相較之下，Hook 更接近強制檢查機制。
若想查看或修改專案記憶，可以使用：
/memory
新手必備命令
在 Claude Code 中輸入 /，就能查看目前可用的命令。新手不需要一次記住所有命令，可以依照使用階段逐步學習。
第一階段建議掌握：
/plan：進入計畫模式，大幅修改前先產生方案。
/diff：查看這次修改了哪些檔案與內容。
/revert 或 /undo：回退至先前的檢查點。
/help：查看命令說明及使用方式。
Claude Code 做錯時不必慌張，確認差異後回退即可。
使用一段時間後再學的命令
/context：查看目前對話使用了多少上下文空間。
/compact：壓縮過長的對話歷史，讓任務繼續進行。
/clear：清空目前會話，適合切換至新任務；專案中的 CLAUDE.md 不會因此消失。
/resume：找回並繼續之前的會話。
/rename：替目前會話命名，方便日後尋找。
/btw：詢問不納入主要對話歷史的題外問題。
進入真實專案後可使用的命令
/model：切換模型。簡單任務可選擇更快或成本較低的模型，複雜任務再使用能力較強的模型。
/code-review：檢查此次變更是否存在明顯錯誤。
/doctor：診斷安裝、登入或設定問題。
/mcp：查看及管理 MCP 連線。
/hooks：查看目前設定的 Hook。
/tasks：查看背景任務的執行進度。
新手不必一次記住所有功能。先掌握安全模式、計畫、差異檢查與回退，再逐步加入專案記憶、模型切換、MCP、Hook 與背景任務，就能把 Claude Code 實際運用在日常工作與真實專案中。
沒有留言:
張貼留言