Codex /goal 與自主執行 完全 Best Practice 手冊

# npm 全域安裝
npm i -g @openai/codex

# macOS Homebrew
brew install --cask codex

# 自行更新
codex update

# 首次啟動 → 會要求登入 ChatGPT 帳號或 API Key
codex

# 完全自主 — 不問任何確認
codex --dangerously-bypass-approvals-and-sandbox "重構 auth module 並跑測試"

# 簡寫別名（效果相同）
codex --yolo "重構 auth module 並跑測試"

codex exec --dangerously-bypass-approvals-and-sandbox \
  --cd /workspace \
  -m gpt-5.4 \
  "套用 migration 並 commit"

# 1. 確認版本 ≥ 0.128.0
codex --version

# 2. 確保在乾淨的 feature branch 上
git checkout -b feat/codex-migration
git status  # 確認 working tree 乾淨

# 3. 建立清晰的 AGENTS.md（或 spec 檔）
cat > AGENTS.md << 'EOF'
## 目標
將專案從 Express.js 遷移到 Fastify，保持所有 API 端點向後相容。

## 驗收條件
- 所有現有測試通過
- API 回應格式不變
- 效能基準 ≥ 現有水平

## 約束
- 不修改資料庫 schema
- 不新增外部依賴超過 3 個
EOF

# 4. 啟動 Codex 並設定 goal
codex -a never -s workspace-write
# 進入 TUI 後：
/goal "按照 AGENTS.md 的規格完成 Express → Fastify 遷移"

# 1. 建立 tmux session
tmux new -s codex-agent

# 2. 在 tmux 內啟動 Codex
codex -a never -s workspace-write \
  -m gpt-5.4 \
  --cd /path/to/project

# 3. 設定持久化目標
/goal "完成整個 v2 API 遷移，包含測試、文件更新、changelog"

# 4. 脫離 tmux（Codex 繼續跑）
# 按 Ctrl+B, D

# 5. 隔天回來
tmux attach -t codex-agent

# Dockerfile
FROM ubuntu:24.04
RUN apt-get update && apt-get install -y nodejs npm git bubblewrap
RUN npm i -g @openai/codex
WORKDIR /workspace
COPY . .

# 執行指令
docker run -d \
  -e OPENAI_API_KEY=$OPENAI_API_KEY \
  --name codex-runner \
  my-codex-image \
  codex exec --sandbox danger-full-access \
    -m gpt-5.4 \
    --cd /workspace \
    "按照 spec.md 完成所有 milestone，每個 milestone 完成後 commit"

# 直接在雲端啟動任務，不需本機保持開啟
codex cloud exec --env ENV_ID "完成 bug triage 並產出報告"

# 加 --attempts 做 best-of-N
codex cloud exec --env ENV_ID --attempts 3 "重構 payment module"

~/.codex/config.toml
# ── 預設（日常互動開發）──
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = false

# ── Profile：需要網路但保持 sandbox ──
[profiles.networked]
approval_policy = "never"
sandbox_mode = "workspace-write"

[profiles.networked.sandbox_workspace_write]
network_access = true

# ── Profile：完全自主（僅限容器內）──
[profiles.yolo]
approval_policy = "never"
sandbox_mode = "danger-full-access"

# ── Auto Review（自動審查代替人工確認）──
[auto_review]
policy = """
只允許：workspace 內的檔案修改、git 操作、測試執行。
拒絕：任何涉及 .env 的操作、刪除超過 10 個檔案的批次操作。
"""

# 使用 profile 啟動
codex -p networked "更新所有依賴並跑 migrate"
codex -p yolo "Non-interactive build"

# TUI 內切換權限（不用重啟）
/permissions  # 選擇 Read-only / Auto / Full Access