프로바이더 및 키

stepper는 다섯 가지 AI 프로바이더를 지원합니다. API 키는 명시적 설정, 환경 변수, 또는 OS 키링을 통해 구성할 수 있습니다. 우선순위가 중요하며, 각 프로바이더마다 인증 요구 사항이 다릅니다.

지원하는 프로바이더

• ollama-cloud — Ollama 클라우드 모델
• oMLX — localhost:8000/v1에서 동작하는 로컬 Apple-Silicon MLX. 인증은 선택 사항입니다
• OpenAI — OpenAI API
• Anthropic — Anthropic Claude 모델
• Codex — OAuth를 통한 ChatGPT

키 우선순위

stepper는 다음 순서로 API 키를 찾습니다: 설정의 명시적 apiKey → 환경 변수 → OS 키링. 가장 먼저 일치하는 것이 적용됩니다.

환경 변수로 키 설정하기

STEPPER_<PROVIDER>_API_KEY 규칙을 사용합니다. 여기서 프로바이더 이름은 대문자로 바꾸고 하이픈은 밑줄로 대체합니다.

# Env var: STEPPER_<PROVIDER>_API_KEY  (provider uppercased, '-' → '_')
export STEPPER_ANTHROPIC_API_KEY=sk-ant-...
export STEPPER_OLLAMA_CLOUD_API_KEY=...

OS 키링에 키 저장하기

keyring 명령으로 키를 안전하게 저장하고 관리합니다. 키링은 시스템의 자격 증명 관리자(macOS의 Keychain, Linux의 secret-service, Windows의 Credential Manager)에 키를 저장합니다.

# Store a key (prompts for the key on stdin):
stepper auth set-key <provider>

# Remove a key:
stepper auth delete-key <provider>

Codex (ChatGPT) OAuth

Codex 프로바이더(ChatGPT)를 사용하려면 OAuth로 인증합니다. 이 과정에서 브라우저가 열리고 자격 증명이 로컬에 저장됩니다.

# Codex (ChatGPT) OAuth — opens a browser, stores ~/.stepper/codex-auth.json (0600):
stepper auth login --codex

oMLX 로컬 설정

localhost에서 동작하는 oMLX는 보통 API 키가 필요 없어, 외부 의존성 없는 로컬 개발에 이상적입니다.