BroadRouter
시작하기

코딩 에이전트에서 오픈 모델 쓰기: Aider, Cline, opencode, Codex

BroadNet Inference 팀 · 4분 분량 · 게시 · 업데이트

주요 코딩 에이전트는 모두 사용자 지정 모델에 base URL, API 키, 모델 ID 세 가지 값을 받습니다. Aider는 OPENAI_API_BASE, Cline과 Roo Code는 OpenAI Compatible 제공자, opencode는 사용자 지정 제공자, Continue는 apiBase를 씁니다. Codex CLI는 이제 Responses API만 지원하므로, 채팅 완성 엔드포인트에 연결하려면 LiteLLM 같은 변환 프록시가 필요합니다.

A developer working at a laptop with code on screen, at dusk.

코딩 에이전트는 원래 대형 제공업체 한두 곳에 맞춰 만들어졌지만, 이제는 거의 모두 사용자 지정 OpenAI 호환 엔드포인트를 받습니다. 덕분에 오픈 모델로 에이전트를 돌릴 수 있습니다. 작업당 비용이 더 싸고, 컨텍스트가 더 큰 경우가 많으며, 인프라도 직접 고를 수 있습니다. 이 페이지는 그 지도입니다. 에이전트별 정확한 설정 이름을 정리하고, 단계별 가이드가 있는 경우 링크를 걸었습니다.

제공업체에서 무엇을 받아야 하나요?

아래 모든 에이전트에는 같은 세 가지 값이 필요합니다.

값 BroadNet Inference
Base URL https://inference.broadnet.ai/v1
API 키 종량제 키 또는 플랜 키
모델 ID broadnet/glm-5.3, broadnet/deepseek-v4.1-flash, broadnet/qwen3.8-27b

모든 에이전트에서 중요한 설정이 두 가지 더 있습니다. 컨텍스트 윈도와 최대 출력 토큰입니다. 사용자 지정 모델 ID에 대해서는 에이전트가 이를 알아낼 수 없어 추측합니다. 모델 페이지를 보고 설정하세요.

에이전트별 정확한 설정

에이전트 설정 위치 Base URL 필드 모델 필드 전체 가이드
Aider 환경 변수 OPENAI_API_BASE --model openai/<id> Aider 가이드
Cline 설정, API Provider: OpenAI Compatible Base URL Model Cline 가이드
Roo Code / Zoo Code 설정, API Provider: OpenAI Compatible Base URL Model Roo Code 가이드
opencode opencode.jsonc, providers settings.baseURL models.<key>.modelID opencode 가이드
Continue config.yaml, provider: openai apiBase model Continue 가이드
Codex CLI config.toml, [model_providers.<id>] base_url model 아래 참고

Aider

export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY=your-key
aider --model openai/broadnet/deepseek-v4.1-flash

openai/ 접두사는 Aider에게 OpenAI 호환 경로를 쓰라고 알려 줍니다. Aider가 모델의 컨텍스트 크기를 모른다고 경고할 수 있는데, 목록에 없는 모델이라면 정상입니다.

Cline

API Provider로 OpenAI Compatible을 고른 뒤 Base URL, API Key, Model을 채우세요. Model Configuration을 열어 컨텍스트 윈도와 최대 출력 토큰을 설정하세요. Cline은 Plan 모드와 Act 모드에 서로 다른 모델을 쓸 수 있으므로, 더 비싼 모델은 계획에만 쓰는 식으로 비용을 아낄 수 있습니다.

Roo Code와 Zoo Code

Roo Code의 저장소는 2026년 5월 15일에 아카이브되었고, README에는 확장 프로그램이 종료되었다고 적혀 있습니다. Roo Code 커뮤니티가 시작해 개발을 이어 가는 포크인 Zoo Code와 Cline을 안내합니다. 이미 설치된 Roo Code는 Cline과 같은 OpenAI Compatible 필드를 쓰며, Roo의 변경 로그에 따르면 기존 XML 도구 호출 방식이 제거되었으므로 네이티브 도구 호출이 명시된 모델을 고르세요. Zoo Code는 자체 문서를 따르세요.

opencode

opencode는 opencode.jsonc의 providers 아래에 OpenAI 호환 패키지와 settings.baseURL로 제공자를 추가합니다. BroadNet ID에는 이미 슬래시가 들어 있으므로 glm-5.3 같은 짧은 맵 키를 쓰고, 전체 ID는 modelID에 넣으세요. capabilities와 limit은 직접 설정하세요. 그러지 않으면 opencode가 가정값을 씁니다.

Continue

models:
  - name: GLM 5.3
    provider: openai
    model: broadnet/glm-5.3
    apiBase: https://inference.broadnet.ai/v1
    apiKey: your-key
    capabilities: [tool_use]
    defaultCompletionOptions:
      contextLength: 1048576
      maxTokens: 8000

Continue의 Agent 모드에는 tool_use가 필요합니다. 도구 호출이 없는 모델에서는 빼세요.

Codex CLI

Codex는 config.toml에서 base_url과 env_key로 제공자를 정의합니다. 현재 설정 레퍼런스에 따르면 지원되는 wire_api 값은 responses 하나뿐이며, Codex는 이제 wire_api = "chat"을 오류로 거부합니다. BroadNet Inference는 /v1/chat/completions를 제공하므로 Codex가 직접 호출할 수 없습니다. 우회 방법은 변환 프록시입니다. LiteLLM 문서에 따르면 LiteLLM 프록시는 /v1/responses를 노출하고 이를 채팅 완성으로 연결할 수 있습니다.

  1. BroadNet을 OpenAI 호환 백엔드로 두고 LiteLLM 프록시를 실행한 뒤, LiteLLM의 Responses API 페이지 설명대로 채팅 완성 브리지를 켜세요.
  2. Codex의 base_url을 프록시로 지정하세요.
  3. 짧은 작업으로 테스트하세요. 브리지는 Responses 전용 기능을 누락할 수 있으므로, 도구 호출이 처음부터 끝까지 동작하는지 확인하세요.

