Source: https://aiprimetech.io/ko/learn/use-claude-api-with-jetbrains/

[홈](/ko/) / [학습](/ko/learn/) / JetBrains IDE에서 무제한 Claude 사용 

# JetBrains IDE에서 Claude 무제한 사용 

IntelliJ IDEA, PyCharm, WebStorm, GoLand 등을 포함한 JetBrains IDE는 JetBrains Marketplace에서 제공되는 Continue 플러그인을 통해 Claude를 지원합니다. Continue는 모든 JetBrains 제품에서 동일하게 작동하는 공유 설정 파일을 사용하므로, 한 번 설정하면 사용하는 모든 IDE에서 Claude를 이용할 수 있습니다. 무제한 게이트웨이를 통해 연결하면 각 IDE에서 토큰별 요금이 누적되지 않으면서 모든 IDE에서 AI 어시스턴트를 언제든 사용할 수 있습니다. 

## 모든 JetBrains IDE에 Continue 설치하기 

JetBrains IDE를 열고 설정(Ctrl+Alt+S)으로 이동한 다음 플러그인을 선택하세요. Marketplace 탭에서 Continue를 검색하고 설치를 클릭하세요. 이 플러그인은 2023.1 버전 이후의 모든 JetBrains IDE에서 작동합니다. 여기에는 IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, RubyMine, CLion, Rider, DataGrip이 포함됩니다. IDE마다 설치해야 하지만, 모두 같은 설정 파일을 공유합니다. 

설치 후 IDE를 다시 시작하면 오른쪽 사이드바에 Continue 패널이 표시됩니다. 처음 실행하면 ~/.continue/에 설정 디렉터리와 기본 config.yaml 파일이 생성됩니다. 무제한 게이트웨이를 통해 Claude를 연결하려면 이 파일 하나만 편집하면 됩니다. 모든 JetBrains IDE가 같은 파일을 읽으며, VS Code에서도 Continue를 사용한다면 동일한 파일을 읽습니다. 

Continue 플러그인은 채팅(사이드바의 대화형 AI), 편집(인라인 코드 수정), 적용(제안된 변경 사항을 파일에 적용)이라는 주요 기능을 제공합니다. 각 기능에 서로 다른 모델을 할당할 수 있어, 어떤 Claude 모델이 어떤 작업을 처리할지 세밀하게 제어할 수 있습니다. 

## 무제한 Claude를 위한 config.yaml 설정 

텍스트 편집기에서 ~/.continue/config.yaml을 여세요. 이 파일은 YAML 형식을 사용하며, 사용 가능한 AI 공급자를 정의하는 models 배열이 있습니다. 새 모델 항목을 추가하고 provider를 anthropic으로, apiBase를 https://unlimited.aiprimetech.io로(/v1이 없는 루트 호스트 — SDK가 경로를 추가함), apiKey를 AI Prime Tech Unlimited 키로 설정하세요. 

각 모델 항목에는 title(UI에 표시되는 이름), model(모델 식별자), 공급자 설정이 필요합니다. 사용할 각 Claude 모델의 항목을 만드세요. 일상적으로 사용할 Sonnet 항목, 복잡한 추론을 위한 Opus 항목을 만들고, 필요하다면 빠른 상호작용을 위한 Haiku 항목도 추가하세요. title 필드의 값이 Continue 모델 선택 목록에 표시됩니다. 

anthropic 대신 openai 공급자 유형을 사용할 수도 있습니다. 이 경우 apiBase를 https://unlimited.aiprimetech.io/v1로(/v1 포함) 설정하고, apiKey 필드에 키를 입력하면 Bearer 인증이 사용됩니다. anthropic 공급자 유형은 사고 블록 같은 네이티브 기능을 지원하고 Continue에서 스트리밍 동작이 더 원활하므로 권장됩니다. 

## 역할 할당: 채팅, 편집, 적용 

Continue에서는 서로 다른 역할에 서로 다른 모델을 할당할 수 있습니다. chat 역할은 코드 설명, 아키텍처 논의, 디버깅 지원 등 사이드바 대화를 처리합니다. edit 역할은 Ctrl+I로 실행하는 인라인 코드 수정을 처리하며, 선택한 코드를 대체할 코드를 생성합니다. apply 역할은 생성된 코드를 기존 파일에 병합하는 작업을 처리합니다. 

config.yaml에서 roles 배열을 사용해 각 모델의 역할을 설정하세요: roles: [chat, edit, apply]. 모든 역할이 할당된 모델은 모든 작업에 사용됩니다. 책임을 나누려면 역할 할당이 서로 다른 모델 항목을 여러 개 만드세요. 예를 들어 깊이 있는 추론 대화를 위해 Opus를 chat 역할에 할당하고, 빠른 인라인 수정을 위해 Sonnet을 edit 및 apply 역할에 할당하세요. 

