Kimi Code CLI v2.7.0, 네이티브 Bedrock provider 추가: AWS 자격 증명 체인으로 Kimi K3.1 Pro Highspeed 연결

AWS에 따르면 Moonshot AI가 Kimi Code CLI v2.7.0에 네이티브 bedrock provider를 추가했습니다. AWS 자격 증명 체인(명명된 프로파일·SSO 포함)으로 Amazon Bedrock 모델을 호출할 수 있어 Bedrock API 키를 따로 관리할 필요가 없습니다.

뉴스 날짜: 읽는 데 약 7분

LINE 공유
목차
  1. 1. 이번 업데이트는 기존 설정 방식과 무엇이 다른가요?
  2. 2. 어떤 사전 조건이 필요하고 어떻게 시작하나요?
  3. 3. 사용 시 어떤 제한과 주의 사항이 있나요?
  4. 4. 자주 묻는 질문

AWS는 블로그에서 Moonshot AI가 개발한 오픈 소스 코딩 에이전트 Kimi Code CLI가 v2.7.0에서 네이티브 bedrock provider(CLI가 특정 모델 서비스에 연결하기 위한 접속 설정)를 추가했다고 밝혔습니다. v2.7.0 이상으로 업그레이드하면 사용할 수 있으며, Amazon Bedrock 모델 추론은 토큰(모델이 처리하는 텍스트 단위) 사용량에 따라 과금됩니다. 가장 큰 변화는 AWS 도구가 로그인 정보를 순서대로 찾는 표준 방식인 AWS 자격 증명 체인을 그대로 쓸 수 있다는 점입니다. AWS CLI에서 미리 이름을 붙여 둔 계정 설정인 명명된 프로파일과 SSO(싱글 사인온)도 포함됩니다. 이미 AWS에서 작업하는 개발자에게는 별도의 Bedrock API 키를 관리할 일이 줄어든다는 의미지만, 자격 증명을 보호하고 권한을 제한할 책임은 여전히 사용자에게 있습니다.

이번 업데이트는 기존 설정 방식과 무엇이 다른가요?

AWS 설명에 따르면 이전에는 type이 openai 또는 openai_responses인 provider를 사용하고, 리전별 base_url을 설정하며, 단기 또는 장기 Amazon Bedrock API 키를 제공해야 했습니다. 새 네이티브 provider는 표준 AWS CLI 자격 증명 체인으로 임시 자격 증명을 확인하고, 모델 ID로 API 형식과 리전 엔드포인트를 추론하며, 필요하면 모델별로 프로토콜을 덮어쓸 수 있습니다.

동작 방식은 다음과 같습니다. provider가 먼저 AWS 자격 증명을 확인하고, @aws/bedrock-token-generator로 단기 Bedrock API 키를 생성해 필요할 때 갱신합니다. 이어서 AWS_REGION 또는 AWS_DEFAULT_REGION을 기준으로 bedrock-runtime 엔드포인트를 만들고, 마지막으로 선택한 추론 프로파일(요청이 어떤 모델과 경로로 갈지 정하는 설정)을 호출합니다. AWS는 사용자가 api_key 또는 api_key_env로 키를 명시하면 그 키가 우선한다고 밝혔습니다.

AWS 블로그를 바탕으로 정리한 설정 방식 비교
항목기존 방식v2.7.0 네이티브 bedrock provider
provider 유형openai 또는 openai_responsesbedrock
인증 방식Amazon Bedrock API 키(단기 또는 장기)표준 AWS 자격 증명 체인, 명명된 프로파일과 SSO 사용 가능
엔드포인트 설정리전 base_url을 직접 설정AWS_REGION과 모델 ID로 추론, protocol과 base_url로 덮어쓰기 가능
키 관리별도로 발급받아 보호해야 함단기 키 자동 생성, 최대 12시간 또는 세션 길이

어떤 사전 조건이 필요하고 어떻게 시작하나요?

AWS가 제시한 사전 조건은 다음과 같습니다. 대상 모델과 추론 프로파일에 접근할 수 있는 AWS 계정, Kimi Code CLI v2.7.0 이상, AWS CLI(선택 사항인 aws login은 v2.32.0 이상 필요), 그리고 대상 모델과 추론 프로파일을 호출할 권한이 있는 IAM 아이덴티티(IAM은 AWS에서 사용자·역할·권한을 관리하는 서비스)입니다. AWS는 최소 권한 원칙에 따라 권한을 부여하고, Kimi Code CLI 전용 IAM 역할 사용도 고려하라고 권고합니다.

AWS 글에 따른 순서는 다음과 같습니다. 먼저 AWS 자격 증명을 설정하고 신원을 확인한 뒤, ~/.kimi-code/config.toml(KIMI_CODE_HOME을 설정했다면 해당 디렉터리의 파일)을 편집해 provider와 모델을 추가하고, 마지막으로 테스트 요청을 보냅니다. 아래는 글에 나온 명령과 설정입니다.

