환경 확인

Windows, macOS, Linux에서 작동합니다 (필요 시 경로 조정).

(1) Node.js

npm list -g --depth=0

• 정상: 출력 또는 빈 목록.
• 실패: "command not found" → Node.js LTS (18+) 설치 후 터미널을 다시 열고 재시도.

node -v
npm -v

(2) CLI 설치

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

필요한 도구만 설치하세요.

(3) 첫 실행 (설정 디렉터리 생성)

각 명령어를 한 번씩 실행하여 ~/.claude, ~/.codex, ~/.gemini가 생성되도록 합니다.

claude

codex

gemini

UI나 마법사가 나타나면 Ctrl+C 또는 화면의 안내에 따라 종료합니다.

(4) 다음 단계

API 키를 사용하여:

• Claude Code
• Codex
• Gemini

설치 문제

문제	해결 방법
EACCES	sudo npm -g 사용 금지; nvm 사용 또는 npm 접두사 수정
회사 프록시	HTTPS_PROXY / npm 프록시 설정
구 버전	npm i -g package@latest