AI Code With

Kilo Code API 키 설정

Kilo Code API 키: kilo.json에 자신의 키 설정

아래 블록을 kilo.json에 붙여넣고 자신의 API 키로 바꾸면 Kilo Code에서 Claude 및 GPT 모델을 사용할 수 있습니다. 사용한 만큼 지불하세요.

설정 시작API 키 받기 →
~/.config/kilo/kilo.jsonjson
config
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}

설정 단계

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

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

bash
mkdir -p "$(dirname "$HOME/.config/kilo/kilo.json")"
cat > "$HOME/.config/kilo/kilo.json" << 'EOF'
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}
EOF

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

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

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

  1. 아직 Kilo Code가 없나요? 설치하세요 (설치되어 있으면 건너뛰세요)

    npm i -g @kilocode/cli를 실행한 다음 kilo --version을 실행하세요. 버전 번호가 나오면 설치된 것입니다.

    npm i -g @kilocode/cli로 Kilo Code CLI를 설치한 다음, kilo --version이 7.8.8을 출력하면 작동하는 것입니다

  2. kilo.json에 설정을 붙여넣고 API 키를 추가하세요

    ~/.config/kilo/kilo.json을 열고 이 페이지 상단의 블록을 붙여넣은 다음, sk-***를 API 키로 바꾸세요 (API 키 받기). 저장 후 파일에 "apiKey": "sk-…" 줄이 있고, 새 터미널을 열거나 재부팅해도 유지됩니다.

    ~/.config/kilo/kilo.json의 provider.aicodewith.options.apiKey에 키를 직접 넣으세요 (여기서는 sk-***로 마스킹됨)

  3. 새 터미널을 열고 Kilo Code 테스트하기

    새 터미널을 열고 kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK"를 실행하세요. OK가 나오면 Kilo Code가 API 키를 사용 중인 것입니다.

    확인: 터미널을 닫고 새 터미널을 연 다음(export 없이) kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK"를 실행하세요. OK 응답이 나오면 설정이 완료된 것입니다.

  4. OK가 나오지 않나요? 오류를 대조해보세요

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

  5. Kilo Code 모델 전환: -m 뒤의 이름 바꾸기

    -m 뒤에 aicodewith/와 kilo.json의 models 아래에 나열된 모델을 쓰세요. 예: aicodewith/gpt-5.5. 모델을 추가하려면 먼저 models 아래에 해당 Model ID를 나열하세요. 모델 및 가격을 참고하세요.

자주 발생하는 오류

키가 설정되지 않음: Error: Unauthorized: 请在请求中提供有效的 API Key。

표시되는 내용

Error: Unauthorized: 请在请求中提供有效的 API Key。
(한국어: "요청에 유효한 API 키를 제공하세요.")
원인
kilo.json의 apiKey가 {env:AICODEWITH_API_KEY}로 설정되어 있는데, 새 터미널에는 해당 변수가 없습니다.
해결 방법
2단계에서처럼 apiKey에 키를 직접 입력하세요.

2단계로 돌아가기: kilo.json에 구성을 붙여넣으세요 →

키가 설정되지 않음: apiKey가 여전히 {env:AICODEWITH_API_KEY}이고 새 터미널에는 해당 변수가 없습니다. kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK"를 실행하면 다음과 같이 출력됩니다: Error: Unauthorized: 请在请求中提供有效的 API Key。 (한국어: "요청에 유효한 API 키를 제공하세요.")

잘못된 키: Error: Unauthorized: 请在请求中提供有效的 API Key。

표시되는 내용

Error: Unauthorized: 请在请求中提供有效的 API Key。
(한국어: "요청에 유효한 API 키를 제공하세요.")
원인
apiKey가 잘못되었습니다. 키가 없을 때와 동일한 오류가 발생합니다.
해결 방법
콘솔에서 키를 다시 복사하여 apiKey 따옴표 안의 값을 교체하세요.

2단계로 돌아가기: kilo.json에 구성을 붙여넣으세요 →

잘못된 키: grep -n sk-wrong ~/.config/kilo/kilo.json 실행 결과 10번째 줄이 "apiKey": "sk-wrong"입니다. kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK"를 실행하면 다음과 같이 출력됩니다: Error: Unauthorized: 请在请求中提供有效的 API Key。 (한국어: "요청에 유효한 API 키를 제공하세요.") — 키가 없을 때의 오류와 동일합니다.

Error: Model not found

표시되는 내용

Error: Model not found
원인
-m 뒤의 모델이 kilo.json의 models에 나열되어 있지 않으면(예: aicodewith/no-such-model) Kilo Code는 요청을 보내기 전에 중지됩니다.
해결 방법
models에 나열된 모델을 사용하세요(예: aicodewith/gpt-5.5).

3단계로 돌아가기: 새 터미널을 열고 Kilo Code를 테스트하세요 →

일반적인 오류: 모델 이름이 잘못되면(여기서는 aicodewith/no-such-model) kilo는 Error: Model not found를 반환합니다. Kilo는 요청을 보내기 전에 이 오류를 자체적으로 발생시킵니다(모델이 kilo.json에 나열되어 있지 않음). 구성에 나열된 모델(예: aicodewith/gpt-5.5)을 사용하세요.

FAQ

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

~/.config/kilo/kilo.json에 baseURL이 https://api.aicodewith.ai/v1인 aicodewith 제공자를 추가하고 apiKey에 키를 입력하세요. 새 터미널에서도 유지됩니다.

Kilo Code base URL에 /v1을 포함해야 하나요?

네. https://api.aicodewith.ai/v1을 사용하세요.

Kilo Code의 kilo.json은 어디에 있나요?

전역 구성 파일은 ~/.config/kilo/kilo.json입니다.

Kilo Code가 Unauthorized라고 표시됩니다. 어떻게 해야 하나요?

kilo.json의 apiKey가 없거나 잘못되었습니다. 해결 방법은 위의 일반적인 오류를 참조하세요.

출처

관련 링크

AI Code With API 키 받기모델 및 요금opencode 통합다른 통합