개발자 여러분! 혹시 매일 똑같은 명령어 치느라 손목이 저릿하고, AI에게 뭔가 시키고 싶은데 매번 길고 장황하게 설명하느라 진땀 뺀 경험, 다들 있으시죠? “이 친구, 좀 똑똑하게 내 말귀를 알아들었으면 좋겠다!” 하는 생각, 한 번쯤 해보셨을 겁니다.

오늘 이 강의가 끝날 때쯤, 여러분은 더 이상 AI를 그저 ‘사용’하는 데 그치지 않고, AI를 설치하는 기초부터 여러분의 손끝에서 움직이는 ‘나만의 맞춤형 AI 조수’를 직접 설계하고 조종하는 ‘AI 조련사’가 되어 있을 겁니다.

---

0부: AI 조수, 일단 책상에 앉히기부터! – 설치와 첫 대화

모든 일에는 순서가 있죠. 가장 먼저, 우리를 도와줄 AI 조수를 컴퓨터에 제대로 ‘모셔오는’ 방법부터 알려드리겠습니다. 아무렇게나 설치하면 나중에 버전이 꼬여서 고생합니다. 저스틴이 알려주는 ‘프로의 설치법’만 따라오세요!

자, 여기 별표 세 개 치세요! ⭐️⭐️⭐️
핵심은 ‘가장 깔끔하고, 항상 최신으로!’ 입니다. 기존에 설치된 흔적을 싹 지우고, ‘NPX’라는 기술을 이용해 매번 최신 버전을 쓰는 게 프로의 방식입니다.

1단계: 기존 설치 흔적 지우기
먼저 우리 컴퓨터에 “나 Gemini CLI 설치한 적 있는데…” 하는 과거의 기억을 깨끗이 지워줍니다.

2단계: ‘만능 단축키’ 설정하기 (Zsh/Bash)
이제 터미널에 “앞으로 gemini라고 치면, 인터넷에서 최신 버전을 바로 가져와서 실행해줘!” 라고 알려주는 단축키를 설정할 겁니다. 아래 명령어를 복사해서 터미널에 붙여넣기만 하면 끝!

-y 옵션 덕분에 매번 “설치할까요?” 라고 묻는 귀찮은 질문도 생략됩니다.

3단계: 첫 대화 시작하기
설치가 끝났습니다! 이제 AI 조수와 첫 대화를 시작해볼까요? 그냥 터미널에 gemini 라고 치고, 하고 싶은 말을 따옴표 안에 넣으면 됩니다.

그러면 AI가 똑똑하게 코드를 짜줄 겁니다. 더 놀라운 건, 대화의 맥락을 기억한다는 거예요. 이어서 이렇게 질문할 수 있죠.

AI가 이전 대화를 기억하고 코드를 수정해줄 겁니다. 어때요, 정말 개인 비서 같지 않나요?

---

1부: AI 조수에게 ‘슈퍼파워’를! – 확장 기능의 모든 것

자, 이제 여러분의 책상에는 똑똑한 AI 조수가 앉아있습니다. 하지만 지금은 그냥 ‘일반 비서’일 뿐이죠. 이 비서를 ‘나만을 위한 전문 비서’로 만드는 기술이 바로 확장 기능(Extensions) 입니다.

이건 마치 우리가 쓰는 스마트폰에 앱을 설치하는 것과 완벽하게 똑같습니다. 처음 산 스마트폰은 전화, 문자밖에 안되지만, 여기에 카메라 앱, 지도 앱, 은행 앱을 설치하면서 세상에 하나뿐인 ‘나만의 스마트폰’으로 만드는 것처럼요.

🔧 확장 기능의 ‘삼총사’를 소개합니다!

확장 기능, 복잡해 보이지만 딱 세 가지 핵심 부품, ‘삼총사’만 기억하면 끝입니다.