연결 작업이 너무 많아 보인다면, opencode와 Aider는 채팅 완성을 기본으로 지원하는 터미널 에이전트입니다.

에이전트보다 엔드포인트를 먼저 테스트하려면 어떻게 하나요?

에이전트가 실패하면 원인이 에이전트인지 엔드포인트인지 구분하기 어렵습니다. 먼저 도구를 하나 제공하는 요청 하나로 엔드포인트만 확인하세요.

curl -s https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"broadnet/glm-5.3","max_tokens":2000,
       "messages":[{"role":"user","content":"Read the file README.md"}],
       "tools":[{"type":"function","function":{"name":"read_file",
         "parameters":{"type":"object","properties":{"path":{"type":"string"}},"required":["path"]}}}]}'

응답에 finish_reason: "tool_calls"와 read_file 호출이 있으면 모델과 키는 정상이고, 남은 문제는 에이전트 설정에 있습니다. 일반 텍스트로 답한다면 도구 기반 에이전트에는 다른 모델을 고르세요. API 요청 빌더가 이 요청을 curl, Python, Node로 대신 작성해 줍니다.

가장 자주 깨지는 부분은 무엇인가요?

  1. 잘못된 모델 ID. broadnet/ 접두사까지 정확히 복사하세요.
  2. 빈 답변. 대형 모델 세 개는 모두 답하기 전에 추론하며, 추론은 출력 한도에 포함됩니다. 한도를 올리세요. 답변이 비어서 돌아오는 이유.
  3. 도구 호출 오류. 도구 호출 지원이 명시된 모델을 쓰세요. BroadNet은 GLM 5.3과 Qwen3.8 27B에 도구 지원을 명시하며, DeepSeek V4.1 Flash에는 명시하지 않습니다. 자세한 내용은 오픈 모델의 도구 호출을 보세요.
  4. 429 오류. 종량제 키는 분당 30 요청, 동시 요청 4개까지 허용합니다. 키 하나로 에디터 창 두 개를 열면 사용량이 합쳐집니다. 오류와 재시도를 보세요.
  5. 기본값이 Responses API. 일부 도구는 OpenAI의 최신 API를 기본으로 씁니다. 가능하다면 채팅 완성으로 바꾸세요.

에이전트별로 어떤 모델을 고를지는 코딩 에이전트에 가장 좋은 오픈 모델에서 다룹니다. 가장 인기 있는 에이전트 세 가지의 차이는 Cline vs Roo Code vs Aider에 있습니다.

BroadNet Inference의 위치

BroadNet Inference는 위의 모든 에이전트에 GLM 5.3, DeepSeek V4.1 Flash, Qwen3.8 27B용 OpenAI 호환 엔드포인트 하나를 데이터 비보관으로 제공합니다. 무제한 플랜을 쓰면 DeepSeek V4.1 Flash가 세션당 월 $60 요금의 정액이 되므로, 하루 종일 돌아가는 Aider 같은 에이전트에 잘 맞습니다. 프록시 없이 Codex CLI에 바로 연결할 수는 없고, 웹 검색 같은 제공업체 측 도구는 호스팅하지 않습니다. inference.broadnet.ai에서 키를 받아 시작하세요.

자주 묻는 질문

Codex CLI를 OpenAI 호환 API와 함께 쓸 수 있나요?

엔드포인트가 Responses API를 지원할 때만 가능합니다. Codex 설정 레퍼런스는 지원되는 wire_api 값으로 responses만 명시합니다. 채팅 완성만 지원하는 제공업체라면 LiteLLM 같은 프록시를 앞에 두세요. LiteLLM 문서에는 /v1/responses를 /v1/chat/completions로 연결하는 방법이 나와 있습니다.

Roo Code는 아직 유지보수되나요?

아니요. GitHub 저장소는 2026년 5월 15일에 아카이브되었고, README에는 확장 프로그램이 종료되었다고 적혀 있습니다. Roo Code 커뮤니티가 시작한 포크라고 소개하는 Zoo Code와 Cline을 안내합니다.

에이전트가 모델을 찾을 수 없다고 하는 이유는 무엇인가요?

모델 ID는 제공업체의 ID와 정확히 일치해야 합니다. BroadNet ID에는 접두사가 붙습니다. 예를 들면 broadnet/glm-5.3 형식입니다. Aider에서는 그 앞에 openai/ 접두사도 붙여야 합니다.

오픈 모델을 쓰면 에이전트가 빈 답변을 돌려주는 이유는 무엇인가요?

추론 모델은 출력 예산의 일부를 생각하는 데 씁니다. 최대 출력 토큰이 작으면 보이는 답변이 시작조차 되지 않습니다. 수천 토큰으로 올리세요.

코딩 에이전트에는 어떤 오픈 모델을 넣어야 하나요?

도구 호출로 작업하는 에이전트라면 GLM 5.3처럼 도구 호출 지원이 명시된 모델을 쓰세요. Aider에는 DeepSeek V4.1 Flash가 잘 맞고, BroadNet 무제한 플랜으로도 쓸 수 있습니다.

Markdown으로 읽기ChatGPT에 질문하기Claude에 질문하기Perplexity에 질문하기