콘텐츠로 이동
무료 가입
Coding Agent 설정

Goose 설정: API Key, Base URL, 모델

BetterToken API Key와 Base URL로 Goose를 설정하고 developer 확장 프로그램을 켠 뒤 텍스트 요청을 확인하세요.

Goose의 OpenAI 제공자를 사용해 BetterToken에 연결하세요. GPT 모델을 사용한 macOS 테스트에서 Goose 1.55.0은 /v1/responses를 통해 텍스트 요청과 파일 읽기 도구 호출을 완료했습니다.

주요 설정

필드값
API KeyOPENAI_API_KEY에 설정한 BetterToken API Key
Base URLOPENAI_HOST의 https://bettertoken.ai(/v1 제외)
모델GOOSE_MODEL의 YOUR_MODEL_ID
ProviderGOOSE_PROVIDER=openai

사전 요구 사항

설치

공식 Goose 설치 프로그램을 사용하세요.

터미널 창
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
goose --version

수동 설정

실행하기 전에 YOUR_API_KEY와 YOUR_MODEL_ID를 바꾸세요.

터미널 창
export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="YOUR_MODEL_ID"
export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_HOST="https://bettertoken.ai"

OPENAI_HOST에는 사이트 루트를 지정합니다. 제공자가 OpenAI여도 이 필드에 /v1을 넣지 마세요.

파일에 접근하려면 goose configure를 실행하고 Toggle Extensions를 선택한 다음 developer를 활성화하세요. developer 확장 프로그램은 파일 및 셸 도구를 제공합니다.

연결 확인

같은 터미널에서 다음 명령을 실행하세요.

터미널 창
goose run --no-session --max-turns 4 -t "Reply with only: OK"

최종 답변이 OK인지 확인하세요. 파일 접근을 별도로 확인하려면 프로젝트에서 Goose를 실행하고 알려진 파일을 읽도록 요청하세요. 도구 결과와 최종 답변을 모두 확인하세요.

모델 전환

GOOSE_MODEL을 모델 광장의 다른 정확한 Model ID로 설정하고 새 실행을 시작하세요.

자주 발생하는 오류

증상확인할 내용
인증 실패Goose를 실행하는 터미널에서 OPENAI_API_KEY를 확인하세요.
요청 URL이 잘못됨OPENAI_HOST를 https://bettertoken.ai로 설정하고 /v1 또는 엔드포인트 접미사를 넣지 마세요.
파일 도구를 사용할 수 없음goose configure에서 기본 제공 developer 확장 프로그램을 활성화하세요.
요청이 계속 Responses를 사용함Goose 1.55.0 테스트에서는 OPENAI_BASE_PATH=v1/chat/completions를 지정해도 테스트한 모델의 경로가 /v1/responses에서 바뀌지 않았습니다. 실제 요청 경로를 확인하세요.

관련 가이드

기술 세부 정보

테스트한 텍스트 및 파일 읽기 요청은 /v1/responses를 사용했습니다. 제공자 이름과 환경 변수 이름만으로 Goose가 다른 모델에 어떤 프로토콜을 선택할지는 알 수 없습니다.