1. 커스텀 명령어 (Custom Commands): AI 조수에게 가르쳐주는 ‘마법 주문’ 입니다. 복잡한 작업을 간단한 /명령어 한 줄로 실행하게 만드는, 오늘 강의의 주인공이죠.
2. 컨텍스트 파일 (GEMINI.md): AI 조수의 ‘두뇌’ 또는 ‘역할 대본’ 입니다. “너는 이제부터 깐깐한 10년 차 시니어 개발자야. 코드 리뷰할 땐 보안을 최우선으로 봐줘.” 라고 AI의 정체성을 심어주는 파일이죠.
3. MCP 서버 (Model Context Protocol): AI 조수에게 ‘외부 세계와 소통하는 능력’ 을 주는 ‘비밀 통로’입니다. 이걸 통해 회사 내부 데이터베이스에 접속하거나, 외부 API를 호출하는 등, 터미널의 한계를 뛰어넘는 진짜 만능 조수를 만들 수 있습니다.

감 오시나요? ‘마법 주문’ 으로 일을 시키고, ‘역할 대본’ 으로 전문가를 만들며, ‘비밀 통로’ 로 한계를 없애는 것. 이 세 가지가 확장 기능의 전부입니다!

---

2부: AI를 조종하는 ‘마법 주문’ – 슬래시 명령어 만들기

자, 이제 하이라이트입니다! 삼총사 중 가장 강력하고 실용적인 ‘마법 주문’, 즉 슬래시 명령어를 만드는 비법을 본격적으로 파헤쳐 보겠습니다.

💡 ‘마법 주문’은 어디서 만드나요?

‘마법 주문’의 정식 명칭은 MCP 프롬프트입니다. 어려운 용어 같지만, 사실은 단골 식당의 ‘나만의 비밀 메뉴’ 와 같아요. 사장님께 “사장님, 늘 먹던 걸로요!” 한마디면 내가 좋아하는 레시피대로 음식이 뚝딱 나오는 것처럼, 매번 길게 설명할 필요 없이 /나만의명령어 한 줄로 AI가 알아서 착착 작업을 수행하게 만드는 거죠.

이 ‘나만의 메뉴’를 만드는 곳이 바로 MCP 서버라는 ‘주방’ 입니다.

1단계: ‘주방(MCP 서버)’ 차리고 레시피 등록하기
mcp-server.js 같은 파일 하나를 만들어 우리의 주방을 차립니다. 그리고 그 안에 server.registerPrompt 라는 마법의 함수로 ‘레시피’를 등록하는 거죠.

2단계: ‘깐깐한 주방 보조(Zod)’로 재료 검수하기
이거 시험에 나와요! (농담조) 😉
코드를 짜다 보면 z.string() 같은 걸 보게 될 텐데, 이게 바로 Zod입니다. Zod는 주문에 들어온 재료(옵션)가 올바른지 검수하는 ‘깐깐한 주방 보조’ 역할을 해요. 예를 들어, 파일 경로를 받아야 하는데 엉뚱한 숫자가 들어오면 “사장님, 재료가 이상해요!” 하고 미리 알려줘서 오류를 막아주는 아주 중요한 친구입니다.

💻 실전! 이런 ‘마법 주문’은 어때요?

자, 이제 이 기술로 뭘 할 수 있을까요? 여러분의 칼퇴를 보장할 몇 가지 마법 주문 예시입니다.

• 코드 리뷰 자동화 (/code-review): /code-review --file "내코드.js" --focus "보안" 주문 한 줄이면, AI 시니어 개발자가 내 코드를 샅샅이 훑어 보안 관점에서 전문가 수준의 리뷰를 해줍니다.
• API 문서 자동 생성 (/api-docs): /api-docs --endpoint "/api/users" 주문만 외우면, 해당 API 명세서가 마법처럼 뚝딱 만들어집니다.
• Git 커밋 메시지 생성 (/git-commit): 매번 커밋 메시지 쓰기 귀찮으셨죠? /git-commit 이라고 치면, AI가 변경된 코드를 분석해서 “feat: 사용자 로그인 기능 추가” 와 같이 깔끔한 커밋 메시지를 알아서 추천해줍니다.

