goose

Settings → Models → Configure providers → OpenAI: Host URL에는 기본 오리진만 입력하세요. goose가 요청 경로(v1/chat/completions)를 자체적으로 추가합니다.

# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com
Organization ID   (leave blank)
Project           (leave blank)

# …or as environment variables, which goose CLI reads too:
OPENAI_API_KEY=sk-kn-...
OPENAI_HOST=https://api.kunavo.com

# OPENAI_BASE_PATH is left unset on purpose. Its default is
# v1/chat/completions, which is the path Kunavo serves — that default is
# exactly why Host URL above carries no /v1.

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. goose Desktop에서: 사이드바 → 설정 → 모델 → 제공자 구성 → OpenAI. CLI에서: goose configure → 제공자 구성 → OpenAI.
3. API 키와 Host URL을 입력하세요. Organization ID와 Project는 비워 두세요. goose는 이 항목을 OpenAI 자체 계정의 사용량 추적과 리소스 관리에 사용하도록 문서화했으며, Kunavo에는 여기에 입력할 대응 항목이 없습니다. 제출을 클릭하세요.
4. 모델을 선택하세요. goose는 goose configure가 “사용자 지정 모델 이름 입력을 지원하지 않는다”고 명시합니다. 원하는 ID가 반환된 목록에 없다면 goose Desktop에서 직접 입력하거나 config.yaml에서 GOOSE_MODEL를 설정하세요. 이 값은 해당 프로세스의 파일 설정을 덮어씁니다.
5. 세션을 시작하고 파일에 접근하는 작업을 지정하세요. goose는 거의 모든 작업에서 도구 호출을 사용합니다. 자체 제공자 페이지에는 도구 호출을 지원하지 않는 모델은 “채팅 완료만 수행할 수 있다”고 명시되어 있으며, 이 경우 확장 기능을 비활성화해야 합니다. 따라서 첫 실행 때는 인사말보다 파일을 읽고 수정하는 작업으로 더 많은 것을 확인할 수 있습니다.

goose의 LLM 제공자 구성 페이지에서 확인했습니다(2026년 9월 29일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 goose에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

다른 방법: Kunavo 제공자 파일

goose는 custom_providers 디렉터리의 JSON 파일에서도 제공자 정의를 불러옵니다. 이 방식으로 추가한 제공자는 OpenAI라는 슬롯을 재사용하지 않고 선택기에 별도 항목으로 표시되며, 자체 키와 저장된 모델 목록을 갖습니다. Kunavo는 kunavo.com/goose/kunavo.json에서 제공자 파일을 공개합니다. 이 파일은 실시간 카탈로그에서 생성되므로 현재 Kunavo가 제공하는 모델 목록이 담겨 있고, 키가 아닌 키 변수의 이름이 포함됩니다.

# macOS / Linux — goose reads every JSON file in this directory
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# The file names the variable; the key itself never goes in the file
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

Windows의 디렉터리는 %APPDATA%\Block\goose\config\custom_providers\입니다. goose Desktop에서는 제공자 구성 아래에 Kunavo가 표시되며, 환경 변수 대신 키체인에 키를 저장할 수 있습니다.

1. 엔드포인트. 파일은 base_url를 https://api.kunavo.com/v1로 설정합니다. goose 문서에는 이 필드가 /v1 기본 주소를 원하는지, 아니면 예시에 나온 전체 /v1/chat/completions를 원하는지 설명되어 있지 않습니다. 소스 코드를 확인하면 이 문제가 해결됩니다. derive_base_path는 두 경우 모두 같은 v1/chat/completions 경로로 변환합니다.
2. GPT ID에는 Responses API를 사용합니다. goose는 gpt-5 또는 gpt-6로 시작하는 모델 ID를 /v1/responses로 보내고, 나머지는 모두 /v1/chat/completions로 보냅니다. Kunavo는 두 API를 모두 제공하므로 파일에 있는 Claude 및 GPT ID를 하나의 키로 사용할 수 있습니다.
3. 도구 호출을 지원하는 모델만 나열됩니다. goose는 거의 모든 턴에서 도구를 사용하므로, 같은 키로 호출할 수 있는 이미지, 비디오, 오디오 모델도 이 파일에서는 제외됩니다.

이 페이지의 다른 내용과 마찬가지로 이 구성도 goose 문서와 소스를 확인했을 뿐 실행해 보지는 않았습니다. 제공자를 직접 작성하려면 제공자 구성 → 사용자 지정 제공자 추가로 이동해 같은 정보를 입력하세요. 유형 OpenAI Compatible, API URL https://api.kunavo.com/v1, sk-kn- 키, 쉼표로 구분한 모델 목록이 필요합니다.