AIコーディングエージェントスキル

Codex CLIとClaude Code CLI — 2つの主要なAIコーディングエージェントに関する専門知識です。

注記: このスキルは両方のツールをリファレンスとして文書化しています。VMark開発は主にClaude Code CLIを使用しています。Codex CLIのセクションは完全性とクロスツールワークフローのために保持されています。

使用時期

• CLIを介した複雑なコーディングタスクの調整
• いずれかのツール用のMCPサーバーの設定
• 自動化パイプライン(CI/CD)のセットアップ
• 認証またはサンドボックスの問題のトラブルシューティング
• エージェント間の機能の比較
• カスタムエージェント/サブエージェント設定

クイックリファレンス

セッションの開始

タスク	Codex CLI	Claude Code CLI
インタラクティブセッション	codex	claude
プロンプト付き	codex "fix the bug"	claude "fix the bug"
非インタラクティブ	codex exec "task"	claude -p "task"
最後の続き	codex resume --last	claude -c
IDで再開	codex resume <id>	claude -r <id>

セーフティモード

モード	Codex CLI	Claude Code CLI
読み取り専用	-s read-only	--permission-mode plan
ワークスペース書き込み	-s workspace-write	(デフォルト)
フルアクセス	-s danger-full-access	--dangerously-skip-permissions
オートモード	--full-auto	--permission-mode default
YOLOモード	--yolo	--dangerously-skip-permissions

モデル選択

タスク	Codex CLI	Claude Code CLI
モデル選択	-m gpt-5-codex	--model opus
ローカルOSS使用	--oss	N/A
フォールバックモデル	N/A	--fallback-model sonnet

---

Codex CLI (OpenAI)

インストール

npm i -g @openai/codex
# または
brew install --cask codex

認証

codex login              # ChatGPT経由のOAuth
codex login --with-api-key   # 標準入力からAPIキーを読み込む
codex login status       # 認証ステータスを確認
codex logout             # 認証情報を削除

コアコマンド

codex - インタラクティブモード

codex                           # TUIを起動
codex "fix all TypeScript errors"  # 初期プロンプト付き
codex -i screenshot.png "explain"  # 画像付き
codex --full-auto "refactor"    # 低摩擦モード
codex --search "find docs"      # ウェブ検索を有効化

codex exec - 非インタラクティブ

codex exec "write tests"        # 実行して終了
codex e "task"                  # 短いエイリアス
echo "task" | codex exec -      # 標準入力から
codex exec --json "task"        # JSONLで出力
codex exec -o result.txt "task" # ファイルに保存
codex exec --output-schema schema.json "task"  # 出力を検証

codex resume - セッションの継続

codex resume                    # インタラクティブピッカー
codex resume --last             # 最新
codex resume --all              # すべてを表示(任意のディレクトリ)
codex resume <session-id>       # 特定のセッション
codex resume <id> "continue with this"  # プロンプト付き

codex review - コードレビュー

codex review                    # 現在のブランチとmainを比較
codex review --uncommitted      # コミット前の変更をレビュー
codex review --base develop     # 特定のブランチと比較
codex review --commit abc123    # 特定のコミットをレビュー
codex review "focus on security"  # カスタム指示

codex apply - クラウドタスクを適用

codex apply <task-id>           # クラウドタスクからdiffを適用

codex cloud - クラウドタスク(実験的)

codex cloud                     # クラウドタスクを参照
codex cloud exec "task" --env <env-id>  # タスクを送信
codex cloud status <task-id>    # ステータスを確認
codex cloud diff <task-id>      # diffを表示
codex cloud apply <task-id>     # 変更を適用

codex mcp - MCPサーバー管理

codex mcp list                  # サーバーをリスト表示
codex mcp list --json           # JSON出力
codex mcp get <name>            # サーバー詳細
codex mcp add <name> -- npx my-server   # stdioサーバーを追加
codex mcp add <name> --url https://... # HTTPサーバーを追加
codex mcp add <name> --env API_KEY=xxx -- cmd  # 環境変数付き
codex mcp remove <name>         # サーバーを削除
codex mcp login <name> --scopes read,write  # HTTPのOAuth
codex mcp logout <name>         # OAuthを削除

