0) 공통 사전 준비

Gemini CLI와 Codex CLI는 npm 설치를 사용하므로 Node.js와 npm이 필요합니다.

Windows PowerShell 공통 확인

# PowerShell 버전 확인
$PSVersionTable.PSVersion

# Node.js / npm 확인
node --version
npm --version

# Git 확인
git --version

Node.js 또는 Git이 없다면, 수업장에서는 아래 방식 중 하나로 사전 설치합니다.

# Node.js LTS 설치
winget install OpenJS.NodeJS.LTS

# Git 설치
winget install Git.Git

# 설치 후 PowerShell을 닫고 다시 열어서 확인
node --version
npm --version
git --version

macOS zsh / Ubuntu bash 공통 확인

# 현재 셸 확인
echo $SHELL

# Node.js / npm 확인
node --version
npm --version

# Git 확인
git --version

macOS에서 Homebrew를 쓰는 경우:

brew install node git

Ubuntu 또는 WSL에서 Node 버전을 안정적으로 맞추고 싶다면 nvm 사용을 권장합니다.

# nvm 설치
curl -o- <https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh> | bash

# bash 사용 시
source ~/.bashrc

# zsh 사용 시
source ~/.zshrc

# Node.js 24 설치 및 사용
nvm install 24
nvm use 24

# Git 설치
sudo apt update
sudo apt install -y git

# 확인
node --version
npm --version
git --version

1) Gemini CLI

Gemini CLI는 Google의 터미널 기반 AI 에이전트입니다. 공식 문서는 npm 전역 설치, Homebrew 설치, npx 실행 방식을 안내하며, 대부분의 사용자는 gemini 명령으로 실행하라고 설명합니다. 인증은 일반 개인 Google 계정의 경우 “Sign in with Google”이 권장되며, API key 방식도 지원합니다. (Gemini CLI)

Windows PowerShell 에서 Gemini CLI 설치

# Gemini CLI 설치
npm install -g @google/gemini-cli

# 명령어가 등록되었는지 확인
Get-Command gemini

# 버전 확인
gemini --version

설치 없이 일회성으로 실행해보고 싶다면:

npx @google/gemini-cli

macOS zsh / Ubuntu bash 에서 Gemini CLI 설치