Claude Code 介紹文檔

什麼是 Claude Code？

一句話說明：Claude Code 是 Anthropic 官方推出的命令列（CLI）AI 編程助手——你在終端機裡用大白話交代事情，它就幫你寫程式、找 Bug、改架構、跑測試。

用生活化的方式理解

想像一下這兩種幫手的差別：

傳統的程式碼補全工具：像手機輸入法的「選字建議」。你打了一半，它猜你下一個字要打什麼，猜完就沒事了，剩下還是你自己打。
Claude Code：像你請了一位資深工程師坐在你旁邊。你說「登入好像壞了，你看一下」，他會自己去翻專案裡的檔案、找出問題、動手改好、順便跑測試確認沒事。
換個比喻：如果 AI 補全是「食譜書」，Claude Code 就是「直接進廚房幫你煮的廚師」。

三個名詞小抄

名詞	白話解釋
終端機（Terminal）	那個黑底白字、要打指令的視窗。就像電腦的「文字版遙控器」
CLI	Command Line Interface，意思就是「用打字下指令來操作的工具」
代碼庫（Codebase）	你這個專案裡所有程式碼檔案的總稱，可以想成「整個資料夾的家當」

核心特色

🖥️ 就在你原本工作的地方

Claude Code 直接跑在終端機裡，不用開瀏覽器、不用裝 IDE 外掛、不用複製貼上程式碼來回搬運。

類比：就像家裡多了一位幫手，他直接站在你的廚房裡幫忙，而不是要你把食材打包寄到別的地方請人處理、再寄回來。

📂 它會先「讀懂你家」再動手

它能讀取並理解整個代碼庫（codebase），包括：

檔案結構與模組關係——哪個檔案負責什麼
既有的程式碼風格與慣例——你習慣怎麼寫，它就跟著怎麼寫
相關的設定檔（如 package.json、.env 等）

類比：一般 AI 像「臨時來代班的人」，只看你手上那一頁；Claude Code 像「先把整間店走一遍」的新同事，知道東西放哪、規矩是什麼，才開始做事。

⚡ 它不只是「出主意」，而是真的動手做

很多 AI 工具只會告訴你「你應該這樣寫」，然後把程式碼丟給你自己貼。Claude Code 可以：

直接修改檔案——自己開檔、自己改、自己存
執行終端指令——例如安裝套件、啟動專案
運行測試並根據結果自動修正——測試紅燈就回頭再修，像自己檢查考卷
進行 Git 操作（建立分支、提交、幫你寫 commit 說明）

類比：差別就像「請人畫一張裝潢設計圖給你」，跟「請人直接把牆刷好」。

🔧 什麼場合都能叫它幫忙

從零開始開發新功能
Bug 修復與除錯（最常用，也最有感）
程式碼重構——把亂七八糟的舊碼整理乾淨
幫你補單元測試（大家最懶得寫的那種）
程式碼審查（Code Review）——當作第二雙眼睛
生成說明文件、README

安裝方式（三步驟）

第一步：安裝（只需要做一次，-g 代表裝在全電腦，之後任何專案都能用）

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

第二步：用終端機切換到你的專案資料夾

cd 你的專案資料夾路徑

第三步：輸入這一個字，開始對話

claude

看到對話提示符號出現，就代表它已經「進門」並開始認識你的專案了，接下來直接用中文講話就好。

基本使用範例

重點觀念：你不需要學任何指令語法，只要像交代同事一樣把話講清楚。

1. 當專案的導覽員：問它東西在哪

claude "這個專案的資料庫連線邏輯在哪裡？"

適合剛接手別人的專案時使用，等於請一位熟門熟路的同事帶你逛一圈。

2. 當偵探：請它抓 Bug

claude "登入功能出現 500 錯誤，請幫我找出原因並修復"

你只要說「哪裡壞了、症狀是什麼」，就像跟醫生描述哪裡痛，剩下的診斷交給它。

