Zenn
🔰

🚀✨ Cline (Roo Code) × Vertex AI で開発を加速！つまづきがちな初期設定とメリット解説

に公開
VS Code
Google Cloud
開発効率
Gemini
Cline
tech

皆さん、こんにちは！AI コーディングエージェントと共にコーディングするのが当たり前になった今、どのコーディングエージェントをどう使うかが開発体験を大きく左右しますよね。

市場には Cursor、Cline や Windsurf をはじめ、多くのコーディングエージェントが登場しています。その中で、今回は Cline または Roo Code（旧 Roo Cline) に注目します。

✨ なぜ Cline なのか？ ✨

Cline を選ぶ理由の一つとして、多くの開発者が愛用している Visual Studio Code の拡張機能として提供されている点が挙げられます。すでに VS Code を業務で標準的に利用している企業や開発者にとって、使い慣れたエディタ環境はそのままに、新しいコーディング エージェント機能を比較的スムーズに導入できるのは大きなアドバンテージです。学習コストを抑えつつ、強力なコーディング エージェントを組み込むことができます。

また、その Cline のバックエンドとして Google Cloud の強力な統合 AI プラットフォーム 「Vertex AI」を連携させる方法をご紹介します。Vertex AI 経由で Gemini などの最新モデルを使うことで、単に AI を利用するだけでなく、エンタープライズレベルの管理性や Google Cloud との連携といった大きなメリットが得られます。

✨ なぜ Vertex AI 経由？そのメリット ✨

すでに Google Cloud を活用されている企業の中には、Google AI Studio や Gemini API を直接利用することに、セキュリティやガバナンス、課金管理の面で懸念を感じる方もいらっしゃるかもしれません。Vertex AI を経由することで、これらの課題をクリアし、既存の Google Cloud 環境と統合された形で安心して Gemini を導入できます。 具体的には、以下のようなメリットがあります。

  • 🔒 セキュリティとガバナンス: Google Cloud の堅牢なセキュリティ基盤 (IAM, VPC Service Controls など) を活用し、アクセス権限やデータの扱いを厳密に管理できます。多くの業界標準コンプライアンスにも対応しており安心です。
  • 📈 信頼性と監視: Google Cloud の安定したインフラ上で動作し、商用利用を想定した SLA (Service Level Agreement) が提供されています。さらに、Cloud Monitoring を使って API の利用状況やパフォーマンスを詳細に監視でき、運用管理が容易になります。
  • 🤖 豊富なモデル管理: Vertex AI の Model Garden では、Gemini の各バージョンに加え、Google の他のモデルやサードパーティ製、オープンソースモデルなど、多種多様なモデルが提供されており、用途に応じて最適なものを選択・管理できます。
  • 💰 課金の一元管理: Vertex AI の利用料金は、他の Google Cloud サービスと合わせて請求されるため、コスト管理がしやすくなります。

これらのメリットを活かして、より高度で信頼性の高い生成 AI 活用を目指しましょう！

🔧 設定手順：Cline と Vertex AI を連携させる

それでは、具体的な設定手順を見ていきましょう。（Google Cloud のアカウントは作成済み、Cline または、Roo Code をインストール済みという前提）

1. gcloud CLI の準備

まずは Google Cloud と連携するためのコマンドラインツール gcloud CLI をセットアップします。

# インストール (macOS + Homebrew の例)
brew install --cask google-cloud-sdk

# 初期設定 (アカウント、プロジェクトを選択)
gcloud init

# 設定確認
gcloud config list

ここで account と project が正しく設定されているか確認してください。

2. Vertex AI API の有効化と認証

次に、Vertex AI API を有効にし、Cline からアクセスするための認証を設定します。以下の 方法A または 方法B のどちらかを選択してください。

方法A: アプリケーションのデフォルト認証

ローカル開発時に gcloud の認証情報を使う手軽な方法です。

gcloud auth login
gcloud auth application-default login
gcloud services enable aiplatform.googleapis.com
方法B: サービスアカウント

アプリケーション専用の認証情報を使いたい場合に適しています。

# サービスアカウント作成（例: vertex-ai-client）
gcloud iam service-accounts create vertex-ai-client \
  --display-name="Vertex AI Client Service Account"

# 権限付与 (Vertex AI User ロール)
gcloud projects add-iam-policy-binding "$(gcloud config get project)" \
  --member="serviceAccount:vertex-ai-client@$(gcloud config get project).iam.gserviceaccount.com" \
  --role="roles/aiplatform.user"

# キーファイル (key.json) を作成・ダウンロード (★重要: このファイルを安全に管理)
gcloud iam service-accounts keys create key.json \
  --iam-account="vertex-ai-client@$(gcloud config get project).iam.gserviceaccount.com"

この key.json ファイルのパスを後ほど Cline の設定で使います。

3. Cline の設定

Cline の設定画面を開き、新しいプロファイルを作成しましょう。

  • 設定プロファイル: 新規作成 (例: VertexAI)
  • API プロバイダ: GCP Vertex AI を選択
  • Google Cloud 認証: 方法A/B に応じて選択
  • Google Cloud キーパス: (方法B の場合のみ) ダウンロードした key.json のパスを指定
  • Google Cloud プロジェクト ID: ご自身のプロジェクト ID を入力
  • Google Cloud リージョン: (例: us-central1)
  • モデル: 使用するモデルを選択 (例: gemini-2.5-pro-preview-03-25 など)

4. 利用開始

設定が完了したら、作成したプロファイルを選択して有効にします。これで準備OKです！

まとめ

Cline または、Roo Code（旧 Roo Cline)と Vertex AI を連携させることで、Gemini などの強力な AI モデルを、エンタープライズレベルのセキュリティ、管理性、そして Google Cloud エコシステムとの連携といったメリットと共に活用できるようになります。

設定自体は gcloud CLI と Cline アプリケーション側の設定で比較的簡単に行えます。ぜひこのガイドを参考に、開発環境をアップグレードしてみてください！

Discussion