Codex CLI かんたん使いこなしガイド コピペOK

Codex CLI かんたん使いこなしガイド コピペOK

まずはまだ最新版をいれよう。

インストール / 更新

npm install -g @openai/codex@latest
codex --version

権限で詰まる場合は次を検討:

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

基本ワークフロー

• 対話で着手: codex -C <repoパス>
• 非対話で一発実行: codex exec "やりたいこと"
• 差分を適用: codex apply
• 画像添付: codex -i path/to/img.png "説明して"

承認とサンドボックス（おすすめ設定）

• 低摩擦・安全: codex --sandbox workspace-write -a on-failure
• フルオート別名: codex --full-auto

プロファイル設定（~/.codex/config.toml）

[profiles.dev]
sandbox = "workspace-write"
ask_for_approval = "on-failure"

使い方: codex -p dev -C ./your-project "テスト整備して"

便利コマンド

• ログイン/ログアウト: codex login / codex logout
• 補完生成: codex completion zsh
• MCPサーバー（上級）: codex mcp
• Web検索を許可: codex --search "調査して要約"

プロンプトのコツ（雛形）

目的: 何を/いつまでに/どう測るか
制約: 触ってよい範囲・禁止事項・依存
出力: 期待する成果物と形式（ファイル/コマンド/要約）

例: codex -p dev -C ./app "ESLintを導入。最小変更で設定/修正/CI追加。最後に変更点要約して"

非対話（exec）レシピ例

# 変更提案→適用まで
codex --full-auto exec "型エラー修正とテスト追加。差分を適用して完了報告"

# 画像付きデバッグ
codex exec -i ./error.png "原因を特定し修正手順を示して"

トラブルシュート

• 権限系: グローバルbinが通っていない → export PATH="$(npm bin -g):$PATH"
• 非信頼リポで停止: codex exec --skip-git-repo-check "…"
• Node要件: Node 18+ を推奨（node -v）

よく使うオプション早見表

• -C <DIR>: 作業ディレクトリ切替
• -p <PROFILE>: プロファイル指定
• -c key=value: 設定の一時上書き（例 -c model="o3"）
• -i <FILE>: 画像添付（複数可）
• --sandbox: read-only / workspace-write / danger-full-access
• -a: 承認ポリシー untrusted / on-failure / on-request / never

ヒント: よく使う構成はプロファイル化し、codex -p dev の一発運用に。