AI Code With

Goose API 키 설정

Goose API 키: config.yaml에서 본인 키 설정

아래 블록을 config.yaml에 붙여넣고, ~/.bashrc에 본인 API 키를 넣으면 Goose에서 Claude 모델을 사용할 수 있습니다. 사용한 만큼 지불하세요.

설정 시작API 키 받기 →
~/.config/goose/config.yamlyaml
config
GOOSE_PROVIDER: openai
GOOSE_MODEL: claude-haiku-4-5-20251001
OPENAI_HOST: https://api.aicodewith.ai
OPENAI_BASE_PATH: v1/chat/completions

설정 단계

나중에 사용할 터미널을 위해 이 키를 저장하세요

로그인하면 이 명령에 사용자의 키가 포함됩니다. 복사해서 한 번 실행하면 도구가 테스트한 위치에 키를 보관합니다.

bash
for rc in "$HOME/.zshrc" "$HOME/.bashrc"; do
  touch "$rc"
  echo 'export OPENAI_API_KEY=sk-***' >> "$rc"
done

로그아웃한 방문자에게는 자리 표시자만 표시됩니다. 로그인하면 키를 채워 드립니다. Sign in · 콘솔에서 키 받기

복사는 명령을 클립보드에 넣을 뿐입니다. 아직 터미널에서 실행하거나 도구 설정에 키를 붙여넣어야 합니다. API 키 받는 방법

이 단계들은 Linux(bash)에서 테스트되었습니다. macOS와 Windows는 아직 테스트되지 않아 목록에 포함하지 않았습니다.

  1. Goose가 아직 없나요? 설치하세요(이미 설치된 경우 건너뛰기)

    curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash를 실행한 다음 goose --version을 실행하세요. 버전 번호가 표시되면 설치된 것입니다.

    Goose 설치: curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash (CONFIGURE=false는 대화형 설정을 건너뜁니다). ~/.local/bin/goose에 설치됩니다. goose --version은 1.54.0을 출력합니다.

  2. config.yaml에 설정을 붙여넣으세요

    ~/.config/goose/config.yaml을 열고 이 페이지 상단의 블록을 붙여넣은 후 저장하세요. 이제 더 이상 이 변수들을 export할 필요가 없습니다.

    ~/.config/goose/config.yaml의 엔드포인트

  3. API 키를 ~/.bashrc에 추가하세요

    echo 'export OPENAI_API_KEY=sk-***' >> ~/.bashrc를 실행하고 sk-***를 본인의 API 키로 바꾸세요(API 키 받기). ~/.bashrc의 마지막 줄이 해당 줄이어야 합니다.

    ~/.bashrc의 마지막 줄이 export OPENAI_API_KEY=sk-***인지 확인하세요(여기서는 마스킹됨)

  4. 새 터미널을 열고 Goose를 테스트하세요

    새 터미널을 열고 goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK"를 실행하세요. OK가 표시되면 Goose가 본인의 API 키를 사용 중인 것입니다.

    확인: 터미널을 닫고 새 터미널을 연 다음 goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK"를 실행하세요. OK 응답이 나오면 설정이 완료된 것입니다.

  5. OK가 표시되지 않나요? 오류를 확인하세요

    터미널에 표시된 오류를 아래의 일반적인 오류와 비교하세요. 각 항목에는 원인과 해결 방법이 나와 있습니다.

  6. Goose 모델 전환: GOOSE_MODEL 변경

    config.yaml에서 GOOSE_MODEL 뒤의 모델 이름을 새 모델 ID로 바꾸되 정확히 입력하세요. 모델 ID는 Models and pricing에서 확인할 수 있습니다.

자주 발생하는 오류

키가 설정되지 않음: https://api.aicodewith.ai/v1/chat/completions에 대한 인증 실패. 상태: 401 Unauthorized. 응답: {"error":"请在请求中提供有效的 API Key。"}

표시되는 내용

error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}.
(English: "Please provide a valid API key in the request.")
원인
터미널에 OPENAI_API_KEY가 없습니다: ~/.bashrc에 없거나, 추가했지만 새 터미널을 열지 않았습니다
해결 방법
3단계에서처럼 키를 ~/.bashrc에 넣은 다음 새 터미널을 여세요

3단계로 돌아가기: API 키를 ~/.bashrc에 넣기 →

키가 설정되지 않음: 새 터미널에 OPENAI_API_KEY가 없습니다. goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK"를 실행하면 두 번 출력됩니다: error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}. (English: "Please provide a valid API key in the request.") 뒤이어 Please retry if you think this is a transient or recoverable error.

잘못된 키: https://api.aicodewith.ai/v1/chat/completions에 대한 인증 실패. 상태: 401 Unauthorized. 응답: {"error":"请在请求中提供有效的 API Key。"}

표시되는 내용

error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}.
(English: "Please provide a valid API key in the request.")
원인
~/.bashrc의 OPENAI_API_KEY가 잘못되었습니다. 키가 없을 때와 같은 오류가 발생합니다
해결 방법
콘솔에서 키를 다시 복사하고, ~/.bashrc의 마지막 줄을 수정한 다음 새 터미널을 여세요

3단계로 돌아가기: API 키를 ~/.bashrc에 넣기 →

잘못된 키: tail -n 1 ~/.bashrc는 export OPENAI_API_KEY=sk-wrong을 표시합니다. goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK"를 실행하면 두 번 출력됩니다: error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}. (English: "Please provide a valid API key in the request.") — 키가 없을 때와 동일합니다

404 "不支持的请求路径" (지원되지 않는 요청 경로)

표시되는 내용

404 "不支持的请求路径" (지원되지 않는 요청 경로)
원인
OPENAI_BASE_PATH가 잘못되었습니다(예: nope/chat/completions). 그래서 요청이 https://api.aicodewith.ai/nope/chat/completions로 갑니다
해결 방법
v1/chat/completions로 다시 설정하세요

2단계로 돌아가기: config.yaml에 구성을 붙여넣기 →

일반적인 오류: 잘못된 OPENAI_BASE_PATH(여기서는 nope/chat/completions)는 요청을 https://api.aicodewith.ai/nope/chat/completions로 보내고 404(지원되지 않는 경로)를 반환합니다. v1/chat/completions로 다시 설정하세요. 참고: 이 릴레이는 /v1이 이미 포함된 HOST도 허용(테스트됨)했으므로, 잘못된 설정을 감지하는 신뢰할 수 있는 방법은 아닙니다

FAQ

Goose에서 내 API 키를 어떻게 사용하나요?

~/.config/goose/config.yaml에서 GOOSE_PROVIDER: openai, OPENAI_HOST: https://api.aicodewith.ai, OPENAI_BASE_PATH: v1/chat/completions를 설정한 다음, ~/.bashrc에 export OPENAI_API_KEY=your key를 추가하세요.

Goose OPENAI_HOST에 /v1이 포함되어야 하나요?

아니요. OPENAI_HOST를 https://api.aicodewith.ai로 설정하고 /v1은 OPENAI_BASE_PATH에 넣으세요.

Goose가 401을 표시합니다. 이제 어떻게 하나요?

터미널에 OPENAI_API_KEY가 없거나 키가 잘못되었습니다. 해결 방법은 위의 일반적인 오류를 참조하세요.

Goose가 모델을 찾을 수 없습니다. 이제 어떻게 하나요?

GOOSE_MODEL이 AI Code With 모델 ID와 정확히 일치하는지 확인하세요.

출처

관련 링크

AI Code With API 키 받기모델 및 가격기타 통합