모델 역할
하나의 클라이언트에 메인 루프, 서브에이전트, 백그라운드 호출용 세 모델을 지정하고 제공업체를 자유롭게 조합하세요.
코딩 에이전트는 한 종류의 호출만 하지 않습니다. 세 종류의 호출을 하며, 이어지는 각 페이지에서는 특정 클라이언트에서 각각을 어디에 설정하는지 보여 줍니다.
| 역할 | 여기서 실행되는 작업 | 중요한 이유 |
|---|---|---|
| 메인 루프 | 대화 중인 모델 | 품질의 대부분을 좌우함 |
| 서브에이전트 | 작업이 분산되는 병렬 워커 | 토큰의 대부분을 사용함 |
| 백그라운드 | 제목, 요약, 파일 설명 | 작지만 지속적이며 과도한 비용을 지불하기 쉬움 |
백그라운드 호출은 거의 모든 상호작용에서 발생하지만 눈에 보이지 않습니다. 이 슬롯에 프런티어 모델을 그대로 두는 것은 에이전트 기반 코딩에서 가장 비용이 많이 드는 기본 설정입니다.
한 번에 세 가지 모두 설정하기
npx @webway/connect --key $WEBWAY_API_KEY
이 명령은 사용자의 카탈로그를 읽고 설치된 클라이언트를 감지한 다음, 각 클라이언트에
필요한 구성을 출력합니다. --write를 추가하기 전까지는 아무것도 기록하지 않습니다.
npx @webway/connect --main <expensive> --sub <mid> --fast <cheap> --write
npx @webway/connect --models # what your key can reach
기존 구성 파일은 교체되지 않고 병합됩니다.
각 클라이언트의 설정 위치
모든 클라이언트가 세 역할을 모두 분리하는 것은 아닙니다. 분리하지 않는 클라이언트에서는 메인 루프 모델이 모든 작업을 실행합니다.
| 클라이언트 | 메인 루프 | 서브에이전트 | 백그라운드 |
|---|---|---|---|
| Claude Code | ANTHROPIC_DEFAULT_OPUS_MODEL |
ANTHROPIC_DEFAULT_SONNET_MODEL 또는 에이전트 프런트매터의 model: |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
| Codex CLI | model |
[profiles.*] 블록, --profile로 선택 |
동일 |
| OpenClaw | agents.defaults.model.primary |
agents 아래의 에이전트별 항목 |
agents 아래의 에이전트별 항목 |
| Hermes | hermes model |
— | — |
| TRAE SOLO | 선택한 사용자 지정 모델 | — | — |
| OpenAI 및 Anthropic SDK | model 인수 |
— | — |
Claude Code가 가장 명확한 사례입니다. 세 개의 ANTHROPIC_DEFAULT_* 변수는 바로
이 세 역할에 해당하며, Haiku 슬롯은 Claude Code의 백그라운드 작업에 사용됩니다.
제공업체 조합하기
세 모델이 모두 한 제공업체에서 나올 필요는 없습니다. 모든 엔드포인트에서 모든 모델에 접근할 수 있으므로, 한 프로토콜만 사용하는 클라이언트에서도 메인 루프는 한 제공업체의 모델로, 서브에이전트는 다른 제공업체의 모델로 실행할 수 있습니다.
npx @webway/connect claude-code \
--main anthropic/claude-opus-5 \
--sub openai/gpt-5.6-terra \
--fast deepseek/deepseek-v4-flash --write
Claude Code는 전체 과정에서 Anthropic Messages를 사용합니다. Webway는 Anthropic으로 전송되지 않는 두 요청을 변환합니다. 이에 드는 비용은 프로토콜 변환에서 확인하세요.