제미니 2.5 프로는 구글의 인공지능 최신 발전을 나타내며, 추론 및 코딩 능력에서 상당한 개선을 보여줍니다. 이 최첨단 모델은 개발자들에게 생산성을 향상시키고 IDE 환경 내에서 원활한 코딩 작업 흐름을 제공하여 개발자들을 돕습니다. 제미니 2.5 프로를 커서에 통합하면 구독 비용 없이 더 효율적인 코드 생성, 지능적인 제안 및 개선된 문제 해결 능력에 접근할 수 있습니다.

이 모델은 복잡한 코딩 패턴을 이해하고, 디버깅 문제를 해결하며, 기술 개념에 대한 종합적인 설명을 제공합니다. 이전 버전과 달리 제미니 2.5 프로는 뛰어난 맥락 인식을 보여 주며, 긴 프로그래밍 세션에서도 일관성을 유지할 수 있게 합니다. 수많은 프로그래밍 언어를 분석하고 코드를 생성하는 능력은 다양한 프로젝트에서 작업하는 개발자들에게 없어서는 안 될 도구가 됩니다.
커서는 다양한 AI 모델에 접근할 수 있는 프리미엄 구독 서비스를 제공하지만, 본 튜토리얼은 추가 비용 없이 제미니 2.5 프로를 커서 설치에 추가하는 방법에 집중합니다. 구글의 무료 API 접근을 활용하여 선호하는 개발 환경 내에서 이 첨단 모델의 모든 기능을 경험할 수 있습니다.
첨단 개발 도구를 이미 활용하고 있는 커서 AI IDE 사용자로서, 당신은 API 개발에 대한 Apidog의 강력한 접근 방식을 높이 평가할 것입니다.

이 종합적인 Postman 대안은 API 설계, 테스트, 문서화 및 협업을 하나의 매끄러운 인터페이스에서 통합하여 귀하의 커서 작업 흐름을 보완합니다.

커서가 AI 기반 도움으로 귀하의 코딩 경험을 향상시키는 동안, Apidog는 자동화된 목업 서버, 직관적인 요청 생성 및 원활한 환경 전환과 같은 기능으로 API 생명주기 관리를 간소화합니다.

이 플랫폼은 REST, GraphQL, WebSocket 및 SOAP 프로토콜을 지원하여 API에 의존하는 애플리케이션을 구축할 때 커서와 완벽한 동반자가 됩니다. 이 현대적인 도구들은 프로젝트 간의 문맥 전환을 최소화하면서 생산성을 극대화하는 개발 생태계를 만듭니다.
커서에 제미니 2.5 프로 추가를 위한 단계별 가이드
1단계: 커서 설정 접근
통합 프로세스의 첫 번째 단계는 모든 구성 옵션이 관리되는 커서의 설정 패널에 접근하는 것입니다. 방법은 운영 체제에 따라 약간 다릅니다:
macOS용:
- 응용 프로그램 폴더 또는 Dock에서 커서 응용 프로그램을 실행합니다.
- 화면 상단의 응용 프로그램 바에서 "Cursor" 메뉴를 클릭합니다.
- 드롭다운 메뉴에서 "Settings"를 선택합니다.
- 후속 옵션에서 "Cursor Settings"를 선택합니다.
Windows/Linux용:
- 시작 메뉴, 바탕화면 바로 가기 또는 응용 프로그램 실행기에서 커서를 엽니다.
- 응용 프로그램 창의 왼쪽 상단 모서리에 있는 "File" 메뉴를 클릭합니다.
- 드롭다운 메뉴에서 "Preferences"를 선택합니다.
- 나타나는 서브 메뉴에서 "Settings"를 클릭합니다.
이렇게 하면 커서 IDE의 다양한 측면을 구성할 수 있는 설정 패널이 열립니다. 패널은 일반적으로 편집기 인터페이스 내의 새 탭으로 나타나며, 조정하는 동안 작업 공간을 유지할 수 있게 합니다.
2단계: 모델 또는 확장 섹션으로 이동

