設定オプションの完全ガイド

学習後にできること

✅ 正しい場所に設定ファイルを作成する
✅ 使用シナリオに応じて適切な設定方案を選択する
✅ すべての設定オプションの機能とデフォルト値を理解する
✅ 環境変数を使用して一時的に設定を上書きする
✅ モデルの動作、アカウントローテーション、プラグインの動作を調整する

現在の課題

設定オプションが多すぎて、どこから始めればいいかわからない？デフォルト設定で問題なく動作するが、さらに最適化したい？複数アカウントのシナリオでどのローテーション戦略を使用すべきかわからない？

中核となる考え方

設定ファイルはプラグインへの「使用説明書」を書くようなものです—どのように動作するかを指示すると、そのとおりに実行します。Antigravity Auth プラグインは豊富な設定オプションを提供していますが、ほとんどのユーザーは少数の中核オプションを設定するだけで十分です。

設定ファイルの優先順位

設定項目の優先順位は高い順から以下の通りです：

環境変数（一時的な上書き）
プロジェクトレベルの設定 .opencode/antigravity.json（現在のプロジェクト）
ユーザーレベルの設定 ~/.config/opencode/antigravity.json（グローバル）

INFO

環境変数の優先順位が最も高く、一時的なテストに適しています。設定ファイルは永続的な設定に適しています。

設定ファイルの場所

オペレーティングシステムに応じて、ユーザーレベルの設定ファイルの場所は異なります：

システム	パス
Linux/macOS	`~/.config/opencode/antigravity.json`
Windows	`%APPDATA%\opencode\antigravity.json`

プロジェクトレベルの設定ファイルは常にプロジェクトルートの .opencode/antigravity.json にあります。

設定オプションの分類

設定オプションは4つのカテゴリに分類されます：

モデルの動作：思考ブロック、セッション復旧、Google Search
アカウントローテーション：複数アカウント管理、選択戦略、PID オフセット
アプリケーションの動作：デバッグログ、自動更新、通知の静寂化
高度な設定：エラー復旧、トークン管理、ヘルススコア

🎒 開始前の準備

[x] プラグインのインストールが完了している（クイックインストールを参照）
[x] 少なくとも1つの Google アカウントが設定されている
[x] JSON の基本構文を理解している

実践してみよう

ステップ 1：設定ファイルを作成する

なぜ：設定ファイルにより、プラグインがあなたのニーズに応じて動作します

オペレーティングシステムに応じたパスで設定ファイルを作成します：

macOS/LinuxWindows

bash

cat > ~/.config/opencode/antigravity.json << 'EOF'
{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json"
}
EOF

powershell

## PowerShell の使用
$env:APPDATA\opencode\antigravity.json = @{
  '$schema' = "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json"
} | ConvertTo-Json -Depth 10

Set-Content -Path "$env:APPDATA\opencode\antigravity.json" -Value $json

確認すべき点：ファイルが正常に作成され、内容に $schema フィールドのみが含まれていること。

TIP

$schema フィールドを追加すると、VS Code が自動的にインテリセンスと型チェックを提供します。

ステップ 2：基本オプションを設定する

なぜ：使用シナリオに応じてプラグインの動作を最適化する

以下の方案から使用シナリオに応じたものを選択してください：

シナリオ A：単一アカウント + Google Search が必要

json

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "sticky",
  "web_search": {
    "default_mode": "auto"
  }
}

シナリオ B：2-3 アカウント + スマートローテーション

json

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "hybrid",
  "web_search": {
    "default_mode": "auto"
  }
}

シナリオ C：複数アカウント + 並列エージェント

json

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "round-robin",
  "switch_on_first_rate_limit": true,
  "pid_offset_enabled": true,
  "web_search": {
    "default_mode": "auto"
  }
}

確認すべき点：設定ファイルが正常に保存され、OpenCode が自動的にプラグイン設定を再読み込みすること。

ステップ 3：設定を検証する

なぜ：設定が有効になっていることを確認する

OpenCode でモデルリクエストを送信し、以下を観察してください：

単一アカウントで sticky 戦略を使用する場合：すべてのリクエストが同じアカウントを使用
複数アカウントで hybrid 戦略を使用する場合：リクエストがインテリジェントに異なるアカウントに割り当てられる
web_search を有効にした Gemini モデル：モデルが必要に応じてネットワークを検索

