終端機指令 依選擇貼到 Mac 終端機或 Windows PowerShell。
Claude 對話 貼到啟動後的 Claude Code。
兩種輸入位置,每一步都會標示。
WEEK 03 / REQUEST, RESPOND, VERIFY讓你的工具,
讓你的工具,
成為可以呼叫的服務。
接著第二週 CSV 檢核器,用 Claude Code 建立本機 API。從兩個窗口、第一次請求,到親自驗證 200、422、415、413,一步一步完成。
零工程經驗17 個小步驟分五天完成建議保留 15 小時
選擇電腦,開始操作 ↓
讀得懂、改得動,用證據說明結果。先知道這三件事① 哪裡輸入? ② 什麼算成功? ③ 卡住找誰?
每步先對照右邊的「預期畫面」,再完成下方驗收。畫面是教學示意,版本號、姓名與提示文字可能不同。
同一問題試兩次還失敗,就把步驟、指令與錯誤訊息給導師。公司帳號、安裝、權限問題交給導師或 IT。
先確認前兩週已完成 第三週起點
- 在同一台電腦,第一週 5/5、第二週含挑戰 8/8、除錯 2/2,程式與文件已保存為 Git 版本。
- 沿用
fde-week01資料夾;不用重新安裝 Python、Git 或 Claude。 - 公司帳號與個人電腦的使用依公司核准方式;資料全為教學合成資料。
- 另一台若沒有第一週成果,請導師安排公司核准的同步;不搬移 .venv,不用私人雲端搬公司資料。
- 本週需 IT 核准在專案 .venv 安裝三個套件;只跑本機 API,不部署 GCP。
DAY 1準備、套件、契約 · 01–04
DAY 2Claude 實作、舊驗收 · 05–07
DAY 3雙窗口、文件、上傳 · 08–11
DAY 4狀態碼、完整驗收 · 12–14
DAY 5根因、回歸、交付 · 15–17
同一份作業,兩條操作路線。
換電腦時,要注意什麼?兩台的使用方式 +
- 安裝與 Python 虛擬環境要在各台電腦各自準備,不搬移 .venv。
- 先在已完成前兩週的那台操作;另一台待核准同步後再重建自己的環境。
- 本週練習包只有合成資料,兩台使用同一套 JSON 規格及驗收標準。
- 導師確認核准的程式庫與允許範圍後再安排同步;本手冊不提供虛構 repo 網址,也不執行 push。
- 網站進度只保存在各自瀏覽器,切換路線分別記錄,不會跨電腦同步。
把結果帶來,一起驗收。
帶給導師的四樣東西
- api_app.py、共用檢核器與雙路線 README。
- 本機 /health、/docs 和四種 HTTP 回應證據。
- 第一週 5/5、第二週 8/8、除錯 2/2、API 13/13 的輸出與最新 commit。
- 五分鐘 demo:新開 A/B 窗口,展示上傳與解釋請求流向。
導師現場小挑戰
導師提供未預告的合成 CSV,先預測 HTTP 與報告,再實際上傳。解釋資料 422 和程式 500 的差異,指出共用驗證函式。
可以使用 Claude Code。導師確認成果與理解後,再回首頁勾選第三週「已驗收通過」。
回第三週課程驗收 ↗我可以把這段貼給導師 交付範本 +
第三週成果 1. 我的專案路徑:~/Developer/fde-week01 2. python3、git、claude 的版本:[填入實際結果] 3. 五項驗收腳本結果:[貼實際輸出] 4. 最新 commit:[貼 git log -1 --oneline] 5. 我能解釋的流程:讀檔 → 讀取欄位 → 統計 → 印出結果 6. 我卡過的問題與處理:[填入] 7. 下一步需要導師協助:[填入,沒有則寫無]
官方參考與畫面說明
所有預期畫面為教學示意;Windows 公司實機與帳號需導師/IT 確認。套件版本為本教學驗證版本,不代表最新版本。
FastAPI 檔案上傳 ↗FastAPI 啟動與互動文件 ↗第二週操作手冊 ↗接著第四週操作手冊 ↗