Articleaws.amazon.com·2026년 11월 20일·1

Use Kimi Code CLI with models on Amazon Bedrock

Quick Summary

Kimi Code CLI v2.7.0의 네이티브 bedrock 공급자는 기존 AWS 자격 증명과 SSO를 활용해 Amazon Bedrock 모델에 연결하고, 별도로 관리하는 API 키에 대한 의존을 줄인다.

Use Kimi Code CLI with models on Amazon Bedrock 관련 대표 이미지

🖼️ 인포그래픽

Use Kimi Code CLI with models on Amazon Bedrock 내용을 설명하는 본문 이미지

🖼️ 4컷 인포그래픽

Use Kimi Code CLI with models on Amazon Bedrock의 핵심 내용을 4단계로 요약한 인포그래픽
Use Kimi Code CLI with models on Amazon Bedrock 핵심 내용을 4단계로 압축한 4컷 인포그래픽

💡 한 줄 요약

Kimi Code CLI v2.7.0의 네이티브 bedrock 공급자는 기존 AWS 자격 증명과 SSO를 활용해 Amazon Bedrock 모델에 연결하고, 별도로 관리하는 API 키에 대한 의존을 줄인다.

📌 핵심 요약

  • Moonshot AI의 오픈 소스 코딩 에이전트 Kimi Code CLI는 v2.7.0부터 네이티브 bedrock 공급자를 지원한다. 기존의 openai 또는 openai_responses 공급자 연결과 달리, 기본 AWS 자격 증명 체인이나 SSO 기반 명명된 프로필을 활용할 수 있다.
  • bedrock 공급자는 @aws/bedrock-token-generator로 단기 Amazon Bedrock API 키를 생성하고 필요할 때 갱신한다. 키의 유효기간은 최대 12시간과 AWS 세션 길이 중 더 짧은 기간이며, 명시적으로 설정한 api_key 또는 api_key_env가 있으면 해당 키가 우선한다.
  • 예시 모델은 Kimi K3.1 Pro Highspeed이며, global.moonshotai.kimi-k3.1 추론 프로필을 사용한다. global. 접두사는 추론 프로필을 선택하고 AWS_REGION은 요청을 받는 리전 엔드포인트를 결정하며, Kimi 모델에는 기본적으로 OpenAI 호환 Chat Completions 경로가 권장된다.
  • 사용 조건에는 지원되는 소스 리전의 모델·추론 프로필 접근 권한, Kimi Code CLI v2.7.0 이상, 적절한 IAM 권한이 포함된다. 예시 설정은 1,000,000토큰 컨텍스트와 추론·이미지 입력·도구 사용 기능을 명시하며, 선택적인 aws login 방식에는 AWS CLI v2.32.0 이상이 필요하다.
  • 글은 최소 권한 원칙과 전용 IAM 역할 검토를 권고하고, config.toml에서 공급자 환경값과 모델 기능을 직접 설정하도록 안내한다. AWS CLI 프로필의 리전만으로는 충분하지 않으며 Kimi Code의 리전을 별도로 지정해야 하고, 연결 확인에는 실제 응답 스트리밍과 인증·권한·리전·모델 접근·네트워크 오류 여부를 확인하는 것이 중요하다.

🧩 주요 포인트

  1. 인증 관리의 전환 → 기존 AWS 세션을 재사용해 수동 API 키 관리를 줄이지만, 자격 증명 보호와 IAM 권한 범위에 대한 책임은 유지된다.
  2. 추론 프로필과 요청 리전의 역할 분리 → global.moonshotai.kimi-k3.1 선택과 AWS_REGION 설정을 구분해야 모델 접근과 요청 경로를 정확히 이해할 수 있다.
  3. 명시적 설정과 실제 요청 검증의 결합 → config.toml의 리전·모델 기능 선언과 응답 스트리밍 확인이 설정 누락이나 접근 문제를 판단하는 핵심이다.

🧠 상세 정리

1. 기존 연결 방식과 네이티브 공급자 도입

Kimi Code CLI는 오픈 웨이트 기반 모델 Kimi 시리즈를 만든 Moonshot AI의 오픈 소스 코딩 에이전트다. 이전에는 Amazon Bedrock 모델을 사용하려면 범용 공급자를 구성하고 별도의 Amazon Bedrock API 키를 발급받아 관리해야 했다. 기존 공급자의 유형은 openai 또는 openai_responses였으며, 각각 OpenAI 호환 Chat Completions 또는 Responses API를 사용하고 리전별 연결 주소와 API 키를 요구했다. v2.7.0에서 추가된 네이티브 bedrock 공급자는 기본 AWS 자격 증명 체인과 명명된 프로필, SSO 기반 인증을 활용할 수 있게 한다. 따라서 변화의 핵심은 별도의 자격 증명을 추가하는 부담을 줄이는 것이며, 글은 Kimi K3.1 Pro Highspeed를 사례로 이러한 연결 방식을 설명한다.

