지원되는 IDE에서 JetBrains AI Assistant 활성화 및 환경 설정 가이드

JetBrains AI Assistant는 생성형 AI 코딩 기능, 자율 다단계 에이전트, 깊이 있는 시맨틱 코드 인텔리전스를 IntelliJ IDEA, PyCharm, WebStorm, GoLand, CLion, Rider, PhpStorm, RubyMine, RustRover, DataGrip, DataSpell 등 JetBrains 개발 환경에 직접 통합한다. 이 어시스턴트는 단순한 독립형 챗 인터페이스나 일반 텍스트 예측기에 머무르지 않고, IDE 내부의 프로젝트 인덱스, 추상 구문 트리(AST), 버전 관리 시스템과 밀접하게 연계되어 컨텍스트 인식 코드 생성, 여러 줄 자동 완성, 다음 편집 제안(Next Edit Suggestions), 자동화된 테스트 작성 및 구조적 리팩터링을 지원한다. JetBrains AI Assistant를 성공적으로 배포하고 구성하려면 소프트웨어 개발자와 엔지니어링 리드가 IDE 버전 전제 조건을 확인하고, 개인 또는 기업 티어에 따른 설치 및 라이선스 활성화를 완료하며, 에디터 내 완성 매개변수를 조정하고, 저장소 수준의 프로젝트 규칙을 수립하며, 모델 제공업체 및 외부 Model Context Protocol(MCP) 도구에 대한 보안 경계를 설정해야 한다.

IDE 호환성 및 필수 버전 요건

JetBrains AI Assistant를 활성화하기 전에 개발자는 로컬 환경이 특정 런타임, 플랫폼 및 조직 기준을 충족하는지 확인해야 한다.

지원 환경 및 IDE 기준 버전

JetBrains AI Assistant는 전체 JetBrains 제품군에서 사용할 수 있는 플러그인 형태로 배포된다. 지원되는 IDE는 다음과 같은 기준 릴리스를 충족해야 한다:

• 상용 JetBrains IDE: IntelliJ IDEA Ultimate, PyCharm Professional, WebStorm, CLion, GoLand, Rider, PhpStorm, RubyMine, RustRover, DataGrip, DataSpell을 포함한 모든 상용 IDE의 2023.3 이상 버전과 호환된다.
• Community Edition IDE: 오픈소스 Community 에디션(예: IntelliJ IDEA Community Edition, PyCharm Community Edition)의 경우 2024.1.1 이상 버전이 필요하다. Community 에디션 내에서 조직 단위의 JetBrains AI 구독을 연결하려면 2024.2.1 이상의 버전을 실행해야 한다.
• 크로스 플랫폼 지원: 호스트 IDE의 표준 시스템 요구 사항을 충족하는 64비트 Windows, macOS(Intel 및 Apple Silicon), Linux 워크스테이션을 지원한다.

연산 토폴로지: 클라우드 LLM 대 로컬 하드웨어

기본적으로 JetBrains AI Assistant는 JetBrains AI 서비스 또는 서드파티 API 제공업체가 관리하는 클라우드 호스팅 대규모 언어 모델(LLM)을 통해 추론을 수행한다. 이 구성에서는 개발자 워크스테이션의 CPU, GPU 또는 배터리에 추가적인 부하가 거의 발생하지 않는다.

그러나 자체 호스팅 오픈 웨이트 모델(예: Ollama 또는 프라이빗 OpenAI 호환 추론 엔드포인트)을 사용하는 팀은 실시간 토큰 스트리밍을 지원하기 위해 충분한 전용 VRAM(파라미터 양자화 수준에 따라 일반적으로 8GB~24GB)을 포함한 전용 워크스테이션 연산 자원을 할당해야 한다.

조직 차원의 사전 요구 사항

고용주나 교육 기관에서 제공한 IDE 라이선스를 사용하는 개발자의 경우, AI 기능에 대한 접근 권한은 조직 수준에서 관리된다:

1. 조직 관리자는 엔터프라이즈 JetBrains Account 관리 콘솔 내에서 JetBrains AI 서비스를 활성화해야 한다.
2. 조직이 엄격한 지식재산권 거버넌스 또는 보안 정책을 적용하는 경우, 관리자는 개발자가 활성화를 시작하기 전에 공유 크레딧 풀을 할당하거나 승인된 서드파티 제공업체를 지정할 수 있다.

