---
title: "goose 커스텀 OpenAI 호환 제공자 설정 | BroadRouter"
description: "goose AI 에이전트를 BroadNet Inference에 OpenAI Compatible 커스텀 제공자로 연결합니다. goose Desktop, goose configure, JSON 파일 세 가지 방법을 다룹니다."
url: https://broadrouter.com/ko/guides/goose-custom-provider/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/guides/goose-custom-provider/) (2026-11-16 업데이트).

# goose에 BroadNet Inference를 커스텀 제공자로 추가하기

업데이트 2026-11-16

goose에서 유형이 OpenAI Compatible인 커스텀 제공자를 추가하고, API URL은 https://inference.broadnet.ai/v1/chat/completions, 키는 BroadNet 키, 사용 가능 모델은 broadnet/glm-5.3 등으로 지정하세요. goose Desktop의 Add Custom Provider 버튼, 터미널의 goose configure, 또는 ~/.config/goose/custom\_providers/ 안의 JSON 파일을 쓰면 됩니다. goose는 도구 호출에 의존하므로 GLM 5.3이나 Qwen3.8 27B로 시작하세요.

goose는 데스크톱 앱과 CLI를 갖춘 오픈 소스 AI 에이전트입니다. 기본 내장되지 않은 서비스는 **커스텀 제공자**로 추가하며, goose는 OpenAI 호환 제공자를 지원합니다. BroadNet Inference는 표준 chat completions를 제공하므로 이 방식으로 연결됩니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 아래 단계는 goose 1.59 기준 [goose 제공자 문서](https://goose-docs.ai/docs/getting-started/providers/)를 따릅니다.

goose 문서는 goose가 “extensively uses tool calling”(번역: 도구 호출을 광범위하게 사용함)이라고 경고하며, 도구 호출이 없는 모델은 모든 확장을 끈 상태에서 채팅만 할 수 있다고 설명합니다. BroadNet은 도구 호출을 GLM 5.3과 Qwen3.8 27B에 표기하므로, 에이전트 작업에는 둘 중 하나를 쓰세요.

## 방법 1: goose Desktop

1.  사이드바를 열고 **Settings**를 클릭한 다음 **Models** 탭으로 가세요.
    
2.  **Configure providers**를 클릭하고, 아래쪽의 **Add Custom Provider**를 클릭하세요.
    
3.  세부 정보를 입력하세요.
    
    | 필드 | 값 |
    | --- | --- |
    | Provider Type | **OpenAI Compatible** |
    | Display Name | BroadNet Inference |
    | API URL | `https://inference.broadnet.ai/v1/chat/completions` |
    | API Key | BroadNet 키 |
    | Available Models | `broadnet/glm-5.3, broadnet/qwen3.8-27b` |
    | Streaming Support | 켬 |
    
4.  **Create Provider**를 클릭한 뒤, 이 제공자와 모델을 선택하세요.
    

## 방법 2: goose CLI

`goose configure`를 실행하고 **Custom Providers**, 이어서 **Add A Custom Provider**를 고른 뒤, 프롬프트에 같은 값을 입력하세요. API 유형은 OpenAI Compatible, API URL은 위와 같고, 인증은 **Yes**로 해서 고정 API 키를 쓰며, 모델 목록은 쉼표로 구분하고, 스트리밍은 켭니다.

## 방법 3: JSON 파일

`~/.config/goose/custom_providers/broadnet.json` 파일을 만드세요(Windows에서는 `%APPDATA%\Block\goose\config\custom_providers\` 폴더).

```json
{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
```

그다음 이 제공자로 세션을 시작하세요.

```bash
export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet
```

키는 환경 변수에만 있으므로, 이 파일은 팀용 저장소에 그대로 넣어도 됩니다.

## 테스트

“what can you do?” 같은 간단한 질문부터 해 보세요. 답이 오면 연결이 된 것입니다. 그다음 켜 둔 확장 중 하나가 필요한 작업을 요청하세요. goose가 도구를 호출하면 도구 호출도 작동하는 것입니다. 텍스트로만 답하고 도구를 전혀 호출하지 않는다면 `broadnet/glm-5.3` 모델로 바꾸세요.

## goose의 가격 표시

JSON 파일의 각 모델에 토큰당 USD 단위의 `input_token_cost`와 `output_token_cost`가 있으면 goose가 비용을 추정할 수 있습니다. BroadNet [가격 페이지](https://broadrouter.com/ko/pricing/)의 100만 토큰당 가격을 1,000,000으로 나눈 값을 넣으세요. 두 필드가 모두 없으면 goose는 자체 카탈로그 가격을 쓰는데, 이 값은 BroadNet 가격과 다를 수 있습니다.

## 문제 해결

-   **401.** 키가 틀렸거나 만료되었거나 사용 가능 금액이 소진되었습니다. 또는 goose를 실행하는 셸에 `BROADNET_API_KEY`가 설정되지 않았습니다.
-   **404.** API URL이 `https://inference.broadnet.ai/v1/chat/completions` 형태인지 확인하세요. 모델 ID가 BroadNet ID와 정확히 일치하는지도 확인하세요. 유료 모델은 충전이 필요하며, 초기 크레딧($5 상당)으로는 `broadnet/gemma-4-26b-a4b` 모델과 Transcribe 모델 두 개만 쓸 수 있으며, Gemma의 32,768 토큰 컨텍스트는 에이전트 작업에는 작습니다.
-   **빈 답변.** DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B에서는 추론도 출력 한도에 포함됩니다. [답변이 비어서 오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **429.** 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.
-   **플랜 키 하나로 goose 세션 두 개를 돌리면 요청이 대기하거나 실패함.** [플랜 세션](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)은 한 번에 요청 하나만 처리하므로, goose 세션마다 별도의 플랜 세션을 쓰세요.

## 이 가이드의 용어

[종량제(Pay-as-you-go)](https://broadrouter.com/ko/glossary/pay-as-you-go/)

종량제(pay-as-you-go)는 구독이나 최소 약정 없이 토큰, 요청, 오디오 분 같은 단위로 사용량을 측정해 쓴 만큼만 내는 요금 방식입니다. 대부분의 LLM API가 선불 잔액에서 차감하거나 정기 청구서를 발행하는 식으로 이렇게 과금합니다.

[AI 에이전트(AI agent)](https://broadrouter.com/ko/glossary/agent/)

AI 에이전트는 언어 모델이 목표를 향해 스스로 단계를 정하는 시스템입니다. 어떤 도구를 호출할지 결정하고, 결과를 읽고, 최종 답변을 내거나 한도에 닿을 때까지 이를 반복합니다. 정해진 지점에서 모델을 호출하는 고정된 스크립트는 보통 워크플로라고 부릅니다.

[도구 호출(tool calling)](https://broadrouter.com/ko/glossary/tool-calling/)

도구 호출(tool calling)은 함수 호출(function calling)이라고도 하며, 모델이 개발자가 정의한 함수를 실행해 달라는 구조화된 요청을 JSON 인자와 함께 반환하는 LLM API 기능입니다. 함수는 애플리케이션이 실행하고 그 결과를 다시 보냅니다. 모델이 직접 코드를 실행하지는 않습니다.

[동시 처리(concurrency)](https://broadrouter.com/ko/glossary/concurrency/)

동시 처리(concurrency)는 클라이언트가 같은 시점에 진행 중인 요청 수입니다. LLM API는 분당 요청 수와 별도로 키나 플랜마다 이를 제한하는 경우가 많습니다. 열려 있는 요청은 응답이 끝날 때까지 GPU 용량을 차지하기 때문입니다.

[속도 제한(rate limit)](https://broadrouter.com/ko/glossary/rate-limit/)

속도 제한(rate limit)은 API가 일정 시간 동안 클라이언트가 사용할 수 있는 양에 두는 상한으로, 분당 요청 수나 분당 토큰 수 같은 기준이 있습니다. 한도를 넘은 요청은 사용량이 다시 한도 아래로 내려갈 때까지 거부되며, 보통 HTTP 429 Too Many Requests가 반환됩니다.

[스트리밍(streaming)](https://broadrouter.com/ko/glossary/streaming/)

스트리밍은 언어 모델의 응답을 마지막에 한 번에 돌려주는 대신, 아직 생성 중일 때 작은 청크로 나눠 돌려주는 방식입니다. OpenAI 호환 API는 요청에서 stream을 true로 설정하면 서버 전송 이벤트(SSE)로 스트리밍합니다.

[API 키(API key)](https://broadrouter.com/ko/glossary/api-key/)

API 키는 API를 호출하는 클라이언트를 식별하고 승인하는 비밀 문자열입니다. LLM API는 보통 이 키를 Authorization: Bearer 헤더로 받으며, 키를 가진 사람은 누구나 키 소유 계정으로 과금되는 요청을 보낼 수 있습니다.

[OpenAI 호환 API(OpenAI-compatible API)](https://broadrouter.com/ko/glossary/openai-compatible-api/)

OpenAI 호환 API는 POST /v1/chat/completions처럼 OpenAI API와 같은 요청 및 응답 형식을 받는 HTTP API입니다. 그래서 OpenAI SDK와 도구는 base URL, API 키, 모델 이름만 바꾸면 이 API를 그대로 사용할 수 있습니다.

## 자주 묻는 질문

### goose의 API URL은 /v1로 끝나야 하나요, /v1/chat/completions로 끝나야 하나요?

goose의 커스텀 제공자 예시가 chat completions 전체 URL을 쓰므로 https://inference.broadnet.ai/v1/chat/completions를 쓰세요. 그래야 goose가 BroadNet이 제공하는 chat completions를 계속 사용합니다.

### goose에는 어떤 BroadNet 모델이 가장 잘 맞나요?

GLM 5.3(broadnet/glm-5.3)입니다. goose 문서는 goose가 도구 호출을 많이 쓴다고 하며, BroadNet은 도구를 GLM 5.3과 Qwen3.8 27B에만 표기합니다.

### BroadNet 무제한 플랜으로 goose를 쓸 수 있나요?

플랜은 DeepSeek V4.1 Flash만 제공하며, BroadNet 문서에는 이 모델의 도구 호출이 표기되어 있지 않습니다. goose는 도구 호출이 없는 모델은 확장을 모두 끈 상태에서 채팅만 할 수 있다고 하므로, 한 달 플랜을 사기 전에 테스트해 보세요.

### goose는 API 키를 어디에 저장하나요?

시스템 키체인에 저장하며, 키링이 꺼져 있으면 secrets.yaml에 저장합니다. JSON 파일 방식에서는 api\_key\_env에 지정한 환경 변수에서 키를 읽습니다.

## 관련 가이드

-   [Kilo Code에서 BroadNet Inference 쓰기(OpenAI Compatible 제공자)](https://broadrouter.com/ko/guides/kilo-code-openai-compatible/)
-   [opencode에 BroadNet Inference를 커스텀 제공자로 추가하기](https://broadrouter.com/ko/guides/opencode-custom-provider/)
-   [에이전트용 무제한 LLM API 플랜은 어떻게 작동하나요?](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)
-   [BroadNet Inference 오류 코드와 재시도해야 하는 경우](https://broadrouter.com/ko/guides/errors-and-retries/)
-   [BroadNet Inference와 함께 쓸 수 있는 모든 도구 (영어)](https://broadrouter.com/integrations/): SDK, 코딩 에이전트, 채팅 UI, 자동화 도구와 각 도구의 정확한 설정

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-goose-custom-provider&utm_content=page-cta) ·

**출처**

-   [goose 문서, Model providers 및 Configure Custom Provider(2026-11-15 확인)](https://goose-docs.ai/docs/getting-started/providers/)
-   [GitHub의 goose(aaif-goose/goose), 최신 v1.59.1(2026-11-15 확인)](https://github.com/aaif-goose/goose)
-   [BroadNet Inference API 레퍼런스(2026-11-15 확인) (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-goose-custom-provider&utm_content=sources)
