Claude Code·Codex CLI 처음 설치하고 첫 작업 시키는 법
터미널에서 쓰는 AI 코딩 도구는 채팅창과 달리 내 컴퓨터의 파일을 직접 고치고 명령까지 실행합니다. 그래서 설치는 명령 한 줄이면 끝나지만, 첫날 정해 둘 것이 두 가지 더 있습니다. 어디까지 허락 없이 맡길지, 그리고 잘못 고쳤을 때 어떻게 되돌릴지입니다. Claude Code와 OpenAI Codex CLI를 기준으로 순서대로 따라가 보겠습니다.
요금제부터 확인하기
둘 다 설치는 무료지만 일을 시키려면 유료 구독이 필요합니다. Claude Code는 Pro·Max·Team·Enterprise 구독이나 API 결제용 Console 계정으로 쓰고, 무료 계정에는 들어 있지 않습니다. Pro는 월 20달러, 1년 치를 한 번에 내면 월 17달러꼴입니다.
Codex는 조금 헷갈립니다. OpenAI 요금 안내에는 모든 ChatGPT 플랜에 Codex가 들어 있다고 적혀 있지만, CLI가 이용 화면으로 명시된 건 Plus(월 20달러)부터입니다. Free와 Go는 데스크톱 앱만 적혀 있어서, 터미널에서 쓸 생각이라면 Plus 이상을 기준으로 잡는 편이 안전합니다.
설치 명령 한 줄 넣기
아래 명령은 공식 문서에 적힌 그대로입니다. Windows라면 PowerShell을 열고 줄 맨 앞에 PS C:\가 보이는지 먼저 확인하세요. 명령 프롬프트(CMD)용 명령은 따로 있어서, 다른 창에 붙여 넣으면 오류가 납니다.
# Claude Code, Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Claude Code, macOS·Linux
curl -fsSL https://claude.ai/install.sh | bash
# Codex CLI, Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
# Codex CLI, macOS·Linux
curl -fsSL https://chatgpt.com/codex/install.sh | shClaude Code 설치는 진행 표시 없이 조용히 끝납니다. 끝나면 터미널을 새로 열고 claude --version을 입력해, 버전 번호 뒤에 (Claude Code)가 붙어 나오면 성공입니다. Node.js가 있다면 npm으로도 설치할 수 있습니다. Claude Code는 npm install -g @anthropic-ai/claude-code, Codex는 npm install -g @openai/codex입니다.
연습용 폴더에서 처음 실행하기
처음부터 중요한 프로젝트에서 시작하지 말고, 버려도 되는 폴더를 하나 만들어 git init부터 해 두세요. 되돌릴 기준점이 생기는 데다, Codex는 시작할 때 Git 폴더인지 보고 권한을 정합니다. Git 폴더면 폴더 안에서 고치되 필요할 때 묻는 Auto로, 아니면 읽기만 하는 read-only로 시작하도록 권합니다.
mkdir ai-practice
cd ai-practice
git init
claudeCodex라면 마지막 줄을 codex로 바꾸면 됩니다. 처음 실행하면 로그인 안내가 나오는데, Claude Code는 브라우저에서 구독 계정으로 로그인하고 Codex는 Sign in with ChatGPT를 고르면 됩니다.
첫 부탁 전에 권한부터 정하기
Claude Code는 2.1.283 이후 버전부터 터미널 세션을 auto 모드로 시작합니다. 별도의 검사 모델이 동작을 살피고 대부분은 묻지 않고 진행하는 방식이라, 처음이라면 Shift+Tab을 눌러 하단 표시를 manual mode on으로 바꿔 두는 편이 안심됩니다. 그러면 파일을 고치거나 명령을 실행하기 전에 매번 허락을 묻습니다. Codex는 입력창에 /permissions를 넣어 바꾸는데, 공식 문서는 대부분의 작업에 Ask for approval을 권합니다.
허락 창에 아래 같은 요청이 보이면 내용을 끝까지 읽기 전에는 승인하지 마세요.
rm,del처럼 파일을 지우거나 연습 폴더 밖을 건드리는 명령git push처럼 내 컴퓨터 밖으로 무언가를 내보내는 명령.env처럼 비밀번호나 키가 든 파일을 읽거나 출력하는 요청- 모르는 패키지 설치나 인터넷에서 받은 스크립트 실행
Claude Code의 --dangerously-skip-permissions와 Codex의 --yolo 옵션은 묻는 단계를 통째로 없앱니다. Claude Code 문서는 이 모드를 인터넷이 끊긴 컨테이너나 가상 머신에서만 쓰라고 하고, Codex 문서도 권장하지 않는다고 표시해 두었으니 첫 달에는 쓰지 마세요.
첫 부탁은 작고 확인 가능하게
첫 부탁은 파일을 고치지 않는 질문이 좋습니다. 그다음 파일 하나만 만들게 하고, 마지막으로 바뀐 내용을 보여 달라고 하면 첫날 연습으로 충분합니다. 아래 세 문장은 제가 만든 예시라 도구별 결과를 견줘 보지는 않았습니다.
이 폴더에 무엇이 있는지 설명해 줘. 파일은 아직 고치지 마.
index.html 파일 하나만 만들어 줘. 제목은 "연습 페이지", 본문은 한 줄이면 돼.
만들기 전에 무엇을 할지 먼저 말해 주고, 다른 파일은 건드리지 마.
방금 바꾼 내용을 보여 줘. 내가 확인하기 전까지 커밋이나 push는 하지 마.두 번째 부탁에서 파일을 만들기 전에 허락 창이 뜨면 정상입니다. 끝난 뒤에는 두 도구 모두 /diff를 입력하면 바뀐 내용을 한 화면에서 볼 수 있습니다.
잘못 고쳤을 때 되돌리기
Claude Code는 메시지를 보낼 때마다 직전 상태를 저장해 둡니다. 입력창이 비어 있을 때 Esc를 두 번 누르거나 /rewind를 입력하고, 돌아갈 지점을 골라 Restore code를 선택하면 됩니다. 다만 터미널 명령(rm, mv 등)으로 바뀐 파일은 이 방법으로 돌아오지 않습니다.
Codex 문서에서는 이런 되돌리기 명령을 찾지 못했으니, Codex를 쓸 때는 Git이 사실상 안전장치입니다. 일을 맡기기 전에 커밋을 하나 해 두고, 끝나면 /diff로 확인한 뒤 마음에 들지 않는 파일은 git restore 파일이름으로 마지막 커밋 상태로 돌리면 됩니다. 이 명령은 그 파일의 커밋하지 않은 변경을 지워 버리니 살릴 부분이 없는지 먼저 보세요.
git add .
git commit -m "AI 작업 전"자주 막히는 곳
claude를 찾을 수 없다고 나온다면 설치한 창을 그대로 쓰고 있을 가능성이 큽니다. 터미널을 새로 열고, 그래도 안 되면 공식 문제 해결 문서의 PATH 항목을 따라가세요.The token '&&' is not a valid statement separator가 뜬다면 CMD용 명령을 PowerShell에 넣은 것이고,'irm' is not recognized는 그 반대입니다.- Codex가 읽기만 하고 고치지 않는다면 Git 폴더가 아니거나 폴더를 신뢰한다고 표시하지 않아 read-only로 시작했을 수 있습니다.
git init후 다시 실행하거나/permissions에서 바꾸세요. - 한도에 걸렸다면 Claude Code는
/usage, Codex는/status로 사용량을 봅니다. Codex Plus는 5시간 단위 한도에 주간 한도가 더해질 수 있으니, 한 번에 기능 하나씩 맡기는 쪽이 오래 갑니다.
첫 작업 전 체크리스트
설치는 금방 끝나지만, 이 도구들은 내 파일을 직접 만진다는 점에서 채팅 AI와 무게가 다릅니다. 첫 주에는 묻는 모드로 두고 허락 창을 하나하나 읽다 보면, AI가 어떤 순서로 일하는지가 자연스럽게 눈에 익습니다. 오늘은 연습용 폴더에서 git init을 하고, 파일을 고치지 말라는 첫 질문 하나만 보내 보세요.
