초보자용 VS Code + Python + Node.js + AI 코딩 CLI 설치 가이드 (터미널 사용) Windows(CMD/PowerShell) · macOS · Linux 기준: 2026-08-26 ============================================================ 0. 먼저 읽기 ============================================================ 1) 자신의 운영체제 부분만 따라 하세요. 설치 목록에서 필요한 것만 설치하세요. 2) 명령어는 한 줄씩 복사해서 터미널에 붙여넣고 Enter를 누릅니다. 3) 설치가 끝나면 VS Code와 터미널을 한 번 닫았다가 다시 엽니다. 4) 마지막의 --version 명령으로 설치 여부를 확인합니다. 5) Windows 초보자는 CMD보다 PowerShell 사용을 권장합니다. ※ Windows 관리자 권한 원칙 - 처음부터 관리자 권한으로 실행하지 않습니다. - 일반 PowerShell/CMD에서 먼저 설치합니다. - Windows가 관리자 권한(UAC)을 요청하면 [예]를 누릅니다. - 권한 오류가 발생한 경우에만 PowerShell/CMD를 [관리자 권한으로 실행]하여 다시 시도합니다. 설치 목록: - VS Code - Python - Node.js - Claude Code - OpenAI Codex CLI - Google Antigravity CLI ※ curl - Claude Code(macOS/Linux)와 Antigravity(macOS/Linux)는 공식 curl 설치 명령을 사용할 수 있습니다. - Codex는 현재 공식적으로 npm 설치가 가장 간단하고 확실합니다. - 인터넷에서 출처가 불분명한 curl | bash 명령은 실행하지 마세요. ============================================================ 1. WINDOWS ============================================================ [1-1] PowerShell 열기 시작 메뉴 → PowerShell 검색 → Windows PowerShell 또는 PowerShell 실행 [관리자 권한: 필요 없음] ※ 처음에는 일반 PowerShell을 실행하세요. ※ 설치 과정에서 Windows가 관리자 권한(UAC)을 요청하면 [예]를 누르세요. ※ 권한 오류가 발생할 때만 PowerShell을 마우스 오른쪽 버튼 → [관리자 권한으로 실행]하여 다시 시도하세요. VS Code 설치 후에는: VS Code → Terminal → New Terminal 에서도 같은 명령을 실행할 수 있습니다. ------------------------------------------------------------ [1-2] VS Code 설치 ------------------------------------------------------------ [관리자 권한: 보통 필요 없음] PowerShell 또는 CMD: winget install Microsoft.VisualStudioCode ※ 일반 PowerShell/CMD에서 실행하세요. ※ 설치 중 Windows가 관리자 권한(UAC)을 요청하면 [예]를 누르세요. 설치 후 터미널을 닫았다가 다시 열고 확인: code --version ------------------------------------------------------------ [1-3] Python 설치 ------------------------------------------------------------ [관리자 권한: 보통 필요 없음] PowerShell 또는 CMD: winget install Python.Python.3.14 ※ 일반 PowerShell/CMD에서 실행하세요. ※ 설치 중 Windows가 관리자 권한(UAC)을 요청하면 [예]를 누르세요. 확인: python --version pip --version 만약 python 명령이 안 되면: python3 --version py --version ------------------------------------------------------------ [1-4] Node.js 설치 ------------------------------------------------------------ [관리자 권한: 설치 중 요청될 수 있음] LTS 버전 권장: winget install --id OpenJS.NodeJS.LTS -e ※ 일반 PowerShell/CMD에서 먼저 실행하세요. ※ Node.js 설치 프로그램이 관리자 권한(UAC)을 요청하면 [예]를 누르세요. 터미널을 다시 열고 확인: node --version npm --version ------------------------------------------------------------ [1-5] Claude Code 설치 ------------------------------------------------------------ [관리자 권한: 필요 없음] ※ 일반 PowerShell/CMD에서 실행하세요. ※ 처음부터 관리자 PowerShell을 사용할 필요는 없습니다. 방법 A. npm 사용 npm install -g @anthropic-ai/claude-code 확인: claude --version 실행: claude 방법 B. Windows PowerShell에서 공식 설치 스크립트를 사용하는 경우 irm https://claude.ai/install.ps1 | iex ※ 환경에 따라 Git for Windows 또는 WSL이 필요할 수 있습니다. ------------------------------------------------------------ [1-6] OpenAI Codex CLI 설치 ------------------------------------------------------------ [관리자 권한: 보통 필요 없음] ※ 일반 PowerShell/CMD에서 실행하세요. Node.js 설치 후: npm install -g @openai/codex 확인: codex --version 실행: codex 또는 로그인: codex login ※ Codex는 현재 npm 설치가 공식적으로 가장 간단합니다. ------------------------------------------------------------ [1-7] Google Antigravity CLI 설치 ------------------------------------------------------------ [관리자 권한: 보통 필요 없음] ※ 일반 PowerShell/CMD에서 실행하세요. PowerShell: irm https://antigravity.google/cli/install.ps1 | iex CMD를 사용하는 경우: curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd 터미널을 다시 열고 확인: agy --version 실행: agy ------------------------------------------------------------ [1-8] Windows 전체 확인 ------------------------------------------------------------ code --version python --version node --version npm --version claude --version codex --version agy --version 각 명령에서 버전 번호가 나오면 설치 완료입니다. ============================================================ 2. macOS ============================================================ [2-1] 터미널 열기 Command + Space → Terminal 검색 → 실행 VS Code 설치 후에는: VS Code → Terminal → New Terminal 에서도 실행할 수 있습니다. ------------------------------------------------------------ [2-2] Homebrew 설치 ------------------------------------------------------------ Homebrew가 없다면: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 설치 확인: brew --version ------------------------------------------------------------ [2-3] VS Code 설치 ------------------------------------------------------------ brew install --cask visual-studio-code 확인: code --version code 명령이 안 되면 VS Code에서: Command + Shift + P 검색: Shell Command: Install 'code' command in PATH ------------------------------------------------------------ [2-4] Python 설치 ------------------------------------------------------------ brew install python 확인: python3 --version pip3 --version ------------------------------------------------------------ [2-5] Node.js 설치 ------------------------------------------------------------ brew install node 확인: node --version npm --version ------------------------------------------------------------ [2-6] Claude Code 설치 ------------------------------------------------------------ 공식 curl 설치: curl -fsSL https://claude.ai/install.sh | bash 또는 npm: npm install -g @anthropic-ai/claude-code 확인: claude --version 실행: claude ------------------------------------------------------------ [2-7] OpenAI Codex CLI 설치 ------------------------------------------------------------ npm install -g @openai/codex 확인: codex --version 실행: codex 로그인이 필요하면: codex login ------------------------------------------------------------ [2-8] Google Antigravity CLI 설치 ------------------------------------------------------------ 공식 curl 설치: curl -fsSL https://antigravity.google/cli/install.sh | bash 터미널을 다시 열고 확인: agy --version 실행: agy ------------------------------------------------------------ [2-9] macOS 전체 확인 ------------------------------------------------------------ code --version python3 --version node --version npm --version claude --version codex --version agy --version ============================================================ 3. LINUX (Ubuntu / Debian 기준) ============================================================ [3-1] 터미널 열기 Ctrl + Alt + T 먼저 기본 패키지 업데이트: sudo apt update ------------------------------------------------------------ [3-2] VS Code 설치 ------------------------------------------------------------ Ubuntu에서 간단한 방법: sudo snap install code --classic 확인: code --version ------------------------------------------------------------ [3-3] Python 설치 ------------------------------------------------------------ sudo apt install -y python3 python3-pip python3-venv 확인: python3 --version pip3 --version ------------------------------------------------------------ [3-4] Node.js 설치 ------------------------------------------------------------ 초보자에게는 nvm 사용을 권장합니다. nvm 설치: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash 터미널을 닫았다가 다시 열거나: source ~/.bashrc Node.js LTS 설치: nvm install --lts 확인: node --version npm --version ------------------------------------------------------------ [3-5] Claude Code 설치 ------------------------------------------------------------ 공식 curl 설치: curl -fsSL https://claude.ai/install.sh | bash 또는 npm: npm install -g @anthropic-ai/claude-code 확인: claude --version 실행: claude ------------------------------------------------------------ [3-6] OpenAI Codex CLI 설치 ------------------------------------------------------------ npm install -g @openai/codex 확인: codex --version 실행: codex 로그인이 필요하면: codex login ------------------------------------------------------------ [3-7] Google Antigravity CLI 설치 ------------------------------------------------------------ 공식 curl 설치: curl -fsSL https://antigravity.google/cli/install.sh | bash 터미널을 다시 열고 확인: agy --version 실행: agy ------------------------------------------------------------ [3-8] Linux 전체 확인 ------------------------------------------------------------ code --version python3 --version node --version npm --version claude --version codex --version agy --version ============================================================ 4. 설치 후 가장 먼저 해보기 ============================================================ 작업 폴더를 하나 만듭니다. Windows PowerShell: mkdir myproject cd myproject code . macOS / Linux: mkdir myproject cd myproject code . VS Code에서: Terminal → New Terminal 그리고 원하는 AI 코딩 도구를 실행합니다. Claude Code: claude OpenAI Codex: codex Google Antigravity: agy ============================================================ 5. 자주 생기는 문제 ============================================================ [문제 1] command not found / 명령을 찾을 수 없습니다. 해결: - 터미널과 VS Code를 완전히 닫았다가 다시 실행 - 설치 명령을 다시 확인 - PATH가 적용되지 않은 경우가 많음 [문제 2] npm 명령이 없습니다. Node.js가 설치되지 않은 것입니다. 확인: node --version npm --version 없으면 Node.js를 먼저 설치하세요. [문제 3] Python 명령이 없습니다. Windows: python --version py --version macOS / Linux: python3 --version [문제 4] 권한 오류가 납니다. macOS/Linux에서 다음처럼 sudo npm install -g ... 를 무조건 사용하는 것은 권장하지 않습니다. sudo npm install -g ... Node/npm 권한 설정 또는 nvm 사용을 권장합니다. ============================================================ 6. 공식 사이트 ============================================================ VS Code https://code.visualstudio.com/ Python https://www.python.org/ Node.js https://nodejs.org/ Claude Code https://docs.anthropic.com/en/docs/claude-code/ OpenAI Codex https://openai.com/codex/ https://github.com/openai/codex Google Antigravity https://antigravity.google/ https://antigravity.google/docs/cli/install/ ============================================================ 7. 초보자 수업에서 권장하는 순서 ============================================================ 1. VS Code 설치 2. Python 설치 3. Node.js 설치 4. VS Code 재시작 5. VS Code Terminal 열기 6. Claude Code 설치 7. Codex 설치 8. Antigravity 설치 9. --version으로 전체 확인 10. 작업 폴더를 만들고 code . 실행 11. claude / codex / agy 중 하나 실행 끝.