生活分享

Claude Code 入門:認識工具與第一條學習路線

認識讀檔、修改與執行工作的方式,選擇學習起點。Claude Code 可以在指定專案裡讀檔案、修改程式、執行工具並檢查結果。你交代「讓待辦清單可以篩選未完成項目」,它會需要先找出畫面、資料與事件處理的位置,再提出或實作變更。學會使用它的第一步,是把一個模糊願望縮成看得見、能檢查的小任務,而不是先背完所有指令。

閱讀時間約 4 分鐘

Claude Code 入門:認識工具與第一條學習路線:文件、螢幕與完成記號的幾何插圖
圖片:Mokaair (© Mokaair)
本篇目錄
  1. 認識工作循環
  2. 選擇第一個入口
  3. 交出一個小任務
  4. 看懂成果與證據
  5. 遇到落差時怎麼修正
  6. 小練習與下一步

Claude Code 可以在指定專案裡讀檔案、修改程式、執行工具並檢查結果。你交代「讓待辦清單可以篩選未完成項目」,它會需要先找出畫面、資料與事件處理的位置,再提出或實作變更。學會使用它的第一步,是把一個模糊願望縮成看得見、能檢查的小任務,而不是先背完所有指令。

這篇是整套教學的入口。你不必已經會寫程式,但要願意確認目前開啟的是哪個資料夾、閱讀它準備做的操作,以及親自看一次完成的結果。閱讀後先選擇桌面或 CLI 路線;手機使用者則先弄清楚工作會在雲端還是電腦上執行,再跟著對應小教學設定。

認識工作循環

認識工作循環 → 選擇第一個入口 → 交出一個小任務
認識工作循環 → 選擇第一個入口 → 交出一個小任務 · 圖片:Mokaair (© Mokaair)
閱讀完整文字說明

Claude Code 入門:認識工具與第一條學習路線,以流程和文件圖形呈現教學重點。

把 Claude Code 想成能使用工具的專案協作者,比把它想成會回答問題的搜尋框更容易理解。一次工作通常包含蒐集上下文、採取行動與驗證結果。這幾個階段可能往返多次:測試失敗後,它還需要讀取錯誤、調整程式並重跑。畫面上持續出現活動訊息,只代表工作正在進行;驗證證據才說明結果是否符合你的要求。

例如「新增待辦」失敗時,單純回覆一段解釋不會修好你的網站。Claude 必須找到表單的送出事件,確認資料怎麼進入清單,改動正確檔案,再實際新增一筆。相反地,如果你只要求理解專案,它可能只讀取檔案並整理架構。指示裡的動詞會影響工作範圍,因此「先分析」與「請修改」要寫清楚。

選擇第一個入口

桌面版適合想用圖形介面選資料夾、看差異與管理工作的人。CLI 適合願意使用終端機、需要管線或腳本的讀者。網頁與手機也能建立或接續支援的任務,但裝置上看得到對話,不等於那部裝置直接保存或執行整個專案。挑入口時,先問自己檔案目前放在哪裡,以及希望工作在哪裡執行。

你的第一個目標建議起點先確認什麼
用視窗修改電腦裡的網站桌面版專案資料夾與帳號資格
在終端機工作CLI作業系統、目前路徑與登入
對 GitHub 專案開雲端任務網頁版儲存庫存取權與環境
外出時查看電腦工作Remote Control本機工作階段持續運作

還拿不定主意,可以先讀。已經想使用桌面版,直接前往;不需要為了跟完整套課程,同時把所有平台裝一遍。

交出一個小任務

第一個練習選你看得懂結果的修改,例如改一個按鈕文字、解釋三個檔案的關係,或確認測試如何啟動。先用的複本,避免把私人工作資料當成入門教材。開啟資料夾後,檢查畫面中的專案名稱或終端機路徑,再送出下面的提示詞。

Claude Code 對話框 · text
請先閱讀這個待辦清單專案,不修改任何檔案。
用繁體中文說明:
1. 網頁從哪個檔案開始。
2. 新增、勾選與刪除分別由哪裡處理。
3. 我該怎麼執行目前的測試。
最後建議一個適合新手、可以在瀏覽器驗證的小改動。

