本動画では、AI コーディングエージェント「Codex」のすべての実行セッションを LangSmith でリアルタイムに追跡・可視化する方法を紹介しています。CLI のバージョン確認から始まり、設定ファイルへのプラグイン有効化、環境変数による追跡フラグの設定まで、具体的なコマンドライン操作を順を追って解説します。実際のタスク実行後の LangSmith ダッシュボード上でのトレース構造（会話履歴、ツール呼び出し、サブエージェントの階層）の確認方法と、トラブルシューティングのポイントも網羅されています。
AI エージェント開発における「ブラックボックス化」への対抗策として、設定手順が明確で即座に適用可能な貴重なチュートリアルです。デバッグや監査が必要な開発者にとって必須の知識を含んでいます。
- 01
事前準備とインストール
Codex CLI バージョン 0.142 以降と LangSmith API キーの準備に加え、CLI からトレーシングプラグインを Marketplace に追加する手順。
- 02
設定ファイルでの有効化
~/.codex/config.toml ファイルに「features」と「plugins」ブロックを追加し、プラグインフックを明示的にオンにする必要がある点。
- 03
環境変数による追跡開始
TRACE_TO_LANGSMITH、CODEX_API_KEY、LANGSMITH_CODEX_PROJECT の 3 つの環境変数を設定してトレース機能を稼働させる方法。
- 04
LangSmith での可視化構造
実行完了後、LLM ラン、ツール呼び出し（シェル・Web）、サブエージェントの階層構造がフラット化されずに保存される様子を確認。
開発者が AI エージェントの内部挙動を可視化・デバッグする際の標準的なワークフローを確立し、コード生成プロセスの透明性と信頼性を高める。特にエンタープライズ環境での AI ガバナンスやコスト管理（トークン使用量の追跡）に直結する実用的なインフラ整備手法を提供する。