CodeMender の概要

高度な AI モデルの登場により、コードの脆弱性に対する懸念が広がりました。攻撃者がエクスプロイトを生成する新しい機能にアクセスできるようになるにつれて、セキュリティ チームは、攻撃者が脆弱性を悪用する前に、脆弱性をプロアクティブに検出して修正するという、大きな時間的プレッシャーにさらされています。

CodeMender は、コードベースの深い脆弱性を発見、検証、パッチ生成できる AI コード セキュリティ エージェントです。CodeMender は、LLM をファインチューニングされたハーネスでラップし、Google DeepMind が設計したプロンプト、スキル、オーケストレーション ロジックを使用して、モデルをコード セキュリティに特化したエージェント システムに変換します。

仕組み

CodeMender は、コードが多数の言語とシステムタイプにまたがる、現代の企業環境の規模と多様性に対応します。

  • 脆弱性を検出する: エージェントがガイドする LLM を使用してコードベースをスキャンし、専用ツールとプロンプト エンジニアリングを活用して、モデルをセキュリティ上の欠陥に集中させます。または、外部のセキュリティ スキャン ツールから脆弱性のリストをインポートすることもできます。
  • 脆弱性を検証する。コードをビルドし、検出された脆弱性を悪用して、悪用可能かどうかを検証します。これにより、確認された脆弱性の優先順位付けが容易になり、誤検出率が低下します。
  • コードベースの言語と互換性のあるパッチを生成してテストし、脆弱性を修正します。

3 つのステージすべてで、CodeMender にコンテキストを提供して、アプリケーションと脅威モデルのニュアンスを考慮できるようにします。LLM と CodeMender のファインチューニングされたハーネスを組み合わせることで、LLM のみを使用して脆弱性を検出して修正する場合よりも、高品質な結果が得られます。

システム アーキテクチャ

ユーザーの視点から見ると、CodeMender システムは次の 2 つのコンポーネントで構成されています。

  • エージェント: コア ビジネス ロジックと推論を実行するホスト型のマルチエージェント システム。
  • クライアント: マシン上で実行されるクライアント。CLI(コマンドを発行して出力を表示する)とデーモン(エージェントに代わってコマンドを実行する。ローカル プロセスレベルのサンドボックス内でオプションの分離を行い、コードを安全にコンパイルし、テストを実行して、脆弱性を検証する)の両方として機能します。

対応する言語とフレームワーク

CodeMender は、デフォルトで C/C++、C# / .NET、Go、Java、JavaScript、TypeScript、Kotlin、Python、Ruby、Rust、PHP の言語をサポートしています。また、これらの言語の標準ライブラリや、一般的なエンタープライズ フレームワーク(HTML/CSS、Django、Flask、React、Spring Boot、ASP.NET、Express など)も幅広くサポートしています。

記載されているプログラミング言語は、厳密な制限ではありません。CodeMender は AI コード セキュリティ エージェントであるため、基盤となるモデルでサポートされている任意の言語でコードを分析して修正できます。サポートは、非独自言語で一般提供されています。

追加のプログラミング言語のスキャン

CodeMender を構成して、デフォルト セットに含まれていないプログラミング言語をスキャンするには、次のいずれかの方法を使用します。

  • グローバル構成: プログラミング言語のファイル拡張子を、グローバル CodeMender ~/.codemender/config.yaml 構成ファイルの scan.extensions.include セクションに追加します。
  • リポジトリごとの構成: リポジトリ内の CodeMender config.yaml 構成ファイルの scan.extensions.include セクションに、プログラミング言語のファイル拡張子を追加します。

たとえば、追加の言語やスクリプト形式をスキャンするには、次のようにします。

scan:
  extensions:
    include:
      # Default languages
      - .py
      - .java
      - .go
      - .js
      - .jsx
      - .mjs
      - .cjs
      - .ts
      - .tsx
      - .c
      - .cc
      - .cpp
      - .cxx
      - .h
      - .hpp
      - .cs
      - .rs
      - .kt
      - .kts
      - .rb
      - .php
      # Additional / custom languages
      - .swift
      - .scala
      - .sh

  # Exclude build, dependency, cache, and artifact directories
  exclude_dirs:
    - node_modules
    - vendor
    - dist
    - bin
    - target
    - obj
    - build
    - .gradle