AWS 글의 검증 및 테스트 명령 · bash
kimi --version
aws sts get-caller-identity --profile YOUR_PROFILE_NAME
kimi --model bedrock-kimi-k3-1 --prompt "Write a Python function that checks whether a string is a palindrome. Include a short usage example."
AWS 글의 config.toml 예시 · toml
default_model = "bedrock-kimi-k3-1"

[providers.bedrock]
type = "bedrock"

[providers.bedrock.env]
AWS_REGION = "YOUR_SOURCE_REGION"
# AWS_PROFILE = "YOUR_PROFILE_NAME"

[models.bedrock-kimi-k3-1]
provider = "bedrock"
model = "global.moonshotai.kimi-k3.1"
max_context_size = 1000000
capabilities = ["always_thinking", "thinking", "image_in", "tool_use"]

AWS는 이미 설정 파일이 있다면 덮어쓰지 말고 백업한 뒤 병합하라고 당부합니다. 또한 대화형 세션에서는 에이전트가 제안하는 파일 수정과 셸 명령을 승인하기 전에 직접 검토하라고 권장합니다.

사용 시 어떤 제한과 주의 사항이 있나요?

AWS는 글 작성 시점에 Kimi Code 데스크톱 및 웹 버전의 provider 생성 화면이 이 자격 증명 체인 설정에 필요한 환경 필드를 모두 제공하지 않아 config.toml을 직접 편집해야 한다고 밝혔습니다. 또한 bedrock provider는 명시적인 AWS_REGION 또는 AWS_DEFAULT_REGION이 필요하며, ~/.aws/config나 aws configure에서 추론하지 못합니다.

Kimi Code는 Bedrock의 대부분 모델 기능을 자동으로 감지하지 않으므로 모델 카드를 참고해 직접 선언해야 합니다. AWS에 따르면 Kimi K3.1 Pro Highspeed는 always_thinking, thinking, image_in, tool_use를 지원하지만 audio_in과 video_in은 지원하지 않으며, 도구와 이미지 흐름은 직접 검증하라고 권장합니다. 비용 면에서 AWS는 글로벌 추론이 지역 프로파일보다 10% 저렴하며 데이터 상주 요구(데이터를 특정 지역 안에 두어야 하는 요건)가 없는 워크로드에 적합하다고 설명합니다. 실제 요금은 Amazon Bedrock 요금 페이지를 확인하세요.

자주 묻는 질문

Amazon Bedrock API 키가 여전히 필요한가요?

AWS 설명에 따르면 config.toml에 AWS 액세스 키나 수동 생성한 Bedrock 키를 넣을 필요가 없으며, provider가 단기 키를 자동으로 생성합니다. 다만 api_key 또는 api_key_env로 키를 명시하면 그 키가 우선 사용됩니다.

사용하면 어떤 비용이 발생하나요?

AWS에 따르면 Amazon Bedrock의 이 모델들은 추론을 토큰 단위로 과금하며, 정리해야 할 상시 클라우드 인프라는 없습니다. 사용 전에 Amazon Bedrock 요금 페이지에서 예상 비용을 확인하는 것이 좋습니다.

다른 프로토콜이나 VPC 엔드포인트를 사용할 수 있나요?

AWS에 따르면 가능합니다. config.toml에서 protocol을 openai, openai_responses 또는 anthropic으로 설정하고 base_url로 대상 URL을 지정하세요(/openai/v1이나 /anthropic 같은 경로 포함). 글에서는 VPC 엔드포인트로 OpenAI Responses API를 사용하는 예를 보여 주며, 모델별 지원 API는 모델 카드에서 확인해야 합니다.

임시 키는 얼마나 오래 쓸 수 있나요?

AWS에 따르면 provider가 생성한 임시 API 키의 유효 기간은 최대 12시간 또는 AWS 세션 길이 중 짧은 쪽입니다.

글에 리전별 제공 여부나 한국 지원에 대한 언급이 있나요?

없습니다. AWS는 지원되는 소스 리전에서 모델과 추론 프로파일에 접근할 수 있어야 한다고만 설명하며, 현재 지원 리전과 추론 프로파일은 Kimi K3.1 Pro Highspeed 모델 카드에서 확인하라고 안내합니다.

이 주제의 최신 뉴스 보기

이 정리가 도움이 되셨나요? 필요한 분께 공유해 보세요

LINE 공유

출처

위에 기재된 참고 자료와 확인일 기준 정보를 바탕으로 정리했습니다. 요금, 시간표, 기능, 이용 약관은 바뀔 수 있으므로 여행, 예약 또는 구매 전에 해당 공식 사이트에서 최신 정보를 확인해 주세요.

라이프스타일