Codex を社内に配ると、情報システム部門や DX 推進担当には「どの部署がどれくらい使っているのか」「誰が何をしたか後から追えるのか」という質問が集まります。ところが利用状況を見る仕組みは1つではありません。分析の画面、集計 API、監査用の記録、端末側のテレメトリーが別々の目的で用意されていて、取り違えると「見えると思っていたものが見えない」という事態になります。

この記事では、株式会社デジライズが導入支援でご説明している「管理者が Codex の利用状況を把握する方法」を、OpenAI の公式ドキュメントとヘルプセンターに記載されている範囲で整理します。

結論: まず「何を知りたいのか」で道具を選んでください。普及の様子は分析画面、社内の BI への取り込みは Analytics API、監査や調査には Compliance API です。そして、どの道具も「すべての操作の完全な記録」ではありません。見えない部分は承認設定や社内ルールで補う前提で設計してください。

目的別に4つの道具を使い分ける

公式のガバナンス文書は、分析とコンプライアンスのデータは目的が違うとしたうえで、問いに合わせて使う面を選ぶよう案内しています。(出典: Governance)

知りたいこと 使うもの 主な提供対象(公開時点の記載)
ChatGPT 全体での普及の様子 Workspace analytics Enterprise・Edu
Codex の普及と利用を画面で見たい Codex analytics(管理コンソールの Insights など) ワークスペースの権限と有効な機能による
集計値を社内の BI やデータ基盤に入れたい Analytics API ワークスペースで有効になっていることを確認して使う
監査や調査のために記録を出したい Compliance API Enterprise・Edu

提供対象の列は、それぞれの公式ページの記載から整理したものです。Workspace analytics の公式ヘルプは Enterprise と Edu 向けの記事であり、Compliance Platform は Enterprise と Edu のワークスペースで利用できると記載されています。(出典: Workspace analytics for ChatGPT Enterprise and Edu、OpenAI Compliance Platform for Enterprise and Edu customers)

また公式ドキュメントは、これらの画面や API が製品へのアクセスを与えたり実行時の権限を変えたりするものではないことも明記しています。分析は「見る道具」であり、「止める道具」ではありません。(出典: Workspace analytics)

Workspace analytics で見えるもの

誰が見られるか

公式ヘルプでは、Workspace analytics を見られるのは Analytics Viewer ロールを持つメンバー、ワークスペースの管理者、ワークスペースのオーナーと記載されています。(出典: Workspace analytics for ChatGPT Enterprise and Edu)分析を見る担当者に管理者権限まで渡さなくてよいように、閲覧専用のロールが用意されていると理解してください。(出典: Roles and workspace permissions)

主な指標

管理コンソールの Usage の Overview では、利用者数やメッセージ数の推移に加えて、Workplace health として ChatGPT・Codex・Work の普及を追う指標が表示されます。公式ヘルプに記載されている定義は次のとおりです。

  • Seats enabled: ユーザーに割り当てたシート数(保留中や削除済みの招待を除く)
  • Seats activated: 有効なユーザーのうち、1回以上メッセージを送った人
  • WAU: 直近の日曜〜土曜の1週間に1回以上メッセージを送ったユニークユーザー数

SCIM を設定していれば、ID プロバイダーから同期したグループ単位で分けて見ることもできます。部署単位で普及を見たい企業は、SCIM のグループを実際の部署に合わせておくと分析が役に立ちやすくなります。(出典: Workspace analytics for ChatGPT Enterprise and Edu)

エクスポートと鮮度

Usage の Overview から、期間を指定してユーザー別のレポートを CSV でダウンロードできます。データはリアルタイムではなく、1〜24時間ごと(通常は6〜12時間以内)に更新されると記載されています。(出典: Workspace analytics for ChatGPT Enterprise and Edu)

ユーザー別レポートには氏名やメールアドレスの列が含まれます。公式ドキュメントも、ダウンロードしたレポートは個人を識別できる組織のデータとして扱い、社内のアクセス・保管・保持の方針を適用するよう求めています。(出典: Workspace analytics)

見えないもの

公式ヘルプは、Workspace analytics は集計された分析の画面であり、生のログの画面ではないとしたうえで、次のものは表示しないと明記しています。

  • メッセージ本文
  • ファイルの内容
  • 項目単位のコンプライアンス記録

なお、会話をタスクの種類や話題に分類して集計する Task insights は既定で有効で、管理者とオーナーは Workspace settings からオフにできます。個々のプロンプトや会話、ユーザー単位の活動は表示しない形の集計だと説明されています。(出典: Workspace analytics for ChatGPT Enterprise and Edu)

Codex の Insights で「何に使われているか」を見る

