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 Key | OPENAI_API_KEY에 설정한 BetterToken API Key |
| Base URL | OPENAI_HOST의 https://bettertoken.ai(/v1 제외) |
| 모델 | GOOSE_MODEL의 YOUR_MODEL_ID |
| Provider | GOOSE_PROVIDER=openai |
사전 요구 사항
설치
공식 Goose 설치 프로그램을 사용하세요.
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bashgoose --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가 다른 모델에 어떤 프로토콜을 선택할지는 알 수 없습니다.