2. Amazon Bedrock의 제공 방식과 인증 책임

글은 Amazon Bedrock이 여러 제공자의 오픈 모델과 독점 모델에 표준 API를 통한 토큰당 과금 추론을 제공한다고 설명한다. 또한 처리가 AWS 데이터 경계 안에 머문다고 안내하며, 구체적인 데이터 보호 조건과 모델별 지원 API·기능은 각각 사용자 가이드와 모델 카드를 참조하도록 한다. 네이티브 공급자는 기존 AWS 인증 흐름을 사용할 수 있고, 모델 ID에서 API 형식과 리전 엔드포인트를 추론하되 필요한 경우 이를 변경할 수 있다고 소개된다. 다만 제공된 본문에는 해당 변경 방법을 다루는 후속 절의 내용이 포함되어 있지 않다. AWS는 장기 자격 증명보다 단기 자격 증명을 권장하며, 이 연결 방식도 AWS 자격 증명 보호와 적절한 권한 제한에 대한 사용자 책임을 없애지는 않는다.

3. 자격 증명 해석과 단기 키의 수명

네이티브 공급자는 별도의 Amazon Bedrock API 키가 설정되지 않은 경우 실행 환경의 표준 AWS 자격 증명 체인에서 인증 정보를 얻는다. AWS_PROFILE은 사용할 명명된 프로필을 선택하는 역할을 하므로, 기본 자격 증명 체인뿐 아니라 조직에서 사용하는 특정 AWS 인증 맥락도 활용할 수 있다. 공급자는 @aws/bedrock-token-generator를 사용해 단기 Amazon Bedrock API 키를 만들고 필요할 때 갱신하므로, AWS 액세스 키나 수동 생성한 Bedrock 키를 Kimi Code의 config.toml에 저장할 필요가 없다. 반면 api_key 또는 api_key_env로 키를 명시하면 그 설정이 우선하므로, 자동 자격 증명 사용 여부는 기존 키 설정의 영향을 받는다. 자동 생성되는 임시 키의 유효기간은 최대 12시간과 AWS 세션 길이 중 더 짧은 기간으로 제한된다.

4. 리전 엔드포인트와 글로벌 추론 프로필

공급자는 AWS_REGION 또는 AWS_DEFAULT_REGION을 해석하고 모델에서 추론한 API 형식에 맞는 bedrock-runtime 리전 엔드포인트를 구성한다. Kimi 모델의 경우 권장되는 기본 경로는 OpenAI 호환 Chat Completions이며, 로컬 모델 별칭은 실제 Amazon Bedrock 모델 또는 추론 프로필 ID에 연결된다. 예시의 global.moonshotai.kimi-k3.1에서 global. 접두사는 글로벌 추론 프로필을 선택하지만, 요청을 받는 리전 엔드포인트는 AWS_REGION이 결정한다. 글은 가장 폭넓은 가용성과 최저 비용을 위한 예시로 글로벌 교차 리전 추론을 사용한다고 설명하고, 사용 전 Amazon Bedrock 요금과 모델 카드의 현재 지원 범위를 확인하도록 한다. 이후 CLI는 응답을 스트리밍하고 클라이언트 측 도구 호출을 사용할 수 있지만, 요청이 완료되려면 인증·권한·모델 접근·네트워크 연결이 모두 충족되어야 한다.

5. 사용 전제와 IAM 권한의 범위

사용 전제는 지원되는 소스 AWS 리전에서 대상 모델과 추론 프로필에 접근할 수 있는 AWS 계정, Kimi Code CLI v2.7.0 이상, 그리고 해당 모델을 호출할 수 있는 IAM 사용자 또는 역할이다. 글의 프로필 및 신원 확인 예시에는 AWS CLI가 사용되며, 선택적인 aws login 인증 방식은 AWS CLI v2.32.0 이상을 요구한다. 제시된 IAM 정책은 Kimi K3.1 Pro Highspeed와 글로벌 추론 프로필에 범위를 맞추고, 단기 베어러 토큰 사용과 추론 프로필 조회, 모델 호출 및 스트리밍 호출에 필요한 권한을 설명한다. 리전과 계정 ID가 없는 기반 모델 ARN은 글로벌 교차 리전 라우팅에 의도적으로 필요하며, 기본 프로젝트 관련 권한은 기본 openai가 아닌 openai_responses 프로토콜을 사용할 때만 필요하다고 구분한다. 글은 AWS 환경 보안이 공동 책임이라는 점을 강조하면서, 특히 운영 환경에서는 최소 권한을 적용하고 일반 AWS 활동과 분리된 Kimi Code CLI 전용 IAM 역할을 검토하도록 권고한다.

6. AWS 인증 맥락과 Kimi Code 설정의 관계