무제한 요금제에서 최적의 전략은 Opus를 chat에 할당하고(복잡한 질문을 하고 철저한 분석이 필요한 경우), Sonnet을 edit 및 apply에 할당하는 것입니다(인라인 결과를 기다리므로 속도가 중요한 경우). 두 모델 모두 동일한 정액 요금에 포함되므로, 선택은 각 상호작용 유형에서 지연 시간과 품질 사이의 균형만 고려하면 됩니다. 

## .continuerc.json으로 프로젝트별 설정 재정의 

config.yaml은 전역 설정이지만, 프로젝트 루트의 .continuerc.json 파일을 사용해 프로젝트별로 설정을 재정의할 수 있습니다. 이는 프로젝트마다 서로 다른 모델 설정이 필요할 때 유용합니다. 예를 들어 Python 프로젝트에는 특정 시스템 프롬프트를 추가하는 것이 도움이 될 수 있고, 레거시 코드베이스는 특정 모델 버전에서 더 잘 작동할 수 있습니다. 

.continuerc.json 파일은 config.yaml과 같은 구조를 사용하지만 JSON 형식으로 작성됩니다. 프로젝트 파일에 지정된 설정은 해당 프로젝트에 대해서만 전역 설정을 재정의합니다. 일반적인 재정의 항목에는 사용자 지정 시스템 프롬프트(프로젝트별 코딩 규칙을 주입하기 위한 설정), 모델 선택(특정 코드베이스에 특정 모델 버전을 사용하기 위한 설정), 컨텍스트 공급자(프로젝트별 문서 소스를 추가하기 위한 설정)가 있습니다. 

무제한 요금제에서는 프로젝트별 설정 재정의를 통해 비용에 영향을 주지 않고 각 코드베이스에 맞게 AI 사용 환경을 조정할 수 있습니다. 복잡한 프로젝트에는 전체 아키텍처 문서를 포함한 상세한 시스템 프롬프트를 추가하세요. 까다로운 레거시 코드베이스에는 Opus를 기본 모델로 사용하세요. 주로 빠른 조회가 필요한 프로젝트에는 Haiku를 사용하세요. 모든 설정에 동일한 정액 요금이 적용됩니다. 

## 컨텍스트 공급자와 코드베이스 인덱싱 

Continue는 요청에 추가 정보를 주입하는 컨텍스트 공급자를 지원합니다. 기본 제공 codebase 공급자는 프로젝트 파일을 인덱싱하고, 질문할 때 관련 코드 조각을 포함합니다. docs 공급자는 문서 URL을 인덱싱할 수 있습니다. terminal 공급자는 최근 터미널 출력을 포함합니다. 활성화된 각 공급자는 모든 요청에 토큰을 추가합니다. 

config.yaml의 contextProviders 섹션에서 컨텍스트 제공자를 구성하세요. codebase 제공자는 임베딩 모델을 사용해 프로젝트를 인덱싱합니다. 이 작업은 로컬에서 실행되며 API 토큰을 소비하지 않습니다. 다만 검색된 컨텍스트 스니펫은 Claude로 전송되는 프롬프트에 포함되어 요청당 토큰 수를 늘립니다. 코드베이스 인덱스가 크면 요청마다 5,000-15,000 토큰이 추가될 수 있습니다. 

무제한 요금제에서는 응답 품질을 높이는 모든 컨텍스트 제공자를 활성화하세요. Claude에 관련 컨텍스트가 많을수록 답변이 더 좋아집니다. 사용하는 프레임워크의 문서 제공자, 사용하는 서비스의 API 참조, 내부 지식 베이스용 사용자 지정 제공자를 추가하세요. 요청당 추가 토큰은 정액 요금에 포함되며, 품질 향상 효과는 이러한 추가 부담을 감수할 만합니다. 

## IDE 간 일관성과 공유 구성 

Continue의 가장 뛰어난 기능 중 하나는 구성의 이식성입니다. ~/.continue/ 디렉터리는 Continue를 사용하는 모든 IDE, 즉 모든 JetBrains 제품과 VS Code에서 공유됩니다. config.yaml을 한 번 수정하면 변경 사항이 모든 곳에 적용됩니다. 무제한 Claude 연결은 Java를 작성할 때 IntelliJ에서, Python을 작성할 때 PyCharm에서, TypeScript를 작성할 때 WebStorm에서, 그 밖의 작업에는 VS Code에서 사용할 수 있습니다. 

이 공유 구성을 통해 어떤 IDE를 열든 모델 기본 설정, 역할 할당, 시스템 프롬프트, 컨텍스트 제공자를 일관되게 유지할 수 있습니다. 여러 언어와 여러 JetBrains IDE를 사용하는 개발자는 각 도구에서 구성을 반복하지 않고도 통합된 AI 경험을 누릴 수 있습니다. 

