Gemini CLI와 VS Code 연동 가이드: 완벽한 AI 개발 환경 구축하기

BahnSeo 2025. 8. 20. 10:28

안녕하세요!

이번 글에서는 개발 생산성을 극대화할 수 있는 Gemini CLI와 Visual Studio Code(VS Code)를 연동하는 방법을 자세히 알려드리겠습니다. 몇 가지 간단한 단계만 거치면 AI와 함께 코딩하는 즐거움을 경험할 수 있습니다.

1단계: Node.js 설치

Gemini CLI를 사용하려면 먼저 Node.js를 설치해야 합니다.

1. Node.js 공식 웹사이트(https://nodejs.org/ko/)에 접속합니다.

2. '권장 사항'으로 표시된 LTS(Long-Term Support) 버전을 다운로드하여 설치합니다. 대부분의 경우 설치 마법사의 기본 설정을 그대로 따라가면 됩니다.

3. 설치가 완료되면, 명령 프롬프트(Command Prompt)를 열고 `node -v`를 입력하여 버전이 정상적으로 출력되는지 확인하세요.

2단계: Gemini CLI 설치 및 계정 연결

이제 Node.js의 `npm`을 사용하여 Gemini CLI를 설치할 차례입니다.

1. 명령 프롬프트에 다음 명령어를 입력하여 Gemini CLI를 전역으로 설치합니다.

npm install -g @google/gemini-cli

2. 설치가 완료되면 `gemini`를 입력하고 엔터를 누르세요. 계정 연결을 위한 화면이 나타날 겁니다.

3. '1. Login with Google'을 선택하면 웹 브라우저가 자동으로 열립니다. 평소 사용하시는 구글 계정으로 로그인하면 됩니다.

4. 로그인이 완료되면 다음과 같은 화면이 나타나며, Gemini CLI 사용 준비가 끝납니다.

5. 기본 명령어는 `/help`를 입력하여 확인할 수 있으며, 종료는 `/quit`를 사용합니다. 또한, 화면 오른쪽 하단에서는 현재 사용 중인 모델과 사용량을 확인할 수 있습니다. 무료 사용자의 경우 사용량에 따라 모델이 `Pro`에서 `Flash`로 변경될 수 있습니다.

6. 개발 작업은 특정 폴더에서 진행하는 것이 효율적이므로, `C:\Dev`와 같은 개발용 폴더를 미리 만들어 두는 것을 추천합니다.

C:\ 밑에 Dev 폴더를 만듭니다. (폴더 이름은 본인이 원하는대로...)

터미널을 열고 Dev 폴더로 이동합니다.

cd C:\Dev

여기서 `gemini `를 실행합니다.

C:\Dev\> gemini

가장 간단하게 Gemini CLI를 사용한 개발환경이 완료된 것입니다.

이상태에서 그냥 사용해도 됩니다.

하지만 좀 더 나은 개발환경을 위해 개발 플랫폼을 설치하고 연동할 것입니다.

3단계: VS Code 설치 및 터미널 설정

개발 플랫폼 VS Code를 설치하겠습니다.

1. VS Code 공식 웹사이트(https://code.visualstudio.com/)에서 설치 파일을 다운로드하여 설치합니다.

2. 설치 후 VS Code를 실행합니다.

3. 상단 메뉴에서 Terminal → New Terminal을 선택하여 터미널 창을 엽니다.

4. 터미널에 `gemini`를 입력하면 아래와 같은 오류가 발생할 수 있습니다.

PS C:\Users\kgbse> gemini
gemini : 이 시스템에서 스크립트를 실행할 수 없으므로 C:\Users\kgbse\AppData\Roaming\npm\gemini.ps1 파일을 로드할 수 없습니다. 자세한 내용은 about_ 
Execution_Policies(https://go.microsoft.com/fwlink/?LinkID=135170)를 참조하십시오.
위치 줄:1 문자:1
+ gemini
+ ~~~~~~
    + CategoryInfo          : 보안 오류: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

이 오류는 PowerShell의 실행 정책때문에 발생합니다. VS Code의 기본 터미널은 보안상의 이유로 외부 스크립트 실행을 제한합니다.

5. PowerShell 실행 정책을 변경합니다.

Gemini CLI 스크립트 실행을 허용하려면 실행 정책을 변경해야 합니다.

1) VS Code 터미널에 다음 명령어를 입력합니다.

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

`RemoteSigned`정책은 신뢰할 수 있는 게시자가 서명한 스크립트만 실행하도록 허용하여 보안을 유지하면서도 로컬 스크립트 실행을 가능하게 합니다.
2) 경고 메시지가 나타나면 `Y`를 입력하고 Enter를 누릅니다.
3) 이제 VS Code 터미널을 다시 시작하고 `gemini`를 입력하면 정상적으로 CLI가 실행됩니다.

6. 여기서 더 진행하지 말고 터미널을 닫습니다.

5단계: 개발 폴더 설정 및 Gemini CLI 연동 완료

마지막으로, VS Code에서 개발 폴더를 설정하고 Gemini CLI를 연동합니다.

1. VS Code 왼쪽 메뉴에서 문서 아이콘을 클릭하고 'Open Folder'를 누릅니다.

2. 앞서 만들었던 `Dev` 폴더를 선택하는데 주의할 점은 Dev 폴더 안으로 들어간 상태에서 '폴더 선택'을 완료합니다. 이제 VS Code의 탐색기 창에 `Dev` 폴더가 보일 겁니다.

3. 다시 새 터미널을 열고 `gemini`를 입력하면 VS Code와 Gemini CLI를 연동할지 묻는 메시지가 나타납니다. '1'을 눌러 연결을 승인합니다.

4. 이제 모든 설정이 완료되었습니다. 아래 화면처럼 Gemini CLI를 VS Code에서 직접 사용할 수 있는 환경이 구축됩니다.

이제 기본적인 AI 개발 환경이 모두 완성되었습니다.

다음 글에서는 이 환경을 기반으로 Flutter 개발 환경을 구성하는 방법을 다루겠습니다.

저작자표시 비영리 변경금지 (새창열림)