初期設定ガイド_CodexとClaude Code連携

SETUP GUIDE ・ COPY & PASTE Codex と Claude Code を Discordでつなぐ 初期設定ガイド コピペで試せる／文系・初心者エンジニア向け ✓ 公式ドキュメント（2026年7月時点）に基づき記載。断定できない箇所は明示します うさうさ研修工房

事前準備 このガイドを試す前に用意するもの すべて「入っているか確認する」だけでOK。難しい作業はここにはありません ✓ Claude Code ✓ Codex CLI ターミナルで claude と打って起動できる状態 ターミナルで codex と打って起動できる状態 インストール済みか確認 インストール済みか確認 ✓ Discordサーバー ✓ ターミナルの基本操作 検証用のサーバーでOK。自分が管理者であること コマンドをコピペして Enter を押せること 無料アカウントで十分 タイピングは不要、コピペでOK コピペで試す初期設定ガイド｜Codex × Claude Code × Discord 2

全体の流れ 4つのSTEPで完了します すべてコピペ中心。所要時間の目安は合計15〜20分程度 STEP 0 Discord Webhook URLを取 得 STEP 1 Claude Code側を 設定 STEP 2 STEP 3 Codex CLI側を 設定 信頼確認 & 動作テスト ポイント：最初は「通知が届く」ことだけを目標にする。レビューの中身は動いてから育てればいい コピペで試す初期設定ガイド｜Codex × Claude Code × Discord 3

STEP 0 Discordの「Webhook URL」を取得する Webhook URL ＝ そのURLに投稿するだけで Discordに自動メッセージが届く “合言葉”のようなもの 1 通知を受け取りたいチャンネルを開く（例： #review-result） ⚠ 取り扱い注意 Webhook URLはパスワードと同じ扱いです。 2 チャンネル設定 →「連携サービス」 →「ウェブフック」 →「新しいウェブフック」 チャットやコードに直接貼らない SNSやGitHubに公開しない 3 名前を付けて「ウェブフック URLをコピー」を押す 環境変数として保存する（STEP1で解説） 漏れたら Discord 側で再発行する コピペで試す初期設定ガイド｜Codex × Claude Code × Discord 4

STEP 1

Claude Code① 通知スクリプトを作る
ターミナルに次のコマンドをそのまま貼り付けてEnter

1行目
ターミナル

mkdir -p ~/.claude/hooks
cat > ~/.claude/hooks/discord-notify.sh << 'EOF'
#!/bin/bash
WEBHOOK_URL="$DISCORD_WEBHOOK_URL"
DIFF=$(git diff --stat | tail -n 20)
curl -s -X POST "$WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d "$(jq -n --arg diff "$DIFF" \
'{content:"✅ Claude Code タスク完了", embeds:[{description:$diff}]}')"
EOF
chmod +x ~/.claude/hooks/discord-notify.sh

コピペで試す初期設定ガイド｜Codex × Claude Code × Discord

通知スクリプト置き場のフォルダを作成

2〜11行目
スクリプトの中身をファイルへ書き出す（catでそのまま
作成）

最終行

スクリプトに実行権限を付与

5

STEP 1

Claude Code② フックを登録して合言葉を渡す
① フックを登録

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
"hooks": {
"Stop": [{
"hooks": [{
"type": "command",
"command": "bash ~/.claude/hooks/discord-notify.sh"
}]
}]
}
}
② Webhook URLを環境変数に保存（.bashrcの場合は読み替え）
EOF
echo 'export
DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/xxxx/
xxxx"' \
>> ~/.zshrc
source ~/.zshrc

コピペで試す初期設定ガイド｜Codex × Claude Code × Discord

これは何をしているか
settings.json
Claude Codeに「タスクが終わったら（ Stop）このスクリプトを実行して」と伝える設定
ファイル

hooks / Stop

Claude Codeが応答を終えたタイミングで発火するイベント名

export ...
Webhook URLをスクリプトに直接書かず、環境変数として渡す方法。コードに合言
葉を書かずに済む

6

STEP 2

Codex CLI① hooks.json を作る
Codex CLIは専用の hooks.json ファイル、または config.toml のどちらでも設定できる（ここでは hooks.json を使用）

公式仕様メモ
ターミナル（~/.codex/hooks.json を作成）

mkdir -p ~/.codex/hooks