IDE를 넘나들며 사용하면 토큰 소비가 배가되므로 무제한 요금제는 이러한 이점을 더욱 높여 줍니다. 하루 종일 IntelliJ, PyCharm, WebStorm을 사용하면서 각 IDE에서 질문하고, 코드를 생성하고, 변경 사항을 검토하는 개발자는 세 IDE 모두에서 API 사용량이 누적됩니다. 토큰당 과금 방식에서는 이러한 IDE 간 사용 패턴으로 비용이 커집니다. 무제한 요금제에서는 하나의 정액 요금으로 모든 IDE를 사용할 수 있습니다. 

## JetBrains에서 Continue 문제 해결 

구성 후 Continue에 '모델을 사용할 수 없음'이 표시되면 config.yaml 구문을 꼼꼼히 확인하세요. YAML은 공백에 민감하므로 들여쓰기가 잘못되면 별도의 알림 없이 모델 항목이 제대로 작동하지 않습니다. YAML 검증기를 사용하거나 Continue 출력 패널(보기 -> 도구 창 -> Continue)을 열어 파싱 오류를 확인하세요. 가장 흔한 문제는 키-값 쌍에서 콜론 뒤에 공백이 빠진 경우입니다. 

동일한 구성으로 VS Code에서는 작동하지만 JetBrains에서는 요청 시간이 초과된다면, JetBrains 프록시 설정이 직접 연결을 덮어쓰는 것이 원인일 수 있습니다. 설정 -> 모양 및 동작 -> 시스템 설정 -> HTTP 프록시를 확인하세요. '자동 감지' 또는 회사 프록시로 설정되어 있다면 '프록시 없음'으로 직접 연결이 가능한지 확인한 다음, 필요한 경우 프록시를 올바르게 구성하세요. 

자격 증명이 올바른데도 인증 오류(401/403)가 발생한다면, 편집 후 config.yaml이 다시 로드되지 않았기 때문일 수 있습니다. Continue 패널을 닫았다가 다시 열거나 IDE를 다시 시작하세요. Continue는 패널을 초기화할 때 구성을 캐시하며, 모든 IDE 버전에서 파일 변경을 감시하는 것은 아닙니다. 

복사

```
# ~/.continue/config.yaml
models:
  - title: "Claude Sonnet (Unlimited)"
    provider: anthropic
    model: claude-sonnet-4-5
    apiBase: "https://aiprimetech.io"
    apiKey: "<your AI Prime Tech Unlimited key>"
    roles:
      - edit
      - apply

  - title: "Claude Opus (Unlimited)"
    provider: anthropic
    model: claude-opus-4-6
    apiBase: "https://aiprimetech.io"
    apiKey: "<your AI Prime Tech Unlimited key>"
    roles:
      - chat

# This config works in ALL JetBrains IDEs + VS Code simultaneously
```

## 자주 묻는 질문 

 하나의 config.yaml을 모든 JetBrains IDE에서 사용할 수 있나요?

네. ~/.continue/config.yaml 파일은 모든 JetBrains IDE(IntelliJ, PyCharm, WebStorm, GoLand 등)와 VS Code에서 공유됩니다. 한 번 구성하면 어디서나 사용할 수 있습니다. 설정을 반복하지 않고도 모든 IDE에서 무제한 Claude 연결을 사용할 수 있습니다. Continue에서 anthropic과 openai 중 어떤 제공자 유형을 사용해야 하나요?

apiBase를 루트 호스트로 설정하고(/v1 제외) anthropic 제공자 유형을 사용하세요. 스트리밍, 사고 블록, 도구 호출을 기본적으로 지원합니다. openai 제공자 유형도 작동하지만 apiBase에 /v1이 필요하며 일부 Anthropic 전용 기능을 사용할 수 없습니다. Continue에서 채팅과 편집에 서로 다른 모델을 할당할 수 있나요?

네. 서로 다른 roles 배열을 가진 모델 항목을 여러 개 만드세요. 깊이 있는 추론을 위해 chat 역할에는 Opus를 할당하고, 빠른 인라인 수정을 위해 edit/apply 역할에는 Sonnet을 할당하세요. 무제한 요금제에서는 비용상의 절충 없이 품질과 속도를 모두 최적화할 수 있습니다. Continue가 컨텍스트 제공자에서 이렇게 많은 토큰을 추가하는 이유는 무엇인가요?

