Study Portal캔들시스터 스터디(CandleSister Study) 공식 연계 강좌
study.candlesister.com
VS Code×Gemini
STEP 02 • API CREDENTIALS

2단계: Gemini API 키 발급 및 설정

Google AI Studio에서 나만의 안전한 Gemini API Key를 발급받고 에디터에 등록합니다.

API Key란 무엇인가요?

API Key는 VS Code가 내 Google 계정의 Gemini 인공지능 서버에 접근할 수 있도록 허가해 주는 "디지털 비밀 출입증"입니다. 개인 비밀번호와 같으므로 절대 다른 사람에게 알려주거나 인터넷에 공개하면 안 됩니다.

API 키 발급 및 에디터 연동 4단계

1

1. Google AI Studio 웹사이트 접속 및 로그인

웹 브라우저를 열고 aistudio.google.com/app/apikey 에 접속한 후 본인의 구글 계정으로 로그인합니다.

2

2. [Create API key (API 키 만들기)] 파란색 버튼 클릭

새 프로젝트 만들기(Create API key in new project)를 선택하면 약 3초 만에 AIzaSy로 시작하는 고유 키가 생성됩니다.

[화면 예시] Google AI Studio > API keys 대시보드
Create API key+ Create API key
3

3. 생성된 API 키를 복사([Copy])하여 안전한 메모장에 임시 보관

키는 한 번 생성된 후 복사 버튼을 눌러 클립보드에 담습니다. 창을 닫아도 나중에 목록에서 다시 확인할 수 있습니다.

4

4. VS Code 확장 프로그램 설정창에 API 키 붙여넣기

VS Code로 돌아와 설치한 확장(예: Roo Code 설정 또는 Gemini Code Assist 로그인 프롬프트)의 "API Key" 입력 필드에 키를 붙여넣고 저장합니다.

설정 경로: VS Code Settings (Ctrl+,) > Extensions > Gemini
gemini.apiKey:AIzaSy••••••••••••••••••••••

API 키 형식 자가 점검기 (보안 안심: 브라우저 내부에서만 검사)

발급받은 키가 올바른 구글 API 키 규격(AIzaSy로 시작하는 39자리 문자열)인지 확인해 보세요.

💡 안전 안내: 입력하신 텍스트는 서버로 전송되지 않으며 오직 사용자 브라우저에서 형식만 검사합니다.
Essential Security

초보자가 반드시 알아야 할 API 키 보안 3대 수칙

안전한 개발 습관은 첫날부터 시작됩니다.

1. 코드에 키를 직접 적어서 GitHub에 올리지 마세요

Git 봇이 1초 만에 유출된 키를 찾아내어 보안 경고가 발생하거나 계정이 정지될 수 있습니다.

2. 환경변수(.env) 파일과 .gitignore를 활용하세요

키는 항상 .env 파일에 보관하고, 프로젝트 루트의 .gitignore에 .env를 추가해 커밋에서 제외하세요.

3. 키 유출이 의심되면 즉시 AI Studio에서 삭제(Revoke)하세요

AI Studio의 API Key 목록에서 언제든지 쓰레기통 아이콘을 눌러 키를 무효화하고 새 키를 발급받을 수 있습니다.

.gitignore 파일 작성 예시:
# API 키와 환경변수 파일 제외
.env
.env.local
*.key