안드로이드 스튜디오에서 Claude Code 사용하는 방법
안드로이드 스튜디오에서 Claude를 코딩 에이전트로 쓰고 싶을 때 가장 먼저 부딪히는 질문이 있다. "API 키를 발급받아야 하나, 아니면 이미 쓰고 있는 Claude Pro/Max 구독으로 되나?" 결론부터 말하면 연동 방식이 두 가지이고, 어느 쪽을 고르느냐에 따라 결제 체계가 완전히 달라진다. 이 글에서는 두 방식의 차이, API 키 없이 구독만으로 연동하는 절차, 그리고 사용량 제한까지 실제로 필요한 내용을 정리한다.
두 가지 연동 방식: 무엇이 다른가
안드로이드 스튜디오에 Claude를 연결하는 경로는 크게 두 가지다.
방법 1: 내장 AI Agent에 모델 추가 (Remote Model Provider)
안드로이드 스튜디오의 공식 기능인 Remote Model Provider를 이용해 내장 AI Agent(Agent Mode)에 Claude를 모델 제공자로 등록하는 방법이다. 절차는 다음과 같다.
- Anthropic Console(console.anthropic.com)에서 API 키를 발급하고 결제수단을 등록한다.
File > Settings(macOS는Android Studio > Settings) → Tools > AI > Model Providers로 이동한다.- Add → Third-Party Remote Provider를 선택하고, URL에
https://api.anthropic.com, API key에 발급받은 키를 입력한다. - Refresh를 누르면 Claude Sonnet, Opus, Haiku 등 모델 목록이 표시되고, 선택 후 저장하면 채팅창의 모델 선택기에서 Claude를 고를 수 있다.
이 방식은 BYOK(Bring Your Own Key) 구조라 API 키가 반드시 필요하고 토큰 사용량에 따라 별도 과금된다. Claude Pro/Max 구독은 여기에 적용되지 않는다. 또한 외부 모델을 연결하면 코드와 프롬프트가 해당 제공자 서버로 전송되므로 데이터 처리 정책을 확인해야 하고, 일부 안드로이드 스튜디오 특화 AI 기능은 외부 모델과 완전히 호환되지 않을 수 있다.
방법 2: Claude Code 플러그인 (API 키 불필요)
Anthropic이 직접 만든 JetBrains 플러그인 "Claude Code [Beta]"를 설치하는 방법이다. 안드로이드 스튜디오는 IntelliJ 플랫폼 기반이라 그대로 호환된다. 이 방식은 API 키 대신 브라우저 로그인으로 Claude Pro/Max 구독 계정에 인증하므로, 이미 구독 중이라면 추가 비용 없이 사용할 수 있다. diff 뷰어 통합이 가장 큰 장점으로, 변경 제안을 채팅창 코드 블록이 아니라 익숙한 side-by-side diff 화면에서 확인할 수 있다.
비교 정리
| 항목 | 내장 AI Agent (Remote Model Provider) | Claude Code 플러그인 |
|---|---|---|
| API 키 | 필수 | 불필요 |
| 결제 방식 | 토큰 사용량별 과금 (Console 충전) | Pro/Max 구독 |
| 인증 | API 키 입력 | 브라우저 OAuth 로그인 |
| UI | 기본 Agent UI | 플러그인 + 통합 터미널 + diff 뷰어 |
한 가지 분명히 해둘 점이 있다. 안드로이드 스튜디오의 기본 Agent UI를 그대로 쓰면서 Claude 구독만으로 사용하는 방법은 없다. 구독을 활용하려면 반드시 Anthropic 공식 Claude Code 플러그인 또는 CLI를 써야 한다. 반대로 기본 Agent UI가 꼭 필요하다면 API 키 발급이 유일한 길이다. 이미 Pro/Max 구독자라면 Claude Code 플러그인 쪽이 경제적이다.
API 키 없이 연동하는 설치 절차
구독 기반 연동은 네 단계면 끝난다. 사전에 Node.js 18 이상이 설치되어 있어야 한다.
- CLI 설치: 터미널에서
npm install -g @anthropic-ai/claude-code를 실행한다. - 구독 계정 로그인:
claude를 실행하면 브라우저가 열리고, Claude.ai 계정(Pro/Max)으로 로그인하면 인증이 완료된다. API 키 입력 단계가 없고, 인증 정보는 로컬에 저장되어 매번 로그인할 필요가 없다. - 플러그인 설치: 안드로이드 스튜디오에서
File > Settings > Plugins→ Marketplace 탭에서 "Claude Code"를 검색해 설치한다. - IDE 재시작 후 사용: 플러그인은 IDE를 완전히 재시작해야 적용된다. 통합 터미널(Windows/Linux는 Alt+F12, macOS는 Option+F12)에서
claude를 입력하면 diff 뷰어 통합 등 모든 기능이 활성화된다.
주의할 점은 반드시 프로젝트 루트 디렉토리에서 실행해야 한다는 것이다. 하위 디렉토리에서 실행하면 Claude가 그 부분만 볼 수 있다.
정품 플러그인 확인 방법
Marketplace에서 "Claude Code"를 검색하면 비슷한 이름의 플러그인이 여럿 나온다. 반드시 publisher가 "Anthropic PBC"인 "Claude Code [Beta]"를 설치해야 한다. PBC는 Public Benefit Corporation의 약자로 Anthropic의 법인 형태다. 다운로드 수가 가장 많고 Claude 공식 로고가 붙어 있다. 이름이 비슷한 다른 플러그인들은 제3자가 만든 것이므로 설치하지 않는 것이 좋다.
사용량 제한은 어떻게 되나
구독 기반으로 Claude Code를 쓰면 무제한이 아니다. Pro와 Max 요금제에는 5시간 단위 제한에 더해 7일 주기로 초기화되는 주간 사용량 제한이 적용되며, 전체 사용량 제한과 Opus 전용 제한 두 가지가 있다. 한도에 도달하면 Max 구독자는 초과분을 표준 API 요금으로 추가 구매(Extra Usage)할 수 있다. Anthropic 측은 이 기준이 사용자 대부분에게는 영향이 없는 수준이라고 밝히고 있다.
또 하나 알아둘 것은 정책 방향이다. Anthropic은 구독 계정을 OAuth로 서드파티 자동화 도구에 연결해 호출을 쏟아내는 사용 패턴을 차단하고 있다. 반면 Claude Code에 직접 작업을 지시하는 것은 Anthropic이 권장하는 정상 사용 방식이므로, 일반적인 개발 작업이라면 가장 안정적이고 정책상으로도 안전하다.
활용 팁
- CLAUDE.md 파일: 프로젝트 루트에 CLAUDE.md를 만들어 프로젝트 컨벤션과 아키텍처 규칙을 적어두면 Claude가 자동으로 참고한다.
- Gradle 빌드: Gradle은 시작만 10~30초 걸리므로, 빠른 반복 작업에서는 Claude에게 코드 생성만 맡기고 빌드는 안드로이드 스튜디오에서 직접 돌리는 편이 낫다.
- 런타임 디버깅: Claude Code는 실행 중인 에뮬레이터 화면을 볼 수 없고 Logcat을 실시간으로 읽지 못한다. 크래시가 나면 Logcat 출력을 복사해 대화창에 붙여넣으면 잘 분석해준다.
- 활용 예시: Room 데이터베이스 모델 생성, Retrofit 응답 처리, Jetpack Compose UI 작성, Gradle 의존성 충돌 해결, 리팩토링 등에 적합하다. 처음에는 함수명 변경 같은 작은 작업부터 시켜보며 감을 잡는 것이 좋다.
정리
안드로이드 스튜디오에서 Claude를 쓰는 길은 두 갈래다. 기본 Agent UI에서 쓰려면 API 키를 발급해 Remote Model Provider로 등록해야 하고(종량 과금), 이미 Pro/Max 구독자라면 Anthropic 공식 Claude Code [Beta] 플러그인으로 추가 비용 없이 연동하는 것이 정답이다. 설치는 CLI 설치 → 브라우저 로그인 → 플러그인 설치 → IDE 재시작의 네 단계면 충분하며, 5시간·주간 사용량 제한이 있다는 점만 기억해두면 된다.
※ 요금제, 사용량 제한 정책, 플러그인 명칭은 2026년 기준이며 변경될 수 있습니다.
댓글
댓글 쓰기