JetBrains AI Assistant 설치 및 활성화

JetBrains AI Assistant 플러그인은 개인 설치 환경에서 기본적으로 활성화되어 있지 않으며, 명시적으로 설치 및 활성화하기 전까지는 독점 소스 코드에 접근하지 않는다.

설치 방법

개발자는 지원되는 IDE에서 세 가지 주요 경로를 통해 플러그인을 설치할 수 있다:

1. JetBrains Marketplace (Settings):
   • Windows/Linux에서는 Ctrl+Alt+S, macOS에서는 Cmd+,를 눌러 Settings 또는 Preferences로 이동한다.
   • 왼쪽 사이드바에서 Plugins를 선택하고 Marketplace 탭을 클릭한다.
   • 검색창에 AI Assistant를 입력하여 검색한다.
   • 공식 JetBrains 플러그인 항목에서 Install을 클릭하고, 안내 메시지가 나타나면 IDE를 다시 시작한다.
2. AI Chat 도구 창:
   • 오른쪽 도구 창 도크에서 AI Chat 아이콘을 클릭한다.
   • 빈 도구 창에 표시되는 Install Plugin 버튼을 클릭하여 백그라운드 설치를 시작한다.
3. JetBrains AI 창 헤더 위젯:
   • 최신 IDE UI 헤더에서 JetBrains AI 상태 위젯을 찾는다.
   • Let's Go를 클릭하여 플러그인을 자동으로 다운로드하고 초기화한다.

라이선스 티어 및 활성화 시나리오

설치가 완료되면 개발자는 적절한 라이선스 모델을 사용하여 플러그인을 활성화해야 한다. JetBrains는 여러 활성화 시나리오에 따라 다양한 인증 방식을 지원한다:

라이선스 티어 상세 정보

• AI Free: 제한된 월간 AI 크레딧으로 경량 클라우드 모델에 대한 기본 접근 권한을 제공하며, 구독이 만료된 사용자 또는 무료 티어 사용자에게 자동으로 부여된다.
• AI Pro: 넉넉한 월간 쿼터, 우선 모델 라우팅, 최첨단 LLM(GPT-4o, Claude 3.5 Sonnet, Gemini 1.5 Pro 포함) 지원을 제공하는 표준 개인용 구독이다. JetBrains All Products Pack 또는 dotUltimate 보유자는 대체로 AI Pro 권한을 기본으로 받는다.
• Pro Trial: 최초 활성화 시 새로운 JetBrains Account에 자동으로 부여되는 30일 완전 기능 평가판 라이선스이다.
• AI Business / Enterprise: 중앙 집중식 청구, 사용자 할당 제어, 공유 크레딧 풀, JetBrains AI Enterprise를 통한 온프레미스 하이브리드 배포 옵션을 갖춘 팀 대상 확장형 플랜이다.

법적 동의 및 이용 약관 동의

초기 활성화 핸드셰이크 단계에서 개발자는 JetBrains AI 서비스 약관과 허용 가능한 사용 정책(AUP)을 검토하고 수락해야 한다. 이 약관은 추론을 위해 전송된 소스 코드가 임시로만 처리되며, 공개 파운데이션 모델을 훈련하는 데 보관되거나 사용되지 않음을 법적으로 명시한다.

IDE 핵심 구성 및 동작 설정

플러그인의 전역 구성 옵션은 Settings | Tools | AI Assistant(macOS는 Preferences | Tools | AI Assistant)에 모여 있다. 설정 참조 문서를 확인하면 개발자가 코딩 습관에 맞춰 도구를 최적화할 수 있다.

Settings / Preferences
  ├── Tools
  │     └── AI Assistant
  │           ├── General Features (Name suggestions, pasted code, PR summaries)
  │           ├── Providers & API keys (BYOK, OAuth, Model selection)
  │           ├── Rules (Project-specific instructions)
  │           ├── Prompt Library (Custom prompt templates)
  │           ├── Skills (Debugger and runtime tools)
  │           └── Agents (ACP agent registries)
  └── Editor
        └── General
              └── Code Completion
                    └── Inline (Cloud completion, Next Edit Suggestions)

자동화 기능 토글

개발자는 방해가 되는 제안을 방지하기 위해 특정 지원 기능의 토글을 켜거나 끌 수 있다:

• Provide AI-generated name suggestions: 인플레이스 심볼 리팩터링(Shift+F6) 시 문맥에 적합한 변수, 함수, 클래스 식별자 이름을 제안한다.
• Suggest converting pasted code to target file language: 다른 언어로 작성된 코드(예: Java 파일에 붙여넣은 Python 스니펫)가 에디터에 삽입되었을 때 이를 자동으로 감지하고 대상 파일 언어로 문법을 변환하도록 제안한다.
• Generate a title for the shelved changelist: 변경 사항 분석을 바탕으로 보류(Shelve)된 Git 변경 집합에 대해 간결하고 명확한 제목을 자동으로 생성한다.
• GitHub Plugin: Generate PR summaries: 내장 GitHub 도구 창을 통해 PR을 생성하거나 검토할 때 커밋과 수정된 파일을 분석하여 구조화된 풀 리퀘스트 설명을 작성한다.

자연어 맞춤 설정

기본적으로 AI Assistant는 시스템 언어 또는 영어로 응답한다. 다국어 환경에서 작업하는 팀은 Settings | Tools | AI Assistant | Natural Language에서 선호하는 자연어를 지정하여 코드 설명, 독스트링(Docstring), 커밋 메시지가 필요한 업무 언어로 작성되도록 설정할 수 있다.

메시지 트리밍 임계값 (Message Trimming Threshold)

대규모 코드베이스를 다룰 때 여러 소스 파일을 첨부하면 대용량 컨텍스트 윈도우라도 빠르게 한계에 도달할 수 있다. Settings | Tools | AI Assistant에서 개발자는 Message Trimming Threshold(모델의 전체 컨텍스트 윈도우에 대한 백분율로 지정)를 설정할 수 있다. 첨부된 페이로드가 이 임계값을 초과하면 AI Assistant는 관련 함수 시그니처와 호출부는 유지한 채 외곽의 덜 중요한 구조를 자동으로 트리밍하여 컨텍스트 초과 토큰 예외를 방지한다.

에디터 내 코드 완성 및 Next Edit Suggestions 구성

JetBrains IDE는 로컬 온디바이스 완성 엔진과 원격 클라우드 완성 엔진으로 구성된 듀얼 엔진 아키텍처를 채택하고 있다.

로컬 Full Line 완성 대 클라우드 다중 라인 완성 비교

최적의 환경을 구성하려면 두 완성 방식 간의 차이를 이해하는 것이 중요하다:

1. Full Line 코드 완성 (Full Line Code Completion): IDE에 직접 내장된 언어별 소형 신경망 모델을 사용하여 개발자의 워크스테이션에서 전적으로 로컬로 실행된다. 네트워크 지연 없이 오프라인으로 작동하며, AI 크레딧을 소비하지 않고 코드를 머신 외부로 전송하지 않는다.
2. 클라우드 코드 완성 (Cloud Code Completion): AI Assistant 클라우드 LLM으로 구동된다. 더 광범위한 파일 컨텍스트를 기반으로 여러 줄 코드 구조, 메서드 전체 본문, 알고리즘 로직 및 함께 작성되는 문서화 주석을 생성한다.

인라인 완성 매개변수 구성

인라인 완성을 세부 조정하려면 Settings | Editor | General | Code Completion | Inline으로 이동한다:

• Enable Cloud-Based Multi-Line Completions: 타이핑하는 동안 AI Assistant가 하나 이상의 줄에 걸쳐 회색 고스트 텍스트(Ghost Text)를 표시할 수 있도록 하려면 이 옵션을 선택한다.
• Next Edit Suggestions (NES): 활성화되면 AI Assistant가 최근 변경 사항을 분석하여 다음에 필요한 편집을 예측하고, 후속 수정을 제안하여 개발자가 관련된 위치(예: 메서드 시그니처 변경 후 인터페이스 구현 업데이트)로 바로 이동할 수 있도록 지원한다.
• Trigger Delay (Debounce): 클라우드 완성 요청을 트리거하기 전 필요한 입력 일시 정지 시간을 설정한다. 네트워크 지연이 심하거나 종량제 모바일 연결을 사용하는 개발자는 이 대기 시간을 늘려 불필요한 API 왕복 호출을 줄일 수 있다.