codex sandbox - サンドボックス化されたコマンド実行

# macOS
codex sandbox macos -- npm test
codex sandbox seatbelt --full-auto -- ./script.sh

# Linux
codex sandbox linux -- npm test
codex sandbox landlock -- ./script.sh

codex completion - シェル補完

codex completion bash >> ~/.bashrc
codex completion zsh >> ~/.zshrc
codex completion fish > ~/.config/fish/completions/codex.fish

スラッシュコマンド(インタラクティブ)

コマンド	目的
/model	モデルを切り替え(gpt-5-codex、gpt-5など)
/approvals	承認ポリシーを変更
/compact	会話をまとめて、コンテキストを解放
/diff	gitのdiffを表示
/review	ワーキングツリーを分析
/status	設定とトークン使用量を表示
/mcp	利用可能なMCPツールをリスト表示
/mention	ファイルを添付
/fork	会話をブランチ化
/resume	前のセッションを再度開く
/new	新しい会話
/init	AGENTS.mdスキャフォルドを作成
/feedback	ログ/診断を送信
/quit, /exit	CLIを終了

設定(~/.codex/config.toml)

model = "gpt-5-codex"
approval_policy = "on-request"

[sandbox]
mode = "workspace-write"

[features]
web_search = true

[profiles.ci]
model = "gpt-4.1"
approval_policy = "never"

グローバルフラグ

-m, --model <MODEL>          モデル選択
-s, --sandbox <MODE>         read-only|workspace-write|danger-full-access
-a, --ask-for-approval <P>   untrusted|on-failure|on-request|never
-c, --config <KEY=VALUE>     設定をオーバーライド
-C, --cd <DIR>               作業ディレクトリ
-i, --image <FILE>           画像を添付
-p, --profile <NAME>         設定プロファイル
--full-auto                  低摩擦モード
--yolo                       すべてのセーフティをバイパス(危険)
--search                     ウェブ検索を有効化
--add-dir <DIR>              追加の書き込みアクセスを付与
--enable <FEATURE>           フィーチャーフラグを有効化
--disable <FEATURE>          フィーチャーフラグを無効化
--oss                        ローカルOSSモデルを使用

---

Claude Code CLI (Anthropic)

インストール

npm install -g @anthropic-ai/claude-code

認証

claude                      # 最初の実行時にログインをプロンプト
claude setup-token          # 長期トークンをセットアップ
# Claude Pro/Maxサブスクリプション、またはAPIキーが必要

コアコマンド

claude - インタラクティブモード

claude                          # REPLを開始
claude "explain this project"   # プロンプト付き
claude -c                       # 最後の会話を続ける
claude -r "session-name"        # 名前/IDで再開
claude --model opus             # モデルを選択
claude --chrome                 # Chrome統合を有効化
claude --ide                    # IDEに自動接続

claude -p - プリントモード(非インタラクティブ)

claude -p "explain this function"   # クエリして終了
cat file | claude -p "explain"      # パイプ入力を処理
claude -p --output-format json "q"  # JSON出力
claude -p --output-format stream-json "q"  # ストリーミングJSON
claude -p --max-turns 3 "task"      # エージェントターンを制限
claude -p --max-budget-usd 5 "task" # 支出制限
claude -p --json-schema '{...}' "q" # 出力スキーマを検証

claude mcp - MCPサーバー管理

claude mcp list                 # サーバーをリスト表示
claude mcp get <name>           # サーバー詳細
claude mcp add <name> <cmd>     # stdioサーバーを追加
claude mcp add -t http <name> <url>  # HTTPサーバーを追加
claude mcp add -e KEY=val <name> -- cmd  # 環境変数付き
claude mcp add -H "Auth: Bearer x" <name> <url>  # ヘッダー付き
claude mcp add -s project <name> <cmd>  # プロジェクトスコープ
claude mcp remove <name>        # サーバーを削除
claude mcp serve                # MCPサーバーとして実行
claude mcp add-from-claude-desktop   # デスクトップアプリからインポート
claude mcp reset-project-choices     # 承認をリセット

