LLM 제공자

LLM 제공자 (필수 — `minara auth login` 으로 OAuth 프로파일을 사용하지 않는 한 최소 하나는 설정해야 합니다)

기본 모델은 .env 에서 읽지 않습니다 — settings.json#model 에 저장됩니다. minara config model use <id>, REPL 의 /model <id>, 또는 웹 UI 의 Provider & Model 페이지에서 변경합니다.

기본 LLM 제공자.

제어 대상: 에이전트 루프가 수행하는 모든 Claude completion 을 인증합니다 (src/core/agent-loop.ts → src/llm/anthropic-*.ts).
사용처: Anthropic 클라이언트 경로를 선택할 때 src/llm/select-provider.ts 에서 사용합니다 (src/llm/anthropic-api-key.ts / anthropic-oauth.ts 아래의 운영 도구도 이를 따릅니다).
설정 시점: 저장된 OAuth 프로필 대신 원시 API 키로 에이전트를 실행할 때 필요합니다. https://console.anthropic.com 에서 발급받으세요.
미설정 시: 에이전트는 (a) minara auth login claude 로 저장된 device-flow OAuth 프로필, 그다음 (b) OPENROUTER_API_KEY 순으로 폴백합니다. 셋 중 어느 것도 사용할 수 없으면 에이전트는 시작을 거부합니다.
형식: 불투명 문자열이며 일반적으로 sk-ant-... 접두사가 붙습니다.
설정 위치: LLM 공급자 자격 증명 (설정 → 공급자 및 모델)

다수의 모델을 아우르는 대체 LLM 라우터.

제어 대상: Anthropic 자격 증명이 없거나 AGENT_MODEL 이 OpenRouter 모델을 지정할 때 OpenRouter (src/llm/openrouter.ts) 를 통해 라우팅되는 completion 을 인증합니다.
사용처: src/llm/select-provider.ts (보조 제공자).
설정 시점: OpenRouter 를 통해 Anthropic 이 아닌 모델(Llama, DeepSeek, Gemini 등)로 에이전트를 실행하려는 경우입니다.
미설정 시: Anthropic / OAuth 경로만 시도합니다.
형식: sk-or-... 로 시작하는 불투명 문자열.
설정 위치: LLM 공급자 자격 증명 (설정 → 공급자 및 모델)

네이티브 xAI (Grok) LLM 제공자 키.

제어 대상: xai-api-key LLM 제공자를 통해 https://api.x.ai/v1 로 직접 호출합니다 — OpenRouter 를 우회하여 지연 시간을 낮추고 라우터 마크업이 없습니다. 네이티브 xAI 클라이언트는 와이어 수준에서 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 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 API 기본 URL 에 대한 선택적 재정의.

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 Cloud LLM 제공자 키.

제어 대상: OpenAI 호환 엔드포인트로 오픈 모델(gpt-oss, deepseek, qwen3-coder, kimi-k2, ...)을 제공하는 Ollama Cloud (https://ollama.com) 에 대해 에이전트를 인증합니다.
사용처: 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 제공자를 사용할 수 없으며, 에이전트는 구성된 다른 제공자를 사용합니다.
형식: ollama.com/settings/keys 에서 발급받는 불투명 문자열.
설정 위치: LLM 공급자 자격 증명 (설정 → 공급자 및 모델)

Ollama 호스트에 대한 선택적 재정의.

제어 대상: ollama 로더 + 카탈로그 페치가 요청을 보내는 위치입니다. 자체 호스팅 / 엔터프라이즈 Ollama 서버나 로컬 인스턴스(http://localhost:11434)를 가리키도록 설정합니다.
기본값: https://ollama.com (Ollama Cloud).
설정 시점: 클라우드가 아닌 Ollama 호스트를 대상으로 하는 경우입니다.
미설정 시: Ollama Cloud 를 사용합니다.
형식: 절대 URL, 끝에 슬래시 없음.
설정 위치: 사용자 대상 설정 아님