--- title: 初期設定ガイド_CodexとClaude Code連携 tags: author: [Yukiko](https://www.docswell.com/user/yukiko_it) site: [Docswell](https://www.docswell.com/) thumbnail: https://bcdn.docswell.com/page/8EDKMM257G.jpg?width=480 description: 初期設定ガイド_CodexとClaude Code連携 by Yukiko published: July 22, 26 canonical: https://www.docswell.com/s/yukiko_it/58NRYL-2026-07-22-081013 --- # Page. 1 ![Page Image](https://bcdn.docswell.com/page/8EDKMM257G.jpg) SETUP GUIDE ・ COPY & PASTE Codex と Claude Code を Discordでつなぐ 初期設定ガイド コピペで試せる／文系・初心者エンジニア向け ✓ 公式ドキュメント（2026年7月時点）に基づき記載。断定できない箇所は明示します うさうさ研修工房 # Page. 2 ![Page Image](https://bcdn.docswell.com/page/V7PKRR1DJ8.jpg) 事前準備 このガイドを試す前に用意するもの すべて「入っているか確認する」だけでOK。難しい作業はここにはありません ✓ Claude Code ✓ Codex CLI ターミナルで claude と打って起動できる状態 ターミナルで codex と打って起動できる状態 インストール済みか確認 インストール済みか確認 ✓ Discordサーバー ✓ ターミナルの基本操作 検証用のサーバーでOK。自分が管理者であること コマンドをコピペして Enter を押せること 無料アカウントで十分 タイピングは不要、コピペでOK コピペで試す初期設定ガイド｜Codex × Claude Code × Discord 2 # Page. 3 ![Page Image](https://bcdn.docswell.com/page/2JVVRRYGJQ.jpg) 全体の流れ 4つのSTEPで完了します すべてコピペ中心。所要時間の目安は合計15〜20分程度 STEP 0 Discord Webhook URLを取 得 STEP 1 Claude Code側を 設定 STEP 2 STEP 3 Codex CLI側を 設定 信頼確認 & 動作テスト ポイント：最初は「通知が届く」ことだけを目標にする。レビューの中身は動いてから育てればいい コピペで試す初期設定ガイド｜Codex × Claude Code × Discord 3 # Page. 4 ![Page Image](https://bcdn.docswell.com/page/5EGLMMWDJL.jpg) 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 # Page. 5 ![Page Image](https://bcdn.docswell.com/page/4JQYRR3X7P.jpg) 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 # Page. 6 ![Page Image](https://bcdn.docswell.com/page/K74W8812E1.jpg) 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 # Page. 7 ![Page Image](https://bcdn.docswell.com/page/LJ1Y22GKEG.jpg) 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 # Page. 8 ![Page Image](https://bcdn.docswell.com/page/GJWGRRKP72.jpg) 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 # Page. 9 ![Page Image](https://bcdn.docswell.com/page/4EZLRRZ673.jpg) 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 # Page. 10 ![Page Image](https://bcdn.docswell.com/page/Y76WRRZL7V.jpg) 動作確認 実際に動かしてみよう 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 # Page. 11 ![Page Image](https://bcdn.docswell.com/page/G75M88WM74.jpg) つまずきポイント よくある質問 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 # Page. 12 ![Page Image](https://bcdn.docswell.com/page/9J29KKQRER.jpg) まとめ 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月時点の公式ドキュメントに基づく。仕様は変更される可能性があるため、実装前に最新版を確認してください