claude plugin - プラグイン管理

claude plugin list              # プラグインをリスト表示
claude plugin install <name>    # プラグインをインストール
claude plugin install <name>@marketplace  # 特定のマーケットプレイスから
claude plugin uninstall <name>  # プラグインを削除
claude plugin enable <name>     # 無効なプラグインを有効化
claude plugin disable <name>    # プラグインを無効化
claude plugin update <name>     # プラグインを更新
claude plugin validate <path>   # マニフェストを検証
claude plugin marketplace       # マーケットプレイスを管理

claude update - 自己更新

claude update                   # アップデートを確認してインストール

claude doctor - 診断

claude doctor                   # ヘルス/問題をチェック

claude install - ネイティブビルド

claude install                  # ネイティブビルドをインストール
claude install stable           # 特定のバージョン
claude install latest           # 最新バージョン

スラッシュコマンド(インタラクティブ)

コマンド	目的
/init	CLAUDE.mdを生成
/clear	コンテキストをリセット
/compact	会話をまとめる
/bug	問題をレポート
/doctor	診断を実行
/model	モデルを切り替え
/config	設定を表示/編集
/permissions	権限を管理
/memory	メモリを表示/編集
/project:<cmd>	プロジェクト固有のコマンド
/user:<cmd>	ユーザー固有のコマンド

カスタムコマンド

.claude/commands/fix-issue.mdを作成:

Fix GitHub issue #$ARGUMENTS

1. Read the issue details
2. Identify the problem
3. Implement the fix
4. Write tests
5. Create a commit

使用: /project:fix-issue 1234

設定

ユーザー設定(~/.claude/settings.json):

{
  "model": "claude-sonnet-4-5-20250929",
  "verbose": false,
  "theme": "dark"
}

プロジェクト設定（.claude/settings.json）:

{
  "allowedTools": ["Bash(git:*)", "Read", "Edit"],
  "disallowedTools": ["Bash(rm:*)"]
}

CLIフラグ

コア

-p, --print                 非インタラクティブモード
-c, --continue              最後の会話を続ける
-r, --resume <ID>           特定のセッションを再開
-v, --version               バージョンを表示

モデル & 設定

--model <MODEL>             sonnet|opus|haiku、またはフルネーム
--fallback-model <MODEL>    オーバーロード時のフォールバック
--settings <FILE>           設定JSONをロード
--setting-sources <LIST>    user,project,local
--session-id <UUID>          特定のセッションIDを使用

システムプロンプト

--system-prompt <TEXT>      デフォルトプロンプトを置換
--append-system-prompt <T>  デフォルトに追記
--system-prompt-file <F>    ファイルで置換(プリントのみ)
--append-system-prompt-file ファイルで置換(プリントのみ)

エージェント & ツール

--agent <NAME>              エージェントを指定
--agents <JSON>             カスタムサブエージェントを定義
--tools <LIST>              組み込みツールを制限
--allowedTools <LIST>       ツールを自動承認
--disallowedTools <LIST>    コンテキストからツールを削除

権限

--permission-mode <MODE>    acceptEdits|bypassPermissions|default|delegate|dontAsk|plan
--dangerously-skip-permissions  すべてのプロンプトをスキップ(危険)
--allow-dangerously-skip-permissions  バイパスオプションを有効化

出力

--output-format <FMT>       text|json|stream-json
--input-format <FMT>        text|stream-json
--include-partial-messages  ストリーミングチャンクを含める
--verbose                   詳細ログ
--debug [FILTER]            フィルタリング付きデバッグモード

高度な設定