단축키 및 제안 수락 제어

인라인 고스트 제안은 표준 키 바인딩을 통해 수락하거나 취소할 수 있다:

• 전체 제안 수락: Tab 키를 누른다.
• 다음 단어 수락: Ctrl+오른쪽 화살표(Windows/Linux) 또는 Option+오른쪽 화살표(macOS)를 눌러 토큰 단위로 부분 수락한다.
• 다음 줄 수락: Ctrl+아래쪽 화살표 또는 지정된 커스텀 키를 눌러 한 줄씩 수락한다.
• 제안 취소: Esc 키를 누르거나 호환되지 않는 문자를 계속 입력한다.
• 수동 트리거: 자동 인라인 제안이 비활성화된 경우 Alt+\(Windows/Linux) 또는 Option+\(macOS)를 눌러 필요할 때 수동으로 완성을 호출할 수 있다.

AI Chat, 컨텍스트 관리 및 프로젝트 규칙

AI Chat 도구 창은 여러 파일, 스택 트레이스, 프로젝트 히스토리를 아우르며 추론할 수 있는 대화형 페어 프로그래밍 환경을 제공한다.

멘션을 활용한 컨텍스트 참조

채팅 프롬프트 창에 소스 코드 스니펫을 직접 복사해 붙여넣는 대신 @ 기호 멘션을 사용하여 명확한 컨텍스트를 전달하는 것이 좋다:

• @file:path/to/File.java: 특정 프로젝트 파일의 내용을 프롬프트 페이로드에 포함한다.
• @symbol:ClassName#methodName: 특정 클래스, 인터페이스, 함수의 선언부, 문서화 주석 및 구현부를 삽입한다.
• @folder:src/main/services: 디렉터리 구조와 모듈 인터페이스를 전달한다.
• @commit:hash: 코드 리뷰 및 회귀 분석을 위해 Git 커밋 diff 및 메타데이터를 제공한다.

/docs를 통한 공식 문서 검색

IDE 사용 안내가 필요한 개발자는 채팅 프롬프트에서 /docs 명령어를 사용하여 JetBrains 공식 문서를 직접 검색할 수 있다. 예를 들어 다음과 같이 입력하면 된다:

/docs how do I configure remote Docker debugging for GoLand?

이 명령어는 JetBrains 공식 제품 문서를 대상으로 RAG(검색 증강 생성) 쿼리를 실행하여, IDE 설정 대화상자로 바로 연결되는 딥링크와 함께 정확한 실행 절차를 안내한다.

커스텀 프롬프트 라이브러리 (Prompt Library)

개발 팀에서는 리포지토리 클래스 생성, HTTP 클라이언트 모킹, 레거시 프레임워크 마이그레이션 등 반복적인 아키텍처 패턴을 자주 구현한다. 개발자는 Settings | Tools | AI Assistant | Prompt Library를 통해 이러한 프롬프트를 표준화할 수 있다:

1. 추가(+) 버튼을 클릭하여 새 커스텀 프롬프트 템플릿을 생성한다.
2. 설명이 담긴 제목을 정의한다(예: Generate Spring Data JPA Repository).
3. 강조 표시된 코드를 나타내는 $SELECTION과 같은 동적 플레이스홀더를 사용하여 템플릿 텍스트를 작성한다.
4. 원클릭으로 빠르게 실행할 수 있도록 에디터 컨텍스트 메뉴에 프롬프트를 지정한다.

프로젝트 규칙(ai-rules.md)을 통한 표준 준수 강제

AI Assistant가 저장소의 규칙에 어긋나는 코드를 생성하지 못하도록 방지하기 위해, 팀은 Settings | Tools | AI Assistant | Rules에서 영구적인 프로젝트 규칙을 수립하거나 저장소 루트에 .jetbrains/ai-rules.md 마크다운 파일을 커밋할 수 있다.

효과적인 규칙 파일은 아키텍처 경계, 코딩 스타일 가이드, 테스트 패턴에 대해 어시스턴트에게 명확한 지침을 제공한다:

# Project Architectural Guidelines

## Technology Stack
- Java 21 LTS with Spring Boot 3.3
- Build Tool: Gradle with Kotlin DSL
- Testing: JUnit 5, AssertJ, and Testcontainers (avoid Mockito for integration tests)

