1강. 물고기 말고 낚시

한 줄 요약 — 이 강의는 "이 서비스를 따라 만드세요"가 아니라 어떤 아이디어든 AI 코딩 에이전트와 끝까지 만들어 내는 순서를 가르칩니다. 오늘은 클로드 코드와 코덱스를 설치하고 첫 질문에 답을 받는 데까지 갑니다.

이번 강의에서 만들 것

• 결과물: 두 도구(클로드 코드, 코덱스) 중 하나 이상이 내 컴퓨터에서 실행되고, 첫 질문에 답합니다.
• 걸리는 시간: 30분(설치 대기 포함). 무료 미리보기입니다. 설치와 로그인까지만 해 보고 계속할지 정하셔도 됩니다.

먼저 알아둘 것

"물고기 말고 낚시"가 무슨 뜻인가

따라 만들기 강의는 물고기를 줍니다. 강의 속 서비스는 완성되지만, 내 아이디어를 들고 오면 막막합니다. 이 강의는 낚시를 가르칩니다. 아이디어가 무엇이든 같은 순서로 시작하고, 막히면 같은 방식으로 빠져나옵니다.

이 강의는 정해진 서비스 하나를 완성하는 대신, 종류가 다른 연습 4개(사이트 공개, 업무 자동화, 데이터 쌓이는 웹앱, 외부 서비스 연동)를 같은 순서로 반복하며 내가 무엇을 어떻게 시킬지 판단하는 법을 익힙니다. 막히면 오류를 읽고, 되돌리고, 다시 시킵니다(8강). 도구는 클로드 코드와 코덱스 둘 다입니다. 방법은 하나, 명령 이름만 다릅니다.

AI 코딩 에이전트는 무엇을 하나

채팅 AI는 답변 글을 줍니다. 코딩 에이전트는 내 프로젝트 폴더 안에서 파일을 읽고, 만들고, 고치고, 명령을 실행해 결과를 확인합니다. 채팅 AI가 전화로 조언해 주는 전문가라면, 코딩 에이전트는 내 작업장에 와서 같이 손을 움직이는 전문가입니다. 작업장에 들어오는 만큼 무엇을 허락할지는 사람이 정합니다(2강).

클로드 코드(Anthropic)와 코덱스(OpenAI, Codex CLI)가 그런 도구입니다. 둘 다 터미널에서 돌고, 규칙 파일 이름만 다릅니다(CLAUDE.md / AGENTS.md). 이 강의는 어느 쪽이 더 좋다고 단정하지 않습니다. 같은 일을 시켜 보고(2강) 내게 맞는 쪽을 고르는 것이 목표입니다.

따라 하기

1~2단계. 터미널 열고 클로드 코드 설치

터미널 열기: macOS는 Cmd + Space → Terminal, Windows는 Win + X → Windows PowerShell(줄 앞에 PS C:\가 보이면 PowerShell). 아래는 공식 문서의 네이티브 설치(권장) 명령이고, 끝날 때까지 진행 표시가 없어도 기다리세요.

curl -fsSL https://claude.ai/install.sh | bash

위는 macOS(그리고 Linux, WSL)용입니다. Windows PowerShell에서는 아래를 씁니다.

irm https://claude.ai/install.ps1 | iex

• 대안: macOS brew install --cask claude-code, Windows winget install Anthropic.ClaudeCode. 두 방법은 자동 업데이트가 되지 않습니다.
• Windows는 Git for Windows 설치를 권장합니다(3강에서 Git을 씁니다).

이렇게 보이면 성공: 새 터미널 창에서 claude --version을 실행하면 버전 번호가 나옵니다.

3단계. 코덱스 설치

공식 문서의 독립 설치 프로그램입니다. macOS(그리고 Linux)는 아래를 씁니다.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows는 새 PowerShell 창에서 아래를 씁니다.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

• 대안: npm install -g @openai/codex(Node.js 필요), macOS brew install --cask codex.

이렇게 보이면 성공: 새 터미널 창에서 codex를 실행했을 때 로그인 또는 입력 화면이 뜹니다(다음 단계).

4단계. 연습 폴더에서 첫 실행과 로그인

mkdir fishing-practice
cd fishing-practice
claude

처음 실행하면 로그인을 요청하고 브라우저가 열립니다. 안내대로 로그인하세요. 나가려면 /exit를 입력합니다. 코덱스는 같은 폴더에서 codex를 실행하면 첫 실행 때 Sign in with ChatGPT 등 로그인 방법을 고릅니다(codex login으로도 가능, 나갈 때는 /quit 또는 /exit).

이렇게 보이면 성공: 입력창이 뜹니다. 클로드 코드는 버전·모델·작업 폴더가 위에 표시됩니다.

5단계. 첫 질문 해 보기

아래를 그대로 붙여 넣으세요(두 도구 똑같이). 폴더가 비어 있어도 괜찮습니다.

