環境構築 | Coding Agent Playbook

# 環境構築

---

## STEP 1: repo を用意

- **fork** して clone（**git 2.48+**）
- 設定は repo 同梱 — **clone するだけで揃う**

2.48+ は box 内 worktree（`--relative-paths`）に必須。fork 時は "Copy the `main` branch only" を**外す** — 講義は `stage/*` ブランチを使う

---

## STEP 2: Docker Sandboxes を入れて `sbx login`

- [Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) を install（`sbx` CLI。v0.34.0+ 推奨）
- `sbx login` で Docker アカウント認証

---

## STEP 3: `sbx secret set -g github`

PR 操作用の **fine-grained PAT**（**対象 repo に限定**して発行）をプロンプトに貼る。ON にする権限:

| 権限 | アクセス | 用途 |
|------|---------|------|
| Contents | Read/Write | `git push` |
| Pull requests | Read/Write | `gh pr create` / merge |
| Issues | Read/Write | `gh issue create` |
| Actions | Read | `gh pr checks`（CI） |
| Commit statuses | Read | `gh pr checks`（status） |

Metadata: Read は自動付与。**secret は box 作成時にのみ反映** → 次の box 起動より前に登録。理由・発行手順は `docs/guide/setup.md`

---

## STEP 4: `sbx secret set -g openai --oauth`

- browser で **ChatGPT 認証**（サブスク経路推奨）
- codex の second opinion（`/a2a-review` / `/pr-codex-ci`）が使う

これも box 作成前に。**サブスク経路**なら github / openai の 2 種だけ（API 課金は anthropic も必要 → STEP 6）

---

## STEP 5: `bash scripts/dev.sh`

- dev box が立ち、その中で claude が起動する
- 初回は image を**自動 build**（約 5 分・以降は数秒）。作り直し・更新は `bash scripts/build-image.sh`
- codex reviewer（`cdx-<NAME>` pair）も自動で立つ — 手動セットアップ不要

Windows は `powershell -ExecutionPolicy Bypass -File scripts/dev.ps1`

---

## STEP 6: 箱の中で `/login`（Claude 認証）

- サブスク（Pro/Max）なら **secret 登録は不要** — 最初の box で `/login` するだけ（v0.34.0）
- 以降の box は自動 provision
- API 課金なら `/login` の代わりに API key を `sbx secret set -g anthropic`（host secret なので **STEP 5 の前**に登録 — 後からだと box 再作成が要る）

`setup-token` を登録すると `claude -p` が壊れる（`docs/guide/setup.md`）

---

## 詰まったら: `bash scripts/check-setup.sh`

- 環境 doctor — **前提ツール（git / sbx / Docker）/ secret / image** をまとめて点検
- 各チェックが対処法を出すので、該当 STEP をやり直す

---

## 次のフェーズへ
**[設計 →](03-design.html)**