## Code Conventions
- Prefer immutable records for Data Transfer Objects (DTOs).
- Enforce explicit constructor injection; do not use field-level `@Autowired`.
- All public REST controllers must return `ResponseEntity<T>` with OpenAPI 3 annotations.
- Handle database operations asynchronously via R2DBC where reactive pipelines are present.

## Security Constraints
- Never log raw authorization tokens, customer personally identifiable information (PII), or passwords.
- Enforce parameter binding on all SQL and JPQL queries to prevent injection vulnerabilities.

AI Assistant는 .jetbrains/ai-rules.md를 읽어 저장소 내에서 전송되는 모든 프롬프트에 해당 제약 조건을 덧붙이므로, 생성되는 코드가 팀의 기준을 엄격히 준수하도록 보장한다.

코딩 에이전트, ACP 및 Model Context Protocol (MCP)

최신 JetBrains AI Assistant는 수동적인 코드 제안을 넘어 능동적이고 자율적인 에이전트 워크플로로 확장되었다.

자율 코딩 에이전트

Settings | Tools | AI Assistant | Agents에서 개발자는 특화된 코딩 에이전트를 구성할 수 있다:

• Junie: 다중 파일 리팩터링, 자율 버그 수정, 테스트 생성을 위해 개발된 JetBrains 자체 에이전트이다. Junie는 단계별 실행 계획을 수립하고, 파일을 수정하며, 로컬 터미널 명령이나 테스트 실행기를 구동한 뒤 개발자가 검토할 수 있도록 통합 diff를 제시한다.
• Claude Agent 및 OpenAI Codex: 제공업체 계정이나 API 키를 사용하여 엔드투엔드 코딩 작업을 수행하는 통합 환경이다.
• Agent Client Protocol (ACP): 개발자가 별도의 커스텀 IDE 플러그인을 개발하지 않고도 사내 구축 에이전트나 독점 서드파티 에이전트를 IDE에 직접 연동할 수 있도록 지원하는 표준화된 프로토콜이다.

Model Context Protocol (MCP) 도구 연동

MCP 도구를 통해 AI Assistant는 외부 환경, 데이터베이스, 컨테이너 엔진 및 엔터프라이즈 이슈 트래커와 상호 작용할 수 있다.

보안을 유지하기 위해 개발자는 Settings | Tools | AI Assistant에서 데이터베이스 권한을 명시적으로 구성해야 한다:

• Read database schemas: 정확한 SQL 쿼리를 생성하기 위해 MCP 에이전트가 테이블, 컬럼 유형, 인덱스를 검사하도록 허용한다.
• Modify database schemas: 에이전트가 DDL 마이그레이션 구문(CREATE, ALTER, DROP)을 생성하고 실행할 수 있는지 제어한다.
• Read database data: 데이터 문제를 디버깅하기 위해 에이전트가 쿼리를 실행하고 결과를 확인할 수 있도록 허용한다.
• Modify database data: 에이전트가 INSERT, UPDATE, DELETE 구문을 실행하기 전에 명시적인 승인을 요구한다.

서드파티 제공업체 및 커스텀 모델 (BYOK)

AI 관련 지출을 일원화하거나 사내 모델 게이트웨이를 활용하고자 하는 조직은 Bring Your Own Key 구성을 통해 AI Assistant를 JetBrains 관리형 클라우드 구독과 분리하여 운영할 수 있다.

서드파티 제공업체 구성

Settings | Tools | AI Assistant | Providers & API keys로 이동한다:

1. Add Provider를 클릭하고 지원되는 상용 공급업체 중에서 선택한다:
   • OpenAI: gpt-4o 또는 o1과 같은 모델에 접근할 수 있는 OpenAI 플랫폼 API 키가 필요하다.
   • Anthropic: claude-3-5-sonnet 또는 claude-3-opus를 지원하는 Anthropic API 키가 필요하다.
   • Google Cloud Vertex AI: 애플리케이션 기본 자격 증명(ADC) 또는 서비스 계정 키를 통해 인증한다.
2. 인증 정보를 입력하고 연결 지연 시간을 테스트한다.
3. 기능별로 모델을 할당한다(예: 인라인 코드 완성에는 빠른 모델을, AI Chat 및 리팩터링에는 심층 추론 모델을 할당).

로컬 및 커스텀 엔드포인트 연결