--max-turns <N>             エージェントターンを制限(プリントのみ)
--max-budget-usd <AMT>      支出制限(プリントのみ)
--json-schema <SCHEMA>      JSON出力を検証
--chrome / --no-chrome      Chrome統合
--ide                       IDE自動接続
--fork-session              再開時に新しいセッションを作成
--no-session-persistence    セッションを保存しない
--add-dir <DIRS>            追加ディレクトリ
--plugin-dir <DIRS>         プラグインをロード
--disable-slash-commands    すべてのスキルを無効化
--mcp-config <FILES>        MCPサーバー設定
--strict-mcp-config         指定されたMCPのみを使用
--betas <HEADERS>           ベータAPIヘッダー

カスタムサブエージェント

claude --agents '{
  "reviewer": {
    "description": "Code reviewer. Use after changes.",
    "prompt": "You are a senior code reviewer...",
    "tools": ["Read", "Grep", "Glob"],
    "model": "sonnet"
  }
}'

---

共通パターン & エッジケース

CI/CD統合

GitHub ActionsでのCodex:

- name: Run Codex
  run: |
    echo "${{ secrets.OPENAI_API_KEY }}" | codex login --with-api-key
    codex exec --json -o result.txt "fix linting errors"

CIでのClaude:

- name: Run Claude
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
  run: |
    claude -p --output-format json "review this PR" > review.json

レート制限への対応

Codex: 自動バックオフが組み込まれています。

Claude: --fallback-modelを使用:

claude -p --fallback-model haiku "quick task"

大規模なコードベースの操作

# Codex: /compactを使用してコンテキストを解放
# セッション内: /compact

# Claude: /compactを使用、または新規開始
claude --no-session-persistence -p "analyze src/"

マルチディレクトリアクセス

# Codex
codex --add-dir ../shared-lib --add-dir ../config

# Claude
claude --add-dir ../shared-lib ../config

構造化出力

Codex:

codex exec --output-schema schema.json "generate API spec"

Claude:

claude -p --json-schema '{"type":"object","properties":{"name":{"type":"string"}}}' "extract data"

画像入力

Codex:

codex -i screenshot.png "explain this UI"
codex -i img1.png -i img2.png "compare these"

Claude:

# プロンプト内のファイル参照経由
claude "analyze the image at ./screenshot.png"

セッションのフォーク

# Codex: セッション内で /fork

# Claude
claude -r "session-id" --fork-session "try alternative approach"

MCPサーバーデバッグ

Codex:

codex mcp list --json | jq .

Claude:

claude --debug "mcp" --mcp-config ./mcp.json

---

トラブルシューティング

認証の問題

問題	Codex	Claude
ログインしていない	codex login status	claude doctor
トークン期限切れ	codex logout && codex login	claude setup-token
APIキーの問題	OPENAI_API_KEYを確認	ANTHROPIC_API_KEYを確認

サンドボックスの問題

問題	ソリューション
アクセス許可が拒否	特定のディレクトリに--add-dirを使用
コマンド実行不可	サンドボックスモードを確認、workspace-writeを使用
ネットワーク遮断	サンドボックスがネットワークをブロック可能。慎重にdanger-full-accessを使用

MCPサーバーの問題

問題	ソリューション
サーバーが見つからない	mcp listを確認、インストールを確認
接続失敗	サーバーログを確認、URL/コマンドを検証
認証が必要	mcp loginを使用(Codex)、またはヘッダーを追加(Claude)

パフォーマンスの問題

問題	ソリューション
応答が遅い	より軽量なモデルを使用(gpt-4.1-mini / haiku)
コンテキスト溢れ	/compactを使用して要約
コストが高い	--max-budget-usdを設定(Claude)

---

ベストプラクティス

1. 探索には読み取り専用から開始し、必要に応じてエスカレート
2. セッションを使用 - 最初から開始するのではなく、仕事を再開
3. AGENTS.md/CLAUDE.mdを作成 - プロジェクト固有の指示用
4. MCPサーバーを活用 - 外部統合用
5. CI/CDで構造化出力を使用 - 解析用
6. 支出制限を設定 - --max-budget-usdで(Claude)
7. diffを確認 - 適用前に(/diff、codex cloud diff)
8. 大きな変更前にコミットチェックポイントを作成