Astreus

프로바이더

Astreus CLI는 여러 LLM 프로바이더를 지원합니다. 다양한 모델로 에이전트를 테스트하고 사용 사례에 가장 적합한 조합을 찾을 수 있도록 프로바이더 간을 원활하게 전환할 수 있습니다.

Astreus CLI는 여러 LLM 프로바이더를 지원합니다. 다양한 모델로 에이전트를 테스트하고 사용 사례에 가장 적합한 조합을 찾을 수 있도록 프로바이더 간을 원활하게 전환할 수 있습니다.

지원되는 프로바이더

예제는 모델을 명시적으로 선택하며, 계속 지원되는 기존 기본값은 변경되지 않습니다. 네이티브 API에서 지원이 종료된 모델은 현재 사용 가능한 대체 모델을 명시적으로 선택해야 합니다.

기존 CLI는 설치된 프레임워크의 getModelsByProvider에서 모델 선택지를 가져옵니다. 선택지는 계속 openai, claude, gemini, ollama의 네 가지입니다.

OpenAI

GPT 모델에 접근할 수 있는 기본 프로바이더입니다.

export OPENAI_API_KEY="${OPENAI_API_KEY:?Set OPENAI_API_KEY in your environment}"
astreus

명시적으로 선택할 모델 ID:

  • gpt-6-astra
  • gpt-5.6-sol
  • gpt-5.6-terra
  • gpt-5.6-luna

OpenRouter를 통한 무료 호스팅 모델

무료 호스팅 모델에서도 ASTREUS_PROVIDER=openai를 유지하세요. 환경 변수로 OpenRouter 키를 제공하고 모델을 명시적으로 선택하세요. 프레임워크 LLM 가이드와 동일한 요청 속도 제한 및 엔드포인트 요구 사항이 적용됩니다.

export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
export OPENAI_API_KEY="${OPENROUTER_API_KEY:?Set OPENROUTER_API_KEY in your environment}"
ASTREUS_PROVIDER=openai ASTREUS_MODEL=openrouter/free astreus

Anthropic (Claude)

세밀한 대화를 위해 Claude 모델을 사용합니다.

export ANTHROPIC_API_KEY="${ANTHROPIC_API_KEY:?Set ANTHROPIC_API_KEY in your environment}"
ASTREUS_PROVIDER=claude ASTREUS_MODEL=claude-sonnet-5 astreus

명시적으로 선택할 모델 ID:

  • claude-fable-5-1
  • claude-opus-5
  • claude-sonnet-5
  • claude-haiku-4-5-20251001

Google (Gemini)

Google의 Gemini 모델을 사용합니다.

export GEMINI_API_KEY="${GEMINI_API_KEY:?Set GEMINI_API_KEY in your environment}"
ASTREUS_PROVIDER=gemini astreus

사용 가능한 모델:

  • gemini-pro (기본값) - Gemini Pro
  • gemini-pro-vision - 비전 지원

Ollama (로컬 모델)

Ollama로 로컬에서 모델을 실행합니다. API 키가 필요하지 않습니다.

# Make sure Ollama is running
ollama serve

# Start CLI with Ollama
ASTREUS_PROVIDER=ollama astreus

사용 가능한 모델:

  • llama3 (기본값) - Llama 3
  • llama2 - Llama 2
  • mistral - Mistral
  • codellama - 코드 특화 Llama

프로바이더 전환

시작 시

환경 변수를 사용합니다:

ASTREUS_PROVIDER=claude ASTREUS_MODEL=claude-sonnet-5 astreus

세션 중

슬래시 명령어로 전환합니다:

/provider claude
/model claude-sonnet-5

또는 대화형 선택기를 엽니다:

/provider
/model

프로바이더 설정

커스텀 엔드포인트

기업 배포나 프록시 환경을 위한 설정입니다:

# Ollama on different host
export OLLAMA_HOST=http://192.168.1.100:11434

비전 지원

일부 프로바이더는 비전(이미지) 기능을 지원합니다:

# Separate API key for vision (optional)
export OPENAI_VISION_API_KEY=sk-your-vision-key
export ANTHROPIC_VISION_API_KEY=your-vision-key
export GEMINI_VISION_API_KEY=your-vision-key

임베딩 지원

메모리 및 지식 기능을 위한 설정입니다:

export OPENAI_EMBEDDING_API_KEY=sk-your-embedding-key
export GEMINI_EMBEDDING_API_KEY=your-embedding-key

에이전트 개발을 위한 모델 선택

구축하려는 에이전트 유형에 따라 적절한 모델을 선택하세요:

에이전트 유형권장 모델이유
코드 분석 에이전트claude-sonnet-5코드 구조와 패턴을 이해하는 데 뛰어남
복잡한 추론 에이전트gpt-4o, claude-sonnet-5다단계 추론과 계획에 최적
빠른 응답 에이전트gpt-4o-mini, gemini-pro실시간 상호작용을 위한 낮은 지연 시간
도구 중심 에이전트gpt-4o안정적인 함수 호출과 도구 사용
긴 컨텍스트 에이전트claude-sonnet-5큰 문서를 보내기 전에 선택한 모델과 엔드포인트의 컨텍스트 한도를 확인하세요
로컬/프라이빗 에이전트llama3, codellama데이터가 기기 밖으로 나가지 않음
비용 민감 에이전트gpt-3.5-turbo, OllamaAPI 비용 최소화

여러 프로바이더에서 에이전트 테스트하기

에이전트를 구축할 때는 다양한 프로바이더로 테스트해 보는 것이 유용합니다:

# Start developing with fast, cheap model
/provider openai
/model gpt-4o-mini

# Test complex reasoning with top models
/provider claude
/model claude-sonnet-5

# Test locally before deployment
/provider ollama
/model llama3

이 워크플로우를 통해 여러 LLM에서 에이전트가 어떻게 동작하는지 파악하고, 사용 사례에 맞는 성능, 속도, 비용의 최적 균형을 찾을 수 있습니다.

마지막 업데이트: 2026년 9월 13일

이 섹션에서

소개

Astreus 프레임워크로 에이전트를 구축하기 위한 AI 기반 개발 어시스턴트입니다. CLI는 Astreus SDK에 대한 완전한 지식을 바탕으로 터미널에서 바로 AI 에이전트를 생성, 테스트, 반복 개발할 수 있도록 도와줍니다.

설치

몇 분 만에 Astreus CLI를 실행해 보세요. 이 CLI는 Astreus 프레임워크로 에이전트를 구축하기 위한 AI 기반 어시스턴트입니다. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.

이전
명령어
다음
설정