diff --git a/.gitea/workflows/cd.yaml b/.gitea/workflows/cd.yaml
index 08345c77..64c42946 100644
--- a/.gitea/workflows/cd.yaml
+++ b/.gitea/workflows/cd.yaml
@@ -78,7 +78,8 @@ jobs:
 
           if [ ! -d "$VENV" ] || [ "$(cat $HASH_FILE 2>/dev/null)" != "$CURRENT_HASH" ]; then
             echo "📦 deps 已變更，重建 venv..."
-            python3 -m venv $VENV
+            # 2026-04-05 Claude Code: 確保 python3-venv 已安裝（runner image 可能未內建）
+            python3 -m venv $VENV 2>/dev/null || (apt-get install -y -q python3-venv && python3 -m venv $VENV)
             source $VENV/bin/activate
             pip install -q uv
             cd apps/api && uv pip install -q -e ".[dev]" && cd -