설정 패널에 들어가면 AI 모델 구성을 관리하는 특정 섹션을 찾아야 합니다:
- 설정 패널의 왼쪽에 있는 탐색 메뉴를 찾아보세요.
- AI 기능과 관련된 카테고리를 찾기 위해 스크롤합니다.
- 이 섹션은 "Models", "AI Providers", "Extensions" 또는 "AI Configuration"으로 표시될 수 있습니다.
- 커서의 최신 버전에서는 "AI Settings" 또는 "Language Models"에서 찾을 수 있습니다.
- 해당 섹션을 클릭하여 모델 관리 인터페이스에 접근합니다.
정확한 레이블은 커서 버전에 따라 다를 수 있지만 AI 관련 설정은 일반적으로 쉽게 접근할 수 있도록 함께 그룹화되어 있습니다. 올바른 섹션을 찾는 데 어려움이 있다면 설정 패널 상단의 검색 기능을 사용하여 "model" 또는 "AI"와 같은 키워드를 입력하여 관련 옵션을 필터링할 수 있습니다.
3단계: 올바른 모델 이름 이해하기

커서에서 제미니 2.5 프로를 구성할 때 정확한 모델 식별자를 사용하는 것이 성공적인 통합을 위해 중요합니다. 제미니 2.5 프로 실험의 정확한 모델 식별자는:
gemini-2.5-pro-exp-03-25
이 문자열은 하이픈과 숫자를 포함하여 정확하게 입력해야 합니다. 조금이라도 편차가 있거나 철자 오류, 대문자 변경이 있으면 연결이 제대로 작동하지 않을 수 있습니다. 모델 식별자는 커서가 사용하려는 제미니의 특정 버전과 통신할 수 있는 고유한 참조 역할을 합니다.
구글은 때때로 모델 버전을 업데이트하므로 연결 문제에 직면하면 구글 AI 스튜디오 문서 페이지에서 가장 최신의 모델 식별자를 확인하십시오. 현재 작성 당시 제공된 식별자는 제미니 2.5 프로의 실험 기능에 접근하는 데 올바른 것입니다.
4단계: 구글 API 키 획득하기 (직접 방법)
커서를 제미니 2.5 프로와 연결하려면 구글에서 API 키가 필요합니다. 이 키는 구글 AI 서비스에 대한 요청을 인증합니다. 키를 얻기 위한 다음 단계를 따르십시오:
- 웹 브라우저를 열고 구글 AI 스튜디오로 가세요:
- 주 URL: https://aistudio.google.com/
- 위의 URL이 작동하지 않을 경우 대체 URL: https://ai.google.dev/
2. 구글 계정으로 로그인합니다.
- 구글 계정이 없는 경우 먼저 하나를 만들어야 합니다.
- 기본적인 구글 계정은 모두 작동하며, Gmail 계정도 포함됩니다.
3. 로그인 후 "Get API key" 옵션을 찾습니다.
- 이는 일반적으로 인터페이스의 왼쪽 상단 모서리에 위치합니다.
- 사이드 메뉴나 계정 설정 아래에서 "API Keys"라고 나타날 수도 있습니다.
4. "Get API key"를 클릭하고 나타나는 옵션에서 "Create API key"를 선택합니다.
- 처음 구글 AI 스튜디오를 사용하는 경우, "Create in new project"를 선택해야 할 수도 있습니다.
- 보안상의 이유로 전화번호로 신원을 확인해야 할 수도 있습니다.

- 시스템은 귀하의 계정에 대한 고유한 API 키를 생성합니다. 이 과정은 몇 초 걸릴 수 있습니다.
5. 새로 생성된 API 키를 복사하여 안전하게 보관합니다.
- 일시적으로 비밀번호 관리자나 안전 노트 앱에 저장하는 것을 고려하십시오.
- 이 키를 곧 커서에 붙여넣어야 합니다.
중요 보안 주의:
- 절대 이 키를 공유하거나 GitHub와 같은 버전 관리 시스템에 커밋하지 마십시오.
- 이 키는 귀하의 구글 클라우드 리소스에 접근할 수 있는 권한을 부여하며 사용 제한이 있을 수 있습니다.
- 키가 유출된 경우 즉시 중지하고 새로 생성해야 합니다.
- 구글은 API 접근을 위한 무료 사용량을 제공하지만, 과도한 사용은 요금을 초래할 수 있습니다.
구글의 API 키 형식은 일반적으로 긴 문자열의 문자, 숫자 및 기호로 구성됩니다. 키를 확보한 후, 커서를 구성하는 준비가 완료되었습니다.
5단계: 커서에서 사용자 지정 모델 추가하기

