revka models, providers, auth

이 페이지에서는 revka CLI의 세 가지 관련 영역을 다룹니다. 프로바이더별 모델 카탈로그를 새로 고치고 확인하는 revka models 그룹, 지원되는 모든 백엔드를 나열하는 revka providers 명령, 그리고 OAuth 및 구독 인증 프로파일(OpenAI Codex, Gemini, Anthropic 구독 토큰 등 프로바이더에 사용되는 자격 증명)을 관리하는 revka auth 그룹입니다.

프로바이더가 현재 제공하는 모델을 확인하거나, 기본 모델을 변경하거나, API 키가 올바르게 동작하는지 확인하거나, 일반 API 키 대신 OAuth로 인증하는 구독 프로바이더에 로그인할 때 이 명령들을 사용합니다.

프로바이더의 개념적 설명 — 전체 카탈로그, 리전 라우팅, 안정성, 커스텀 엔드포인트 — 은 커스텀 프로바이더 & 로컬 LLM과 프로바이더 카탈로그를 참조하세요. config.toml에서 자격 증명을 설정하는 방법은 Config: provider, agent & routing을 참조하세요.

revka models

프로바이더 모델 카탈로그는 각 프로바이더의 models 엔드포인트에서 실시간으로 가져와 디스크에 캐시됩니다. 캐시는 <workspace>/state/models_cache.json에 저장되며 항목은 **12시간 동안 유효(fresh)**한 것으로 간주됩니다. 그 이후에는 오래된(stale) 것으로 표시되지만, 오래된 항목은 삭제되지 않으며 실시간 새로 고침이 실패할 경우 폴백으로 계속 사용됩니다.

revka models refresh

프로바이더의 현재 모델 카탈로그를 가져와 캐시에 씁니다.

revka models refresh                       # refresh the configured default provider
revka models refresh --provider openrouter # refresh a specific provider
revka models refresh --all                 # refresh every live-discovery provider
revka models refresh --force               # ignore the fresh cache and fetch now

플래그	설명
--provider <ID>	새로 고칠 프로바이더를 지정합니다. 기본값은 설정된 default_provider입니다.
--all	실시간 모델 검색을 지원하는 모든 프로바이더를 새로 고칩니다. --provider와 함께 사용할 수 없습니다.
--force	유효한 캐시 항목을 무시하고 강제로 실시간 조회합니다.

--force 없이 새로 고침을 실행하면, 유효한 캐시(12시간 이내) 항목이 있을 경우 네트워크를 호출하지 않고 캐시된 목록을 출력하며, revka models refresh --force --provider <ID>로 즉시 최신 정보를 가져올 수 있다고 안내합니다.

실시간 조회가 실패하거나 프로바이더가 빈 목록을 반환하면, Revka는 가장 최근의 캐시된 카탈로그(오래된 경우에도)를 폴백으로 사용하고 얼마나 오래된 것인지 알려주므로, 프로바이더 일시 장애가 발생해도 모델 목록 없이 작업하는 상황은 발생하지 않습니다.

참고

새로 고침에 사용되는 API 키는 설정과 환경 변수에서 다음 순서로 결정됩니다: api_key → 프로바이더별 환경 변수 → REVKA_API_KEY / API_KEY. 새로 고침 시 인증 오류가 반환된다면 해당 프로바이더에 잘못된 키가 설정된 것입니다.

revka models list

프로바이더의 캐시된 모델 목록을 출력합니다. 이 명령은 캐시만 읽으며 네트워크를 호출하지 않으므로, 캐시가 비어 있다면 먼저 revka models refresh를 실행하세요.

revka models list                     # list cached models for the default provider
revka models list --provider anthropic

현재 설정된 default_model은 *로 표시됩니다. 출력에는 캐시가 작성된 지 얼마나 되었는지도 표시됩니다. 해당 프로바이더의 캐시가 없으면, 실행해야 할 revka models refresh 명령을 안내합니다.

revka models set

config.toml에 새 default_model을 씁니다.

revka models set claude-sonnet-4-20250514

이 명령은 default_model 키를 직접 편집하는 것과 동일한 편의 래퍼입니다. 프로바이더의 형식에 맞는 모델 ID를 사용하세요 — 예를 들어 OpenRouter는 provider/model-name 형식(anthropic/claude-sonnet-4-6)을 사용하고, Anthropic은 모델 ID만 단독으로 사용합니다.

revka models status