---

오늘의 정리

오늘 AI 조수를 설치하는 기초부터 내 마음대로 조종하는 고급 기술까지, 정말 많은 내용을 배웠습니다. 머릿속이 복잡할 테니, 저스틴이 딱 3줄로 완벽하게 정리해 드릴게요!

1. ‘프로의 설치법(NPX 별칭)’으로 Gemini CLI를 항상 최신으로, 깔끔하게 설치하고 gemini "질문"으로 대화를 시작한다.
2. ‘확장 기능’은 스마트폰에 앱을 깔듯 AI 조수를 커스터마이징하는 것이며, ‘역할 대본’과 ‘마법 주문’이 핵심이다.
3. ‘마법 주문(슬래시 명령어)’을 만들면, 코드 리뷰나 문서 작성 같은 복잡한 개발 업무를 명령어 한 줄로 자동화할 수 있다.

여러분, 이제 여러분은 AI의 단순한 사용자가 아닙니다. 자신의 개발 환경에 딱 맞는 AI 도구를 직접 설계하고, 마법 주문으로 AI를 조종하는 ‘AI 설계자’이자 ‘AI 조련사’ 입니다.

오늘의 과제입니다! 지금 당장 여러분이 매일 컴퓨터 앞에서 하는 가장 귀찮고 반복적인 작업, 딱 하나만 떠올려보세요. 그리고 그 작업을 어떤 ‘마법 주문’으로 만들 수 있을지 상상해보는 겁니다. 그 상상이 여러분의 업무 효율을 극적으로 바꿔줄 첫걸음입니다!

그럼 오늘 강의는 여기까지! 일타 강사 저스틴이었습니다! 📚

---

지난번 강의가 끝나고 “강사님! 저는 윈도우 쓰는데, 설치가 너무 헷갈려요!” 하는 질문이 폭주했습니다. 그래서 준비했습니다! 맥, 리눅스 사용자뿐만 아니라 대한민국 윈도우 개발자 여러분을 위한 완벽 맞춤형 통합 특강!

---

0부: AI 조수, 내 PC에 입주시키기! – 윈도우 맞춤 설치와 첫 대화

모든 일에는 순서가 있죠. 가장 먼저, 우리를 도와줄 AI 조수를 컴퓨터에 제대로 ‘모셔오는’ 방법부터 알려드리겠습니다. 저스틴이 알려주는 ‘윈도우 프로 설치법’만 따라오세요!

자, 윈도우 사용자분들, 집중하세요! ⭐️⭐️⭐️
핵심은 ‘가장 깔끔하고, 항상 최신으로!’ 입니다. 먼저 Node.js라는 기본 프로그램이 설치되어 있어야 합니다. 없다면 공식 홈페이지에서 LTS 버전을 받아 설치해주세요.

1단계: 과거의 흔적 지우기 (공통)
혹시 모를 구버전이나 설치 오류를 막기 위해, 과거의 기억을 깨끗이 지워줍니다. PowerShell이나 명령 프롬프트(CMD)를 열고 아래 명령어를 입력하세요.

2단계: ‘만능 단축키’ 설정하기 (윈도우 핵심!)
터미널에 gemini라고만 쳐도 최신 버전이 바로 실행되도록 만드는 과정입니다. 윈도우에서는 PowerShell을 쓰는 걸 강력 추천합니다!

[방법 1] PowerShell 사용자 (강력 추천)
가장 안정적이고 표준적인 방법입니다.

