TL;DR：Claude Code 是 Anthropic 打造的終端機 AI 編程助理，能直接讀懂你的整個程式碼庫、編輯檔案、跑指令。安裝只要一行 npm install，登入後就能在專案目錄裡用自然語言叫它改 code、修 bug、做重構。

Claude Code 是什麼？

Claude Code 是什麼？簡單說，它是 Anthropic 推出的命令列（CLI）AI 編程助理。跟一般在瀏覽器裡貼程式碼問 AI 不同，Claude Code 直接跑在你的終端機裡，能存取整個專案的檔案結構、讀寫程式碼、執行 shell 指令，把「問 AI → 複製貼上 → 手動改」的流程壓縮成一句話完成。

它的官方定位是：

Use Claude, Anthropic’s AI assistant, right from your terminal. Claude can understand your codebase, edit files, run terminal commands, and handle entire workflows for you.

核心能力包括：

  • 程式碼庫理解：自動讀取專案結構與檔案內容，不需要你手動複製貼上
  • 檔案讀寫：直接建立、修改、刪除檔案，改完你確認就好
  • 指令執行：在終端機跑 build、test、git 等指令
  • MCP 擴充：透過 Model Context Protocol 連接外部工具（資料庫、API、第三方服務）
  • 多模型切換：支援 Opus、Sonnet、Haiku 等不同模型，用 --model 參數切換

為什麼用？

情境一：接手陌生專案 你剛加入新團隊，面對幾萬行不熟悉的程式碼。在專案根目錄啟動 Claude Code，直接問「這個專案的架構是什麼？入口在哪？」，它會掃描整個目錄結構和關鍵檔案，給你結構化的回答。

情境二：跨檔案重構 要把某個函式改名，牽涉到 20 個檔案的引用。手動找 → 改 → 測試很痛苦。用 Claude Code 一句「把 getUserData 重新命名為 fetchUserProfile，所有引用一起改」，它會定位所有檔案、逐一修改、跑測試確認。

情境三：自動化重複工作 寫 commit message、產生測試案例、建立新的 API endpoint — 這些有固定模式但耗時間的工作，Claude Code 都能用自然語言指揮完成。搭配 --print 模式還能串進 CI/CD pipeline 做自動化。

怎麼用？（步驟教學）

Step 1: 安裝 Claude Code

前置條件：需要 Node.js 18 以上版本。確認方式：

1

node --version

安裝 Claude Code：

1

npm install -g @anthropic-ai/claude-code

安裝完成後驗證：

1

claude --version

你會看到類似 2.1.x (Claude Code) 的版本號。

Step 2: 登入認證

Claude Code 需要有效的訂閱或 API 金鑰。執行：

1

claude auth login

系統會引導你透過瀏覽器登入 Anthropic 帳號。登入後確認狀態：

1

claude auth status

成功會顯示你的帳號資訊和訂閱類型。

Step 3: 在專案中啟動

切換到你的專案目錄，直接輸入：

1
2

cd your-project
claude

這會啟動互動式對話。你可以直接用自然語言跟它溝通：

1

> 這個專案的目錄結構是什麼？主要入口檔在哪？

1

> 幫我在 src/utils/ 建立一個日期格式化函式，支援 ISO 8601 和 Unix timestamp

1

> 跑一次測試，如果有失敗就修好它

如果只想執行單一指令不進入互動模式，用 --print 參數：

1

claude -p "列出這個專案所有的 TODO 註解"

想繼續上一次的對話，用 --continue：

1

claude --continue

或用 --resume 選擇歷史對話繼續：

1

claude --resume

常見錯誤與排查

錯誤 1: 安裝後找不到 claude 指令

原因: npm 全域安裝路徑不在系統 PATH 中。

解法: 執行 npm config get prefix 查看全域安裝路徑，確認該路徑的 bin 子目錄在你的 PATH 環境變數中。以 Linux 為例：

1

export PATH="$(npm config get prefix)/bin:$PATH"

將這行加入 ~/.bashrc 或 ~/.zshrc 以持久化。

錯誤 2: 認證失敗或 API 回傳 401

原因: 登入 token 過期，或使用的方案不包含 Claude Code 存取權限。

解法: 先確認認證狀態：

1

claude auth status

如果顯示未登入或 token 有問題，重新執行 claude auth login。確認你的帳號有 Max、Team 或 Enterprise 訂閱，或已設定有效的 API 金鑰。

錯誤 3: 啟動後回應很慢或 timeout

原因: 網路連線不穩，或專案太大導致初始化耗時。

解法: 用 claude doctor 執行健康檢查，它會診斷常見的連線和設定問題：

1

claude doctor

如果是大型專案，可以透過 .claudeignore 檔案排除不需要掃描的目錄（如 node_modules、dist）。

延伸閱讀

結語

如果你是每天在終端機裡工作的開發者，Claude Code 值得花 10 分鐘裝起來試試。它最大的價值不是取代你寫程式，而是把那些「查文件、跨檔案搜尋、重複性修改」的時間壓縮掉，讓你專注在真正需要思考的設計和邏輯上。

下一步建議：裝好之後，在你最熟悉的專案裡啟動 Claude Code，先從「解釋這段程式碼」開始，感受它對你程式碼庫的理解力。等你確認它讀得懂你的專案，再開始讓它動手改東西。