スキャン オプションの構成の詳細については、構成パラメータ(config.yaml)をご覧ください。

品質に関する注意事項

CodeMender は、言語ごとの正式な評価を公開していません。デフォルトの言語は、ベンチマークの対象範囲が最も広い言語を反映しています。他の言語での結果は異なる場合があります。組織で特定の言語を優先して詳細な評価を行う必要がある場合や、デフォルトで含める必要がある場合は、Google アカウント チームにお問い合わせください。

サポートされているモデル

CodeMender は次のモデルをサポートしています。

クリックしてサポートされているモデルを開く

CodeMender は、Fairwind プログラムを通じてアクセスできるお客様向けに、Gemini 3.8 Flash Cyber、Gemini 4 Argon Cyber Permissive、Gemini 4 Carbon for cyber もサポートしています。

Gemini 4 Argon(gemini-4-argon)と Gemini 4 Carbon(gemini-4-carbon)には、エクスプロイトの生成や脆弱性の検証を含むリクエストをブロックする可能性のあるサイバー セーフティ機能が組み込まれています。gemini-4-argon または gemini-4-carbon の安全ブロックは、Gemini 3.8 Flash Cyber(gemini-3.8-flash-cyber)に対する再試行を自動的にトリガーします。プロジェクトが Gemini 3.8 Flash Cyber にアクセスできない場合は、Gemini 3.8 Flash(gemini-3.8-flash)にフォールバックします。

cm verify は、サイバーモデルで最適に動作します。プロジェクトが Fairwind Program を介してアクセスできる場合は、--model フラグ(--model gemini-3.8-flash-cyber など)を使用して渡します。

CodeMender CLI コマンドの実行時にモデルを指定するには、モデルを指定するをご覧ください。

サポートされるリージョン

CodeMender は世界中で利用できます。

トークンの使用状況を追跡する

CodeMender は、コマンドの実行中のライブ ステータス行と、コマンドが正常に完了したときの 1 行の概要の 2 つの場所でトークンの消費量を表示します。カウントには、現在のセッションの入力トークン、出力トークン、合計トークンが含まれます。

ライブ ステータス行

cm find、cm fix、cm verify、cm session resume のいずれかが実行されているときに --compact フラグを渡すと、エージェントの動作に合わせて更新されるローリング ステータス行が表示されます。

cm find ./src/auth/ --compact

ステータス行には、セッションの累積合計が表示されます。

Tokens: 40k in / 12k out / 60k total

再開されたセッションは、前回の実行が終了したところからカウントを継続します。total のカウントにはモデルの内部推論トークンが含まれる場合があるため、in + out を超える可能性があります。

終了の概要

コマンドが正常に終了し、少なくとも 1 つのツールステップが実行されると、CodeMender は経過時間とトークンの合計を含む 1 行の概要を出力します。

✅ Completed 14 tool steps in 3m 42s | Tokens: 40k in / 12k out / 60k total

課金対象のトークン使用量

Google Cloud プロジェクト全体の累積請求トークン使用量と費用傾向を表示するには、Cloud Billing の請求レポートと費用傾向を表示するをご覧ください。

CLI の使用を開始する

CLI ツールを設定し、ワークスペースを初期化してスキャンを開始します。

前提条件

CodeMender CLI を初期化する前に、環境が正しく準備されていることを確認します。

  • Google Cloud プロジェクトを設定する: 必要な API と IAM ロールを使用して Google Cloud プロジェクトを設定します。
  • CodeMender CLI をダウンロードする: ご利用のオペレーティング システム用の CodeMender CLI バイナリをダウンロードしてインストールします。
  • Google Cloud 認証情報とプロジェクトを構成する: Google Cloud アプリケーションのデフォルト認証情報(ADC)を構成し、CLI を認証するターゲット プロジェクトを設定します。
  • ソースコードをプロビジョニングする: スキャンするプロジェクトのソースコードをクローンまたはコピーして、ワークスペースに配置します。
  • サンドボックスを構成する: サンドボックス環境のディレクトリ マウント、ネットワーク アクセス プロファイル、セキュリティ例外を定義します。

モデルの指定