確認すべき点：プラグインの動作が設定通りになっていること。

設定オプションの詳細解説

モデルの動作

これらのオプションはモデルの思考と応答方法に影響を与えます。

keep_thinking

値	デフォルト	説明
`true`	-	Claude の思考ブロックを保持し、ラウンド間で一貫性を維持
`false`	✓	思考ブロックを取り除き、より安定し、コンテキストを小さく保つ

注意

keep_thinking を有効にすると、モデルの安定性が低下し、署名エラーが発生する可能性があります。false を推奨します。

session_recovery

値	デフォルト	説明
`true`	✓	ツール呼び出しが中断されたセッションを自動的に復旧
`false`	-	エラー発生時に自動復旧を行わない

auto_resume

値	デフォルト	説明
`true`	-	復旧後に自動的に "continue" を送信
`false`	✓	復旧後にプロンプトを表示し、手動で続行

resume_text

復旧時に送信されるテキストをカスタマイズします。デフォルトは "continue" で、任意のテキストに変更可能です。

web_search

オプション	デフォルト	説明
`default_mode`	`"off"`	`"auto"` または `"off"`
`grounding_threshold`	`0.3`	検索閾値（0=常に検索、1=決して検索しない）

INFO

grounding_threshold は default_mode: "auto" のときのみ有効です。値が大きいほど、モデルは検索をより保守的に行います。

アカウントローテーション

これらのオプションは複数アカウント間のリクエスト割り当てを管理します。

account_selection_strategy

戦略	デフォルト	適用シナリオ
`sticky`	-	単一アカウント、プロンプトキャッシュを保持
`round-robin`	-	4+ アカウント、スループットを最大化
`hybrid`	✓	2-3 アカウント、インテリジェントローテーション

TIP

アカウント数別の推奨戦略：

1 個のアカウント → sticky
2-3 個のアカウント → hybrid
4+ 個のアカウント → round-robin
並列エージェント → round-robin + pid_offset_enabled: true

switch_on_first_rate_limit

値	デフォルト	説明
`true`	✓	初回の 429 エラーで即座にアカウントを切り替え
`false`	-	現在のアカウントをリトライし、2回目の 429 で切り替え

pid_offset_enabled

値	デフォルト	説明
`true`	-	異なるセッション（PID）が異なる開始アカウントを使用
`false`	✓	すべてのセッションが同じアカウントから開始

TIP

単一セッション使用時は false を維持し、Anthropic プロンプトキャッシュを保持してください。複数セッションの並列実行時は true の有効化を推奨します。

quota_fallback

値	デフォルト	説明
`true`	-	Gemini モデルのクォータプールフォールバック
`false`	✓	フォールバックを有効にしない

INFO

Gemini モデルのみ適用されます。プライマリクォータプールが枯渇した場合、同じアカウントのバックアップクォータプールを試行します。

アプリケーション動作

これらのオプションはプラグイン自体の動作を制御します。

quiet_mode

値	デフォルト	説明
`true`	-	ほとんどのトースト通知を抑制（復旧通知は除く）
`false`	✓	すべての通知を表示

debug

値	デフォルト	説明
`true`	-	デバッグログを有効にする
`false`	✓	デバッグログを記録しない

TIP

デバッグログを一時的に有効にするには、設定ファイルを変更せずに環境変数を使用してください：

bash

OPENCODE_ANTIGRAVITY_DEBUG=1 opencode   # 基本ログ
OPENCODE_ANTIGRAVITY_DEBUG=2 opencode   # 詳細ログ

log_dir

カスタムデバッグログディレクトリ。デフォルトは ~/.config/opencode/antigravity-logs/ です。

auto_update

値	デフォルト	説明
`true`	✓	プラグインを自動的にチェックして更新
`false`	-	自動更新を行わない

高度な設定

これらのオプションはエッジケース用であり、ほとんどのユーザーは変更する必要がありません。

高度な設定を展開して表示

エラー復旧

オプション	デフォルト	説明
`empty_response_max_attempts`	`4`	空のレスポンスの最大再試行回数
`empty_response_retry_delay_ms`	`2000`	再試行間隔（ミリ秒）
`tool_id_recovery`	`true`	ツールIDの不一致を修復
`claude_tool_hardening`	`true`	ツールパラメータの幻覚を防止
`max_rate_limit_wait_seconds`	`300`	レート制限時の最大待機時間（0=無限）

