所有入門單元免費開放 · 課程內容持續更新中

第一次對話:讓 Claude 讀懂你的專案

建立一個練習資料夾,在裡面啟動 Claude Code,請它建立檔案、解釋資料夾內容,再用 /init 產生 CLAUDE.md,讓 Claude 每次開工都記得你的專案和習慣。

第 5.3 堂約 14 分鐘

先準備一個「工作的地方」

上一堂你已經裝好 Claude Code,也登入了。這一堂要正式和它對話。

在那之前,有一個觀念很重要:Claude Code 會在你啟動它的那個資料夾裡工作。 它看得到這個資料夾(和裡面的子資料夾)的檔案,改檔案也是改這裡的。所以每次使用前,先「走進」你要它工作的資料夾,再叫它出來。

我們先做一個專門練習用的空資料夾。打開終端機,一行一行輸入(每行按一次 Enter):

mkdir my-first-claude
cd my-first-claude
claude

這三行在做的事:

  • mkdir my-first-claude:建立一個叫 my-first-claude 的資料夾(mkdir 是 make directory 的縮寫)。
  • cd my-first-claude:走進這個資料夾(cd 是 change directory)。
  • claude:在這裡啟動 Claude Code。

這幾行在 Windows PowerShell 和 Mac 終端機都通用。資料夾會建立在你的使用者資料夾裡,之後可以在檔案總管或 Finder 找到它。

第一次進到資料夾會問你的事

第一次在某個資料夾啟動時,Claude Code 會先問你:是否信任這個資料夾裡的檔案? 這是一道安全關卡,因為別人給你的專案裡可能藏著奇怪的設定。

這是你自己剛建立的空資料夾,選「是」就好。以後如果打開來路不明的專案,再停下來想一想。

確認一下:現在是哪種模式

Claude Code 有幾種「權限模式」,決定它做事前要不要先問你(第 5 堂會完整介紹)。新版的 Claude Code 預設可能是 Auto 模式,它會自己判斷安全的動作直接做。

但在學習階段,我們希望每一步都看得到、都由你按同意。請看畫面最下方的提示列:

  • 如果出現 auto、accept edits 或 plan 這類字樣,按 Shift+Tab 切換,直到這些字樣消失。這時候就是 Manual(手動) 模式,任何修改都會先問你。
  • 從 Auto 模式按一次 Shift+Tab,就會回到 Manual。

Claude Code 對話畫面示意,標出五個區域:最上方狀態列顯示版本、模型和目前資料夾;你輸入的請求;Claude 跳出的權限詢問,有是、是並且這次不再問、否並告訴 Claude 怎麼改三個選項;輸入框;最下方的提示列會顯示目前模式

第 3 區的權限詢問,是你和 Claude 之間最重要的對話。

第一句話:先問它能做什麼

在輸入框打字,就像在聊天一樣。直接用中文:

第一句話

你好!我是程式新手,這是我第一次用 Claude Code。這個資料夾目前是空的。請用白話告訴我:你在這個資料夾裡可以幫我做哪些事?

它會回你一段說明。這一步它只是回答,不會動到任何檔案。

請它建立檔案,練習「按同意」

接著請它真的動手:

請 Claude 建立檔案

請幫我在這個資料夾建立兩個檔案:

  1. README.md:介紹這是「我的 AI 學習筆記」,說明我正在學 Claude Code。
  2. notes 資料夾裡的「第一天.md」:用條列寫下今天學到的三件事:安裝 Claude Code、打開終端機、第一次和 Claude 對話。

這次 Claude 會停下來,跳出權限詢問,讓你看它打算建立的檔案內容。選項大致有三種:

選項 意思 什麼時候選
是 這一次同意 看過內容,覺得沒問題
是,而且這類動作這次不再問 這次對話裡,同類的動作都直接做 你很確定接下來的動作都是安全的
否,並告訴 Claude 怎麼做 不要做,你可以打字說要怎麼改 內容不對,或你看不懂它要幹嘛

用方向鍵選、按 Enter 確認。現在先選第一個「是」,一個一個看過去。

做完後,打開檔案總管(Mac 是 Finder),到使用者資料夾裡的 my-first-claude,你會看到 Claude 剛建立的檔案。這就是它和聊天 AI 最大的不同:檔案真的出現在你的電腦裡了。

請它解釋這個資料夾

現在資料夾裡有東西了。試試看讓 Claude「讀懂」它:

請 Claude 解釋專案

請看一下這個資料夾,告訴我:

  1. 裡面有哪些檔案和資料夾?
  2. 每個檔案是做什麼的?
  3. 如果我要繼續寫學習筆記,你建議怎麼整理?