에어갭(폐쇄망) 환경이나 프라이빗 데이터 센터의 경우 개발자는 커스텀 모델을 선택할 수 있다:

+-------------------------------------------------------------+
|                      Local Workstation                      |
|                                                             |
|  +------------------------+      +-----------------------+  |
|  |     JetBrains IDE      |      |     Ollama Server     |  |
|  |  (AI Assistant Plugin) | ---> | (http://localhost:    |  |
|  |                        | <--- |  11434/v1)            |  |
|  +------------------------+      +-----------------------+  |
+-------------------------------------------------------------+

1. OpenAI 호환 API를 제공하는 로컬 추론 서버(예: Ollama, vLLM, LM Studio)를 실행한다.
2. Providers & API keys에서 Custom OpenAI-Compatible 공급자를 추가한다.
3. 베이스 URL(예: Ollama의 경우 http://localhost:11434/v1)을 설정하고 로드된 모델 식별자(예: qwen2.5-coder:32b, deepseek-coder-v2)를 지정한다.
4. 외부 WAN 유출 없이 로컬 코드 완성이 에디터로 정상적으로 스트리밍되는지 확인한다.

데이터 거버넌스, 개인정보 보호 및 엔터프라이즈 제어

상용 환경에 AI 코딩 어시스턴트를 도입할 때는 투명한 데이터 프라이버시 보장과 감사 체계가 필수적이다.

데이터 전송 및 모델 훈련 경계

JetBrains는 공식 문서와 트러스트 센터(Trust Center)를 통해 데이터 처리의 명확한 경계를 규정하고 있다:

• 베이스 모델 훈련 배제: 고객의 소스 코드, 컨텍스트 페이로드, 생성된 완성 코드는 JetBrains나 모델 파트너사에 보관되지 않으며 기본 파운데이션 모델을 훈련하는 데 결코 사용되지 않는다.
• 임시 처리 원칙(Ephemeral Processing): JetBrains AI 서비스를 통해 라우팅되는 프롬프트는 추론 실행 및 로깅 규정 준수 목적으로만 메모리에 임시 보관되며 처리 후 즉시 폐기된다.
• 데이터 공유 옵트인 정책: Send detailed code-related data 설정은 기본적으로 비활성화되어 있다. 수동으로 활성화하더라도 원격 측정 데이터는 익명화되어 JetBrains IDE 기능의 성능 평가에만 사용된다.

기업 방화벽, 프록시 및 SSL 검사

기업 보안 경계 내에서 작동하는 개발자 워크스테이션은 안전한 아웃바운드 통신을 허용해야 한다:

• 게이트웨이 엔드포인트: *.jetbrains.com 및 지정된 서드파티 모델 엔드포인트에 대한 아웃바운드 HTTPS(포트 443) 및 WebSocket(WSS) 연결을 허용 목록에 추가한다.
• 기업 SSL 검사: 사내 보안 어플라이언스가 자체 내부 인증 기관(CA)을 사용하여 TLS 트래픽을 가로채고 복호화하는 경우, 개발자는 TLS 핸드셰이크 실패를 방지하기 위해 기업 CA 인증서를 호스트 IDE의 신뢰할 수 있는 인증서 저장소(Settings | Tools | Server Certificates)에 추가해야 한다.

쿼터 모니터링 및 비활성화 옵션

창 헤더에 위치한 JetBrains AI 상태 위젯은 사용 현황에 대한 실시간 가시성을 제공한다:

• 구독 쿼터: 잔여 월간 AI 크레딧을 추적하고 월별 쿼터 갱신 날짜를 표시한다.
• 탑업 크레딧 (Top-Up Credits): 고부하 에이전트 작업으로 기본 쿼터가 소진되었을 때 개인 개발자나 팀이 추가 크레딧을 구매할 수 있다.
• 공유 풀 관리: 기업 라이선스 서버에 연결된 경우 크레딧 소비 현황을 동적으로 보여준다.

AI Assistant 사용을 일시 중단해야 하는 경우 위젯 메뉴를 통해 단일 프로젝트에 대해 기능을 비활성화하거나, 로컬 Full Line 완성은 유지하면서 클라우드 완성만 끄거나, IDE 전체에서 플러그인을 완전히 제거하는 등의 옵션을 선택할 수 있다.