WEEK 01 / YOUR FIRST WORKING TOOL

從開啟電腦，
到你的第一個小工具。

這週只做一件事：讓 Claude Code 幫你寫一個讀取 CSV 的工具，再由你親自核對結果。

零工程經驗17 個小步驟分五天完成建議保留 15 小時

選擇電腦，開始操作 ↓

這週先讓它在自己的電腦跑起來。

先知道這三件事

① 哪裡輸入？

終端機指令依選擇貼到 Mac 終端機或 Windows PowerShell。
Claude 對話貼到啟動後的 Claude Code。
兩種輸入位置，每一步都會標示。

② 什麼算成功？

每步先對照右邊的「預期畫面」，再完成下方驗收。畫面是教學示意，版本號、姓名與提示文字可能不同。

③ 卡住找誰？

同一問題試兩次還失敗，就把步驟、指令與錯誤訊息給導師。公司帳號、安裝、權限問題交給導師或 IT。

開工前：和導師一起確認準備清單

家裡使用 MacBook Neo（macOS 13 或以上）；公司使用 Windows（Windows 10 1809+ 或 Windows 11），由 IT 確認可用工具。
公司提供 Claude Team 帳號，管理員已確認你可以使用 Claude Code。登入時使用公司核准的帳號。
第一天預留導師陪跑時間；安裝等待時間依網路與公司管理政策而異。
第一週使用教學合成資料；暫時不需要 GCP、API 金鑰或付費模型 API。
同時向公司提出 GCP 測試專案與預算申請，供第七週使用；本手冊不操作 GCP。

Mac 使用 ~/Developer/fde-week01，Windows 使用 $HOME\Developer\fde-week01 練習資料夾。已安裝的工具先查版本；需要更新或出現管理員限制時請找 IT。

DAY 1工具準備 · 步驟 01–04

DAY 2專案與登入 · 05–08

DAY 3請 Claude 實作 · 09–10

DAY 4親自查驗 · 11–14

DAY 5保存與交付 · 15–17

先選你現在使用的電腦

同一份作業，兩條操作路線。

換電腦時，要注意什麼？兩台的使用方式＋

安裝與 Python 虛擬環境要在各台電腦各自準備，不搬移 .venv。
第一週先選一台完成整份作業；另一台可先做到環境確認。
本週練習包只有合成資料，兩台使用相同程式與驗收標準。
程式的跨電腦同步在第二週由導師安排公司核准的 Git 流程；不要用個人雲端搬公司資料。
網站進度只保存在各自瀏覽器，切換路線分別記錄，不會跨電腦同步。

FINISH WITH EVIDENCE

把結果帶來，一起驗收。

帶給導師的四樣東西

練習資料夾：程式、README、CLAUDE.md、合成資料與驗收腳本。
正常檔、空檔及不存在檔案的實際輸出。
五項驗收全數通過的輸出，以及最新的 Git commit 紀錄。
五分鐘 demo：從新終端機啟動，再用白話解釋程式的資料流。

導師現場小挑戰

把一份合成 CSV 放到另一個含空白的路徑。你要找出正確路徑、加上引號並執行成功，再指出程式的讀檔、統計與輸出位置。

可以使用 Claude Code。導師確認成果與理解後，再回課程首頁勾選第一週「已驗收通過」。

回第一週課程驗收 ↗

我可以把這段貼給導師交付範本＋

第一週成果
1. 我的專案路徑：~/Developer/fde-week01
2. python3、git、claude 的版本：［填入實際結果］
3. 五項驗收腳本結果：［貼實際輸出］
4. 最新 commit：［貼 git log -1 --oneline］
5. 我能解釋的流程：讀檔 → 讀取欄位 → 統計 → 印出結果
6. 我卡過的問題與處理：［填入］
7. 下一步需要導師協助：［填入，沒有則寫無］

官方參考與畫面說明

安裝方式依官方文件查核於 2026-10-12；操作示意不是擷取自你的電腦。登入、權限提示會隨版本及公司設定改變，以你的實際畫面為準。

Claude Code 官方入門 ↗安裝與環境需求 ↗Python macOS 安裝 ↗Git Windows 安裝 ↗Python Windows 使用 ↗Git macOS 安裝 ↗

從開啟電腦，到你的第一個小工具。