你不需要告訴它要看哪個檔案,它會自己打開來讀。讀取這個資料夾裡的檔案,即使在 Manual 模式也不需要你同意,因為讀不會改變任何東西。

之後遇到別人的專案、從網路下載的範例,這招一樣有用:「這個專案在做什麼?我應該從哪個檔案開始看?」

/init:幫專案寫一份交接筆記

這裡有個小問題:每一次新對話,Claude 都是從零開始的。 它不會記得你上次說過「我是新手,請用白話」。

解決方法是 CLAUDE.md。這是一個放在專案資料夾裡的文字檔,Claude Code 每次開始新對話時都會先讀它。你可以把它想成給 Claude 的「交接筆記」。

在輸入框輸入:

/init

開頭是斜線 / 的叫做「指令」(slash command),是給 Claude Code 本身的命令,不是給 Claude 聊天的話。/init 會讓 Claude 看過整個專案,自動寫出一份 CLAUDE.md 草稿。它要建立檔案時,一樣會問你同不同意。

CLAUDE.md 示意:左邊是一份筆記,寫著專案說明、資料夾結構,以及請你這樣做的規矩(用繁體中文、用白話解釋、改檔前先說明);右邊是星期一、星期三、下個月三次不同的對話,每次開始都會先讀這份筆記

CLAUDE.md 就是一份寫給 Claude 看的 README。

加上你自己的規矩

/init 寫出來的是它觀察到的東西。真正有價值的,是它自己看不出來、只有你知道的事,例如你的程度和偏好。請它幫你加上去:

在 CLAUDE.md 加上你的習慣

請在 CLAUDE.md 最後加一段「與我合作的方式」,內容是:

  • 一律用繁體中文回答。
  • 我是程式新手,解釋時請用白話,第一次出現的術語要說明意思。
  • 修改或刪除檔案之前,先用一兩句話說明你要做什麼、為什麼。
  • 執行任何指令之前,先說明那行指令的作用。

之後想再改,可以直接用編輯器打開 CLAUDE.md 修改,或在 Claude Code 裡輸入 /memory,它會列出你的 CLAUDE.md 檔案讓你選擇、打開來編輯。

常用指令速查

在輸入框輸入 /,會跳出所有可用的指令清單,可以用方向鍵挑。新手最常用的是這些:

指令 作用
/help 顯示說明和可用指令
/init 產生或改進這個專案的 CLAUDE.md
/memory 打開、編輯 CLAUDE.md 等記憶檔案
/clear 開始一段全新的對話(換話題時用)
/compact 把目前的對話濃縮成摘要,對話太長時用
/resume 回到之前的某一段對話
/model 切換使用的模型
/usage 查看用量
/exit 離開 Claude Code

還有兩個小技巧:

  • 在訊息裡打 @ 加上檔名(例如 @README.md),可以直接指定要它看哪個檔案。
  • 按鍵盤的「上」方向鍵,可以叫出你之前輸入過的訊息。

下次怎麼回來

離開後,下次想接著做,先 cd 到同一個資料夾,然後:

claude -c

-c 是 continue,會接續這個資料夾裡最近一次的對話。只輸入 claude 則是開一段新對話(但一樣會讀 CLAUDE.md)。

不知道怎麼用某個功能?直接問它

Claude Code 有哪些對新手最有用的指令和快捷鍵?請挑 5 個,用白話說明什麼情況下會用到。

Claude Code 很清楚自己的功能,有問題直接問它,往往比上網查還快。

行動練習
  1. 建立 my-first-claude 資料夾,在裡面啟動 Claude Code,確認目前是 Manual 模式。
  2. 請 Claude 建立 README.md 和 notes/第一天.md,每次權限詢問都先看內容再選「是」。至少練習一次選「否」,請它改內容後再同意。
  3. 執行 /init,再請它把「與我合作的方式」加進 CLAUDE.md。
  4. 輸入 /exit 離開,再用 claude -c 回來,問它:「你還記得我們剛剛做了什麼嗎?」
  5. 最後用 /clear 開一段新對話,問它:「你應該用什麼語氣跟我說話?」看看它是不是照著 CLAUDE.md 回答。

讀完了嗎?

標記完成後,單元與專案的進度會自動更新(只存在這台裝置的瀏覽器)。

卡住了?讓 AI 當你的家教複製這段提問範本,貼到 Claude 或其他 AI 工具,再補上你卡住的地方。

留言與討論

卡關了、有心得,或發現內容需要更新?都歡迎留言。留言使用 GitHub 帳號登入。

留言區即將開放。現在可以先到 GitHub 討論區 發問,或看看 交流頁 的其他管道。