Kimi OpenCode

상위 문서: ← Kimi Integrations 출처: Kimi API Platform 공식 문서 — Use Kimi Models in OpenCode 한글화 (2026-07-22) 공급사: Moonshot AI (月之暗面)

OpenCode는 오픈소스 프로그래밍 에이전트입니다. 이 가이드는 내장 인증을 통해 OpenCode를 Kimi Open Platform에 연결하고, 1M 토큰 컨텍스트 윈도우의 kimi-k3를 사용하는 방법을 설명합니다.

이 가이드는 OpenCode 1.18.3 기준입니다. 인터페이스, 설정 옵션, 지원 기능은 버전마다 변경될 수 있습니다.

사전 준비

• OpenCode 공식 문서에 따라 설치/업데이트
• Kimi Open Platform에서 API Key 생성 (비공개 보관)
• 계정 설정 확인 — 사용 가능 잔액, 한도, 조직 설정

Kimi K3는 계정 내 사용 가능 잔액이 필요합니다. 신규 인증 바우처는 K3에 사용할 수 없습니다. 등급별 rate limit은 Rate Limits 참고. 조직이 IP 화이트리스트를 사용하면 Organization Best Practices에 따라 호출 컴퓨터의 공인 IPv4 추가 필요.

1단계: API Key 설정

$ opencode auth login
┌  Add credential
│
◆  Select provider
│  Search: Moon█ (2 matches)
│  ● Moonshot AI
│  ↑/↓ to select • Enter: confirm • Type: to search
└

목록에서 Moonshot AI를 선택하고, Kimi Open Platform API Key를 붙여넣고 Enter:

$ opencode auth login
┌  Add credential
│
◇  Select provider
│  Moonshot AI
│
◇  Enter your API key
│  ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
│
└  Done

API Key는 설정 파일, 스크린샷, Git 저장소에 절대 넣지 마세요. 이 가이드는 Global Kimi Open Platform Key 사용을 전제로 하며, 다른 Kimi 서비스/지역의 Key로 대체하지 마세요.

2단계: Kimi K3 모델 선택

opencode

입력창에서 /models 실행 후 Select model 대화상자에서 Kimi K3 검색·선택.

3단계: Reasoning Effort 조정

입력창에서 /variants 실행 → Select variant에서 max 선택.

kimi-k3는 max reasoning effort가 기본이며 low / high로 전환 가능합니다. 자세한 내용은 Model Parameter Reference 참고.

설정 완료 시 상태 표시줄에 Kimi K3, Moonshot AI, max가 표시됩니다.

---

변경 이력

날짜	변경
2026-07-22	초판 작성 (공식 OpenCode 통합 가이드 한글화)
2026-07-22	제목에 "Kimi" 접두사 추가, 본문 H1 중복 제거