設定ファイルの置き場は ~/.codex/hooks.json か
~/.codex/config.toml（プロジェクト直下の .codex/ で

cat > ~/.codex/hooks.json << 'EOF'
{
"description": "Discordへの完了通知",
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "bash ~/.codex/hooks/discord-notify.sh",
"timeout": 30
}
]
}
]
}
}
コピペで試す初期設定ガイド｜Codex
× Claude Code × Discord
EOF

も可）

フック機能自体は現在デフォルトで有効。無効化す
るには config.toml に [features] hooks = false を書く

timeout の単位は秒。省略時は 600秒

7

STEP 2

Codex CLI② 通知スクリプト（注意点あり）
⚠ Claude Codeとの違い：Codex CLIの Stop イベントは、正常終了（exit 0）時に標準出力へ JSON を返す仕様。プレーンテキストのみの出力は無効と明記され
ている。curl の後に echo '{}' を必ず付ける

ターミナル

cat > ~/.codex/hooks/discord-notify.sh << 'EOF'
#!/bin/bash
WEBHOOK_URL="$DISCORD_WEBHOOK_URL"
curl -s -X POST "$WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d '{"content":" ✅ Codex CLI タスク完了 "}'
# Stopイベントは exit 0 時にJSONを期待するため必須
echo '{}'
EOF
chmod +x ~/.codex/hooks/discord-notify.sh

コピペで試す初期設定ガイド｜Codex × Claude Code × Discord

8

STEP 3・重要 ／hooks で「信頼」しないと動きません ここは見落としやすい公式仕様。前の記事にはなかった最新情報です Codex CLIは安全のため、「管理外（ non-managed）」のフックを初回実行前に人間が内容を確認し、明示的に信頼（ trust）しないと実行しない設 計になっている 1 2 codex /hooks レビュー待ちを確認 ターミナルで codex と入力してCodex 起動中に /hooks と入力。設定済み discord-notify.sh が「レビュー待ち」と CLIを起動 のフック一覧が開く して表示される コピペで試す初期設定ガイド｜Codex × Claude Code × Discord 3 4 Trust を選択 内容を確認し、信頼する操作を選 ぶ。以降このフックは自動実行され る 9

動作確認 実際に動かしてみよう Claude Codeのテスト Codex CLIのテスト 1 ターミナルで claude を起動 1 ターミナルで codex を起動 2 「READMEを1行要約して」などタスクを依頼 2 同様に簡単なタスクを依頼 3 応答が終わったら Discord のチャンネルを確認 3 ／hooks で Trust 済みか確認 → Discordを確認 うまく届かないときのチェック echo $DISCORD_WEBHOOK_URL ls -l ~/.claude/hooks/ Codexは /hooks でTrust済みか 環境変数が空でないか確認 スクリプトに実行権限(x)が付いているか確認 レビュー待ちのままだと実行されない コピペで試す初期設定ガイド｜Codex × Claude Code × Discord 10

つまずきポイント よくある質問 Q Webhook URLはどこに保存すればいい？ 環境変数（~/.zshrc や ~/.bashrc）に保存する。コードやチャットに直接貼らない Q Claude CodeとCodexの設定ファイルは共有できる？ 共有できない。別物として、それぞれの場所に個別に用意する コピペで試す初期設定ガイド｜Codex × Claude Code × Discord Q Codexでフックが動かない ／hooks で discord-notify.sh がTrust済みか確認。設定ファイルの場所 （~/.codex/hooks.json）が正しいかも確認 Q 通知が届くようになったら次は？ 前回資料の「原則A：書いた本人に採点させない」「原則B：新規セッションで読む」に 沿って、実際のレビュー運用へ発展させる 11

まとめ STEP0〜3：Webhook取得 → Claude Code設定 → Codex CLI設定 → 信頼確認とテスト、の4手順でコピペのみで完結する Codex CLIのフックは現在デフォルトで有効。ただし非管理フックは／hooks での信頼（Trust）操作が必須という点は見落としやすい Webhook URLは環境変数で管理し、コードやチャットに直接書かない 参考：公式ドキュメント Claude Code Hooks Reference （code.claude.com/docs/en/hooks ） Codex Hooks （developers.openai.com/codex/hooks ） ※ 2026年7月時点の公式ドキュメントに基づく。仕様は変更される可能性があるため、実装前に最新版を確認してください