管理コンソールには ChatGPT Work と Codex の分析があり、Usage は活動と消費を、Insights は利用をカテゴリーとタスクに分類して表示します。開発の仕事については Code review の画面でレビューの活動と指摘を確認できます。表示される内容は権限と有効な機能によって変わります。(出典: Usage Insights)

Insights では、カテゴリーやタスクごとに Messages(メッセージ数)、Share of credits(クレジット消費の割合)、Active users(利用者数)を並べて見ます。公式ドキュメントが繰り返し注意しているのは、数字の読み方です。

  • メッセージ数は、チームがどれだけの仕事を終えたかを示さない
  • サンプリングの注記が出ている場合、数値はサンプルであり、全体を推計するために拡大しない
  • Code review の PRs reviewed は、レビューした PR が必ずマージやデプロイされたことを意味しない
  • 件数がゼロでも、活動がないのか集計の欠けなのかを期間と対象で確かめる

価値を判断するときは、Insights の数字とチームの記録(Pull Request、不具合の記録など)を合わせて見て、実際に作業した人を評価に加えるよう案内されています。(出典: Usage Insights)コードレビューの運用そのものはCodex のコードレビューをチームで使う記事で解説しています。

Analytics API で社内の BI に取り込む

定例の報告を自動化したい、社内の組織データと突き合わせたいという場合は Analytics API を使います。公式ドキュメントは、ChatGPT・Codex・Work の日次利用をまとめて返す Daily Usage Analytics API を挙げ、使う前にワークスペースで有効になっていることを確認するよう求めています。(出典: Analytics API)

権限の扱いで間違えやすい点があります。

  • Daily Usage Analytics API には、enterprise.analytics.usage.read を持つワークスペース単位の Admin key が必要
  • Codex 用の権限 codex.enterprise.analytics.read では、このエンドポイントにはアクセスできない
  • 公式ヘルプでは、Codex Enterprise Analytics は Codex を有効にした Enterprise のワークスペースで利用でき、管理コンソールの Credentials > Admin keys で Codex analytics API を Read に設定した Admin key を作ると説明されている
  • API Platform の組織のキーでは、ChatGPT ワークスペースの分析にはアクセスできない

(出典: Analytics API、Using Codex with your ChatGPT plan)

ルート、項目、集計期間の定義は Admin API reference が正本で、公式ドキュメントは画面のラベルやダウンロードした項目名から長く使う報告の仕様を作らないよう注意しています。(出典: Governance)

Compliance API で監査と調査の記録を取る

何に使うか

Compliance API は、セキュリティ・法務・ガバナンス・調査のために監査可能な記録が必要な場面で使います。公式ドキュメントは、普及や傾向の測定には分析を使い、コンプライアンスの記録は使わないよう明記しています。さらに「コードの品質や個人の成果を推し量るために使わない」とも書かれています。(出典: Compliance API and audit events)

公式ヘルプでは、Codex の利用(CLI や IDE 拡張などのローカルのクライアントと、web やクラウドに委任した利用の両方)が Compliance API で取得できると説明されています。(出典: Using Codex with your ChatGPT plan)また、Codex の Policies & Configurations の画面で行った変更はワークスペースの監査ログに記録され、権限のある管理者が管理コンソールまたは Compliance API で確認できます。(出典: OpenAI Compliance Platform for Enterprise and Edu customers)「誰がいつ Codex の制御を変えたか」を追えることは、統制の説明に役立ちます。

始め方

公式ドキュメントの手順は次のとおりです。(出典: Compliance API and audit events)

  1. Admin API reference を開き、自分の管理者ロールで必要なリソースにアクセスできるか確認する
  2. 継続的な収集には、追記のみ(append-only)のコンプライアンスログのストリームを使う
  3. ログファイルをダウンロードし、本番ではない SIEM やデータレイクで取り込みを試す
  4. 継続的な収集を定期実行にし、取り出した記録に社内のアクセス・保持・リーガルホールドの管理を適用する

キーの発行にも決まりがあります。公式ヘルプでは、ワークスペースのオーナーか管理者がワークスペース単位の Admin key を作り、広いコンプライアンスアクセスと会話メッセージの権限はオーナーだけが付与できると記載されています。(出典: OpenAI Compliance Platform for Enterprise and Edu customers)

保持は30日

Compliance Logs Platform のデータ保持は30日です。より長く残したい場合は、すべてのログを継続的にダウンロードして自社の方針で保管するよう案内されています。(出典: OpenAI Compliance Platform for Enterprise and Edu customers)「何かあったら後で取りに行く」では間に合わない前提で、取得の仕組みを先に作ってください。

完全な記録ではない

