Agent Redactor で Codex を使う

前提条件: インストール Agent Redactor 起動した状態にしておいてください. Codex がインストールされ、PATH で利用可能であることも必要です。
  1. Agent Redactor を設定する(最初にこれを行う)

    Codex を設定する前に、ローカルの編集プロキシを起動して、Codex がそれ経由で接続できるようにします。Profiles サイドバーでプロファイルを選択または作成します。Local URL を http://localhost:8080/(または任意のポート)に、Forward To を実際のプロバイダーのエンドポイント(例: https://openrouter.ai/api/v1)に設定し、実際の API Key を貼り付けます。キーはローカルで暗号化され、マシンから送信されることはありません。Save All Settings をクリックし、ポートが利用可能と表示されることを確認します。

  2. 編集ルールを選択する

    マシンから何かが送信される前に何を編集するか決めます。AI Powered Detection Model を有効にして検出させる PII カテゴリーを選んだり、決定的なマッチングのために Regex Patterns と Keywords を追加したり、3 つの任意の組み合わせを使ったりできます。選択はあなた次第です。Regex と Keywords は、AI モデルが見落とす可能性のあるプロジェクト固有のシークレットにも最適です。

  3. Codex を Agent Redactor に向ける

    Codex はプロバイダーを TOML 設定ファイルから読み込みます。Windows では C:\Users\<you>\.codex\config.toml(その他の OS では ~/.codex/config.toml)を開き、存在しない場合は作成します。既存の設定を保持したまま、以下を追加します:

    model_provider = "agentredactor"
    model_reasoning_effort = "high"
    model = "nvidia/nemotron-3-ultra-550b-a55b:free"
    
    [model_providers.agentredactor]
    name = "agentredactor"
    base_url = "http://localhost:8080/"
    
    [model_providers.agentredactor.auth]
    command = "sh"
    args = ["-c", "echo $AGENTREDACTOR_API_KEY"]
    • base_url: Agent Redactor の Local URL と正確に一致している必要があります。
    • model: nvidia/nemotron-3-ultra-550b-a55b:free をプロバイダーの正確なモデル名に置き換えます。
    • model_reasoning_effort: 任意。お好みで設定するか、行ごと削除してください。
    • [model_providers.agentredactor.auth]: AGENTREDACTOR_API_KEY 環境変数を出力するシェルコマンドを実行して API トークンを取得するよう Codex に指示します。プレースホルダー値で問題ありません。Agent Redactor が既に実際の API キーを安全に保持し、アップストリームに注入するためです。
  4. プレースホルダー API キーを設定する

    プロキシが実際のキーを必要としなくても、Codex はトークンが存在することを期待します。環境変数を設定します:

    PowerShell (Windows):

    setx AGENTREDACTOR_API_KEY "placeholder"

    bash (Linux):

    echo 'export AGENTREDACTOR_API_KEY="placeholder"' >> ~/.bashrc

    どちらも変数を永続的に保存しますが、新しいターミナルでのみ反映されます(setx は SUCCESS: Specified value was saved. と出力します)。続行する前にターミナルを閉じて再度開いてください。

  5. Codex を起動して安全に作業する

    新しいターミナルから Codex を起動します:

    codex

    ヘッダーに選択したモデルと推論の努力が表示されるはずです。今後、すべての送信リクエストはインターネットに到達する前に、Agent Redactor 経由でローカルにフィルタリングされます。下の例では、モデルは以前名前があった場所に編集済みのプレースホルダーのみを受け取りました。

    Codex のセッション。モデルはユーザー名が編集済みのキーワード プレースホルダーであると答えています
    プロキシ経由で実行されている Codex。モデルは実際の名前の代わりに編集済みのプレースホルダーを受け取りました。

編集の確認

Agent Redactor の Session Redactions パネルを確認すると、正確に何が傍受されたかわかります。

Agent Redactor の Statistics パネル。Requests: 3、PII: 5、Keywords: 3、Session Redactions に Bob を含む傍受されたキーワードが一覧表示
Statistics パネルに "Requests: 3, PII: 5, Keywords: 3" と表示され、Session Redactions にタイムスタンプと種類付きで傍受された値が一覧表示されます。
ヒント: プロファイルで Regex Patterns と Keywords を使い、AI モデルが見落とす可能性のあるプロジェクト固有のシークレット(内部ホスト名、独自 ID、プロジェクトのコードネームなど)を捕捉しましょう。