CODEX COURSE / 18 CLI + 06 API + 32 MONTHLY
信頼できる Codex オペレーティングシステムを作る。
CLI course の後、正直な日付を持つ月刊 archive で API 境界、multimodal、Agents、Realtime、Codex、app UI をつなぎます。
安全に Terminal へ入る
インストール、認証、正しい repository からの起動、そして Codex に作業を任せる前の authority 選択を行います。
- 01Codex を導入し、toolchain を証明するVersion と診断経路が記録された、正常に動く Codex CLI。
- 02Credential を漏らさず認証を選ぶAccount、billing boundary、credential storage が理解された authenticated CLI。
- 03最初の terminal session を engineering task にする意図した repo で bounded task を終え、検証 evidence が残る。
- 04自律性より先に authority を設定するTask impact に合い、full access を既定にしない permission profile。
作業を読みやすく再現可能にする
Live session を制御し、durable guidance を記録し、scope ごとに設定し、変更を review 可能な evidence に変えます。
- 05長い CLI session を制御するPlanning から implementation/review まで読みやすく制御可能な session。
- 06AGENTS.md で repository knowledge を永続化するRepo の build/check 方法を教える concise で verified な AGENTS.md chain。
- 07Model、effort、scope で Codex work を計画するContinuity-first、明示的 model role、supported native effort、非拡張 permission boundary、live-catalog check、安全な fallback を持つ Codex plan。
- 08変更を reviewable evidence にするPrioritized findings と acceptance decision を持つ change-test-diff-review loop。
拡張、統制、自動化
MCP を接続し、skills をパッケージ化し、guardrails を追加してから、独立した作業を subagents と安全な CI へ拡張します。
- 09MCP で外部 system を接続するNarrow tool surface と明示 startup/approval policy を持つ verified MCP。
- 10繰り返す workflow を Skills にする明確な trigger、test、distribution path を持つ narrow skill。
- 11Hooks と Rules で guardrails を置くComplete security と誤称しない reviewed hook と tested command rule。
- 12Subagents から安全な Automation へ拡張するBounded parallel workflow と machine-readable な least-privilege automation。
Codex を observable system として運用する
Headless execution、JSONL、saved-session lifecycle、Cloud tasks、sandbox policy tests、diagnostics、features、completions で CLI curriculum を完成させます。
- 13codex exec で再現可能な headless 作業を行うWorkspace、authority、exit status、artifact、retry が明示された headless Codex job。
- 14JSONL を stream し、最終結果を制約するJSONL を安全に parse し、action 前に一つの typed final result を検証する automation boundary。
- 15Codex session を resume、fork、archive、restore するLineage が明確で cleanup が可逆、誤った永久削除を防ぐ session workflow。
- 16Codex Cloud task を local apply 前に review するAttempt identity、local review、可逆 apply step を保つ remote-task workflow。
- 17Sandbox で command を試し execpolicy を監査するSandbox enforcement と command-policy decision を分離した repeatable permission test。
- 18Codex を診断し features と completions を確認するFailing layer を特定し、対象 feature/shell integration だけを変える診断手順。
OpenAI Platform を直接構築する
既存 API architecture notes は独立 archive として残し、18本の CLI curriculum には含めません。
- A01Responses をシステム境界にするモデルを変更しても製品契約が変わらない request layer。
- A02各 Tool に狭い契約を与えるside effect を review、retry、revoke できる tool layer。
- A03Schema をユーザー体験として設計する明示的 validation gate を通って製品 code に入る typed model output。
- A04Agent Loop の所有者を決めるcontroller と stop conditions が明確な multi-step workflow。
- A05Realtime をライブシステムとして設計する実ネットワーク、音声、中断 pattern で検証された realtime architecture。
- A06モデル選択を境界へ隔離するrewrite ではなく evidence と config で新 model を採用できる deployment。
月刊技術アーカイブ / 32号
32号の回顧型 engineering issue。
API 境界と multimodal system から Agents、Realtime、Codex、ChatGPT app UI までを公式資料でたどる。
- ISSUES
- 32
- RANGE
- 2024—26
- LANG
- 03
RETROSPECTIVE / SOURCE-CHECKED
12 ISSUES
- 2024 / 01 API
API request を製品境界にする
認証、request ID、timeout、error 正規化を server-owned adapter に集約し、UI から platform を直接呼ばない。
- 2024 / 02 PROMPTS
prompt を application code と同様に version 管理する
永続的な developer instruction と user input を分け、output contract を明示し、prompt change を review 可能にする。
- 2024 / 03 MODELS
流行の model 名ではなく capability で route する
workload を modality、tool support、latency、quality、budget で記述し、configuration で deployable model に解決する。
- 2024 / 04 DATA
schema を output contract にする
Structured Outputs は parsing ambiguity を減らすが、refusal、incomplete result、domain-invalid value は製品側で扱う。
- 2024 / 05 TOOLS
各 function tool に狭い contract を与える
tool definition は callable intent を表すだけで、validation、execution、idempotency、result は認証済み server code が所有する。
- 2024 / 06 UX
streaming を state machine として設計する
有用な stream は start、typed delta、tool activity、completion、cancellation、failure を区別し、単なる文字追記にしない。
- 2024 / 07 VISION
image understanding を evidence extraction として扱う
image から推論してよい範囲を定義し、original asset reference を保持し、observation と decision を分ける。
- 2024 / 08 MEDIA
image generation を asset pipeline の背後に置く
prompt intent、generation request、moderation state、asset storage、metadata、editorial acceptance を観測可能な段階に分ける。
- 2024 / 09 AUDIO
timestamp と uncertainty を中心に transcription を構築する
transcription を upload validation、language context、segmentation、speaker policy、correction workflow を含む media-processing job として扱う。
- 2024 / 10 AUDIO
synthetic speech を開示された interface として設計する
voice、format、chunking、playback、interruption を製品判断とし、AI-generated voice であることを開示する。
- 2024 / 11 RETRIEVAL
retrieval と generation を分離する
embedding は semantic comparison を支えるが、production retrieval には chunk ownership、metadata filter、freshness、citation、deletion が必要。
- 2024 / 12 OPERATIONS
遅延許容 workload を batch processing へ移す
batch work には stable custom identifier、immutable input manifest、per-item status、result reconciliation、bounded replay が必要。
RETROSPECTIVE / SOURCE-CHECKED
12 ISSUES
- 2025 / 01 RESPONSES
Responses を agentic application boundary にする
typed input/output item により message、reasoning、tool call、tool result を multi-step request 全体で分離できる。
- 2025 / 02 STATE
conversation state を明示的に選ぶ
history 再送、response identifier chain、conversation resource のどれを使うか決め、data policy に明示する。
- 2025 / 03 TOOLS
web search を citation 付き retrieval として扱う
search result は volatile evidence。source URL を保持し、retrieval time と event time を分け、claim 付近に citation を示す。
- 2025 / 04 RETRIEVAL
ownership と freshness を備えた file search を構築する
hosted retrieval tool でも corpus governance、ingestion status、metadata、access filter、citation、refresh、deletion が必要。
- 2025 / 05 TOOLS
code execution を disposable compute cell として使う
bounded input を渡し expected artifact を定義し、sandbox 外で output を検証してから business workflow に入れる。
- 2025 / 06 ASYNC
long-running response を asynchronous job にする
background work には job identifier、polling/streaming policy、cancellation、expiry、idempotent consumption、visible status が必要。
- 2025 / 07 SAFETY
side-effect boundary に approval を置く
tool を impact で分類し、external message、purchase、destructive write、credential use、privilege change 前に停止する。
- 2025 / 08 MCP
MCP server を external principal として扱う
有効化前に server identity、transport、authentication、exposed tools、returned data、approval、failure behavior を棚卸しする。
- 2025 / 09 AGENTS
agent loop の owner を明確にする
controller が turn、tool、state、approval、stop condition、trace を所有し、specialist には narrow task と typed result を渡す。
- 2025 / 10 AGENTS
handoff を typed delegation にする
handoff には single goal、bounded context、allowed tool、authority、deadline、output shape、next owner を含める。
- 2025 / 11 OBSERVE
secret を記録せず decision を trace する
stable correlation identifier で run、turn、model、tool、handoff、approval、latency、usage、terminal outcome を結ぶ。
- 2025 / 12 EVALS
evaluation を release gate にする
system 変更前に representative input、human-readable criteria、適切な automated grader、baseline を定義する。
RETROSPECTIVE / SOURCE-CHECKED
08 ISSUES
- 2026 / 01 REALTIME
Realtime を live distributed system として設計する
transport、session configuration、turn detection、interruption、tool、reconnect、terminal state が体験を共同で定義する。
- 2026 / 02 REALTIME
browser Realtime credential を ephemeral に保つ
server-authenticated session bootstrap により browser が long-lived platform key なしで media transport を確立する。
- 2026 / 03 CODEX
bounded repository で Codex を開始する
coding agent が編集する前に working directory、task、sandbox、approval policy、definition of done を明示する。
- 2026 / 04 CODEX
repository の真実を AGENTS.md に残す
durable guidance は architecture boundary、command、convention、verification を示し、current task の代わりにはしない。
- 2026 / 05 CODEX
configuration、sandbox、approval を分離する
configuration は default を選び、sandbox は filesystem/network limit を強制し、approval は exceptional authority を管理する。
- 2026 / 06 CODEX
live access は MCP、repeatable method は Skills を選ぶ
MCP は認証済み external tool/context を接続し、Skill は instruction、script、reference、trigger を reusable workflow にまとめる。
- 2026 / 07 CODEX
conflicting write ではなく evidence を並列化する
subagent には independent ownership と result contract、headless CI には固定 permission、machine-readable output、isolated credential が必要。
- 2026 / 08 APPS
MCP tool に UI を追加しても trust を browser に移さない
MCP server が tool truth と authorization を所有し、embedded component は state を描画して narrow bridge 経由で action を要求する。