Codex, Claude Code, Gemini CLI, Grok — 요즘 개발자들이 터미널에서 쓰는 AI 코딩 도구들입니다. 문제는 설치 명령어가 도구마다 달라서 쓸 때마다 검색하게 된다는 것. 이 글에 네 가지를 전부 모았습니다. 아래 명령어를 복사해 터미널에 붙여넣으면 끝이고, 네 개 모두 이 글을 쓰면서 직접 설치해 실행까지 확인한 명령어입니다.
먼저 용어 하나만 — AI CLI는 Command Line Interface의 약자로, 채팅 웹사이트가 아니라 터미널(명령창)에서 돌아가는 AI를 말합니다. 웹 챗봇과 달리 내 컴퓨터의 파일을 직접 읽고 고치고 명령을 실행할 수 있어서, 코딩·자동화 작업에서는 사실상 표준이 됐습니다.
설치 명령어 한눈에 보기
| 도구 | 설치 명령 (윈도우·맥 공통) | 요구사항 | 로그인 |
|---|---|---|---|
| Claude Code | npm install -g @anthropic-ai/claude-code | Node 18+ | Claude 계정 (Pro/Max) |
| Codex CLI | npm install -g @openai/codex | Node 22+ | ChatGPT 계정 (Plus/Pro) |
| Gemini CLI | npm install -g @google/gemini-cli | Node 18+ | 구글 계정 (무료 한도) |
| Grok CLI | npm install -g @xai-official/grok | Node LTS | X 계정 또는 API 키 |
넷 다 npm으로 설치하므로 Node.js가 먼저 필요합니다. 아래 준비부터 하고 원하는 도구 섹션으로 내려가시면 됩니다.
도구별로 로그인·기본 사용법·문제 해결까지 깊게 정리한 개별 가이드도 있습니다:
- Claude Code 설치 방법 — 윈도우·맥 명령어와 로그인까지
- 코덱스 설치방법 — ChatGPT Codex CLI 윈도우·맥 총정리
- Gemini CLI 사용법 — 설치부터 무료 한도, 로그인까지
- 그록 CLI 설치 방법 — 공식 Grok Build 명령어와 사용법
공통 준비 — Node.js 설치
윈도우는 PowerShell을 열고:
winget install OpenJS.NodeJS.LTS맥은 터미널에서 (Homebrew 기준):
brew install node설치 후 터미널을 껐다 다시 열고 확인합니다. v22 이상이면 네 도구 모두 사용 가능합니다.
node --versionClaude Code 설치 방법
Anthropic의 CLI 에이전트입니다. npm 한 줄이면 됩니다.
npm install -g @anthropic-ai/claude-codenpm 없이 설치하고 싶다면 네이티브 설치 스크립트도 있습니다. 윈도우 PowerShell은:
irm https://claude.ai/install.ps1 | iex맥·리눅스는:
curl -fsSL https://claude.ai/install.sh | bash설치 후 작업할 폴더에서 claude를 입력하면 브라우저가 열리며 로그인합니다. Claude Pro/Max 구독 또는 API 크레딧이 필요합니다.
Codex CLI 설치 방법 (ChatGPT)
OpenAI의 CLI 에이전트입니다. Node 22 이상이 필요하다는 점만 주의하세요.
npm install -g @openai/codex가장 흔한 실수가 npm install -g codex로 치는 것입니다. 이건 2012년에 등록된 전혀 무관한 패키지라 설치해도 아무 일도 안 일어납니다. 반드시 @openai/를 붙여야 합니다. 맥에서는 Homebrew로도 됩니다:
brew install --cask codexnpm 없이 설치하는 공식 스크립트도 있습니다. 윈도우 PowerShell은:
irm https://chatgpt.com/codex/install.ps1 | iex맥·리눅스는:
curl -fsSL https://chatgpt.com/codex/install.sh | sh실행은 codex. 처음 실행하면 ChatGPT 계정으로 로그인하며, Plus/Pro 구독으로 쓸 수 있습니다.
Gemini CLI 설치 방법 (구글)
구글의 오픈소스 CLI 에이전트입니다.
npm install -g @google/gemini-cli설치 없이 한 번 써보고 싶으면 npx로 바로 실행할 수도 있습니다:
npx @google/gemini-cli실행은 gemini. 개인 구글 계정으로 로그인하면 무료 사용 한도가 제공되는 것이 특징이라, 넷 중 진입 장벽이 가장 낮습니다. 일단 하나만 깔아본다면 이걸 추천합니다.
Grok CLI 설치 방법 (xAI)
xAI(일론 머스크)의 CLI 에이전트입니다. 패키지 이름을 특히 조심해야 합니다 — npm에 이름이 비슷한 비공식 패키지가 여럿 있는데, 공식은 xAI 보안팀(security@x.ai)이 관리하는 @xai-official/grok 하나입니다.
npm install -g @xai-official/grok맥·리눅스는 공식 설치 스크립트도 있습니다:
curl -fsSL https://x.ai/cli/install.sh | bash실행은 grok. 첫 실행 시 브라우저로 로그인하고, 서버 환경이라면 console.x.ai에서 API 키를 받아 XAI_API_KEY 환경변수로 넣으면 됩니다.
설치가 안 될 때 — 증상별 해결
- “명령을 찾을 수 없습니다”가 뜸 — 설치는 됐는데 PATH가 갱신 안 된 경우가 대부분입니다. 터미널을 완전히 껐다 다시 여세요. 그래도 안 되면 재부팅.
- 설치 중 오류가 남 —
node --version부터 확인하세요. Codex는 22 미만이면 실패합니다. 낮으면 Node.js LTS를 다시 설치하면 됩니다. - 설치했는데 엉뚱한 게 실행됨 — 패키지 이름을 다시 보세요.
@openai/codex,@xai-official/grok처럼 @ 스코프까지가 정식 이름입니다. 스코프 없는 유사 패키지가 여럿 있습니다. - 맥에서 권한 오류(EACCES) —
sudo로 강행하지 말고 Homebrew로 Node를 설치하면 대부분 해결됩니다.
네 개 모두 정상 설치됐는지는 버전 확인으로 끝납니다. 실제로 이 글의 명령어로 설치한 결과입니다.
어떤 걸 설치해야 하나
고민된다면 이렇게 정리할 수 있습니다. 무료로 먼저 경험하려면 Gemini CLI, 이미 ChatGPT Plus를 쓰고 있다면 Codex, Claude 구독자라면 Claude Code가 자연스럽습니다. 어차피 설치는 각 1분이라 여러 개 깔아두고 비교해도 부담이 없습니다 — 넷은 서로 공존하며 충돌하지 않습니다.
CLI 에이전트를 여러 개 굴려서 팀처럼 부리는 단계까지 궁금하시다면 클로드 AI 직원 만들기와 멀티에이전트를, 어떤 AI가 내 용도에 맞는지는 Gemini와 ChatGPT 비교를 참고하시기 바랍니다.
참고 자료: @openai/codex — npm 공식 패키지 · Gemini CLI — 구글 공식 GitHub · @xai-official/grok — npm 공식 패키지 · @anthropic-ai/claude-code — npm 공식 패키지
답글 남기기