1. PowerShell을 실행하세요.
2. notepad $PROFILE 이라고 입력하고 엔터를 치세요.
3. “파일을 찾을 수 없습니다. 새로 만드시겠습니까?” 라고 물어보면 ‘예(Y)’를 누르세요.
4. 메모장이 열리면, 아래 코드를 그대로 복사해서 붙여넣고 저장하세요.
   
   function gemini { npx -y @google/gemini-cli $args } ```5. `PowerShell`을 껐다가 다시 켜면 이제 `gemini` 명령어를 바로 사용할 수 있습니다.

   1 2 3 4 5 6

   function gemini {     npx -y @google/gemini-cli $args } ```5.  `PowerShell`을 껐다가 다시 켜면 이제 `gemini` 명령어를 바로 사용할 수 있습니다.

[방법 2] 명령 프롬프트(CMD) 사용자
이 방법은 프롬프트 창을 닫으면 설정이 사라지지만, 급할 때 유용합니다.

1. 명령 프롬프트를 실행하세요.
2. 아래 명령어를 복사해서 붙여넣으세요.
   
   doskey gemini=npx -y @google/gemini-cli $* ``` 이제 이 창 안에서는 `gemini` 명령어를 사용할 수 있습니다.

   1 2	doskey gemini=npx -y @google/gemini-cli $* ```    이제 이 창 안에서는 `gemini` 명령어를 사용할 수 있습니다.

---

Gemini CLI에 API 키 설정하기 (Windows)

Gemini를 사용하려면 api 키를 발급 받아 설정해 줘야 합니다. 여러 방법이 있지만, 보안과 편의성을 고려하여 가장 추천하는 방법부터 알려드리겠습니다.

방법 A: 환경 변수 사용 (가장 안전하고 표준적인 방법)

이 방법은 API 키를 코드나 명령어에 직접 노출하지 않고, 시스템에 등록하여 사용하는 가장 안전한 방식입니다.

1. 시작 메뉴에서 환경 변수를 검색하고, ‘시스템 환경 변수 편집’을 실행합니다.
2. ‘시스템 속성’ 창 하단의 환경 변수(N)... 버튼을 클릭합니다.
3. ‘사용자 변수’ 또는 ‘시스템 변수’ 섹션에서 새로 만들기(W)...를 클릭합니다. (현재 사용자에게만 적용하려면 ‘사용자 변수’를 추천합니다.)
4. 새 창이 뜨면 다음과 같이 입력합니다.
   • 변수 이름: GOOGLE_API_KEY
   • 변수 값: 1단계에서 복사해 둔 여러분의 API 키 (예: AIzaSy...)
5. 확인 버튼을 눌러 모든 창을 닫습니다.
6. 중요: 변경 사항을 적용하려면 실행 중인 모든 PowerShell 또는 CMD 창을 껐다가 새로 켜야 합니다.

방법 B: gemini auth 명령어 사용 (가장 간편한 방법)

CLI가 알아서 키를 저장하고 관리하게 하는 편리한 방법입니다.

1. PowerShell이나 CMD를 켭니다.
2. 다음 명령어를 입력합니다.
   
   gemini auth

   1 2	gemini auth

3. “Enter your Google API Key:” 라는 메시지가 나타나면, 1단계에서 복사한 API 키를 붙여넣고 엔터를 누릅니다.
4. CLI가 키를 안전한 설정 파일(%USERPROFILE%\.gemini\config.json)에 저장해줍니다.

방법 C: --api-key 플래그 사용 (임시 테스트용)

매번 명령어를 실행할 때마다 키를 직접 입력하는 방식입니다. 보안에 취약하고 불편하므로 추천하지 않지만, 급하게 테스트할 때 유용합니다.

3단계: 연동 확인하기

이제 모든 설정이 끝났습니다! PowerShell이나 CMD 새 창을 열고, API 키 없이 간단한 명령어를 실행하여 제대로 작동하는지 확인합니다.

만약 아래와 같이 AI가 생성한 코드가 나타난다면 성공적으로 연동된 것입니다!

만약 인증 오류(authentication error)가 발생한다면, 환경 변수 이름(GOOGLE_API_KEY)이 정확한지, 키 값에 오타가 없는지 다시 한번 확인해 보세요.