讀完回覆後,不必逐行理解程式。先對照它提到的檔名是否真的存在,測試指令是否與 README 相符,以及建議改動是否落在你能辨認的範圍。如果它說專案有登入系統,練習檔案卻沒有,先要求指出依據,釐清理解錯誤後才繼續修改。

看懂成果與證據

進入實作後,讓 Claude 列出改過的檔案、執行過的檢查及尚未驗證的地方。對介面功能,程式測試通過仍需要打開瀏覽器操作一次。對說明文件,則要確認指令能複製、連結能打開、文字描述與實際檔案一致。驗證方式要跟任務的成果相配,不必對一行標題修改要求與大型改版相同的檢查。

  1. 記下修改前的行為,例如按鈕原本顯示「新增」。
  2. 要求只把這個按鈕改成「加入待辦」,保留原有操作。
  3. 查看差異,確認修改量符合這個小目標。
  4. 重新載入網頁,新增、勾選與刪除各試一次。
  5. 記錄實際結果與尚未確認的環境,再決定是否保留修改。

遇到落差時怎麼修正

如果 Claude 一開始讀了錯誤資料夾,停止目前的修改,重新選擇專案,並說明剛才的路徑錯誤。若它擴大需求,例如順便增加登入、換框架或重做全部樣式,把任務改寫成「只調整指定按鈕,其他需求另外列出」。若結果沒有生效,先確認瀏覽器是否連到這一份專案的伺服器,而不是另一個仍開著的網站。

新手常把「回答看起來專業」當成「專案已經修好」。更可靠的方法是每次問相同的三件事:改了什麼、怎麼確認、還缺什麼。這也能幫你把求助內容寫得具體;貼上錯誤訊息時,附上剛才執行的步驟與預期結果,通常比只說「不能用」更容易往下處理。

第一次練習不需要把所有功能都開啟。先完成讀取檔案、說明修改、檢查結果三個動作,保存一份能重跑的紀錄,再依你常用的裝置選下一篇。遇到不熟悉的名詞,使用總目錄搜尋即可回到對應說明。

小練習與下一步

請完成一次只讀的專案介紹,再做一次按鈕文字修改。完成判準是你能指出專案入口、自行執行測試,並在瀏覽器確認修改前後的差異。把需求、回覆中最有用的資訊和驗證結果寫成短筆記,下一次就能沿用同一個工作節奏。想讓交代任務更穩定,再讀,接著選一條路線繼續。

回總目錄

  • 生活分享

    Claude Code|建立第一個 mod:在 Claude Code 行程內數工具呼叫

    寫一個三檔案的 mod,用驗證器與測試確認它掛上的事件。文件把 mod 定義成多了入口檔的 plugin:入口檔叫 hooks module,Claude Code 在事件發生時呼叫裡面的函式,函式可以觀察、改寫或接手事件。

  • 生活分享

    Claude Code|Git Worktree 平行工作

    隔離多個任務的檔案與分支。Git Worktree 讓同一儲存庫擁有多個工作目錄,各自使用分支與檔案。本篇會把待辦篩選與文件整理分開,確認兩個 session 不會直接改到彼此的檔案,再把其中一個成果整合回主分支。你也會知道何時可以安全清理工作目錄。

  • 生活分享

    Claude Code|雙 Worktree 實作與衝突整合

    隔離兩項功能,最後完成整合與回歸。兩個 Claude 工作階段同時編輯專案,最容易出現的問題是互相改到同一份檔案,或各自測試通過、整合後卻失敗。本篇用兩個 Worktree 分別處理篩選預設值與介面文字,故意製造一次小衝突,再完成整合、驗證與清理。你不需要先啟用 Agent Teams。

  • 生活分享

    Claude Code|比較流程品質、用量與執行時間

    以同一資料集比較兩種工作方法。比較兩種 Claude 工作方法時,不能只挑成功那一次,也不能只看第一個答案有多快。本篇用固定案例、原始紀錄和一致判準,比較品質、重試、等待與人工整合時間,最後寫出有樣本數與限制的報告,而不是保證某個方法一定省錢。

最新旅遊情報攻略

資料來源

生活分享