3. 當工人：請它蓋新東西

claude "幫我新增一個使用者密碼重設的 API 端點"

4. 當品管：請它跑測試並自己修好

claude "執行所有測試，並修正失敗的部分"

工作流程示意

它做事的節奏，其實跟一位靠得住的師傅接工作一樣：先看現場 → 講做法 → 動工 → 驗收 → 修到好。

步驟	名稱	說明	生活類比
1️⃣	理解需求	讀取專案上下文，分析你的指令	師傅先到現場勘查、聽你要什麼
2️⃣	規劃方案	提出修改計畫，或反問你把需求問清楚	先報一份施工計畫給你確認
3️⃣	執行變更	直接編輯檔案、執行指令	開始動工
4️⃣	驗證結果	跑測試、檢查結果符不符合預期	完工後自己先檢查一遍
5️⃣	回饋與迭代	依結果持續調整，直到任務完成	你說哪裡不對，他回頭修

flowchart TD
    A[你用中文交代需求] --> B[Claude 讀專案、搞懂現況]
    B --> C[提出計畫或反問你]
    C --> D[動手改檔案／執行指令]
    D --> E[跑測試驗收]
    E -->|沒過| D
    E -->|通過| F[任務完成，你檢查並提交]

什麼時候該找它？

✅ 個人專案快速開發——想法很多、時間很少的時候
✅ 大型代碼庫的維護與除錯——面對幾百個檔案不知從何下手時
✅ 學習新框架時的輔助——邊做邊問，等於有個隨叫隨到的家教
✅ 自動化重複性開發任務——那種很無聊但一定要做的事（改命名、補測試、寫文件）
反過來說，如果只是想查一個語法怎麼寫，其實直接問也可以，但那有點像「請搬家公司幫你搬一個杯子」——能做，只是有點浪費它的本事。

注意事項（新手請務必看這段）

總結

Claude Code 把 AI 直接放進開發者最熟悉的終端機裡。憑著深度理解專案脈絡與自主執行能力，它不只是「會回答問題的工具」，而是真的能替你動手做事的夥伴。
一句話收尾：過去你要把問題翻譯成程式碼；現在你只要把問題講清楚。
新手上手三件事，記住就夠了：
一、先開 Git，再開工。
二、把需求講具體，像交代新同事一樣。
三、它做完，你看一眼再收下。

Claude Code 介紹文檔

什麼是 Claude Code？

用生活化的方式理解

想像一下這兩種幫手的差別：

傳統的程式碼補全工具：像手機輸入法的「選字建議」。你打了一半，它猜你下一個字要打什麼，猜完就沒事了，剩下還是你自己打。
Claude Code：像你請了一位資深工程師坐在你旁邊。你說「登入好像壞了，你看一下」，他會自己去翻專案裡的檔案、找出問題、動手改好、順便跑測試確認沒事。
換個比喻：如果 AI 補全是「食譜書」，Claude Code 就是「直接進廚房幫你煮的廚師」。

三個名詞小抄

名詞	白話解釋
終端機（Terminal）	那個黑底白字、要打指令的視窗。就像電腦的「文字版遙控器」
CLI	Command Line Interface，意思就是「用打字下指令來操作的工具」
代碼庫（Codebase）	你這個專案裡所有程式碼檔案的總稱，可以想成「整個資料夾的家當」

核心特色

🖥️ 就在你原本工作的地方

Claude Code 直接跑在終端機裡，不用開瀏覽器、不用裝 IDE 外掛、不用複製貼上程式碼來回搬運。

類比：就像家裡多了一位幫手，他直接站在你的廚房裡幫忙，而不是要你把食材打包寄到別的地方請人處理、再寄回來。

📂 它會先「讀懂你家」再動手

它能讀取並理解整個代碼庫（codebase），包括：

檔案結構與模組關係——哪個檔案負責什麼
既有的程式碼風格與慣例——你習慣怎麼寫，它就跟著怎麼寫
相關的設定檔（如 package.json、.env 等）

