LLMプロバイダーの設定
SpecForgeには、自然言語による仕様生成やエラー説明などのLLMベースの機能が含まれています。これらの機能を使用するには、LLMプロバイダーを設定する必要があります。
サポートされているプロバイダー
SpecForgeは現在、以下のLLMプロバイダーをサポートしています：
- OpenAI
- APIキーはplatform.openai.com/api-keysから取得します。
- Gemini
- APIキーはai.google.dev/gemini-api/docs/api-keyから取得します。
- Anthropic
- APIキーはplatform.claude.com/docs/en/api/admin/api_keys/retrieveから取得します。
- Ollama
- docs.ollama.com/quickstartからOllamaをインストールして実行します。
設定方法
VS Code UIでの設定
- LLMプロバイダーとモデルは、それぞれVS Codeの設定の
specforge.llmProviderとspecforge.llmModelから設定できます。 - VS Codeの拡張機能設定で
specforge.apiKeySource設定がvscodeに設定されていることを確認してください。 - コマンドパレットから
SpecForge: Configure API Key for LLM Providerコマンドを実行します。これにより、選択したプロバイダーのAPIキーの入力を求められます。キーはVS Codeのシークレットストレージに安全に保存されます。
環境変数での設定（Windows、macOS、Linux）
SpecForgeは環境変数を読み取ってLLMプロバイダーを設定します。
- VS Codeの拡張機能設定で
specforge.apiKeySource設定がenvに設定されていることを確認してください。 - SpecForgeサーバーを起動する前に、次の環境変数を設定します：
OpenAI
# Linux / macOS
export SPECFORGE_LLM_PROVIDER=openai
export SPECFORGE_LLM_MODEL=gpt-5-nano-2025-08-07
export OPENAI_API_KEY=your-api-key-here
# Windows PowerShell
$env:SPECFORGE_LLM_PROVIDER="openai"
$env:SPECFORGE_LLM_MODEL="gpt-5-nano-2025-08-07"
$env:OPENAI_API_KEY="your-api-key-here"
APIキーはplatform.openai.com/api-keysから取得できます。
Gemini
# Linux / macOS
export SPECFORGE_LLM_PROVIDER=gemini
export SPECFORGE_LLM_MODEL=gemini-2.5-flash
export GEMINI_API_KEY=your-api-key-here
# Windows PowerShell
$env:SPECFORGE_LLM_PROVIDER="gemini"
$env:SPECFORGE_LLM_MODEL="gemini-2.5-flash"
$env:GEMINI_API_KEY="your-api-key-here"
APIキーはai.google.dev/gemini-api/docs/api-keyから取得できます。
Anthropic
# Linux / macOS
export SPECFORGE_LLM_PROVIDER=anthropic
export SPECFORGE_LLM_MODEL=claude-haiku-4-5
export ANTHROPIC_API_KEY=your-api-key-here
# Windows PowerShell
$env:SPECFORGE_LLM_PROVIDER="anthropic"
$env:SPECFORGE_LLM_MODEL="claude-haiku-4-5"
$env:ANTHROPIC_API_KEY="your-api-key-here"
APIキーはplatform.claude.com/docs/en/api/admin/api_keys/retrieveから取得できます。
Ollama
まず、docs.ollama.com/quickstartからOllamaをインストールして実行します。
次に、環境変数を設定します：
# Linux / macOS
export SPECFORGE_LLM_PROVIDER=ollama
export SPECFORGE_LLM_MODEL=your-model-name # 例：llama3.2、mistral
export OLLAMA_API_BASE=http://127.0.0.1:11434
# Windows PowerShell
$env:SPECFORGE_LLM_PROVIDER="ollama"
$env:SPECFORGE_LLM_MODEL="your-model-name" # 例：llama3.2、mistral
$env:OLLAMA_API_BASE="http://127.0.0.1:11434"
Ollamaサーバーが別のマシンで実行されている場合は、OLLAMA_API_BASEを変更してください。
デフォルトモデル
SPECFORGE_LLM_MODEL変数を設定しない場合：
- OpenAI： デフォルトは
gpt-5-nano-2025-08-07 - Gemini： デフォルトは
gemini-2.5-flash - Anthropic： デフォルトは
claude-haiku-4-5 - Ollama： モデルを指定する必要があります（デフォルトなし）
LLM設定なしの場合
適切なLLMプロバイダー設定がない場合、LLMベースのSpecForge機能は利用できません。SpecForgeの残りの部分は通常どおり動作し続けます。