빠른 답변: OpenRouter의 baidu/ernie-5.5-flash-preview:free 엔드포인트를 통해 OpenCode와 Claude Code에서 ERNIE 5.5 Flash를 무료로 실행할 수 있습니다. OpenCode에서는 OpenRouter를 연결하고 "model": "openrouter/baidu/ernie-5.5-flash-preview:free"로 설정하면 됩니다. Claude Code에서는 ANTHROPIC_BASE_URL을 OpenRouter로 지정하고 ERNIE 슬러그를 모델로 고정하면 됩니다. 토큰당 비용은 $0이지만, 크레딧을 구매하지 않은 경우 하루 50회 요청으로 제한됩니다.
코딩 에이전트에게는 이 일일 제한이 핵심입니다. 에이전트는 작업당 한 번의 요청을 보내는 것이 아니라, 단계마다 한 번씩 요청을 보냅니다. 이 가이드에서는 두 에이전트 모두를 설정하고, 무료 할당량 안에서 처리할 수 있는 코딩 작업을 보여주며, 무료 경로가 어디서 한계에 도달하는지 알려드립니다.
아래의 모든 제한 사항은 2026년 11월 12일 기준 OpenRouter 공식 페이지에서 확인한 것입니다.
ERNIE 5.5 Flash Preview란?
ERNIE 5.5 Flash Preview는 2026년 11월 10일에 공개된 바이두의 채팅 및 에이전트 모델입니다. 총 2,800억 개의 파라미터를 가진 희소(sparse) Mixture-of-Experts 모델로, 토큰당 140억 개의 활성 파라미터를 사용하며 1,024,000 토큰의 컨텍스트 윈도우를 갖추고 있습니다. 바이두는 이 모델을 코딩, 에이전트 작업, 딥 리서치에 적합하다고 소개하며, OpenRouter는 도구 호출(tool calling)이 가능한 추론 활성화 모델로 분류하고 있습니다.
또한 Hugging Face에는 사전 학습 전용인 ERNIE 5.5 Flash Base도 공개되어 있지만, 이것은 파인튜닝하거나 직접 서빙할 때 사용하는 모델입니다. 코딩 에이전트가 실제로 통신하는 대상은 Preview 모델입니다. 모델의 전체적인 분석은 ERNIE 5.5 Flash란? 문서를 참고하세요. 이전 세대에서 넘어오는 분이라면 ERNIE 5.1 개요에서 무엇이 달라졌는지 확인할 수 있습니다.
OpenRouter에서 ERNIE 5.5 Flash 무료 한도
OpenRouter의 모델 페이지에는 :free 변형이 입력 $0, 출력 $0으로 표시되어 있으며, 단일 공급자인 바이두 챈펀(Baidu Qianfan)이 서비스를 제공합니다. 요청 속도 제한은 OpenRouter의 제한 문서에서 비롯된 것으로, :free로 끝나는 모든 모델 ID에 적용됩니다.
| 항목 | 값 (2026-11-12 확인) |
|---|---|
| 모델 ID | baidu/ernie-5.5-flash-preview:free |
| 가격 | 입력 $0, 출력 $0 |
| 컨텍스트 윈도우 | 1,024,000 토큰 |
| 분당 요청 수 | 20 |
| 일일 요청 수 (누적 크레딧 구매액 10 미만) | 50 |
| 일일 요청 수 (누적 크레딧 구매액 10 이상) | 1,000 |
| 배후 공급자 수 | 1 (바이두 챈펀) |
에이전트 사용 시 두 가지 세부 사항이 중요합니다. OpenRouter의 가격 페이지에 따르면 실패한 요청도 일일 한도에 포함됩니다. 그리고 계정 크레딧 잔액이 음수가 되면 충전할 때까지 무료 모델이 402 오류로 차단됩니다.
하루 1,000회 등급은 크레딧을 사용한 것이 아니라 구매한 이력이 있어야 적용됩니다.
OpenCode에서 ERNIE 5.5 Flash 설정하기
OpenCode는 OpenRouter를 기본적으로 지원하므로 두 설정 중 더 간단한 쪽입니다. OpenRouter 계정과 OpenRouter 대시보드에서 발급받은 API 키가 필요합니다.
- OpenCode를 설치하거나 업데이트한 후, 프로젝트 폴더에서 실행합니다:
cd your-project
opencode
- OpenRouter를 연결합니다. OpenCode 내에서
/connect를 실행하고 OpenRouter를 선택한 뒤 키를 붙여넣습니다. 실행 전에 환경 변수로 내보낼 수도 있습니다:
export OPENROUTER_API_KEY="sk-or-v1-..."
- 프로젝트 루트의
opencode.json에서 모델을 고정합니다. OpenCode의 공급자 문서에 따르면openrouter/접두사 뒤에 전체 OpenRouter 모델 ID를 사용하라고 명시되어 있습니다:
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/baidu/ernie-5.5-flash-preview:free"
}
/models로 선택을 확인합니다. 목록에 ERNIE가 나타나지 않더라도 설정 파일의 값이 우선 적용되므로,:free를 포함해 슬러그 철자를 확인하세요.
이제 모든 프롬프트가 OpenRouter를 거쳐 ERNIE 5.5 Flash Preview로 전달됩니다. 앞서 다룬 GLM-5.3-Flash OpenCode 가이드나 DeepSeek V4.1 Flash 가이드를 따라해 보셨다면 패턴이 완전히 동일하다는 것을 알 수 있습니다. 슬러그만 바꾸면 됩니다.
Claude Code에서 ERNIE 5.5 Flash 설정하기
Claude Code는 OpenRouter가 Anthropic 호환 Messages 엔드포인트를 제공하기 때문에 OpenRouter와 통신할 수 있습니다. ERNIE 모델 페이지에는 이 모델의 지원 경로로 POST https://openrouter.ai/api/v1/messages가 명시되어 있습니다.
먼저 지원 수준을 분명히 이해해야 합니다. OpenRouter의 Claude Code 통합 가이드는 OpenRouter와 함께 사용하는 Claude Code가 "Anthropic 자체 공급자에서만 작동이 보장되며", Claude Code는 "다른 공급자와는 올바르게 작동하지 않을 수 있다"고 설명합니다. 여기서 ERNIE를 실행하는 것은 문서화된 설정을 통해 가능하지만, 보장된 조합은 아닙니다.
- OpenRouter 문서에 명시된 그대로 셸 프로파일에 연결 변수를 설정합니다:
export OPENROUTER_API_KEY="sk-or-v1-..."
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY="" # 반드시 명시적으로 비워두어야 함
- Claude Code가 사용하는 모든 모델 클래스에 ERNIE를 고정하여, 어느 단계에서도 조용히 유료 Anthropic 모델로 폴백(fallback)하지 않도록 합니다:
export ANTHROPIC_DEFAULT_OPUS_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_SONNET_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="baidu/ernie-5.5-flash-preview:free"
설정을 하나의 프로젝트에만 적용하고 싶다면, 동일한 키를 .claude/settings.json의 env 블록에 넣을 수도 있습니다.
- 셸을 다시 로드하고
claude를 실행한 뒤/status를 실행합니다.Auth token: ANTHROPIC_AUTH_TOKEN과Anthropic base URL: https://openrouter.ai/api가 표시되어야 합니다.ANTHROPIC_API_KEY나 Claude 계정 로그인으로 표시된다면, 환경 변수가 세션에 전달되지 않은 것입니다. /model을 열어 각 클래스가 ERNIE로 지정되었는지 확인한 다음, 첫 프롬프트를 보낸 후 OpenRouter 활동 대시보드에서 모델 열을 확인합니다.
일반적인 Claude Code 설정에 대해서는 Claude Code와 OpenRouter 사용 방법에서 더 자세히 다룹니다.
50회 요청 안에서 처리할 수 있는 실제 코딩 작업
하루 50회 요청으로는 에이전트가 이리저리 헤매게 둘 수 없습니다. "완료"가 어떤 상태인지 이미 알고 있는 범위가 명확한 작업을 주세요. 다음은 작은 저장소에서 잘 작동하는 예시입니다:
In src/routes/orders.ts, GET /orders/:id returns 500 when the order
doesn't exist. Make it return 404 with {"error":"order_not_found"}.
Read only the files you need, make the smallest change, then run
the orders tests with npm test and stop. Don't refactor anything else.
이 형태가 무료 티어에서 잘 작동하는 이유는 다음과 같습니다:
- 파일명을 명시합니다. 에이전트가 저장소 전체 검색을 건너뛰어 여러 번의 요청을 절약합니다.
- 수정 사항을 정의합니다. 상태 코드와 응답 본문이 프롬프트에 포함되어 있어 추가 왕복이 필요 없습니다.
- 범위를 제한합니다. "테스트 실행 후 중단"이라는 지시가 루프를 끝내 에이전트가 계속 다듬는 것을 방지합니다.
이런 작업은 보통 몇 번의 모델 호출로 끝납니다: 라우트 확인, 에러 핸들러 확인, 수정, 테스트 실행, 결과 보고. "orders 모듈 정리해 줘" 같은 막연한 프롬프트는 아무것도 완성되기 전에 하루 할당량을 소진할 수 있습니다.
100만 토큰 컨텍스트 윈도우는 ERNIE가 에이전트에 적합한 또 다른 이유입니다. 긴 스택 트레이스나 OpenAPI 파일 전체를 여러 턴에 나누지 않고 하나의 프롬프트에 넣을 수 있습니다. 모든 요청이 소중할 때는 작은 요청 5번보다 큰 요청 1번이 유리합니다.
Apidog CLI로 ERNIE가 API 테스트를 실행하게 하기
에이전트가 엔드포인트를 수정한 후에는 단위 테스트가 통과했는지뿐 아니라 API가 여전히 의도대로 동작하는지에 대한 증거가 필요합니다. Apidog CLI를 사용하면 같은 에이전트가 팀이 Apidog에 이미 보관 중인 테스트 시나리오를 실행하고, 실패 내역을 읽고, 코드를 수정한 뒤 다시 실행할 수 있습니다. 프롬프트 하나만 작성하면, 명령어는 ERNIE가 실행합니다.
CLI를 설치하고, 로그인한 뒤 에이전트 스킬을 추가합니다:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # 안내가 뜨면 OpenCode 또는 Claude Code를 선택
그다음 에이전트에 다음 프롬프트를 하나 줍니다:
Run the "Orders API" test scenario in Apidog project <projectId> against
the local environment. If any step fails, find the endpoint in this repo
that causes it, fix it, and rerun the scenario until it passes.
Summarize what you changed.
에이전트는 시나리오를 찾아 파싱 가능한 JSON 리포트와 함께 실행하고, 수정 후 다시 실행합니다:
apidog test-scenario list --project <projectId>
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --out-dir ./apidog-reports
# 에이전트가 실패한 라우트를 수정한 후:
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --upload-report
--upload-report 플래그는 실행 요약을 Apidog로 전송하여 팀이 앱에서 확인할 수 있게 합니다. 에이전트가 이전 실행과 비교해야 할 경우 apidog test-report list --project <projectId>로 과거 실행 기록을 불러올 수 있습니다.
다만 비용을 계산해야 합니다. 각 테스트 실행, 리포트 읽기, 코드 수정은 모두 에이전트 단계이므로, 수정-재실행 루프 하나에 모델 요청 10회가 소요될 수 있습니다. 하루 50회 티어에서는 이 루프를 오후 종일 돌리는 것이 아니라 한두 번만 실행하세요. 나머지 플래그들은 Claude Code에서 Apidog CLI 사용 가이드와 apidog run 명령어 레퍼런스에서 다룹니다. Apidog의 Free 플랜은 최대 4명의 팀까지 무료로 사용할 수 있습니다.
무료 경로에 문제가 생길 때
무료 엔드포인트는 단일 공급자 뒤에 있는 프리뷰 모델입니다. 예상되는 문제와 해결 방법을 정리했습니다.
| 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
연속 실행 후 429 발생 |
분당 20회 요청 제한 | 에이전트 속도를 늦추거나 1분 정도 대기 |
이후 하루 종일 429 |
일일 50회 요청 소진 (실패한 요청도 포함) | UTC 초기화를 기다리거나 10 크레딧 구매로 하루 1,000회로 확장 |
무료 모델에서 402 발생 |
계정 잔액 음수 | 크레딧을 추가해 잔액을 0 이상으로 만들기 |
| JSON 출력에서 에이전트 오류 | 구조화된 출력(structured output) 오류 | 일반 텍스트로 요청하고 직접 파싱 |
| Claude Code 기능 오작동 | Claude Code 뒤에 Anthropic이 아닌 모델 사용 | ERNIE는 OpenCode를 사용하거나 모델을 원래대로 되돌리기 |
구조화된 출력 행에는 구체적인 수치가 있습니다. 2026년 11월 12일 기준 OpenRouter 모델 페이지에서 이 엔드포인트의 구조화된 출력 오류율은 21.70%, 도구 호출 오류율은 1.01%로 표시되었습니다. 코딩 에이전트가 의존하는 도구 호출은 양호한 편이지만, 엄격한 JSON 스키마는 그렇지 않으므로 에이전트 워크플로는 도구와 일반 텍스트 위주로 유지하는 것이 좋습니다.
속도도 표면적인 수치와 다릅니다. 바이두는 초당 200토큰 이상을 주장하지만, OpenRouter가 그날 무료 엔드포인트에서 측정한 P50은 초당 79토큰이었습니다.
마지막으로, 이름에 "Preview"가 들어가는 데에는 이유가 있습니다. 모델, 제한 사항, :free 변형은 예고 없이 변경될 수 있습니다. 슬러그가 더 이상 작동하지 않으면 설정을 디버깅하기 전에 OpenRouter 페이지를 먼저 확인하세요. 유료 또는 직접 접근 방법은 ERNIE 5.5 Flash API 가이드에서 바이두 챈펀을 다룹니다.
FAQ
OpenCode에서 ERNIE 5.5 Flash는 정말 무료인가요? 네. OpenRouter에서 baidu/ernie-5.5-flash-preview:free 엔드포인트는 입력 및 출력 토큰당 $0입니다. OpenRouter 크레딧을 최소 10 크레딧 구매하지 않은 경우 분당 20회, 하루 50회 요청으로 제한됩니다.
Claude Code는 ERNIE 5.5 Flash를 공식 지원하나요? 공식적으로는 아닙니다. OpenRouter는 Claude Code를 다른 모델로 연결하는 방법을 문서화하고 있지만, 이 설정은 Anthropic 자체 공급자에서만 작동이 보장된다고 명시합니다. 실행은 되지만 도구 관련해서는 불안정할 수 있으니, ERNIE에는 OpenCode가 더 안전한 선택입니다.
OpenRouter에서 ERNIE 5.5 Flash의 모델 ID는 무엇인가요? 무료 변형은 baidu/ernie-5.5-flash-preview:free입니다. OpenCode에서는 openrouter/ 접두사를 붙이고, Claude Code에서는 ANTHROPIC_DEFAULT_*_MODEL 변수에 그대로 사용합니다.
하루 50회 요청으로 몇 개의 코딩 작업을 처리할 수 있나요? 작업에 따라 다릅니다. 범위가 명확한 수정은 에이전트 단계 5~10회 정도 소요되므로 몇 가지 작업은 처리할 수 있습니다. 개방형 리팩토링은 한 번에 전체 할당량을 소진할 수 있습니다. 프롬프트에 파일명을 명시하고 "완료" 기준을 정의하세요.
100만 토큰 컨텍스트 전체를 무료로 사용할 수 있나요? OpenRouter는 무료 변형에 모델의 전체 윈도우와 동일한 1,024,000 토큰 컨텍스트 윈도우를 명시하고 있습니다. 큰 프롬프트도 여전히 요청 1회로 계산되므로, 긴 컨텍스트 프롬프트는 일일 한도를 효율적으로 사용할 수 있습니다.
OpenRouter 없이 무료로 사용할 방법이 있나요? ERNIE 5.5 Flash 무료 가이드에서 모든 $0 경로를 비교합니다. 바이두는 Hugging Face에 ERNIE 5.5 Flash Base도 공개했으며, vLLM으로 ERNIE 5.5 Flash 로컬 실행하기 문서에서 다루듯 직접 서빙할 수도 있습니다.