類比：一般 AI 像「臨時來代班的人」，只看你手上那一頁；Claude Code 像「先把整間店走一遍」的新同事，知道東西放哪、規矩是什麼，才開始做事。

⚡ 它不只是「出主意」，而是真的動手做

很多 AI 工具只會告訴你「你應該這樣寫」，然後把程式碼丟給你自己貼。Claude Code 可以：

直接修改檔案——自己開檔、自己改、自己存
執行終端指令——例如安裝套件、啟動專案
運行測試並根據結果自動修正——測試紅燈就回頭再修，像自己檢查考卷
進行 Git 操作（建立分支、提交、幫你寫 commit 說明）

類比：差別就像「請人畫一張裝潢設計圖給你」，跟「請人直接把牆刷好」。

🔧 什麼場合都能叫它幫忙

從零開始開發新功能
Bug 修復與除錯（最常用，也最有感）
程式碼重構——把亂七八糟的舊碼整理乾淨
幫你補單元測試（大家最懶得寫的那種）
程式碼審查（Code Review）——當作第二雙眼睛
生成說明文件、README

安裝方式（三步驟）

第一步：安裝（只需要做一次，-g 代表裝在全電腦，之後任何專案都能用）

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

第二步：用終端機切換到你的專案資料夾

cd 你的專案資料夾路徑

第三步：輸入這一個字，開始對話

claude

看到對話提示符號出現，就代表它已經「進門」並開始認識你的專案了，接下來直接用中文講話就好。

基本使用範例

重點觀念：你不需要學任何指令語法，只要像交代同事一樣把話講清楚。

1. 當專案的導覽員：問它東西在哪

claude "這個專案的資料庫連線邏輯在哪裡？"

適合剛接手別人的專案時使用，等於請一位熟門熟路的同事帶你逛一圈。

2. 當偵探：請它抓 Bug

claude "登入功能出現 500 錯誤，請幫我找出原因並修復"

你只要說「哪裡壞了、症狀是什麼」，就像跟醫生描述哪裡痛，剩下的診斷交給它。

3. 當工人：請它蓋新東西

claude "幫我新增一個使用者密碼重設的 API 端點"

4. 當品管：請它跑測試並自己修好

claude "執行所有測試，並修正失敗的部分"

工作流程示意

它做事的節奏，其實跟一位靠得住的師傅接工作一樣：先看現場 → 講做法 → 動工 → 驗收 → 修到好。

步驟	名稱	說明	生活類比
1️⃣	理解需求	讀取專案上下文，分析你的指令	師傅先到現場勘查、聽你要什麼
2️⃣	規劃方案	提出修改計畫，或反問你把需求問清楚	先報一份施工計畫給你確認
3️⃣	執行變更	直接編輯檔案、執行指令	開始動工
4️⃣	驗證結果	跑測試、檢查結果符不符合預期	完工後自己先檢查一遍
5️⃣	回饋與迭代	依結果持續調整，直到任務完成	你說哪裡不對，他回頭修

flowchart TD
    A[你用中文交代需求] --> B[Claude 讀專案、搞懂現況]
    B --> C[提出計畫或反問你]
    C --> D[動手改檔案／執行指令]
    D --> E[跑測試驗收]
    E -->|沒過| D
    E -->|通過| F[任務完成，你檢查並提交]

什麼時候該找它？

✅ 個人專案快速開發——想法很多、時間很少的時候
✅ 大型代碼庫的維護與除錯——面對幾百個檔案不知從何下手時
✅ 學習新框架時的輔助——邊做邊問，等於有個隨叫隨到的家教
✅ 自動化重複性開發任務——那種很無聊但一定要做的事（改命名、補測試、寫文件）
反過來說，如果只是想查一個語法怎麼寫，其實直接問也可以，但那有點像「請搬家公司幫你搬一個杯子」——能做，只是有點浪費它的本事。