Claude Code에서 Kimi K3 API 무료로 사용하는 방법 ($30 크레딧 + John.AI 프록시 연동

 

Claude Code 꿀팁

Claude Code에서 Kimi K3 API 무료로 사용하는 방법 ($30 크레딧 + John.AI 프록시 연동)

model.com의 $30 무료 API 크레딧을 활용해 Claude Code의 백엔드 모델을 Moonshot Kimi K3로 교체하는 전체 가이드입니다.

📌 왜 프록시(John.AI)가 필요한가요?

Claude Code는 Anthropic API 규격만을 지원하는 반면, model.com에서 제공하는 Kimi K3 API는 OpenAI API 규격을 사용합니다. 규격 차이를 해결하기 위해 로컬 프록시 도구인 John.AI를 중계기로 사용하여 두 규격을 연결합니다.

1 model.com 회원가입 및 $30 크레딧 발급

  1. model.com 접속: 웹브라우저에서 model.com에 접속합니다.
  2. 계정 생성: Google 또는 GitHub 계정으로 가입을 진행합니다. 가입 직후 계정에 $30 무료 크레딧이 자동으로 제공됩니다 (약 1,000만 입력 토큰 상당).
  3. 엔드포인트 배포: 상단 메뉴에서 Endpoints로 이동한 후 Kimi K3 모델을 찾아 Deploy this model 버튼을 클릭합니다.
  4. API 토큰 생성: 엔드포인트 관리 화면에서 토큰 생성 버튼을 눌러 Token ID와 Token Secret을 발급받습니다.
⚠️ 중요: API 키 조합 방식

발급받은 키는 단 한 번만 표시되므로 바로 복사해 두어야 합니다. John.AI 입력 시 TokenID.TokenSecret 형태로 중간에 점(.)을 찍어 하나의 문자열로 조합해야 정상 동작합니다.

2 John.AI 프록시 프로그램 설치 및 세팅

OpenAI 호환 API를 Anthropic 규격으로 변환해 주는 GUI 프록시 도구인 John.AI를 설치하고 연동합니다.

  1. John.AI 공식 페이지에서 운영체제(Windows / macOS / Linux)에 맞는 프로그램을 다운로드하여 설치합니다.
  2. John.AI 앱 실행 후 Settings 메뉴로 진입합니다.
  3. + (추가) 버튼을 눌러 새로운 Provider를 등록합니다. Name에 model을 입력합니다.
  4. Base URL: model.com 엔드포인트 페이지에서 제공하는 Base URL을 복사하여 입력합니다.
  5. API Key: 1단계에서 조합한 TokenID.TokenSecret 문자열을 붙여넣습니다.
  6. Provider 설정 저장 후, 모델 항목에서 Moonshot Kimi K3를 선택하고 프록시 서버를 활성화(Enable)합니다.

3 Claude Code 환경변수 및 프록시 연결

Claude Code가 Anthropic 공식 서버 대신 방금 실행한 John.AI 로컬 프록시를 바라보도록 환경변수 또는 설정 파일을 업데이트합니다.

[방법 A] 시스템 환경 변수 설정 (Windows 기준)

# 시스템 환경 변수 편집 창에서 아래 변수 추가/수정
ANTHROPIC_BASE_URL = http://localhost:프록시포트

[방법 B] settings.json 파일 수정

사용자 디렉토리의 .claude/settings.json 파일 내 기존 설정 항목 중 이전 Base URL 지정이 있다면 이를 정돈합니다.

4 실행 및 활용 테스트

  1. 터미널(Cmd, PowerShell, WSL 등)을 새로 열고 claude를 입력하여 Claude Code를 실행합니다.
  2. 상단에 연결된 모델 정보로 moonshot-ai/kimi-k3가 정상 출력되는지 확인합니다.
  3. 프로젝트 디렉터리에서 코드 생성, 리팩토링, 기능 구현 명령을 요청해 봅니다.
    > Create a simple snake game in HTML/JS
  4. 사용 후 model.com 대시보드로 돌아가면 $30 무료 크레딧에서 토큰 사용량만큼 실시간으로 차감되는 모습을 확인할 수 있습니다.

💡 추가 활용 팁 & 주의사항

  • John.AI 백그라운드 유지: Claude Code를 사용할 때는 항상 John.AI 프록시 앱이 실행 중이어야 합니다.
  • 오류 발생 시: 모델 호출 중 에러가 발생하면 터미널을 완전히 종료 후 다시 열거나, John.AI 서비스가 켜져 있는지 확인해 보세요.
  • 비용 효율성: Kimi K3 모델은 코딩 성능이 우수하면서도 토큰 단가가 저렴하여 $30 크레딧으로도 매우 오랜 기간 많은 양의 코딩 작업을 처리할 수 있습니다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

정부 무료 공공데이터 종류 총정리 & Python API 실전 호출 연동 가이드

이미지
  정부 무료 공공데이터 종류 총정리 & Python API 실전 호출 연동 가이드 "아이디어는 있는데 활용할 데이터가 없다고요?" 정부와 지자체가 무료로 제공하는 11,000개 이상의 공공데이터(Open API)를 활용하면 상권 분석, 부동산 추이, 날씨 연동 앱 등 수많은 서비스를 직접 구축할 수 있습니다. 카테고리별 공공데이터 종류부터 파이썬(Python)으로 상권 API를 연동하는 실전 코드 까지 한 번에 정리해 드립니다. 📌 목차 1. 수익화에 유용한 대표 공공데이터 6가지 분류 2. [실전 코드] Python으로 상권 정보 API 호출 & 데이터 파싱하기 3. API 연동 시 필수 주의사항 (디코딩 인증키 오류 해결) 4. 공공데이터 + AI(Claude/ChatGPT) 서비스 자동화 아이디어 5. 공공데이터포털 API 신청 3단계 절차 ✍️ 운영자 노트 저는 기상 데이터를 다루는 일을 하고 있어서 공공데이터포털의 기상청 API를 실무에서 꾸준히 씁니다. 처음 신청했을 때 가장 오래 헤맨 지점이 아래 3번의 Encoding/Decoding 인증키 구분 이었습니다 — 에러 메시지는 키가 등록되지 않았다고 나오는데, 실제 원인은 키 종류를 잘못 고른 것이었습니다. 같은 곳에서 시간을 버리지 않도록 트러블슈팅 섹션을 꼭 확인하세요. 1. 주요 공공데이터 종류 및 대표 Open API 공공데이터포털(data.go.kr)에서 다룰 수 있는 수천 가지 데이터 중,...
자세한 내용 보기

말 대신 화면을 녹화하면 AI가 그대로 따라합니다: 클로드(Claude) 화면 녹화 스킬 & Chrome 연동 가이드

이미지
  말 대신 화면을 녹화하면 AI가 그대로 따라합니다: 클로드(Claude) 화면 녹화 스킬 & Chrome 연동 가이드(2026.7월 기준 macOS만 가능) 복잡한 프롬프트 작성 없이 화면 작업 과정을 녹화하기만 하면 클로드가 스스로 웹을 조종해 반복 업무를 자동화합니다. 구체적인 설치부터 실전 활용 방법까지 정리했습니다. ✍️ 운영자 노트 이 블로그의 운영 작업(설정 변경·게시·검증) 상당 부분을 실제로 클로드 + Chrome 연동으로 처리하고 있습니다. 브라우저를 직접 조종하는 방식은 확실히 강력하지만, 화면 녹화(Record a Skill) 스킬 자체는 글 작성 시점 기준 macOS 전용 입니다. 윈도우 사용자는 아래 '함께 보면 좋은 글'의 윈도우 대안 정리를 먼저 확인하세요. 💡 어떤 업무를 스킬로 만들면 좋을까? (3가지 기준) 모든 일을 녹화할 필요는 없습니다. 다음 3가지 조건에 부합하는 업무일수록 자동화 효과가 극대화됩니다. 자주 반복하는 일: 매일/매주 정기적으로 수행하는 데이터 수집 및 정리 작업 직접 커넥터 연결이 안 되는 서비스: API나 전용 연동 도구가 없는 외부 웹사이트 활용 업무 글로 설명하기 어려운 일: 프롬프트로 조건과 순서를 일일이 기재하기 복잡한 마우스 클릭·타이핑 작업 🛠️ 사전 설치 및 설정 방법 step-by-step 1. 클로드 데스크톱(Claude Desktop) 앱 설정 클로드 데스크톱 앱 실행 후 좌측 메뉴에서 사용자 지정(Custom) 클릭 스킬(Skills) 탭 선택 후 우측 상단의 추가(Add) 클릭 메뉴 중 화면 녹화(Record...
자세한 내용 보기

Claude Code 하나로 논문 작성부터 심사까지: academic-research-skills 완벽 가이드

이미지
  Academic AI Tool Claude Code 하나로 논문 작성부터 심사까지: academic-research-skills 완벽 가이드 AI 환각을 차단하고 연구 생산성을 극대화하는 대학원생·연구원 필수 라이브러리 논문 작성 시 AI를 활용할 때 가장 두려운 순간은 "존재하지 않는 가짜 인용(Hallucination)" 이나 "기계가 쓴 듯한 진부한 문체" 때문일 것입니다. 오늘 소개할 Imbad0202/academic-research-skills 는 단순한 AI 자동 글쓰기 도구가 아닙니다. 연구자가 주도권을 쥐고 AI를 '학술 전문가 파트너'로 활용하도록 설계된 Claude Code 전용 프레임워크 입니다. 1. 왜 이 라이브러리를 써야 할까? 이 툴은 2026년 최신 연구 지표와 학술적 가이드라인을 반영하여 개발되었습니다. 핵심 철학은 "AI는 코파일럿(보조)이지, 필럿(주도자)이 아니다" 입니다. 엄격한 인용 검증 (Claim Audit): 논문에 포함된 인용 출처가 실제 주장과 일치하는지 3단계 앵커로 실시간 검증합니다. 개인 맞춤형 문체 학습 (Style Calibration): 기존에 본인이 작성했던 논문 어조를 학습하여 AI 특유의 상투적인 문체를 제거합니다. 다단계 동료 심사 모의 테스트 (Peer Reviewer): 제출 전 논문의 논리적 허점, 과장된 주장, 근거 부족을 미리 찾아냅니다. 전 과정 통합 관리: 연구 기획 → 문헌 조사 → 작성 → 검토 → 최종 출력(DOCX/PDF)을 원스톱 처리합니다. ✍️ 운영자 노트 — 논문을 쓰고 심사하는 입장에서 저는 대기과학 분야에서 실제로 논문을 쓰고 국제 학술지 심사(리뷰)에도 참여...
자세한 내용 보기