Claude Code を Gemini と共に YOLO モードで使用する方法 (2026年版)
Claude Code で Gemini モデルを実行し、自動承認(auto-accept)を有効にして高速な自律型コーディングを実現する
Hyperealで構築を始めよう
Kling、Flux、Sora、Veoなどに単一のAPIでアクセス。無料クレジットで開始、数百万規模まで拡張可能。
クレジットカード不要 • 10万人以上の開発者 • エンタープライズ対応
YOLOモードでGeminiを使用してClaude Codeを活用する方法 (2026年版)
Claude CodeはAnthropicが提供するエージェンティック・コーディングのためのCLIですが、Claudeモデルだけに限定されているわけではありません。適切な設定を行えば、GoogleのGeminiモデルをClaude Code経由で実行できます。これを「YOLOモード」(自動承認)と組み合わせることで、手動の承認を一切必要としない、完全に自律的なコーディングワークフローを構築できます。
このガイドでは、Claude CodeのモデルプロバイダーとしてGeminiを設定する方法、YOLOモードを有効にする方法、そしてプロジェクトを誤って削除しないためのセーフティ・ガードレールの設定方法を解説します。
YOLOモードとは?
YOLOモード(コミュニティによる呼称で、Anthropicの公式名称は「auto-accept」または「dangerously skip permissions」)は、ファイルの編集、ターミナルコマンド、その他のアクションといったすべてのツール使用を、ユーザーの確認なしで自動的に承認するようClaude Codeに指示するモードです。
通常、Claude Codeはファイルの書き込みやシェルコマンドの実行ごとに承認を求めます。これは安全ですが、速度は低下します。YOLOモードはその摩擦を取り除きます。
# 通常モード: Claudeはアクションごとに許可を求めます
claude
# > "I'd like to edit src/auth.ts. Allow? (y/n)"
# YOLOモード: Claudeは許可を求めずに実行します
claude --dangerously-skip-permissions
# > *即座にsrc/auth.tsを編集*
# > *即座にnpm testを実行*
# > *即座に失敗したテストを修正*
注意: YOLOモードは、マシン上で任意のシェルコマンドを実行できる権限を持ちます。サンドボックス環境、コンテナ、またはGitで容易に変更を元に戻せるリポジトリ内でのみ使用してください。
なぜClaude CodeでGeminiを使用するのか?
Geminiモデルに切り替えることには、いくつかの利点があります。
| 理由 | 詳細 |
|---|---|
| コスト | Gemini 2.0 FlashはClaude Sonnetよりも大幅に安価です |
| 速度 | Gemini Flashは単純なタスクにおいて非常に低レイテンシです |
| 無料枠 | Google AI Studioは寛大な無料API利用枠を提供しています |
| コンテキストウィンドウ | Geminiモデルは最大100万トークンのコンテキストをサポートします |
| 実験 | タスクの種類に応じて異なるモデルを試すことができます |
特にGemini 2.0 Flashは極めて高速かつ安価であり、モデルが何度も反復的な呼び出しを行うYOLOモードには理想的です。
前提条件
開始する前に、以下が準備されていることを確認してください。
- Claude Codeのインストール:
npm install -g @anthropic-ai/claude-code - Google AI StudioのAPIキー: aistudio.google.com で無料で取得可能
- Node.js 18+ がインストールされていること
- Git: バージョン管理用(YOLOモードを使用する際の必須のセーフティネット)
ステップ 1: Gemini APIキーを取得する
- Google AI Studioにアクセスします。
- Googleアカウントでサインインします。
- 左サイドバーの Get API Key をクリックします。
- Create API Key をクリックし、Google Cloudプロジェクトを選択(または新規作成)します。
- APIキーをコピーします。
無料枠では、Gemini 2.0 Flashに対して寛大なレート制限が提供されています。
| モデル | 無料枠制限 | 有料プラン料金 |
|---|---|---|
| Gemini 2.0 Flash | 15 RPM, 1M TPM | $0.10 / 1M input tokens |
| Gemini 2.0 Pro | 2 RPM, 100K TPM | $1.25 / 1M input tokens |
| Gemini 2.5 Pro | 5 RPM, 250K TPM | $1.25 / 1M input tokens |
ステップ 2: Geminiを使用するようにClaude Codeを設定する
Claude Codeは、OpenAI互換のAPI設定を介してサードパーティモデルをサポートしています。以下の環境変数を設定してください。
# Geminiをモデルプロバイダーとして設定
export CLAUDE_CODE_USE_BEDROCK=0
export ANTHROPIC_API_KEY="placeholder"
# モデルを設定
export CLAUDE_MODEL="gemini-2.0-flash"
# Google AIをプロバイダーとして設定
export MODEL_PROVIDER="google"
export GOOGLE_API_KEY="your-google-ai-studio-api-key"
あるいは、Claude Codeの起動時に --model フラグを使用することもできます。
claude --model gemini-2.0-flash
設定ファイルを使用する
恒久的に設定を保存するには、Claude Codeの設定に追加します。
# Claude Codeの設定を更新
claude config set --global model gemini-2.0-flash
claude config set --global provider google
または、設定ファイルを直接編集します。
// ~/.claude/settings.json
{
"model": "gemini-2.0-flash",
"provider": "google",
"apiKey": "your-google-api-key"
}
OpenRouterをプロキシとして使用する
別の方法として、複数のモデルプロバイダーに統一されたAPIを提供するOpenRouterを使用することも可能です。
export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-your-openrouter-key"
export CLAUDE_MODEL="google/gemini-2.0-flash"
OpenRouterがAnthropicのフォーマットからGoogleのフォーマットへのAPI変換を処理するため、この方法も有効です。
ステップ 3: YOLOモードを有効にする
Geminiと自動承認モードを組み合わせます。
# Geminiを使用した基本的なYOLOモード
CLAUDE_MODEL="gemini-2.0-flash" \
GOOGLE_API_KEY="your-key" \
claude --dangerously-skip-permissions
セーフティ・ガードレールの追加
YOLOモードは「無謀」を意味するものではありません。破壊的なアクションを防ぐために、許可されるコマンドのホワイトリストを設定してください。
# コマンド制限付きのYOLOモード
claude --dangerously-skip-permissions \
--allowedTools "Edit,Write,Read,Glob,Grep"
これによりファイル操作は許可されますが、任意のシェルコマンドはブロックされます。より柔軟でありながら危険な操作を制限する設定例:
// .claude/settings.json
{
"permissions": {
"allow": [
"Read",
"Write",
"Edit",
"Glob",
"Grep",
"Bash(npm test)",
"Bash(npm run lint)",
"Bash(npx tsc --noEmit)"
],
"deny": [
"Bash(rm -rf *)",
"Bash(git push)",
"Bash(sudo *)"
]
}
}
推奨される安全なセットアップ
YOLOモードを使用する前には、必ずセーフティネットを構築してください。
# 1. Gitリポジトリ内にいることを確認
git status
# 2. 現在の変更をすべてコミットまたはスタッシュする
git add -A && git commit -m "checkpoint before YOLO mode"
# 3. YOLO作業用のブランチを作成
git checkout -b yolo-experiment
# 4. 安全にYOLOモードを実行
claude --dangerously-skip-permissions
# 5. 終了後、すべての変更を確認
git diff
# 6. 問題が発生した場合はリセット
git checkout main
git branch -D yolo-experiment
ステップ 4: 実践的なワークフロー
素早いバグ修正
Gemini Flashを使用したYOLOモードは、迅速なバグ修正に最適です。
claude --dangerously-skip-permissions \
"fix the TypeScript errors in src/components/ and run tsc to verify"
Gemini Flashはこれを迅速に処理します。エラー出力を読み取り、問題を特定し、修正を行い、型チェッカーを実行する ―― これらすべてをプロンプトを表示せずに行います。
テストの生成
モジュール全体のテストを自律的に生成します。
claude --dangerously-skip-permissions \
"write comprehensive unit tests for all functions in src/utils/. \
Use vitest. Run the tests and fix any failures."
コードのリファクタリング
プロジェクト全体のコードパターンをリファクタリングします。
claude --dangerously-skip-permissions \
"refactor all useState + useEffect patterns in src/components/ \
to use React Query instead. Update imports and types."
ドキュメント生成
コードからドキュメントを生成します。
claude --dangerously-skip-permissions \
"add JSDoc comments to all exported functions in src/lib/. \
Include parameter descriptions, return types, and examples."
YOLOタスク別のモデル比較
YOLOモードにおいて、モデルごとに異なる強みがあります。
| タスクタイプ | 最適なモデル | 理由 |
|---|---|---|
| 素早い修正、Lint対応 | Gemini 2.0 Flash | 高速、安価、十分な性能 |
| 複雑なリファクタリング | Claude Sonnet | 高いコード推論能力 |
| テスト生成 | Gemini 2.5 Pro | コード理解に優れる |
| 複数ファイルにわたる設計 | Claude Sonnet | 計画能力が高い |
| ドキュメント作成 | Gemini 2.0 Flash | 速度重視。品質も十分 |
| バグ調査 | Gemini 2.5 Pro | 多くのファイルを読み込むための大容量コンテキスト |
トラブルシューティング
よくある問題
「Model not found」エラー:
正しいモデル識別子を使用しているか確認してください。Google AI Studioでは gemini-2.0-flash ですが、OpenRouterでは google/gemini-2.0-flash となります。
レート制限エラー: Geminiの無料枠には厳格なレート制限(Flashの場合は15 RPM)があります。YOLOモードでは、Claude Codeが短時間に多くのリクエストを送信することがあります。有料プランへのアップグレードを検討するか、遅延を挟んでください。
コンテキスト長の制限:
Claude Codeが読み込むファイルが多すぎてコンテキストウィンドウを超えてしまう場合は、.claudeignore ファイルを使用して不要なディレクトリを除外してください。
# .claudeignore
node_modules/
dist/
build/
.next/
coverage/
*.lock
ツール使用の互換性: すべてのモデルがClaude Codeのツール形式を完全に処理できるわけではありません。パースエラーが発生する場合は、プロバイダー間の形式を正規化してくれるOpenRouterをプロキシとして試してみてください。
よくある質問 (FAQ)
YOLOモードは安全ですか? Gitを使用し、専用ブランチで作業し、許可するツールを制限していれば安全です。本番サーバーやバージョン管理されていない環境では決して使用しないでください。
Claude CodeにおいてGeminiはClaudeと同等に動作しますか? 単純なタスク(バグ修正、テスト生成、ドキュメント作成)については、Gemini Flashは十分に機能します。複雑な複数ファイルのリファクタリングやアーキテクチャの変更については、一般的にClaude Sonnetの方が信頼性が高いです。
YOLOモードでGemini 2.5 Proを使用できますか? はい、可能ですが、レート制限がより厳しく、コストも高くなります。速度とコストがピーク時の品質よりも重要になるYOLOモードでは、通常Gemini 2.0 Flashが適しています。
これはAnthropicのクレジットを消費しますか? いいえ。GoogleのAPIキーを設定している場合、すべてのリクエストはGoogleのサーバーに送信され、Google AI Studioのクォータを使用します。
まとめ
Google GeminiとClaude CodeのYOLOモードを組み合わせることで、高速かつ安価で自律的なコーディングアシスタントが手に入ります。Gemini Flashのスピードと自動承認モードを組み合わせれば、やりたいことを伝え、席を外し、戻ってきたときには作業が完了しているというワークフローが可能になります。
鍵となるのは「安全性」です。常にGitを使用し、ブランチで作業し、危険なコマンドを制限し、マージ前に変更を確認してください。これらのガードレールを設ければ、YOLOモードは真の生産性向上ツールとなります。
もし、メディア生成機能を必要とするAIアプリケーションを構築しているなら、Hypereal AIを無料でお試しください(クレジットカード不要)。Claude Codeで構築するプロジェクトのバックエンドとして最適です。