API 키를 손에 쥔 후, 커서 설정 패널로 돌아가 사용자 지정 모델을 구성합니다:
- 2단계에서 확인한 AI 관련 설정 섹션 내에서 모델 추가 또는 사용자 지정과 관련된 옵션을 확인합니다.
- 다음과 같은 옵션을 구체적으로 찾아보세요:
- "Custom Provider"
- "Add Model"
- "Custom Model Configuration"
- "Override OpenAI Base URL"
- 모델 목록 근처에서 "Add" 또는 "+"라는 레이블이 붙은 버튼이 보이면, 클릭하여 새 모델 구성을 추가하기 시작합니다.
- "Override OpenAI Base URL"이 보이면, 이는 특히 중요합니다.
- 이 설정은 커서가 주로 OpenAI 호환 API와 작동함을 나타냅니다.
- 구글의 제미니 API와 함께 작동하도록 이 설정을 조정해야 합니다.
- 모든 버전의 커서가 이 기능을 같은 방식으로 분명히 레이블하지는 않습니다.

사용자 지정 모델을 추가하는 인터페이스는 커서 버전에 따라 약간 다르지만, 기본 기능은 동일합니다. 제미니 모델에 대한 연결 세부 정보를 제공해야 합니다.
6단계: 모델 이름 입력하기
사용자 지정 모델을 추가할 적절한 섹션을 찾은 후:
- "Model Name", "Model ID" 또는 유사한 레이블이 붙은 필드를 찾습니다.
- 이 필드를 클릭하여 텍스트 입력을 활성화합니다.
- 정확히:
gemini-2.5-pro-exp-03-25
를 입력합니다. - 입력을 다음 사항을 확인하여 다시 확인합니다:
- "gemini"의 올바른 철자
- 모든 하이픈이 적절한 위치에 있는지
- 올바른 숫자 시퀀스 "2.5" 및 "03-25"
- 식별자 앞이나 뒤에 추가 공백이 없는지
이 정확한 식별자는 커서가 구글의 API 서비스에서 올바른 모델 버전을 요청하도록 보장합니다. 이 문자열에 오류가 있으면 연결 실패 또는 예상치 못한 동작이 발생할 수 있습니다.
7단계: OpenAI 기본 URL 오버라이드 하기
커서를 포함한 많은 AI 코드 편집기는 처음에 주로 OpenAI의 모델과 작업하도록 설계되었습니다. 구글의 제미니 모델을 사용하기 위해서는 이러한 요청을 구글의 API 엔드포인트로 리다이렉션해야 합니다:
기본 OpenAI URL을 오버라이드하는 설정을 찾아보세요.
- 이것은 "API Base URL", "Endpoint" 또는 "OpenAI Compatible URL"로 표시될 수 있습니다.
- 모델 이름을 입력했던 곳 근처의 텍스트 필드로 나타날 수 있습니다.
OpenAI 호환 컨텍스트에서 제미니 API의 다음 URL을 입력합니다:
<https://generativelanguage.googleapis.com/v1beta/openai/>
URL은 표시된 대로 정확하게 입력되어야 하며, 마지막 슬래시를 포함합니다.
- 이 엔드포인트는 커서가 구글의 API 서비스와 이미 이해하는 형식을 사용하여 통신할 수 있게 합니다.
커서 버전 중 일부는 "Google"을 공급자로 선택하는 드롭다운이 있을 수 있습니다.
- 이 옵션이 제공되면 URL을 수동으로 입력하는 대신 선택하세요.
- 이는 귀하의 커서 버전이 구글의 서비스를 기본적으로 지원함을 나타냅니다.
이 URL 리다이렉션은 커서가 API 요청을 보내는 위치를 지시하기 때문에 매우 중요합니다. 이 변경이 없으면 커서는 OpenAI 서버에서 제미니 모델을 요청하려고 시도하게 되고 실패할 것입니다.
8단계: 구글 API 키 입력하기
다음으로, 요청을 인증하기 위해 구글 API 키를 제공해야 합니다:
- "API Key", "Google API Key" 또는 "Authentication Token"이라는 레이블이 붙은 필드를 찾습니다.
- 이 필드는 모델 이름 및 기본 URL과 같은 섹션에 있을 수 있습니다.
- 일부 버전에서는 별도의 "API Keys" 섹션 아래에 있을 수 있습니다.
- 이 필드를 클릭하여 텍스트 입력을 활성화합니다.
- 4단계에서 구글 AI 스튜디오에서 얻은 API 키를 신중하게 붙여넣습니다.
- 키보드 단축키가 비활성화된 경우 Ctrl+V(Windows/Linux) 또는 Cmd+V(Mac)를 사용하여 붙여넣습니다.
- 대안으로 오른쪽 클릭 후 "Paste"를 선택할 수 있습니다.
- 전체 키가 정확히 붙여넣어졌는지 확인합니다.
- 시작이나 끝에 불필요한 공백이 없는지 확인합니다.
- 어떤 문자도 잘리거나 중복되지 않았는지 확인합니다.
- 키는 구글에서 제공한 것과 정확히 일치해야 합니다.
- 모든 키를 입력한 후 "Test Connection" 기능이 제공될 수 있습니다.
- 가능한 경우 이 기능을 사용하여 구성 작업이 제대로 되는지 확인합니다.
- 성공적인 테스트는 모든 세부 정보가 정확하다는 것을 확인해 줍니다.
이 API 키는 인증 자격 증명으로 기능하며 커서가 제미니 서비스에 요청하는 모든 요청에 필요합니다. 유효한 키가 없으면 설정이 올바르더라도 통합은 실패하게 됩니다.
9단계: 설정 저장하기
모든 필수 정보를 입력한 후, 구성을 저장해야 합니다:
- 설정 패널 하단에서 "Save", "Apply" 또는 "OK" 버튼을 찾습니다.
- 일부 버전에서는 변경 사항을 자동으로 저장할 수 있습니다.
- 자동 저장이 활성화된 경우 "Saving..." 또는 "Changes saved"라는 표시가 보일 수 있습니다.
2. 저장 버튼을 클릭하여 변경 내용을 기록합니다.
- 설정 패널은 변경 사항을 적용하는 동안 잠시 로딩 표시를 할 수 있습니다.
- 일부 버전에서는 새로운 구성을 완전히 적용하기 위해 커서를 재시작해야 할 수도 있습니다.
3. 변경 사항을 적용하기 위해 커서를 재시작하라는 메시지가 표시되면 "Restart Now"를 선택합니다.
- 이렇게 하면 커서의 모든 구성 요소가 새 구성을 인식합니다.
- 작업은 재시작 전에 자동으로 저장되어야 합니다.
4. 저장(필요한 경우 재시작 후) 후 커서는 새 구성으로 로드됩니다.
- 이제 제미니 2.5 프로 모델을 편집기 내에서 사용할 수 있어야 합니다.
설정을 올바르게 저장하는 것은 지속적인 구성을 위해 필수적입니다. 이 단계를 수행하지 않으면 커서를 닫고 다시 열 때 변경 사항이 사라질 수 있습니다.
10단계: 통합 테스트하기
마지막 단계는 제미니 2.5 프로 통합이 올바르게 작동하는지 확인하는 것입니다:
- 커서 IDE에서 코드 파일을 열거나 새로 만듭니다.
- 테스트를 위해 어떤 프로그래밍 언어도 사용할 수 있지만, Python이나 JavaScript가 인기 있어 좋은 선택입니다.
2. 커서에서 AI 어시스턴트 인터페이스를 찾습니다.
- 일반적으로 오른쪽에 채팅 패널로 나타납니다.
- 또는 키보드 단축키로 활성화할 수 있는 명령 팔레트로 제공됩니다.
3. AI 기반 기능을 사용해 보세요:
- 코드 자동 완성: 함수나 변수 선언을 입력하기 시작하고 제미니가 제안을 제공하는지 확인합니다.
- 채팅 상호작용: 채팅 패널을 열고 코딩 질문을 합니다.
- 명령 호출: Ctrl/Cmd + K로 AI 기능을 직접 호출합니다.
4. 커서가 어떤 AI 모델을 사용할지 선택할 수 있는 옵션을 제공하면 "gemini-2.5-pro-exp-03-25"가 있는지 확인하고 선택합니다.
- 이 선택은 채팅 인터페이스의 드롭다운으로 제공될 수 있습니다.
- 또는 명령 팔레트의 옵션으로 제공될 수도 있습니다.
5. "Python에서 피보나치 수열을 계산하는 함수를 작성해 주세요"와 같은 테스트 프롬프트를 보냅니다.
- 응답의 품질, 코드의 정확성 및 설명의 명확성을 관찰합니다.
- 정상적으로 작동하는 제미니 2.5 프로는 잘 구조화된 코드와 상세한 설명을 제공해야 합니다.
모델이 프롬프트에 적절하게 응답하면 축하합니다! 무료로 제미니 2.5 프로를 커서에 성공적으로 통합한 것입니다.
대안 방법: OpenRouter 사용하기 (잠재적으로 무료)
직접 API 키 방법에 문제가 발생하면, OpenRouter를 중개 플랫폼으로 활용하여 다양한 AI 모델, 포함하여 제미니 2.5 프로에 연결하는 것을 간소화할 수 있습니다.
1단계: OpenRouter 설정하기
- OpenRouter 웹사이트를 방문합니다: https://openrouter.ai/
- 계정을 만들고 로그인합니다.
- 구글, GitHub, 또는 이메일 인증을 사용하여 일반적으로 가입할 수 있습니다.
- 계정 생성 시 필요한 확인 단계를 완료합니다.
3. 로그인 후 대시보드로 이동합니다.
- "API Keys" 또는 "Credentials" 섹션을 찾습니다.
- "Create API Key" 또는 유사한 옵션을 클릭합니다.
4. API 키의 이름을 "커서 통합"과 같이 기억하기 쉬운 이름으로 설정합니다.
- 이렇게 하면 미래에 이 키의 용도를 식별하는 데 도움이 됩니다.
5. 원할 경우 사용 한도를 설정합니다.
- OpenRouter는 각 키가 사용할 수 있는 금액을 제한할 수 있습니다.
- 개인 프로젝트의 경우 예기치 않은 요금을 피하기 위해 낮은 한도를 설정하는 것이 좋습니다.
6. OpenRouter API 키를 생성하고 복사합니다.
- 직접 구글 API 키를 사용할 때와 마찬가지로 안전하게 저장합니다.