デフォルトでは、CodeMender は Gemini 3.8 Flash を使用します。デフォルトのモデルをオーバーライドするには、対応するモデル ID を指定して --model フラグを渡します。

  • Gemini 3.8 Flash(デフォルト): --model gemini-3.8-flash
  • Gemini 3.8 Flash Cyber: --model gemini-3.8-flash-cyber
  • Gemini 4 Argon: --model gemini-4-argon
  • Gemini 4 Argon Cyber Permissive: --model gemini-4-argon-cyber-permissive
  • Gemini 4 Carbon: --model gemini-4-carbon
  • サイバー向け Gemini 4 Carbon: --model gemini-4-carbon-cyber-permissive
  • Gemini 3.7 Flash: --model gemini-3.7-flash(2027 年 1 月 28 日に廃止)
  • Gemini 3.6 Flash: --model gemini-3.6-flash(非推奨。2026 年 11 月 19 日に廃止)
  • Gemini 3.5 Flash: --model gemini-3.5-flash
  • Gemini 3.1 Pro プレビュー版: --model gemini-3.1-pro-preview

非推奨のモデルは、廃止日まで引き続き機能します。使用すると、CLI に警告が表示されます。モデルが廃止されると、そのモデルを使用するリクエストは失敗します。廃止日までに Gemini 3.8 Flash に切り替えてください。

--model フラグは次のコマンドでサポートされています。

  • cm find
  • cm verify
  • cm fix

これらのコマンドのいずれかを実行するときにモデルを指定するには、次の構文を使用します。

cm COMMAND TARGET --model MODEL_NAME

セキュリティとデータ プライバシー

以降のセクションでは、CodeMender のセキュリティ モデル、データ保持ポリシー、アクセス制御について説明します。

CodeMender がクラウドに送信するデータ

CodeMender を使用する場合、ローカル CLI ツールがコードへのアクセスを仲介するため、ソースコード リポジトリ全体が Google のサーバーにアップロードされることはなく、ホスト型エージェントが独自にクローンを作成することもありません。

代わりに、CLI は Google がホストするエージェントに送信するデータを厳密にローカライズします。このデータは次の要素で構成されます。

  • 対象のファイルの内容またはコード スニペット、脆弱性情報、提案されたパッチ、コマンド実行結果。
  • メタデータ、診断、エラー、使用状況のテレメトリー(消費されたトークンやコマンドの実行時間など)。

Google が基盤モデルの重みのトレーニングにお客様のソースコードを使用することはありません。

保持ポリシーとは何ですか?

CodeMender は、厳格な短期データ保持ポリシーを使用しています。

  • 最大 7 日間の保持: コード スニペットやトラッキング状態などのセッション データは、Gemini Enterprise Agent Platform ストレージに最大 7 日間保持されます。これにより、ユーザーは中断されたスキャンをシームレスに再開できます。7 日が経過すると、システムによって自動的に削除されます(ゼロデータの保持を参照)。
  • 明示的な削除: 7 日間待つ必要はありません。DeleteInteraction を呼び出すことで、すべてのセッション データのクリーンアップをすぐにトリガーできます。
  • エフェメラルな検出結果: 脆弱性の検出結果とパッチは、長期保存データベースに保存されません。パイプライン中にメモリ内に蓄積されます。

データにアクセスできるユーザー

CodeMender は、人間の可視性に関して「ゼロデータ アクセス」アプローチを使用します。

  • 人間によるアクセスなし: 人間のグループや Google のエンジニアは、本番環境の顧客データを読み取るアクセス権を持っていません。
  • オペレーターの可視性なし: 本番環境のデバッグやエラー トラッキングであっても、Google オペレーターは制限されており、お客様のソースコード コンテキストや一時的なセッション状態を可視化することはできません。
  • 厳格な分離: Google は、組織とお客様の課金プロジェクトごとにすべてのデータを論理的に分離し、アクセス制御を行って、共有インフラストラクチャ内でテナントのプライバシーを保護します。
  • VPC Service Controls(VPC-SC): 環境をさらに保護するため、CodeMender のアーキテクチャは VPC-SC を完全にサポートしています。これにより、 Google Cloud リソースの周囲に安全なセキュリティ境界を定義できるため、ローカル データがクラウド推論エンジンに送信される際のデータ漏洩のリスクを軽減できます。

次のステップ

詳細な手順については、次のガイドをご覧ください。