リファレンス環境変数
LLM プロバイダー
LLM プロバイダー (必須 — `minara auth login` で OAuth プロファイルを 使用しない限り、少なくとも 1 つは設定する必要があります)
デフォルトモデルは .env からは読み込まれません — settings.json#model に 保存されます。minara config model use <id>、REPL の /model <id>、 または web UI の Provider & Model ページで変更します。
ANTHROPIC_API_KEY
メインの LLM プロバイダー。
- 制御対象: Agent ループが行うすべての Claude コンプリーションを認証します(src/core/agent-loop.ts → src/llm/anthropic-*.ts)。
- 使用箇所: src/llm/select-provider.ts が Anthropic クライアントパスを選択する際に読み取ります(src/llm/anthropic-api-key.ts / anthropic-oauth.ts 配下の運用ツールも従います)。
- 設定するタイミング: 保存済みの OAuth プロファイルではなく、生の API キーで Agent を実行する場合。https://console.anthropic.com で取得できます。
- 未設定時: Agent は (a)
minara auth login claudeで保存された device-flow OAuth プロファイル、続いて (b) OPENROUTER_API_KEY へフォールバックします。3 つのいずれも利用できない場合、Agent は起動を拒否します。 - 形式: 不透明な文字列。通常は
sk-ant-...で始まります。 - 設定の所在: LLM プロバイダー資格情報(設定 → プロバイダーとモデル)
OPENROUTER_API_KEY
多数のモデルをカバーする代替 LLM ルーター。
- 制御対象: Anthropic の認証情報が存在しない場合、または AGENT_MODEL が OpenRouter のモデルを指定している場合に、OpenRouter 経由でルーティングされるコンプリーションを認証します(src/llm/openrouter.ts)。
- 使用箇所: src/llm/select-provider.ts(セカンダリプロバイダー)。
- 設定するタイミング: OpenRouter 経由で Anthropic 以外のモデル(Llama、DeepSeek、Gemini など)を使って Agent を実行したい場合。
- 未設定時: Anthropic / OAuth のパスのみを試行します。
- 形式:
sk-or-...で始まる不透明な文字列。 - 設定の所在: LLM プロバイダー資格情報(設定 → プロバイダーとモデル)
XAI_API_KEY
ネイティブ xAI(Grok)LLM プロバイダーキー。
- 制御対象:
xai-api-keyLLM プロバイダーを通じて https://api.x.ai/v1 へ直接呼び出します。OpenRouter を経由せず、レイテンシを抑えつつルーターのマークアップを回避します。ネイティブ xAI クライアントは wire レベルで OpenAI 互換です(src/llm/xai-api-key.ts は openai-wire.ts を再利用します)。 - 使用箇所: src/llm/select-provider.ts(xAI は自動選択で最も優先度が低く、他のプロバイダープロファイルや環境変数が存在しない場合にのみ、この環境変数が
xai-api-keyを有効にします)。 - 設定するタイミング: xAI コンソールのキーを持っていて、ネイティブの Grok ルーティングを使いたい場合。
- 未設定時: Grok は OpenRouter 経由でも引き続き利用できます(
x-ai/grok-4)。 - 形式: https://console.x.ai/ から取得する不透明な文字列。
- 設定の所在: LLM プロバイダー資格情報(設定 → プロバイダーとモデル)
KIMI_API_KEY
KIMI_API_KEY:ネイティブ Kimi LLM プロバイダーキー。
- 制御対象: https://api.moonshot.ai/v1 への Kimi チャットおよびモデルカタログ要求を認証します。
- 使用箇所: src/llm/select-provider.ts、src/llm/v2/custom-loaders.ts の
kimi-api-keyローダー、Kimi モデルカタログ取得で使用します。 - 設定するタイミング: Kimi API プラットフォームキーを持ち、OpenRouter 経由ではなく Kimi モデルへ直接接続したい場合。
- 未設定時: Kimi の直接プロバイダーは利用できませんが、別の構成済みアグリゲーターから Kimi モデルを利用できる場合があります。
- 形式: https://platform.kimi.ai/ で作成する不透明な文字列。
- 設定の所在: LLM プロバイダー資格情報(設定 → プロバイダーとモデル)
XAI_BASE_URL
xAI API ベース URL の任意のオーバーライド。
- 制御対象: xai-api-key + xai-oauth クライアントがリクエストを送信する宛先。
- デフォルト: https://api.x.ai/v1
- 設定するタイミング: ステージングエンドポイントやプロキシを対象にする場合。
- 未設定時: 公式の api.x.ai エンドポイントが使われます。
- 設定の所在: ユーザー向け設定ではありません
MINARA_XAI_OAUTH_CLIENT_ID
xAI OAuth の client_id をオーバーライドします。
- 制御対象:
minara auth login xai(OAuth ブラウザフロー)の実行時に、Minara が auth.x.ai へ送信する OAuth 公開 client_id。 - デフォルト: xAI 公式の Grok-CLI 公開 client_id で、Hermes Agent も使用しており、公開ソースに従ってオープンに共有されています。RFC 8252 §8.4 はネイティブアプリ間での公開クライアントの再利用を認めていますが、xAI は予告なく無効化する可能性があります。
- 設定するタイミング: xAI が Minara 専用の登録済み client_id を発行している場合。
- 未設定時: 共有の Grok-CLI id が使われ、最初の
minara auth login xai時に一度だけ stderr 警告が出力されます。 - 形式: UUID 形式の文字列。
- 設定の所在: ユーザー向け設定ではありません
Ollama Cloud
OLLAMA_API_KEY
Ollama Cloud LLM プロバイダーキー。
- 制御対象: Ollama Cloud(https://ollama.com)に対して Agent を認証します。Ollama Cloud は OpenAI 互換のエンドポイント経由でオープンモデル(gpt-oss、deepseek、qwen3-coder、kimi-k2 ……)を提供します。
- 使用箇所: src/llm/v2/custom-loaders.ts(
ollamaローダー)、src/gateway/auth-cli.ts(minara auth login ollama)、src/gateway/model-registry.ts(/api/tagsカタログ取得)。 - 設定するタイミング: Ollama Cloud のモデルを使いたい場合。https://ollama.com/settings/keys でキーを作成します。
- 未設定時:
ollamaプロバイダーは利用できず、Agent は別の構成済みプロバイダーを使います。 - 形式: ollama.com/settings/keys から取得する不透明な文字列。
- 設定の所在: LLM プロバイダー資格情報(設定 → プロバイダーとモデル)
OLLAMA_BASE_URL
Ollama ホストの任意のオーバーライド。
- 制御対象:
ollamaローダー + カタログ取得がリクエストを送信する宛先。セルフホスト / エンタープライズの Ollama サーバー、またはローカルインスタンス(http://localhost:11434)を指定します。 - デフォルト: https://ollama.com(Ollama Cloud)。
- 設定するタイミング: クラウド以外の Ollama ホストを対象にする場合。
- 未設定時: Ollama Cloud が使われます。
- 形式: 絶対 URL、末尾スラッシュなし。
- 設定の所在: ユーザー向け設定ではありません