코딩 에이전트는 원래 대형 제공업체 한두 곳에 맞춰 만들어졌지만, 이제는 거의 모두 사용자 지정 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를 노출하고 이를 채팅 완성으로 연결할 수 있습니다.
- BroadNet을 OpenAI 호환 백엔드로 두고 LiteLLM 프록시를 실행한 뒤, LiteLLM의 Responses API 페이지 설명대로 채팅 완성 브리지를 켜세요.
- Codex의
base_url을 프록시로 지정하세요. - 짧은 작업으로 테스트하세요. 브리지는 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로 대신 작성해 줍니다.
가장 자주 깨지는 부분은 무엇인가요?
- 잘못된 모델 ID.
broadnet/접두사까지 정확히 복사하세요. - 빈 답변. 대형 모델 세 개는 모두 답하기 전에 추론하며, 추론은 출력 한도에 포함됩니다. 한도를 올리세요. 답변이 비어서 돌아오는 이유.
- 도구 호출 오류. 도구 호출 지원이 명시된 모델을 쓰세요. BroadNet은 GLM 5.3과 Qwen3.8 27B에 도구 지원을 명시하며, DeepSeek V4.1 Flash에는 명시하지 않습니다. 자세한 내용은 오픈 모델의 도구 호출을 보세요.
- 429 오류. 종량제 키는 분당 30 요청, 동시 요청 4개까지 허용합니다. 키 하나로 에디터 창 두 개를 열면 사용량이 합쳐집니다. 오류와 재시도를 보세요.
- 기본값이 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에서 키를 받아 시작하세요.

