Day 1 確定了要解決的問題。今天先不寫 Agent，先準備開發環境。

環境如果沒有固定版本，後面很容易遇到問題。今天會安裝 Claude Code、Python、uv、Node.js 和 Git，最後用兩個小測試確認工具都能正常工作。

今天會用到的工具

Claude Code
    ↓
Python 3.11+
    ↓
uv
    ↓
Node.js + npm
    ↓
Git + Git hooks

各工具的用途不同：

• Claude Code：協助閱讀程式碼、撰寫測試和除錯
• Python：後端與 Agent 的主要程式語言
• uv：管理 Python 版本與套件
• Node.js + npm：執行 Next.js 前端
• Git：保存修改紀錄，方便回溯

步驟 1：安裝 Claude Code

Claude Code 會在專案中協助我閱讀檔案、修改程式與執行測試。

可以從 https://claude.com/code 開始，或依照使用的編輯器安裝對應擴充功能。VS Code 和 JetBrains IDE 都有可用的整合方式。

安裝後開啟 Claude Code，確認編輯器中可以看到 Claude 的操作介面。今天先不用測試複雜功能，能正常開啟即可。

步驟 2：安裝 Python 3.11+

Python 是後端和 LangGraph 的主要程式語言。

請從 https://www.python.org/downloads/ 下載 Python 3.11 或更新版本。Windows 安裝時，記得勾選「Add Python to PATH」。

完成後，在新的終端機執行：

python --version
# 預期看到：Python 3.11.x 或更新版本

如果找不到 python，先關閉目前的終端機，再開一個新的視窗。安裝程式更新 PATH 後，舊終端機不一定會立即讀到新的環境變數。

選擇 Python 3.11+ 的原因，是這個專案會使用較新的 type hints 和目前套件支援的 Python 版本。不要在正式開發時混用多個 Python 版本。

步驟 3：安裝 uv

Python 套件可以用 pip 管理，但這個專案使用 uv。它負責建立虛擬環境、安裝依賴與鎖定版本。

先用 pip 安裝：

pip install uv

也可以依照 https://github.com/astral-sh/uv 的說明安裝。

確認版本：

uv --version
# 預期看到：uv 0.x.x

之後在 backend 資料夾會用 uv add 安裝 FastAPI、LangGraph 和其他依賴，套件清單會記錄在 pyproject.toml。

步驟 4：安裝 Node.js

Day 23 會用 Next.js 建立前端，所以先安裝 Node.js 和 npm。

請從 https://nodejs.org/ 下載 LTS 版本。安裝時使用預設選項就好。

確認安裝：

node --version
# 預期看到：v18.x.x、v20.x.x 或更新的 LTS 版本

npm --version
# 預期看到版本號

步驟 5：設定 Git

Git 用來保存每個階段的修改。先從 https://git-scm.com/ 安裝，確認版本：

git --version
# 預期看到：git version 2.x.x

設定提交者資訊：

git config --global user.name "你的名字"
git config --global user.email "你的信箱"

Git hooks 會在 commit 前執行格式檢查或測試。今天先完成 Git 基本設定，Day 3 建立專案結構後再加入 hooks。

步驟 6：建立專案資料夾

以下指令用於 macOS、Linux，以及支援相同指令的終端機環境：

mkdir ~/projects
cd ~/projects
mkdir "2026-learning-coach"
cd "2026-learning-coach"

git init
git status

Windows PowerShell 也可以直接在檔案總管建立資料夾，再用終端機切換到該路徑。

預計的專案結構如下：

2026-learning-coach/
├── .git/
├── backend/
├── frontend/
├── docs/
└── README.md

backend、frontend 會在後面的文章建立。docs 用來放 PRD、架構說明和開發紀錄。

步驟 7：執行第一個 Python 測試

在專案資料夾建立 test.py：

# test.py - 測試 Python 環境

def hello():
    print("Hello from Python 3.11+")
    print("Claude Code 開發環境已就緒！")

if __name__ == "__main__":
    hello()

執行：

cd ~/projects/2026-learning-coach
python test.py

預期輸出：

Hello from Python 3.11+
Claude Code 開發環境已就緒！

接著建立 test.js：

// test.js - 測試 Node.js 環境

console.log("Node.js 環境已就緒");
console.log("前端開發準備完成");

執行：

node test.js

預期輸出：

Node.js 環境已就緒
前端開發準備完成

這兩個測試很簡單，但能先確認 Python 和 Node.js 都能從目前的終端機執行。

常見問題

找不到 Python

執行 python --version 沒有版本號，通常是 Python 沒有加入 PATH。重新安裝時勾選「Add Python to PATH」，或確認終端機是否在安裝後重新開啟。

uv 安裝失敗

先更新 pip：

pip install --upgrade pip
pip install uv

Git commit 出現身份錯誤

重新設定名稱和信箱：

git config --global user.name "你的名字"
git config --global user.email "你的信箱"

Claude Code 找不到 Python

在 VS Code 按 Ctrl+Shift+P，搜尋 Python: Select Interpreter，再選擇 Python 3.11+ 的環境。

新工具在舊終端機找不到

關閉目前所有終端機，重新開啟一個視窗。PATH 的更新通常只會套用到新啟動的終端機。

Day 2 完成檢查

Day 1 ✓ 產品定義
Day 2 ✓ 開發環境
Day 3 ⬜ 專案架構
Day 4 ⬜ 資料庫與實作

今天先確認工具可以使用。明天會把 backend、frontend 和 docs 的結構建立起來，讓後面的功能有固定位置可以放。