ここが最も大切な点です。公式ドキュメントは、Compliance API の記録やローカルのテレメトリーが、ローカルのすべてのコマンド、ファイル操作、スクリーンショット、承認、外部への操作の完全な記録になるわけではないと明記しています。(出典: Compliance API and audit events、Work admin FAQ)そのため、代表的なタスクを実際に実行し、取り出した記録と実際に行った操作を比べる確認が手順に含まれています。

端末側の動きは OpenTelemetry で補う

Codex は OpenTelemetry(OTel)によるイベントの出力に対応しています。既定ではオフで、設定ファイルで明示的に有効にします。有効にすると、会話の開始(モデル、推論の設定、サンドボックスと承認の設定)、ツールの承認や拒否の判断、ツールの実行結果などが構造化されたログとして出力されます。プロンプト本文は既定で伏せられます。(出典: Agent approvals and security)

導入時の注意として公式ドキュメントが挙げているのは次の点です。

  • プロンプト本文の記録(log_user_prompt)は、規程で認められない限りオフのままにする。プロンプトにはソースコードや機密情報が含まれうる
  • 送信先は自社が管理するコレクターに限り、保持期間とアクセス制御をかける
  • ネットワークをオフにして CLI を動かしている場合、テレメトリーはコレクターに届かない

OTel は承認やサンドボックスの代わりではなく、それを補うものと位置づけられています。サンドボックスと承認の考え方はサンドボックスと承認ポリシーの記事をご覧ください。

ChatGPT Business の場合

公開時点の ChatGPT の料金ページでは、Business プランに「利用状況の分析と支出管理」が含まれると記載されています。一方、この記事で紹介した Workspace analytics の公式ヘルプ、Codex Enterprise Analytics、Compliance Platform は、Enterprise や Edu を対象とした記載です。Business で同じ画面や API が使えるとは書けないため、実際の管理コンソールで確認してください。

支出の管理については、Business 向けの公式ヘルプに手順があります。Standard と Premium のシートには Codex などの利用枠が含まれ、使い切った後はワークスペースのクレジットで追加の利用をまかなえます。オーナーと管理者は、シートの種類ごとの月間クレジット上限と、ユーザーごとの上書きを設定できます。既定ではどのシートにも上限は設定されていません。(出典: Managing credits and spend controls in ChatGPT Business)利用上限と支出管理は分析とは別の仕組みで、機能の利用権を設定するものではありません。(出典: ChatGPT usage limits and spend controls)

利用者本人が自分の残りの利用枠を確かめたい場合は、設定画面や利用状況の画面を開くか、Codex CLI のセッション中に /status を入力するよう公式ヘルプで案内されています。(出典: Using Codex with your ChatGPT plan)

社内ルールとどう組み合わせるか

道具の仕様が分かったら、社内ルールに落とし込みます。デジライズでは、次の5点を利用開始前に決めることをおすすめしています。公式の管理者向けロールアウトガイドも、レポートとコンプライアンス(分析へのアクセス、監査記録の書き出し、その後のデータの扱い)に担当者を置くよう求めています。(出典: Admin rollout guide)

  1. 目的を書く: 利用状況のデータを「展開の進み具合の確認」と「監査・調査」に使い、人事評価には使わないと明文化する
  2. 閲覧者を絞る: 分析は Analytics Viewer、監査記録はセキュリティ担当と、見る人と見られる範囲を分ける
  3. 書き出したデータを守る: CSV や監査記録は個人を識別できるデータとして、保管場所と保存期間を決める。API キーは社内のシークレット管理に置く
  4. 保持の仕組みを作る: Compliance Logs Platform の30日に頼らず、継続取得して自社の規程どおりに保管する
  5. 見えない部分を別の統制で補う: 完全な操作記録にはならない前提で、危険な操作は承認設定と管理者設定で止める

社員にも、何が集計され何が記録されるのかを先に伝えておいてください。sandbox・承認・データの扱いまで含めた統制の全体像はCodex のセキュリティとガバナンスの記事にまとめています。

まとめ

管理者が Codex の利用状況を把握する道具は目的ごとに分かれています。普及は Workspace analytics と Insights、社内の報告基盤には Analytics API、監査と調査には Compliance API、端末側の動きは OpenTelemetry です。どれも「すべての操作の完全な記録」ではありません。数字を個人の評価に使わず、保持は自社で担い、見えない部分は承認設定と社内ルールで補う。この3点を押さえておけば、利用状況のデータは展開を前に進めるための材料になります。

なお、この記事の内容は公開時点の OpenAI 公式ドキュメントとヘルプセンターで確認した範囲です。画面の名称、対象プラン、権限の名前、保持期間は変わることがあるため、社内規程に落とし込む前に最新の記載をご確認ください。デジライズでは、利用状況の把握と社内ルールづくりを含めた導入支援のご相談を承っています。