기본 프로바이더의 활성 모델 설정과 캐시 유효 상태를 표시합니다.

revka models status

설정된 프로바이더, 모델, 온도(temperature)를 출력하고, 캐시된 모델 수, 캐시 작성 시점, 그리고 유효(fresh)(12시간 이내) 또는 오래됨(stale) 여부를 표시합니다.

실시간 검색을 지원하는 프로바이더

revka models refresh(및 --all)는 쿼리 가능한 모델 카탈로그를 제공하는 프로바이더에서만 동작합니다:

openrouter, openai, openai-codex, anthropic, groq, mistral, deepseek, xai,
together-ai, gemini, ollama, llamacpp, sglang, vllm, osaurus, astrai,
avian, venice, fireworks, novita, cohere, moonshot, glm, zai, qwen, nvidia,
opencode-go

목록에 없는 프로바이더를 새로 고치면 Provider '<id>' does not support live model discovery yet가 반환됩니다. 해당 프로바이더는 revka models set으로 모델을 수동으로 설정하세요.

팁

설정된 모든 프로바이더의 모델 카탈로그를 한 번에 확인하고 각 프로바이더의 인증/연결 상태도 보려면 revka doctor models를 사용하세요. 배포 전에 키가 제대로 동작하는지 확인하는 가장 빠른 방법입니다.

revka providers

지원되는 모든 프로바이더를 정식 ID, 표시 이름, 별칭, 그리고 현재 설정에서 활성화된 프로바이더 표시와 함께 나열합니다.

revka providers

출력에서 활성 프로바이더는 (active)로 표시되고, Ollama와 같이 로컬에서 실행되는 프로바이더는 [local]로 표시됩니다. 두 가지 합성 항목은 항상 표시됩니다:

• custom:<URL> — OpenAI 호환 엔드포인트를 Revka에 연결합니다.
• anthropic-custom:<URL> — Anthropic 호환 엔드포인트를 Revka에 연결합니다.

프로바이더 ID(또는 별칭)는 config.toml의 default_provider 값, revka agent의 -p/--provider 플래그, 또는 REVKA_PROVIDER 환경 변수에 사용합니다. 베이스 URL, 환경 변수, 기능을 포함한 전체 카탈로그는 프로바이더 카탈로그를 참조하세요.

인증 관리

대부분의 프로바이더는 config.toml이나 환경 변수에 설정된 일반 API 키로 인증합니다. 일부 프로바이더는 정적 API 키 없이 OAuth 또는 구독 토큰으로 인증합니다. revka auth 명령은 이러한 자격 증명을 관리합니다.

인증 프로파일은 config.toml과 별도로 ~/.revka/auth-profiles.json(설정 디렉터리 내 단일 암호화 JSON 파일)에 저장되며, 프로바이더와 프로파일 이름(기본값: default)을 키로 사용합니다. 여러 프로파일을 사용하면 예를 들어 개인 구독과 업무 구독을 함께 유지하고 전환할 수 있습니다.

구독/OAuth 프로바이더는 다음과 같습니다:

프로바이더	인증 방식
openai-codex (별칭 codex)	OAuth — 브라우저 또는 디바이스 코드 플로우, 또는 기존 Codex 자격 증명 가져오기
gemini	OAuth 로그인
anthropic	구독 설정 토큰 / 토큰 직접 붙여넣기

각 프로바이더가 요청 시 이 자격 증명을 사용하는 방법은 OAuth & 구독 프로바이더를, 자격 증명 저장에 대해서는 시크릿, 페어링 & 디바이스 인증을 참조하세요.

revka auth login

구독 프로바이더의 OAuth 로그인을 시작합니다.

revka auth login --provider openai-codex
revka auth login --provider openai-codex --device-code
revka auth login --provider openai-codex --import ~/.codex/auth.json
revka auth login --provider gemini --profile work

플래그	설명
--provider <ID>	인증할 프로바이더 (예: openai-codex, gemini). 필수입니다.
--profile <NAME>	자격 증명을 저장할 프로파일 이름. 기본값: default.
--device-code	리다이렉트 플로우 대신 OAuth 디바이스 코드 플로우를 사용합니다. 헤드리스 호스트에서 유용합니다.
--import <PATH>	새 로그인 대신 기존 auth.json을 가져옵니다. 현재 openai-codex만 지원하며, 기본 경로는 ~/.codex/auth.json입니다. --device-code와 함께 사용할 수 없습니다.

