Codex×Discord連携_研修資料

世界一調査官シリーズ Codex × Discord 連携で拓く エンジニアの新しい開発体験 OpenAI Codexの基礎から、Discordを使ったリモート運用・チーム通知連携までを 法人研修レベルで体系的に解説します。 CLI × 自律型コーディングエージェント うさうさ研修工房 Discord 連携運用

AGENDA 本日の研修構成 01 Codexとは何か エージェント型 AIコーディングツールの正体と全体像 02 Codex CLIの基本操作 インストール・ AGENTS.md・承認モードの設計思想 03 なぜDiscord連携が必要か リモート操作・通知・チーム開発での活用理由 04 連携方式と実践事例 Webhook方式／カスタム Bot方式と代表的な OSS実装 05 導入時の注意点とまとめ セキュリティ設計・運用ルール策定のポイント うさうさ研修工房｜Codex × Discord 実践研修 2

CHAPTER 01 「Codex」は3つの意味を持つ 同名の別プロダクトが存在するため、研修ではまず用語を整理します。 2021年 2025年5月〜 本研修の対象 初代 Codex（GPT-3ベー ス） 現行 Codex（自律型エー ジェント） Codex CLI / IDE拡張 / Web / App コード補完モデルとしてAPI提供。2023年に 自然言語の指示でコード生成・編集・テスト API提供終了し、現在は稼働していない。 ・実行までを自律的に行う、現在の主役。 うさうさ研修工房｜Codex × Discord 実践研修 ChatGPTサブスクリプションに統合された、 複数入口を持つコーディングエージェント 群。 3

CHAPTER 01 4つの入口から使える Codex CLI単体のツールではなく、利用シーンに応じて選べるエージェント群として提供されている。 Codex CLI IDE拡張 ターミナル常駐型。ローカルリ VS Code等のエディタに常駐。 ポジトリを直接操作でき、エン 開いているファイルの文脈を ジニアが最も効率的に使える 踏まえて修正提案を受けられ 形態。 る。 うさうさ研修工房｜Codex × Discord 実践研修 Web デスクトップアプリ / Cloud ブラウザからサインインしてす クラウド型実行にも対応し、長 ぐ利用可能。導入までの最短 時間タスクの自走運用がしや ルート。 すい。 4

CHAPTER 01 料金プラン（ ChatGPT統合型） 旧CodexのようなAPI従量課金ではなく、ChatGPTサブスクリプションに含まれる形で提供される。 Free / 対象プラン Plus ¥0〜 月 $20 一部の対象プランでも利用枠あり。まず試 基本的なCodexエージェント機能を利用可 すのに最適。 能。個人開発者向け。 ヘビーユーザー向け Pro 月 $200 無制限利用＋高推論モード（xhigh）。大規 模リポジトリや複雑なリファクタリング向け。 ※金額・上限は更新が速い領域のため、導入前に必ず OpenAI公式ドキュメントで最新情報を確認してください。 うさうさ研修工房｜Codex × Discord 実践研修 5

CHAPTER 02 Codex CLIをはじめる 1 インストール npm install -g @openai/codex でグローバル導入。所要時間は約5分。 # 1. インストール $ npm install -g @openai/codex 2 サインイン ChatGPTアカウントでOAuth認証。個人利用はこの方式を推奨。 # 2. 起動 & サインイン $ codex 3 4 AGENTS.mdを配置 # 3. プロジェクトルールを配置 プロジェクトルールを記述。実行時間短縮・トークン削減につながる運用 資産になる。 $ touch AGENTS.md /model で切り替え # 4. モデル切り替え（セッション中） > /model セッション中にモデルを変更可能。タスクの複雑さに応じて調整する。 うさうさ研修工房｜Codex × Discord 実践研修 6

CHAPTER 02 承認モードで実行範囲を制御する CLIは強力な分、承認設定を緩めると意図しないコマンドが実行されるリスクがある。最初は厳しめの設定で運用する。 workspace-write（推奨） danger-full-access（要注意） 起動ディレクトリ（--cd で指定したパス）以下のファイルのみ書き込み 全ファイルシステムへの書き込み・任意コマンド実行が可能。Docker 可。研修・通常業務ではこちらを既定にする。 等の隔離環境でのみ使用する。 補足 : 個人利用は ChatGPT OAuth認証、 CI/CDや自動化スクリプトは APIキー認証が一般的に推奨される。 APIキーは組織の Secret管理ツールで管理する。 うさうさ研修工房｜Codex × Discord 実践研修 7

