KMP로 Todo 앱을 만들면서 AI 도구를 어떻게 붙일지 고민했습니다. JetBrains AI(BYOK)와 Claude Code 플러그인, 두 가지 옵션을 실제로 써보고 비교한 기록입니다.

두 가지 선택지

JetBrains AI + BYOK(Bring Your Own Key) Android Studio(IntelliJ 계열)에 내장된 AI 어시스턴트에 Anthropic API 키를 직접 연결하는 방식입니다. IDE 안에서 자연스럽게 통합되지만, 에이전틱 워크플로우보다는 인라인 보조에 가깝습니다.

Claude Code JetBrains 플러그인 터미널 기반 Claude Code를 IDE 안에서 사용할 수 있게 해주는 플러그인입니다. 파일 시스템 접근, 여러 파일에 걸친 수정, 커밋까지 하나의 흐름으로 처리할 수 있습니다.

설정 과정

  1. Android Studio에서 Plugins 마켓플레이스 검색 → Claude Code 플러그인 설치
  2. 터미널에서 claude 실행 또는 플러그인 UI에서 바로 실행
  3. 프로젝트 루트를 인식시키면 commonMain, androidMain, iosMain 구조를 자동으로 파악

여기서 중요한 건 API 과금 체계입니다. claude.ai 구독(Pro/Max)과 Anthropic API Console 과금은 완전히 별개입니다. Claude Code는 API Console 쪽 크레딧을 사용하므로, claude.ai 구독만 있다면 별도로 API 키를 발급받아야 합니다.

KMP 특유의 테스트: 플랫폼 영향 파악

가장 궁금했던 건 "AI가 commonMain 코드 수정이 androidMain/iosMain에 미치는 영향을 파악하는가"였습니다.

expect/actual 함수 하나를 commonMain에서 수정하도록 지시했을 때:

  • 양쪽 actual 구현체를 모두 찾아서 시그니처를 맞춰야 한다는 걸 인식했습니다
  • 다만 iOS 쪽 빌드는 로컬에서 직접 컴파일해서 검증하지 못하는 환경이라, 실제 컴파일 확인은 사람이 해야 했습니다

실전 예시: Todo 완료 상태 필터 추가하기

  1. "완료된 항목만 보기 토글을 추가해줘"라고 지시
  2. TodoViewModel에 StateFlow 필터 로직 추가
  3. Compose UI에 토글 버튼 추가
  4. Koin 모듈 변경 없이도 기존 DI 그래프에 자연스럽게 편입되는지 확인

이 정도 규모의 변경은 파일 3~4개를 오가며 일관성 있게 처리해줬습니다.

장단점

장점

  • 여러 파일에 걸친 수정을 한 번에 처리
  • 커밋 메시지까지 자동으로 정리해줌
  • 터미널 기반이라 CI 스크립트 등에도 응용 가능

단점

  • iOS 실기기/시뮬레이터 빌드 검증은 결국 사람 몫
  • API Console 과금이 별도라 비용 체감이 claude.ai 구독보다 직접적
  • KMP처럼 상대적으로 마이너한 생태계는 학습 데이터가 적어 가끔 오래된 API를 제안하기도 함

마무리

작은 팀이나 1인 개발 환경에서는 Claude Code가 "리뷰어 겸 페어 프로그래머" 역할을 꽤 잘 해줍니다. 다만 KMP 특유의 멀티플랫폼 빌드 검증은 여전히 사람이 마지막 확인을 해줘야 한다는 걸 감안하고 워크플로우를 짜는 게 좋습니다.