기본(비디바이스 코드) 플로우는 브라우저를 열어 권한을 부여한 뒤 리다이렉트를 캡처하여 완료합니다. 브라우저를 사용할 수 없는 환경에서는 --device-code를 사용하거나 revka auth paste-redirect로 리다이렉트를 수동으로 완료하세요.

revka auth paste-redirect

프로바이더가 반환한 리다이렉트 URL(또는 원시 인증 코드)을 붙여넣어 OAuth 로그인을 완료합니다 — 브라우저 리다이렉트가 자동으로 캡처되지 않을 때 사용합니다.

revka auth paste-redirect --provider openai-codex --input "<URL_OR_CODE>"

플래그	설명
--provider <ID>	인증 중인 프로바이더.
--profile <NAME>	프로파일 이름. 기본값: default.
--input <URL_OR_CODE>	전체 리다이렉트 URL 또는 원시 OAuth 코드. 생략하면 입력을 요청합니다.

revka auth paste-token

구독 또는 설정 토큰을 직접 저장합니다 — API 키 대신 토큰 값을 직접 제공하는 Anthropic 구독 인증에 사용합니다.

revka auth paste-token --provider anthropic --token "<VALUE>"
revka auth paste-token --provider anthropic --auth-kind api-key

플래그	설명
--provider <ID>	프로바이더 (예: anthropic).
--profile <NAME>	프로파일 이름. 기본값: default.
--token <VALUE>	토큰 값. 생략하면 대화형으로 입력을 요청합니다(셸 히스토리에 기록되지 않음).
--auth-kind <KIND>	토큰 전송 방식을 재정의합니다: authorization 또는 api-key.

주의

토큰은 민감한 자격 증명입니다. 셸 히스토리에 남지 않도록 --token을 생략하고 대화형 프롬프트를 사용하는 것을 권장하며, 온보딩 시 시크릿 암호화를 활성화하여 저장된 자격 증명을 보호하세요.

revka auth setup-token

paste-token의 대화형 별칭으로, Anthropic 구독 설정 토큰 플로우를 위해 설계되었습니다.

revka auth setup-token --provider anthropic

동일한 --provider 및 --profile 플래그를 사용하며, 토큰 값 입력을 요청합니다.

revka auth refresh

저장된 갱신 토큰(refresh token)으로 액세스 토큰을 갱신합니다. openai-codex와 gemini에서 지원합니다.

revka auth refresh --provider openai-codex
revka auth refresh --provider openai-codex --profile work
revka auth refresh --provider gemini

플래그	설명
--provider <ID>	토큰을 갱신할 프로바이더.
--profile <NAME_OR_ID>	프로파일 이름 또는 전체 프로파일 ID. 선택 사항.

장기 실행 배포 환경에서는 토큰이 자동으로 갱신되며, 이 명령은 수동으로 강제 갱신할 때 사용합니다.

revka auth use

여러 프로파일을 유지할 때 특정 프로바이더의 활성 프로파일을 전환합니다.

revka auth use --provider openai-codex --profile work

플래그	설명
--provider <ID>	전환할 프로바이더.
--profile <NAME>	활성화할 프로파일 이름 또는 전체 프로파일 ID.

revka auth logout

저장된 인증 프로파일을 삭제합니다.

revka auth logout --provider openai-codex
revka auth logout --provider openai-codex --profile work

플래그	설명
--provider <ID>	로그아웃할 프로바이더.
--profile <NAME>	삭제할 프로파일. 기본값: default.

revka auth list

모든 프로바이더에 걸쳐 저장된 인증 프로파일을 나열합니다.

revka auth list

revka auth status

프로바이더별 활성 프로파일과 각 토큰의 만료 시점을 표시합니다.

revka auth status

현재 적용 중인 구독 자격 증명과 만료가 임박한 토큰이 있는지 확인할 때 사용합니다.

관련 페이지

• 커스텀 프로바이더 & 로컬 LLM — Ollama, llama.cpp, 커스텀 엔드포인트 연결 방법.
• 프로바이더 카탈로그 — 프로바이더 ID, 베이스 URL, 기능 전체 표.
• OAuth & 구독 프로바이더 — Codex, Gemini, Claude Code 등의 인증 방식.
• Config: provider, agent & routing — 이 명령들의 기반이 되는 config.toml 키.
• revka doctor, status & self-test — revka doctor models로 모델 카탈로그 확인 및 키 유효성 검사.
• revka agent — 세션별 프로바이더 및 모델 재정의.