Goose

터미널과 데스크톱에서 동작하며 OpenAI 호환 모델이라면 무엇이든 쓸 수 있는 오픈소스 AI 에이전트.

Goose란

Goose는 Block에서 만든 오픈소스 AI 에이전트로, 터미널에서 실행하거나 데스크톱 앱으로 쓸 수 있습니다. 어떤 LLM이든 사용해 내 컴퓨터에서 코드를 작성하고 실행하고 수정하고 테스트할 수 있습니다. OpenAI provider를 TokenMix로 향하게 하면 Claude, GPT, DeepSeek 등으로 Goose를 구동할 수 있습니다. 이 가이드는 CLI를 다루지만, 데스크톱 앱도 동일한 설정을 사용합니다.

시작하기 전에

• 공식 사이트(block.github.io/goose)에서 Goose를 설치합니다.
• tokenmix.ai에서 가입하고 콘솔을 연 뒤 API Keys로 이동해 sk-tm- 로 시작하는 키를 생성합니다.

TokenMix 연결하기

Goose는 엔드포인트를 host와 base path로 나눠서 관리합니다. 여기서 실수하는 사람이 많은데, host에는 /v1을 포함하지 않습니다. /v1/chat/completions 부분이 base path에 해당하며, 기본값이 이미 올바르게 설정되어 있습니다.

1. 터미널에서 다음을 실행합니다: goose configure
2. "Configure Providers"(프로바이더 설정)를 선택한 다음 "OpenAI"를 선택합니다.
3. OPENAI_API_KEY: sk-tm- 키를 붙여넣습니다.
4. OPENAI_HOST: https://api.tokenmix.ai 를 입력합니다. 끝에 /v1을 붙이지 않습니다.
5. OPENAI_BASE_PATH: Enter를 눌러 기본값 v1/chat/completions 을 그대로 둡니다.
6. 사용할 모델을 입력합니다. 예를 들어 claude-sonnet-4.6 입니다.

동작 확인

다음 명령으로 세션을 시작합니다: goose session

"what files are in this folder?"(이 폴더에 어떤 파일들이 있나요?)처럼 간단한 것을 물어보세요. 그럴듯한 답이 돌아오면 Goose가 TokenMix에 연결된 것입니다. 사용량은 TokenMix 콘솔에서 확인할 수 있습니다.

자주 묻는 질문

연결 오류가 날 때: OPENAI_HOST가 /v1 없이 정확히 https://api.tokenmix.ai 인지, OPENAI_BASE_PATH가 v1/chat/completions 그대로인지 확인하세요. host에 /v1을 넣는 것이 가장 흔한 실수입니다.

데스크톱 앱: Settings(설정)를 열고 Models(모델)로 이동해 OpenAI provider를 설정하고, 동일한 host와 키를 입력합니다.

어떤 모델을 고를지: 에이전트 작업과 코딩에는 Claude Opus 4.8, Claude Sonnet 4.6, DeepSeek V4 Pro가 무난한 선택입니다.