Goose를 자체 로컬 모델과 함께 사용하세요

Goose는 Block의 오픈소스 온-머신 코딩 에이전트입니다. Goose에는 기본 제공 Tokios 제공자가 없지만, JSON 파일을 통해 사용자 지정 제공자를 지원하므로 https://api.tokios.com/v1을(를) 가리키고 커넥터 뒤의 모든 모델에 도달할 수 있습니다.

사전 요구 사항

A running Tokios connector paired with your local model — see Connector install
A registered model deployment name — see Register a model
A Tokios API key (sk-tok-…) — see API keys
Goose 설치

사용자 지정 제공자 구성

Goose용 사용자 지정 제공자 파일을 생성하세요. 사용자 지정 제공자 구성은 Goose 릴리스마다 변경되었으므로, 설치된 버전을 기준으로 정확한 JSON 스키마(필드 이름, 필수 키와 선택 키, models 배열이 예상되는지 아니면 다른 구조가 예상되는지)를 확인하세요.

macOS/Linux
Windows

JSON 파일을 ~/.config/goose/custom_providers/에 생성하십시오.

tokios.json

{
  "name": "tokios",
  "display_name": "Tokios",
  "engine": "openai",
  "base_url": "https://api.tokios.com/v1",
  "api_key_env": "TOKIOS_API_KEY",
  "models": ["gemma-tunnel"]
}

Create a JSON file in %APPDATA%\Block\goose\config\custom_providers\:

tokios.json

{
  "name": "tokios",
  "display_name": "Tokios",
  "engine": "openai",
  "base_url": "https://api.tokios.com/v1",
  "api_key_env": "TOKIOS_API_KEY",
  "models": ["gemma-tunnel"]
}

파일은 키 자체를 보관하는 대신 환경 변수를 지칭하므로 Goose를 시작하기 전에 내보내세요.

export TOKIOS_API_KEY=sk-tok-YOUR_KEY

$env:TOKIOS_API_KEY = "sk-tok-YOUR_KEY"

Replace gemma-tunnel with the public deployment name you registered on the Models tab — not the local model id your backend (Ollama, llama.cpp, vLLM, or LM Studio) uses. Because api_key_env stores only the variable name, this file is safe to commit; the key never enters it.

If requests 404, check how your Goose release interprets base_url. Goose’s own custom-provider example writes the full endpoint path (.../v1/chat/completions) rather than just the /v1 root, and the two forms are not interchangeable — try https://api.tokios.com/v1/chat/completions if https://api.tokios.com/v1 fails.

대안은 내장 OpenAI 제공자입니다.

프로바이더 파일을 추가하고 싶지 않다면, Goose의 내장 openai 프로바이더는 사용자 지정 호스트를 허용합니다. Goose는 이를 ~/.config/goose/config.yaml에 저장합니다.

export GOOSE_PROVIDER=openai
export GOOSE_MODEL=gemma-tunnel
export OPENAI_HOST=https://api.tokios.com
export OPENAI_API_KEY=sk-tok-YOUR_KEY

OPENAI_HOST는 호스트 루트이고 OPENAI_BASE_PATH는 요청 경로이며, 기본값은 v1/chat/completions — Tokios가 제공하는 경로 — 이므로 일반적으로 설정하지 않은 채 둡니다.

대안 (환경 변수)

사용자 지정 프로바이더 파일 대신, OPENAI_HOST 환경 변수를 사용하여 Goose의 OpenAI 호환 클라이언트를 Tokios에 지정할 수 있습니다. 설치된 버전에서 OPENAI_HOST가 호스트만 기대하는지 전체 /v1 경로를 기대하는지, 그리고 인증을 위해 OPENAI_API_KEY와의 페어링이 필요한지 확인하십시오.

export OPENAI_HOST="https://api.tokios.com/v1"
export OPENAI_API_KEY="sk-tok-YOUR_KEY"

Goose는 Anthropic을 별도의 퍼스트파티 제공자로 취급하며, 일반적인 사용자 지정 Anthropic 기본 URL은 아직 제공되지 않습니다. 오픈 기능 요청으로 추적되고 있습니다 (block/goose#3777). 위의 OpenAI 호환 제공자 슬롯을 사용하여 Tokios에 연결하세요.

도구 호출이 가능한 모델을 선택하세요.

Goose의 에이전트는 파일을 읽고, 명령을 실행하고, 코드를 편집하기 위해 도구 호출에 의존합니다. 모든 로컬 모델이 도구 호출을 안정적으로 처리하는 것은 아닙니다. 실제 편집 작업에 Goose를 신뢰하기 전에 강력한 도구 호출 지원을 갖춘 모델로 구동되는 배포를 선택하세요. 에이전트 코딩 작업에 모델을 매칭하는 방법에 대한 지침은 작업별 모델 선택을 참조하세요.

문제 해결

401 오류

Goose가 보낸 API 키가 누락되었거나, 형식이 잘못되었거나, 해지되었습니다. api_key(또는 OPENAI_API_KEY)에 전체 sk-tok-… 키가 추가 공백 없이 포함되어 있는지 확인하고, Keys 탭에서 상태를 확인하세요.

404 오류

모델 이름이 models에 등록된 배포와 일치하지 않습니다. Models 탭의 공개 이름과 정확히 일치하는지 확인하세요 — Ollama, llama.cpp, vLLM 또는 LM Studio 로컬 모델 ID가 아니라.

503 오류

해당 배포의 커넥터가 오프라인 상태이거나 동시성 한도에 도달했습니다. Connectors 탭을 확인하세요 — 커넥터가 Online로 표시되어야 하며, 이를 실행하는 머신이 계속 켜져 있고 연결 가능해야 합니다.

다음 단계

빠른 시작

커넥터를 설정하고, 모델을 등록하고, API 키를 처음부터 생성하세요.

작업별로 모델 선택

로컬 모델을 Goose에 연결하기 전에 에이전트 코딩 작업에 맞는 모델을 매칭하세요.

하드웨어와 호환성

런타임 서빙과 연결

클라이언트 또는 앱 연결

비교

Goose를 자체 로컬 모델과 함께 사용하세요

사전 요구 사항

사용자 지정 제공자 구성

대안은 내장 OpenAI 제공자입니다.

대안 (환경 변수)

도구 호출이 가능한 모델을 선택하세요.

문제 해결

다음 단계

빠른 시작

작업별로 모델 선택

​사전 요구 사항

​사용자 지정 제공자 구성

​대안은 내장 OpenAI 제공자입니다.

​대안 (환경 변수)

​도구 호출이 가능한 모델을 선택하세요.

​문제 해결

​다음 단계

빠른 시작

작업별로 모델 선택

사전 요구 사항

사용자 지정 제공자 구성

대안은 내장 OpenAI 제공자입니다.

대안 (환경 변수)

도구 호출이 가능한 모델을 선택하세요.

문제 해결

다음 단계