OpenRouter를 이용해 Claude Code에서 Kimi K2를 사용

AI/CLAUDE

OpenRouter를 이용해 Claude Code에서 Kimi K2를 사용

dma-ai 2025. 7. 24. 10:56

728x90

OpenRouter를 이용해 Claude Code에서 Kimi K2를 사용하려면, config.json 파일을 OpenRouter API와 Kimi K2 모델에 맞게 설정해야 합니다. 아래는 안전하게 동작하는 최소 예시와 주요 설정 방법입니다.

1. OpenRouter API 키 발급

OpenRouter 공식 사이트에서 계정을 만들고 API 키를 발급받으세요.
API 키는 "sk-or-..." 또는 "or-..." 형태입니다.

2. Claude Code config.json 예시

일반적으로 config.json 파일은 Claude Code의 설정 폴더(예: ~/.config/claude-code/config.json 또는 실행 경로)에 위치합니다.

json

{ "provider": "openrouter", "openrouter": { "api_key": "or-여기에_본인_API_키_입력", "base_url": "https://openrouter.ai/api/v1", "model": "moonshotlabs/kimi-72b" } }

※ 공식 Kimi K2 모델명은 OpenRouter에서 moonshotlabs/kimi-72b 또는 moonshotlabs/kimi-32b 입니다. 실제 OpenRouter의 모델 리스트에서 최신 Kimi K2 모델명을 확인해 정확히 입력하세요.

3. 주요 필드 설명

provider: 반드시 "openrouter"로 설정해야 OpenRouter로 API 요청을 보냅니다.
openrouter.api_key: OpenRouter 대시보드에서 발급받은 API 키를 입력합니다.
openrouter.base_url: "https://openrouter.ai/api/v1"로 설정합니다.
openrouter.model: 사용하려는 Kimi K2 모델명(OpenRouter의 공식 명칭, 예: "moonshotlabs/kimi-72b").

4. 예시 위치 및 적용

홈 폴더 기준 예시 위치:
- 리눅스/맥: ~/.config/claude-code/config.json
- 윈도우: %USERPROFILE%\.config\claude-code\config.json
- 혹은 실행 폴더에 직접 두어도 인식되는 경우가 많습니다.

5. 참고 및 주의

간혹 OpenRouter에서 Kimi K2 변형 모델명 또는 모델 filenamings(moonshotlabs/kimi-32b, moonshotlabs/kimi-72b, moonshotlabs/kimi-72b-4096)이 자주 바뀌므로, 반드시 OpenRouter 모델 카탈로그에서 최신 명칭을 확인해 적용하세요.
일부 워크플로우, 클라이언트 버전에 따라 model 항목을 models (복수형, 배열)로 입력하는 경우도 있으나, core 구조는 위와 동일합니다.

요약

OpenRouter로 Claude Code에서 Kimi K2를 쓰고 싶다면 config.json을 다음과 같이 설정하세요:

json

{ "provider": "openrouter", "openrouter": { "api_key": "or-본인_API_키", "base_url": "https://openrouter.ai/api/v1", "model": "moonshotlabs/kimi-72b" } }

이렇게 설정 후 Claude Code를 재시작하면 모든 개발세션에서 OpenRouter의 Kimi K2 모델이 사용됩니다13.
배포 주의사항: OpenRouter와 Kimi K2간 호환성 이슈가 간혹 보고되므로(영상·포럼 등), 정상 동작 여부는 실제 실행을 통해 반드시 확인하세요3.

728x90

저작자표시 변경금지 (새창열림)