2단계: OpenRouter로 커서 구성하기
직접 방법의 1단계에서 설명한 대로 커서 설정에 접근합니다.
사용자 지정 모델이나 API 키 섹션으로 이동합니다.
- 이것은 직접 구글 API 방법에 사용했던 것과 동일한 섹션입니다.
"OpenAI Base URL 오버라이드" 옵션을 활성화합니다.
- 이것은 OpenRouter를 통해 요청을 리다이렉션하는 데 매우 중요합니다.
알맞은 필드에 OpenRouter API 키를 입력합니다.
- 이는 직접 방법에서 사용한 구글 API 키를 대체합니다.
사용자 지정 API 엔드포인트/기본 URL을 다음과 같이 설정합니다:
<https://openrouter.ai/api/v1>
사용자 지정 모델을 추가할 때 다음을 입력합니다:
google/gemini-2.5-pro-exp-03-25:free
(참고: 이 정확한 모델 식별자는 OpenRouter 웹사이트에서 확인하십시오, 변경될 수 있습니다)
직접 방법의 9단계에서 설명한 대로 설정을 저장합니다.
10단계에서 설명한 대로 통합을 테스트합니다.
- 연결이 작동하는지 확인하기 위해 테스트 프롬프트를 보냅니다.
- 응답이 제미니 2.5 프로의 예상 품질과 일치하는지 확인합니다.
OpenRouter 방법은 직접 방법에 비해 몇 가지 장점이 있습니다:
- 단순화된 API 관리
- 제공자와의 OpenRouter 계약을 통한 낮은 비용의 가능성
- 커서를 재구성하지 않고 다양한 AI 모델 간의 간편한 전환
- 일반적인 용도에 충분할 수 있는 월 사용 무료 크레딧
그러나 이 방법은 귀하와 구글 사이에 추가 서비스를 추가한 것이므로, 지연이 발생하거나 OpenRouter에 문제가 발생했을 때 실패할 수 있는 지점이 될 수 있습니다.
결론
이 포괄적인 튜토리얼을 따라 구글의 강력한 제미니 2.5 프로 모델을 커서 IDE에 무료로 추가했습니다. 이 통합은 지능적인 코드 완성부터 복잡한 문제 해결 지원에 이르기까지 고급 AI 기능으로 귀하의 개발 작업 흐름을 향상시킵니다.
기본 통합은 무료이지만, API 사용은 구글의 할당량 및 가격에 따라 다르다는 점을 기억하십시오. 무료 사용량은 개인 프로젝트를 하는 개발자에게는 일반적으로 충분하지만, 무료 한도를 초과 할 가능성에 대비하여 사용량을 모니터링합니다.
커서와 구글의 AI 서비스가 발전함에 따라 이 과정의 일부 단계가 변경될 수 있습니다. 어려움이 있는 경우 두 플랫폼의 공식 문서나 커뮤니티 포럼에서 최신 정보를 확인하십시오.
이제 제미니 2.5 프로가 커서 내에서 귀하의 손에 있으며, 오늘날 가장 진보된 AI 코드 보조 도구 중 하나로 생산성을 높이고 복잡한 개발 문제를 해결할 준비가 되어 있습니다.