AWS 인증 방식은 조직의 설정에 따라 달라지며, 명명된 프로필은 여러 AWS 사용 맥락을 구분하는 수단으로 제시된다. 글은 AWS IAM Identity Center 기반 SSO와 AWS Management Console 자격 증명을 활용하는 방식을 예로 들고, 캐시된 로그인 세션을 직접 지원하지 않는 도구를 위한 credential_process 안내도 언급한다. 어느 방식을 사용하든 최종 세션은 IAM 사용자나 역할로 해석되며, 그 신원에 대상 Amazon Bedrock 접근 권한이 있어야 한다. 특히 AWS CLI 프로필에 지정한 리전은 AWS CLI 명령에 적용되지만 Kimi Code에서 사용할 리전은 별도로 명시해야 한다는 점을 구분한다. Kimi Code의 설정 파일은 기본적으로 ~/.kimi-code/config.toml이며 KIMI_CODE_HOME이 있으면 그 위치를 따르고, 기존 파일은 관련 없는 공급자나 모델 설정을 보존하면서 병합하도록 안내한다.

7. 모델 별칭과 기능 선언의 의미

예시에서 bedrock-kimi-k3-1은 Kimi Code CLI 내부에서 사용하는 로컬 모델 별칭이며, 실제 모델 값은 global.moonshotai.kimi-k3.1 추론 프로필 ID다. 해당 모델 설정은 1,000,000토큰 컨텍스트와 always_thinking, thinking, image_in, tool_use 기능을 명시해 추론·이미지 입력·도구 사용 지원을 표현한다. 예시가 api_key, api_key_env, AWS_BEARER_TOKEN_BEDROCK을 생략하는 이유는 실행 환경의 AWS 자격 증명을 사용하기 위해서이며, 별도의 Bedrock 키가 설정되어 있다면 그 키가 우선한다. 공급자 환경값을 담는 providers.bedrock.env 표는 공급자에 설정을 전달하지만 셸 환경변수를 내보내지는 않으므로 적용 범위를 구분해야 한다. 글은 Kimi 모델을 포함한 대부분의 Amazon Bedrock 모델 기능을 Kimi Code가 자동 탐지하지 않기 때문에, 대상 모델 카드에 근거해 기능을 명시해야 한다고 설명한다.

8. 실제 연결 확인과 작성 시점의 제약

글은 소규모 비대화형 코딩 요청의 응답 스트리밍을 확인하는 것이 공급자 상태 표시만 보는 것보다 의미 있는 연결 검증이라고 설명한다. 확인 대상은 인증·권한·리전·모델 접근·네트워크 오류의 발생 여부이며, 기본 모델을 지정하면 이후 프로젝트의 대화형 세션에서도 해당 별칭이 자동 선택된다. 코딩 세션에서는 에이전트가 제안하는 파일 변경과 셸 명령을 승인하기 전에 검토하도록 안내해 사용자의 확인 역할도 강조한다. 작성 시점의 데스크톱 및 웹 공급자 생성 화면은 자격 증명 체인 구성에 필요한 모든 공급자 환경 필드를 노출하지 않으므로, 글은 config.toml을 직접 사용하는 방식을 권장한다. 제공된 본문은 모델 기능 선언을 설명하던 중 image_에서 끝나므로, 이후의 추가 권고나 세부 설정은 확인할 수 없다.

🧾 핵심 주장 / 시사점

  • 네이티브 bedrock 공급자의 이점은 자격 증명 관리 부담을 줄이는 데 있으며, 실제 권한 부여와 자격 증명 보호는 기존 AWS 보안 책임 안에 남는다.
  • 글로벌 추론 프로필을 사용해도 요청을 받는 리전 설정은 별도로 필요하므로, 모델 선택과 리전 선택을 구분하는 것이 구성 이해의 핵심이다.
  • 모델 기능 자동 탐지와 설정 화면의 제약 때문에 명시적인 config.toml 설정이 중요하며, 최종 연결 상태는 실제 요청 결과로 판단해야 한다.

✅ 액션 아이템

  • Kimi Code CLI v2.7.0 이상과 기존 AWS 자격 증명·SSO 프로필의 사용 가능 여부 확인.
  • global.moonshotai.kimi-k3.1의 접근 권한, AWS_REGION 및 최소 권한 원칙에 따른 IAM 권한 범위 검토.
  • config.toml의 모델 기능과 명시적 API 키 우선 적용 여부를 확인하고, 실제 응답 스트리밍으로 연결 상태 검증.

❓ 열린 질문

  • 사용하려는 소스 리전에서 Kimi K3.1 Pro Highspeed와 global.moonshotai.kimi-k3.1에 접근할 수 있는가?
  • 기존 config.toml의 api_key 또는 api_key_env가 AWS 자격 증명 체인보다 우선 적용되고 있는가?
  • Kimi Code에 AWS_REGION과 모델 기능을 명시한 뒤 실제 응답 스트리밍에서 인증·권한·리전·모델 접근·네트워크 오류 없이 요청이 완료되는가?

관련 문서

공통 태그와 주제 흐름을 기준으로 같이 보면 좋은 문서를 이어서 제안합니다.