トークン管理

オプション	デフォルト	説明
`proactive_token_refresh`	`true`	期限切れ前に積極的にトークンを更新
`proactive_refresh_buffer_seconds`	`1800`	30分前に更新
`proactive_refresh_check_interval_seconds`	`300`	更新チェック間隔（秒）

署名キャッシュ（`keep_thinking: true` のとき有効）

オプション	デフォルト	説明
`signature_cache.enabled`	`true`	ディスクキャッシュを有効にする
`signature_cache.memory_ttl_seconds`	`3600`	メモリキャッシュ TTL（1時間）
`signature_cache.disk_ttl_seconds`	`172800`	ディスクキャッシュ TTL（48時間）
`signature_cache.write_interval_seconds`	`60`	バックグラウンド書き込み間隔（秒）

ヘルススコア（`hybrid` 戦略で使用）

オプション	デフォルト	説明
`health_score.initial`	`70`	初期ヘルススコア
`health_score.success_reward`	`1`	成功時の報酬スコア
`health_score.rate_limit_penalty`	`-10`	レート制限時のペナルティスコア
`health_score.failure_penalty`	`-20`	失敗時のペナルティスコア
`health_score.recovery_rate_per_hour`	`2`	1時間あたりの回復スコア
`health_score.min_usable`	`50`	利用可能アカウントの最低スコア
`health_score.max_score`	`100`	ヘルススコアの上限

トークンバケット（`hybrid` 戦略で使用）

オプション	デフォルト	説明
`token_bucket.max_tokens`	`50`	バケットの最大容量
`token_bucket.regeneration_rate_per_minute`	`6`	1分あたりの回復速度
`token_bucket.initial_tokens`	`50`	初期トークン数

推奨設定方案

単一アカウントの設定

対象：Google アカウントが1つだけのユーザー

json

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "sticky",
  "web_search": {
    "default_mode": "auto"
  }
}

設定説明：

sticky：ローテーションなし、Anthropic プロンプトキャッシュを保持
web_search: auto：Gemini が必要に応じて検索可能

2-3 アカウントの設定

対象：小規模チームや一定の柔軟性が必要なユーザー

json

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "hybrid",
  "web_search": {
    "default_mode": "auto"
  }
}

設定説明：

hybrid：インテリジェントローテーション、ヘルススコアで最適なアカウントを選択
web_search: auto：Gemini が必要に応じて検索可能

複数アカウント + 並列エージェントの設定

対象：複数の並行エージェントを実行しているユーザー

json

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "round-robin",
  "switch_on_first_rate_limit": true,
  "pid_offset_enabled": true,
  "web_search": {
    "default_mode": "auto"
  }
}

設定説明：

round-robin：リクエストごとにアカウントをローテーション
switch_on_first_rate_limit: true：初回 429 エラーで即座に切り替え
pid_offset_enabled: true：異なるセッションが異なる開始アカウントを使用
web_search: auto：Gemini が必要に応じて検索可能

よくある落とし穴

❌ エラー：設定変更後に反映されない

原因：OpenCode が設定ファイルを再読み込みしていない可能性があります。

解決方法：OpenCode を再起動するか、JSON 構文が正しいか確認してください。

❌ エラー：設定ファイルの JSON 形式エラー

原因：JSON 構文エラー（カンマの欠落、余分なカンマ、コメントなど）。

解決方法：JSON 検証ツールを使用して確認するか、$schema フィールドを追加して IDE のインテリセンスを有効にしてください。

❌ エラー：環境変数が反映されない

原因：環境変数名のスペルミス、または OpenCode を再起動していない。

解決方法：変数名が OPENCODE_ANTIGRAVITY_*（すべて大文字、正しいプレフィックス）であることを確認し、OpenCode を再起動してください。

❌ エラー：`keep_thinking: true` を有効にすると頻繁にエラーが発生する

原因：思考ブロックの署名が一致していません。

解決方法：keep_thinking: false（デフォルト値）を維持するか、signature_cache 設定を調整してください。

本レッスンのまとめ