CHAPTER 03 なぜCodex × Discord連携なのか チーム開発の現場では、ターミナルの外からCodexを扱いたい場面が多く生まれる。 スマホから操作 進捗をリアルタイム通知 外出先でも進捗確認・承認・追 処理の進捗・成功・エラーを 加指示ができる。 PCの前にい Discordチャンネルへ自動通知 なくてもチームの手が止まらな し、状況把握のコストを下げ い。 る。 うさうさ研修工房｜Codex × Discord 実践研修 質問・承認をチャットで 完結 チームでの可視化 判断が必要な場面で選択肢付 個人のターミナル作業をチー きの質問を受け取り、チャット ムのDiscordチャンネルに開き、 上で即座に回答できる。 進行状況を共有しやすくする。 8

CHAPTER 04 連携の全体像： 2つのアプローチ OpenAI公式による Discordの one-click 連携は存在しない。すべてコミュニティによる実装。 シンプル・一方向 高機能・双方向 方式① Webhook 方式② カスタム Bot CodexからDiscordの Webhook URL へPOSTリクエストを送信し、メッ discord.js / discord.py 等でBotを構築。コマンドを受けてCodex セージを通知する最も手軽な方法。 CLI／APIを呼び出し、応答を整形して返す。 うさうさ研修工房｜Codex × Discord 実践研修 9

CHAPTER 04 カスタム Bot方式のアーキテクチャ Discordを操作端末に、中継サーバーがCodex CLIと双方向にやり取りする構成が一般的。 Discord 中継Bot Codex CLI スマホ・PC等 チャンネル / スレッド discord.js / discord.py コマンド処理・整形 ローカル or サーバー上で実行 app-serverプロトコル Discord → Bot → Codex：作業指示・回答・離席モード終了などを送信 Codex → Bot → Discord：進捗通知・選択肢付きの質問・ログやスクリーンショットの共有 中継サーバーはローカルの HTTP経由で Codex CLIと通信し、 Discord APIを介して Botがメッセージを中継する設計が代表的。 うさうさ研修工房｜Codex × Discord 実践研修 10

CHAPTER 04 実践事例：代表的な OSS実装3選 いずれもコミュニティ発の非公式実装。導入前にライセンス・セキュリティ設計を確認すること。 discord-codex-bot discord-bridge-server codex-discord スラッシュコマンド対応 Bot Claude Code / Codex 兼用の中継サーバー ローカルワークスペース制御 Bot Discordの専用チャンネルを通じてエージェント ローカルの Codexログインセッションを利用し、 と双方向にやり取り。進捗通知・選択肢付き APIキー不要でスマホから Codexを制御。承認・ 質問・スクリーンショット共有に対応。 完了時のプッシュ通知に対応。 /start owner/repo でリポジトリごとの作業ス レッドを作成。投稿メッセージを Codex CLIへ渡 し、進捗と応答を同じスレッドへ返す。画像添 付は --image としてCodexに渡せる。 うさうさ研修工房｜Codex × Discord 実践研修 11

CHAPTER 05 導入時の注意点 Discord連携は利便性が高い一方、社内ルールとして安全設計を先に決めておく必要がある。 承認モードは最初は厳しく トークン・ APIキーの管理 Discord経由でも既定は workspace-write。danger-full-accessは隔 Botトークンやコンソール上の APIキーは組織の Secret管理ツール 離環境限定とルール化する。 で一元管理し、平文共有しない。 チャンネル・権限の分離 非公式実装であることの周知 リポジトリ／プロジェクトごとにチャンネルを分け、実行権限を持 公式連携ではないため、仕様変更やメンテナンス停止のリスク つメンバーを限定する。 を前提に運用計画を立てる。 うさうさ研修工房｜Codex × Discord 実践研修 12

SUMMARY まとめ：今日からできる 3ステップ Codex CLIを試す AGENTS.mdを整備する Discord連携は小さく始める うさうさ研修工房｜Codex × Discord 実践研修 npm install -g @openai/codex でまず個人環境に導入し、workspace-writeで挙動を確認 する。 プロジェクトのルールを明文化し、チームで再利用できる運用資産として育てる。 まずWebhookによる通知から着手し、必要になった段階でカスタムBotへ拡張する。 13

ご清聴ありがとうございました Codex × Discord連携は、ターミナルの外へ開発体験を広げる第一歩です。 小さく試し、チームのルールとともに育てていきましょう。 うさうさ研修工房