컨텍스트 제공자(코드베이스 인덱스, 문서, 터미널)는 모든 요청에 관련 정보를 삽입합니다. 이로 인해 호출당 5,000-15,000 토큰이 추가될 수 있지만 응답 품질은 크게 향상됩니다. 무제한 요금제에서는 요청당 추가 토큰 부담을 걱정하지 않고 유용한 제공자를 모두 활성화하세요. 특정 프로젝트의 설정을 재정의하려면 어떻게 하나요?

프로젝트 루트에 .continuerc.json 파일을 만드세요. 이 파일은 config.yaml과 동일한 구조를 사용하며(JSON 형식), 해당 프로젝트에 한해서만 전역 설정을 재정의합니다. 프로젝트별 시스템 프롬프트, 모델 기본 설정 또는 컨텍스트 제공자를 설정할 때 유용합니다.  

몇 분 만에 Claude 사용 시작하기

API 키를 발급받으세요 — Anthropic 계정이나 대기자 명단 등록이 필요하지 않습니다.[API 키 발급받기](/register) 

AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다.    

## 더 많은 Claude API 가이드

[Claude API 키 발급 방법](/ko/learn/how-to-get-a-claude-api-key/)[Claude API 요금 해설](/ko/learn/claude-api-pricing-explained/)[Claude API를 가장 저렴하게 사용하는 방법](/ko/learn/cheapest-way-to-use-claude-api/)[Claude API로 Cursor 무제한 사용](/ko/learn/use-claude-api-with-cursor/)[Claude Code 무제한 이용](/ko/learn/use-claude-api-with-claude-code/)[Claude API 게이트웨이와 Anthropic 직접 이용 비교](/ko/learn/claude-api-vs-anthropic-direct/)[OpenAI 호환 API를 통해 Claude 사용하기](/ko/learn/openai-compatible-claude-api/)[Claude 모델 비교](/ko/learn/claude-api-models-compared/)[암호화폐로 Claude API 요금 결제하기](/ko/learn/claude-api-with-crypto-payment/)[대기 명단 없이 Claude API 이용하기](/ko/learn/claude-api-without-waitlist/)[Claude 토큰 사용량을 줄이는 방법](/ko/learn/how-to-reduce-claude-token-usage/)[Claude API로 Cline 무제한 사용](/ko/learn/use-claude-api-with-cline/)[Claude API로 Roo Code 무제한 사용](/ko/learn/use-claude-api-with-roo-code/)[Claude API로 Aider 무제한 사용하기](/ko/learn/use-claude-api-with-aider/)[VS Code에서 Claude 무제한 사용](/ko/learn/use-claude-api-with-vscode/)[Claude API로 OpenCode 무제한 사용하기](/ko/learn/use-claude-api-with-opencode/)[Claude에서 Hermes 에이전트 무제한 실행하기](/ko/learn/run-hermes-agent-with-claude-api/)[Claude에서 OpenClaw 무제한 실행하기](/ko/learn/run-openclaw-with-claude-api/)[Anthropic 호환 API의 의미](/ko/learn/anthropic-compatible-api/)[Claude Code API 키 — 발급 및 설정 방법](/ko/learn/claude-code-api-key-setup/)[Claude Code API 비용 — 요금과 절감 방법](/ko/learn/claude-code-api-costs/)[Claude API 오류 — 요청 한도, 400, 500, 529 해결 방법](/ko/learn/claude-api-errors-troubleshooting/)[Claude API 크레딧 구매 방법](/ko/learn/buy-claude-api-credits/)[Claude API 무료 체험: 실제로 무료인 것과 무료가 아닌 것](/ko/learn/claude-api-free-trial/)[Claude API와 Claude Pro/Max 구독 — 어떤 것을 선택할까요](/ko/learn/claude-api-vs-subscription/)[Claude에서 Codex CLI 실행하기](/ko/learn/use-claude-api-with-codex/)[Claude를 n8n에 연결하기](/ko/learn/use-claude-api-with-n8n/)[LiteLLM을 Claude로 라우팅하기](/ko/learn/use-claude-api-with-litellm/)[Kilo Code에서 Claude 사용하기](/ko/learn/use-claude-api-with-kilo-code/)[GitHub Copilot에 Claude 연결하기](/ko/learn/use-claude-api-with-github-copilot/)[게이트웨이를 통해 Zed를 Claude에 연결하기](/ko/learn/use-claude-api-with-zed/)[Cherry Studio를 Claude에 연결하기](/ko/learn/use-claude-api-with-cherry-studio/)[LangChain을 게이트웨이의 Claude에 연결하기](/ko/learn/use-claude-api-with-langchain/)[Claude로 Factory Droid 실행하기](/ko/learn/use-claude-api-with-factory-droid/)[Claude Code API 이해하기](/ko/learn/claude-code-api/)[애플리케이션에 Claude API 통합하기](/ko/learn/claude-api-integration/)