設定ファイルの場所の優先順位：環境変数 > プロジェクトレベル > ユーザーレベル。

中核設定項目：

モデルの動作：keep_thinking、session_recovery、web_search
アカウントローテーション：account_selection_strategy、pid_offset_enabled
アプリケーションの動作：debug、quiet_mode、auto_update

シナリオ別推奨設定：

単一アカウント：sticky
2-3 アカウント：hybrid
4+ アカウント：round-robin
並列エージェント：round-robin + pid_offset_enabled: true

次のレッスンの予告

次のレッスンでは デバッグログ を学習します。
学習内容：
デバッグログの有効化方法
ログ内容の解釈方法
よくある問題のトラブルシューティング方法

付録：ソースコード参照

クリックしてソースコードの場所を表示

最終更新日：2026-01-23

機能	ファイルパス	行番号
設定 Schema 定義	`src/plugin/config/schema.ts`	12-323
デフォルト設定値	`src/plugin/config/schema.ts`	325-373
設定読み込みロジック	`src/plugin/config/loader.ts`	1-100

重要な定数：

DEFAULT_CONFIG: すべての設定項目のデフォルト値

重要な型：

AntigravityConfig: 設定オブジェクトの型
AccountSelectionStrategy: アカウント選択戦略の型
SignatureCacheConfig: 署名キャッシュ設定の型

設定オプションの完全ガイド ​

学習後にできること ​

現在の課題 ​

中核となる考え方 ​

設定ファイルの優先順位 ​

設定ファイルの場所 ​

設定オプションの分類 ​

🎒 開始前の準備 ​

実践してみよう ​

ステップ 1：設定ファイルを作成する ​

ステップ 2：基本オプションを設定する ​

ステップ 3：設定を検証する ​

設定オプションの詳細解説 ​

モデルの動作 ​

keep_thinking ​

session_recovery ​

auto_resume ​

resume_text ​

web_search ​

アカウントローテーション ​

account_selection_strategy ​

switch_on_first_rate_limit ​

pid_offset_enabled ​

quota_fallback ​

アプリケーション動作 ​

quiet_mode ​

debug ​

log_dir ​

auto_update ​

高度な設定 ​

エラー復旧 ​

トークン管理 ​

署名キャッシュ（keep_thinking: true のとき有効） ​

ヘルススコア（hybrid 戦略で使用） ​

トークンバケット（hybrid 戦略で使用） ​

推奨設定方案 ​

単一アカウントの設定 ​

2-3 アカウントの設定 ​

複数アカウント + 並列エージェントの設定 ​

よくある落とし穴 ​

❌ エラー：設定変更後に反映されない ​

❌ エラー：設定ファイルの JSON 形式エラー ​

❌ エラー：環境変数が反映されない ​

❌ エラー：keep_thinking: true を有効にすると頻繁にエラーが発生する ​

本レッスンのまとめ ​

次のレッスンの予告 ​

付録：ソースコード参照 ​

設定オプションの完全ガイド

学習後にできること

現在の課題

中核となる考え方

設定ファイルの優先順位

設定ファイルの場所

設定オプションの分類

🎒 開始前の準備

実践してみよう

ステップ 1：設定ファイルを作成する

ステップ 2：基本オプションを設定する

ステップ 3：設定を検証する

設定オプションの詳細解説

モデルの動作

keep_thinking

session_recovery

auto_resume

resume_text

web_search

アカウントローテーション

account_selection_strategy

switch_on_first_rate_limit

pid_offset_enabled

quota_fallback

アプリケーション動作

quiet_mode

debug

log_dir

auto_update

高度な設定

エラー復旧

トークン管理

署名キャッシュ（`keep_thinking: true` のとき有効）

ヘルススコア（`hybrid` 戦略で使用）

トークンバケット（`hybrid` 戦略で使用）

推奨設定方案

単一アカウントの設定

2-3 アカウントの設定

複数アカウント + 並列エージェントの設定

よくある落とし穴

❌ エラー：設定変更後に反映されない

❌ エラー：設定ファイルの JSON 形式エラー

❌ エラー：環境変数が反映されない

❌ エラー：`keep_thinking: true` を有効にすると頻繁にエラーが発生する

本レッスンのまとめ

次のレッスンの予告

付録：ソースコード参照