나는 코딩을 전혀 모르는 사람이야. 이 폴더는 비어 있어.
1) 너는 지금 무엇을 할 수 있고, 무엇을 할 수 없는지 5줄 이내로 알려줘.
2) 내가 "[내가 만들고 싶은 것 한 줄]"을 만들고 싶다면, 처음 해야 할 일을 번호로 5개만 알려줘.
3) 아직 파일은 아무것도 만들지 마.

이렇게 보이면 성공: 파일을 만들지 않고 글로만 답합니다. 중간에 멈추려면 Esc를 누릅니다.

6단계. 계정과 요금 고르기

요금제와 한도는 자주 바뀌므로 숫자를 쓰지 않습니다. 결제 전에 공식 페이지에서 직접 확인하세요(2026년 10월 기준, 공개 전 재확인).

• 클로드 코드: claude.com/pricing. 공식 문서 기준 클로드 구독(Pro·Max·Team·Enterprise) 또는 Console 계정이 필요하고, 무료 claude.ai 플랜은 해당되지 않습니다.
• 코덱스: learn.chatgpt.com/docs/pricing(OpenAI 코덱스 요금 안내). ChatGPT 계정으로 로그인하는 방식(구독 사용량)과 API 키 방식(사용량만큼 과금)이 있습니다.

상황	선택 기준
처음이라 써 보고 정하고 싶다	이미 가진 구독이 있으면 그 계정으로 먼저 로그인. 한도에 자주 걸리면 그때 플랜 검토
매일 길게 쓸 것 같다	두 도구의 한도 정책을 공식 페이지에서 비교한 뒤 결정(14강)
쓴 만큼만 내고 싶다	API 키 방식. 구독과 비용 구조가 다르니 공식 페이지로 확인

7단계. 만들기 루프 6단계 한눈에 보기

이 강의 전체의 뼈대입니다. 4부의 연습 4개를 모두 이 순서로 만듭니다.

단계	이름	한 줄	다루는 강
①	말하기	무엇을, 누구를 위해, 어떻게 되면 성공인지 말로 정리	4·6강
②	쪼개기	한 번에 하나만. 계획을 먼저 받고 승인	5강
③	만들기	AI가 만든다. 사람은 작은 단위로 허락한다	2·3강
④	확인하기	돌려보고, 증거를 받는다	7강
⑤	고치기	오류를 읽고 전달하고, 안 되면 되돌린다	8강
⑥	기억시키기	규칙 파일·메모에 배운 것을 쌓는다	3·9강

8단계. 이 강의의 진행 규칙 4가지

1. 프롬프트는 복사해서 붙여 넣습니다. text 상자가 AI에게 그대로 보내는 말이고, 바꿀 곳은 [ ]로 표시합니다.
2. 개발 서버(npm run dev 등)는 내가 직접 켜고 끕니다. AI에게는 빌드·테스트처럼 끝나는 명령만 시킵니다.
3. API 키·비밀번호는 대화창에 붙이지 않습니다. .env 환경변수에 직접 넣고, 브라우저(클라이언트) 코드에는 넣지 않습니다.
4. 되돌릴 수 없는 삭제와 운영 데이터 변경은 사람이 확인합니다.

막혔을 때

증상	대처
claude/codex를 찾을 수 없음	새 터미널 창을 열어 다시 시도. 그래도 안 되면 각 공식 설치 문서의 문제 해결(PATH)을 따름
로그인했는데 사용할 수 없다고 나옴	무료 claude.ai 플랜에는 클로드 코드가 없습니다. 계정 종류를 확인
설치 점검이 필요함	클로드 코드는 claude doctor, 코덱스는 codex doctor

클로드(코덱스)에게 맡겨도 되는 것 / 사람이 반드시 볼 것

AI에게 맡겨도 되는 것	사람이 반드시 볼 것
폴더 구조 설명, 할 일 목록 정리	요금제 선택과 결제(내 돈이 나가는 결정)
설치 오류 메시지 해석	설치 명령을 공식 문서 주소에서 복사했는지(출처 모를 명령 금지)
첫 질문에 대한 답변 초안	API 키·비밀번호를 대화창에 붙이지 않았는지

내 아이디어로 바꾸기

• 5단계의 [내가 만들고 싶은 것 한 줄]을 지금 떠오르는 아이디어 하나로 바꾸세요. 완벽하지 않아도 됩니다. 4강에서 다듬습니다.

숙제와 체크리스트

• 클로드 코드나 코덱스(둘 다면 더 좋다)를 실행하고 로그인했다
• 첫 질문에 답을 받았다
• Esc로 중단하고 /exit로 종료하는 법을 해 봤다
• 두 도구의 요금 페이지를 직접 열어 보고 시작할 계정을 정했다
• 만들기 루프 6단계 이름을 말할 수 있다
• 개발 서버는 내가 직접 켠다는 규칙을 기억한다

다음 강의

2강에서는 같은 한 장짜리 페이지를 두 도구에 똑같이 시켜 보고, 어디까지 맡길지(권한·승인·샌드박스)와 되돌리는 안전망을 배웁니다.