← 홈으로 ⚡ Week 12 · Cursor Agent & Codex

Cursor Agent & Codex CLI
AI 프롬프트로 브랜치·커밋·Push까지

코드 짜는 것만이 Vibe coding이 아닙니다.
브랜치 만들기부터 GitHub Push까지 — 전부 AI에게 말로 시키는 방법

🤔 오늘의 주제 — 왜 이게 필요해?

상황 ①: Cursor 무료 한도를 다 썼을 때

Cursor 무료 플랜은 매달 fast request 50회가 주어집니다. 열심히 Vibe coding을 하다 보면 생각보다 빨리 소진됩니다. 이때 두 가지 선택지가 있습니다.

💰 유료 플랜 (월 $20)
  • 빠른 요청 무제한
  • Cursor UI 그대로 유지
  • 가장 편한 선택
  • 단, 매달 비용 발생
🔑 OpenAI API Key + Codex CLI (오늘 배울 것)
  • 사용한 만큼만 과금 (종량제)
  • 소규모 사용이면 훨씬 저렴
  • Cursor 터미널에서 바로 사용
  • 또는 Cursor에 API Key 연결 → 크레딧 없이 계속

상황 ②: git 명령어 외우기 귀찮을 때

Week 11에서 GitHub Pages를 웹 UI로 배웠습니다. 하지만 실제 개발에서는 터미널에서 git 명령어를 쳐야 합니다. 매번 검색하거나 외워야 하는 이 과정을 AI에게 맡기면 어떨까요?

git 명령어를 외우는 것 = 길을 외우기
AI에게 "거기 데려다줘" = 내비게이션
둘 다 목적지에 도착하지만, 내비게이션이 있으면 처음 가는 길도 두렵지 않습니다.

오늘은 Cursor Agent 모드와 Codex CLI를 통해, 코딩뿐 아니라 브랜치·커밋·Push까지 전부 AI 프롬프트로 처리하는 방법을 배웁니다.

🔄 Cursor Agent 모드 — Vibe Coding의 진짜 핵심

일반 채팅 모드 vs Agent 모드

구분 일반 채팅 모드 Agent 모드
코드 제안 O O
파일 직접 수정 ✕ (사람이 직접 적용) O (AI가 직접 수정)
터미널 명령 실행 ✕ O (git, npm 등)
여러 파일 동시 수정 ✕ O
git 작업 자동화 ✕ O ← 오늘의 핵심

Agent 모드는 AI가 직접 파일을 수정하고 터미널 명령어도 실행할 수 있습니다. 즉, "커밋하고 푸쉬해줘"라고 하면 git add, git commit, git push를 알아서 실행합니다.

Agent 모드 켜는 법

1
Cursor 열기 → Composer 탭으로 이동

단축키 Ctrl + Shift + I (Windows) 또는 Cmd + Shift + I (Mac)로 Composer를 엽니다.

2
상단 드롭다운에서 "Agent" 선택

Composer 입력창 위쪽에 있는 모드 드롭다운(기본값: "Normal")을 클릭하여 Agent로 변경합니다.

3
이제 터미널 명령도 자연어로 요청

"이 파일 저장하고 커밋해줘", "새 브랜치 만들고 작업해줘" 같은 요청을 Agent가 직접 실행합니다. Agent가 실행할 명령을 먼저 보여주고 승인을 구하기도 합니다.

승인 vs 자동 실행: Agent가 터미널 명령을 실행하기 전, "Run command?" 확인 팝업이 뜰 수 있습니다. 내용을 확인하고 허용하면 됩니다. 처음에는 어떤 명령을 실행하는지 꼭 확인해 보세요.

📟 Codex CLI — Cursor 한도 소진 후 대안

Codex CLI는 OpenAI가 만든 터미널 기반 AI 코딩 에이전트입니다. Claude Code(Anthropic)와 비슷한 역할로, 터미널에서 자연어로 명령을 내리면 AI가 파일을 수정하고 명령을 실행합니다. Cursor 크레딧과 완전히 별개이고, OpenAI API Key로 동작합니다.

OpenAI API Key 발급

1
platform.openai.com 접속 후 로그인

ChatGPT 계정으로 로그인하면 됩니다.

2
API Keys → Create new secret key

왼쪽 메뉴 → API Keys → + Create new secret key 버튼 클릭. 생성된 키(sk-...)를 복사해 안전한 곳에 보관합니다. 이 창을 닫으면 다시 볼 수 없습니다.

3
결제 수단 등록 (Billing)

API는 종량제입니다. Billing 탭에서 카드를 등록하고 크레딧을 충전합니다. 일반적인 사용량이면 월 1~3달러 수준입니다.

API Key 보안 주의: API Key는 절대 코드에 직접 넣거나 GitHub에 올리면 안 됩니다. 환경변수나 별도 설정 파일에 저장하세요. 유출 시 타인이 내 비용으로 API를 사용할 수 있습니다.

Codex CLI 설치 — Windows

1
Node.js 설치 확인 후 Codex CLI 설치

PowerShell 또는 명령 프롬프트에서:

# Node.js 버전 확인 (22 이상 필요) node --version # Codex CLI 설치 npm install -g @openai/codex
2
API Key 환경변수 설정

현재 세션에만 적용 (임시):

set OPENAI_API_KEY=sk-여기에키입력

영구 적용하려면: Windows 검색 → "환경 변수 편집" → 시스템 변수 추가

Codex CLI 설치 — Mac / Linux

# Codex CLI 설치 npm install -g @openai/codex # API Key 설정 (현재 세션) export OPENAI_API_KEY=sk-여기에키입력 # 영구 적용 (~/.zshrc 또는 ~/.bashrc에 추가) echo 'export OPENAI_API_KEY=sk-여기에키입력' >> ~/.zshrc

Codex CLI 기본 사용법

# 프로젝트 폴더로 이동 후 실행 cd my-project # 기본 사용법: 한 줄 명령 codex "커피 내기 룰렛 앱에 다크모드 추가해줘" # 대화형 모드로 시작 codex

승인 모드 3가지 — 처음엔 반드시 suggest부터

Suggest
기본값
변경 내용을 제안만 합니다. 모든 파일 수정·명령 실행 전에 사람이 직접 승인해야 합니다.
처음 사용 시 권장
Auto-edit
--approval-mode auto-edit
파일 수정은 자동으로 합니다. 단, 터미널 명령 실행은 여전히 승인이 필요합니다.
어느 정도 익숙해지면
Full-auto
--approval-mode full-auto
파일 수정과 명령 실행 모두 자동입니다. 내부적으로 격리 환경에서 실행합니다.
충분히 신뢰할 때만
# 승인 모드 지정 예시 codex --approval-mode auto-edit "index.html 수정해줘"

🔗 Cursor에서 Codex 연결하기

두 가지 방법 중 상황에 맞게 선택하세요.

방법 ① Cursor 내장 터미널에서 Codex CLI 실행

Cursor에는 VS Code처럼 내장 터미널이 있습니다. 여기서 Codex CLI를 실행하면 Cursor에서 열린 프로젝트 폴더 안에서 Codex가 동작합니다.

1
Cursor 내장 터미널 열기

Ctrl + ` (백틱) 누르면 하단에 터미널이 열립니다.

2
Codex 실행
codex "배경색을 어둡게 바꿔줘"

Codex가 현재 폴더의 파일들을 보고 수정합니다. Cursor 에디터 탭에서 변경 사항이 실시간으로 반영됩니다.

이 방법은 Cursor의 편집 화면과 Codex의 AI 능력을 동시에 활용할 수 있어 실질적으로 가장 좋은 조합입니다. Cursor로 코드를 보면서, 터미널의 Codex에게 수정을 맡기는 식으로 사용합니다.

방법 ② Cursor Settings에서 OpenAI API Key 연결

Cursor 자체에 OpenAI API Key를 등록하면, Cursor의 채팅·Composer 기능이 내 API Key를 써서 동작합니다. Cursor 크레딧이 없어도 Cursor UI 그대로 사용 가능합니다.

1
Cursor Settings 열기

Ctrl + , → 또는 좌측 하단 톱니바퀴 아이콘 → Settings

2
Models → OpenAI API Key 입력

Cursor Settings → Models 탭 → OpenAI API Key 입력란에 발급받은 키 입력 → Save.
이후 모델 선택에서 gpt-4o를 선택하면 Cursor 크레딧 없이 내 API Key로 동작합니다.

3
기존과 똑같이 사용

Cursor Agent 모드, Composer, 채팅 등 모든 기능이 그대로 작동합니다. 다만 API 사용량이 OpenAI 대시보드에서 과금됩니다.

방법 장점 단점
① 터미널 + Codex CLI Cursor UI 그대로 유지, 터미널 명령에 강함 터미널과 에디터를 오가야 함
② Cursor에 API Key 연결 Cursor UI 그대로, 사용법 변화 없음 API 과금, 모델별 성능 차이

🌿 브랜치 심화 — main을 지키면서 안전하게 작업하기

브랜치가 왜 필요한가?

Week 11에서 용어 사전에서 잠깐 나왔던 Branch. 이번에는 실제로 왜 쓰는지 파고들겠습니다.

중요한 보고서를 수정할 때 원본을 바로 건드리지 않고
"사본_수정중.docx"를 만들어서 작업하는 것과 같습니다.
괜찮으면 원본에 반영하고, 마음에 안 들면 사본만 버립니다.

GitHub에서 main 브랜치는 항상 배포 가능한 상태여야 합니다. 새 기능을 만들거나 실험을 할 때는 별도 브랜치에서 하고, 완성됐을 때만 main에 합칩니다.

브랜치 흐름 시각화

main  ──●──────────────────────────────────────●──▶
           \                                    /
            feature/dark-mode  ──●──●──●──
                                  코딩  커밋  커밋

●  = 커밋 (저장 포인트)
feature 브랜치에서 작업이 끝나면 main으로 Merge(병합)

브랜치 기본 명령어 — AI가 대신 실행해줄 것들

# 새 브랜치 만들기 git branch feature-dark-mode # 브랜치로 이동 git checkout feature-dark-mode # 또는 최신 방식 git switch feature-dark-mode # 만들고 바로 이동 (가장 자주 쓰는 방법) git checkout -b feature-dark-mode # 현재 어떤 브랜치인지 확인 git branch # main으로 돌아가기 git checkout main # 브랜치 병합 (main에서 실행) git merge feature-dark-mode # 병합 완료 후 브랜치 삭제 git branch -d feature-dark-mode
이 명령어들을 외울 필요는 없습니다. AI에게 "feature-dark-mode 브랜치 만들고 이동해줘" 라고 하면 알아서 실행합니다. 명령어는 AI가 무엇을 실행하는지 이해하기 위해 한 번 보는 정도로 충분합니다.

실무에서의 브랜치 이름 규칙

종류 이름 패턴 예시
새 기능 feature/기능명 feature/dark-mode, feature/login
버그 수정 fix/버그명 fix/login-error, fix/typo
내용 추가 content/내용명 content/week-12
핫픽스 (긴급) hotfix/내용 hotfix/crash-on-mobile

AI로 브랜치 만들기 — 프롬프트 예시

Cursor Agent / Codex CLI 프롬프트
"feature/dark-mode 브랜치 새로 만들고 거기로 이동해줘"
Cursor Agent / Codex CLI 프롬프트
"지금 어떤 브랜치에 있는지 알려줘"
Cursor Agent / Codex CLI 프롬프트
"작업 다 끝났어. main에 merge해줘"

⬆️ AI 프롬프트로 커밋·Push하기

수동 vs AI 비교

같은 작업을 수동과 AI로 비교해봅니다.

🔧 수동 (터미널에서 직접)
git add . git commit -m "다크모드 추가" git push origin main
  • 명령어 3개를 기억해야 함
  • add → commit → push 순서 기억
  • 오타 시 에러
⚡ AI로 (Agent / Codex)
프롬프트
"다크모드 추가한 거 커밋하고 GitHub에 올려줘"
  • 자연어 한 줄
  • 순서는 AI가 판단
  • 실수해도 AI가 수정

Cursor Agent로 Git 작업하기 — 프롬프트 모음

하고 싶은 것 Agent에게 이렇게 말하면
전체 변경 커밋 "지금 수정한 파일들 전부 커밋해줘. 메시지는 '다크모드 추가'"
특정 파일만 커밋 "index.html 파일만 골라서 커밋해줘"
커밋 + 푸쉬 한번에 "커밋하고 바로 GitHub에 올려줘"
현재 상태 확인 "지금 git 상태 어때? 뭐가 바뀌었어?"
최근 커밋 확인 "최근 커밋 5개 보여줘"
브랜치 만들고 작업 "feature/login 브랜치 만들고 거기서 로그인 기능 추가해줘"
변경 취소 (아직 커밋 전) "방금 바꾼 거 되돌려줘. 아직 커밋 안 했어"
Pull Request 안내 "GitHub에 Push 완료됐어. 이제 PR은 어떻게 만들어?"

Codex CLI로 Git 작업하기

# 변경된 파일 커밋 + 푸쉬 codex "변경된 파일들 커밋하고 origin main에 푸쉬해줘" # 현재 상태 확인 codex "git status 보여주고 커밋할 게 있는지 알려줘" # 새 브랜치 만들고 커밋 codex "feature/week-12 브랜치 새로 만들고 현재 작업 커밋해줘" # 커밋 히스토리 codex "지금까지 커밋 내역 정리해서 보여줘"

🔄 전체 워크플로우 — 처음부터 끝까지 AI로

실습 시나리오: Week 10에서 만든 커피 내기 룰렛에 다크모드 추가하기. 브랜치 생성부터 GitHub Push까지 전 과정을 AI 프롬프트로만 진행합니다.

1
브랜치 만들기
Cursor Agent 또는 Codex
"feature/dark-mode 브랜치 새로 만들고 거기로 이동해줘"

AI가 git checkout -b feature/dark-mode를 실행합니다.

2
기능 추가 (Vibe coding)
Cursor Agent 또는 Codex
"coffee-roulette.html에 다크모드 토글 버튼 추가해줘. 배경이 어두워지고 텍스트는 밝아지면 돼"

AI가 파일을 직접 수정합니다. Cursor 에디터에서 변경 내용을 확인합니다.

3
수정 요청 (필요시)
Cursor Agent 또는 Codex
"버튼이 너무 작아. 오른쪽 상단에 크게 배치해줘"

마음에 들 때까지 계속 수정 요청합니다.

4
커밋
Cursor Agent 또는 Codex
"지금 변경사항 커밋해줘. 메시지는 'feat: 다크모드 토글 버튼 추가'"

AI가 git add . → git commit -m "..."을 실행합니다.

5
GitHub에 Push
Cursor Agent 또는 Codex
"GitHub에 올려줘"

AI가 git push origin feature/dark-mode를 실행합니다.

6
Pull Request 만들기 (GitHub 웹에서)

GitHub.com → 내 레포 → "Compare & pull request" 버튼 클릭 → 제목/설명 입력 → Create pull request.
팀원에게 리뷰를 요청하거나, 혼자 작업하면 바로 Merge pull request를 눌러 main에 합칩니다.

7
로컬 main 업데이트 + 브랜치 정리
Cursor Agent 또는 Codex
"main으로 돌아와서 방금 머지된 내용 가져오고, feature/dark-mode 브랜치는 삭제해줘"

AI가 git checkout main → git pull → git branch -d feature/dark-mode를 실행합니다.

전체 흐름 요약: 브랜치 → 코딩 → 커밋 → Push → PR → Merge → 브랜치 삭제. 이 7단계가 전문 개발자들이 매일 하는 Git 워크플로우입니다. 이제 전부 AI에게 말로 시킬 수 있습니다.

❓ 자주 묻는 질문

Q Codex CLI vs Cursor Agent, 뭐가 더 좋아요?
목적이 다릅니다. Cursor Agent는 Cursor 에디터 안에서 파일을 보면서 AI와 대화하는 경험이 자연스럽고, UI가 친숙합니다. Codex CLI는 터미널 기반으로 git 명령이나 자동화에 더 강하고, Cursor 크레딧과 독립적입니다. Cursor 크레딧이 있을 때는 Agent를, 소진됐을 때는 Codex CLI를 쓰거나, Cursor에 OpenAI API Key를 연결해서 계속 Cursor UI를 쓰는 것이 가장 현실적인 조합입니다.
Q OpenAI API 비용이 많이 나오나요?
일반적인 팀 내 학습·프로토타입 사용량 기준으로 월 1~5달러 수준입니다. GPT-4o는 입력 100만 토큰당 약 $2.5, 출력은 $10입니다. 코드 작업 수십 회 정도는 몇 달러 이내입니다. platform.openai.com의 Usage 탭에서 실시간으로 확인할 수 있습니다. 혹시 모를 과금 방지를 위해 월 사용 한도(Usage limits)를 $10~20으로 설정해 두는 것을 권장합니다.
Q 실수로 main에 직접 커밋했어요. 어떻게 하나요?
당황하지 말고 AI에게 물어보세요. "방금 실수로 main에 바로 커밋했어. 되돌릴 수 있어?"라고 하면 상황에 맞는 방법(git revert, git reset 등)을 안내해줍니다. GitHub에 Push하기 전이면 간단히 되돌릴 수 있고, Push 후에도 방법이 있습니다. 단, 협업 중인 레포라면 주의가 필요하므로 AI의 설명을 잘 읽고 진행하세요.
Q Codex가 잘못된 git 명령을 실행하면 어쩌나요?
그래서 처음에는 반드시 suggest 모드(기본값)로 시작해야 합니다. Suggest 모드에서는 모든 명령 실행 전에 사람이 승인해야 합니다. AI가 실행하려는 명령을 보여주면, 이해가 안 되면 "이게 뭐 하는 명령이야?"라고 물어본 다음 승인 여부를 결정하세요. git reset --hard처럼 되돌리기 어려운 명령은 특히 주의해서 확인하세요.
Q 브랜치를 너무 많이 만들면 관리가 힘들지 않나요?
맞습니다. 그래서 기능 개발이 끝나고 main에 Merge한 브랜치는 바로 삭제하는 것이 좋습니다. "완료된 브랜치 삭제해줘"라고 AI에게 시키면 됩니다. GitHub 레포 Settings에서 "Automatically delete head branches" 옵션을 켜두면 PR이 Merge될 때 자동으로 브랜치가 삭제됩니다.

🎓 핵심 요약

오늘 배운 것

주제 핵심
Cursor Agent 모드 파일 수정 + 터미널 명령 실행까지 AI가 직접. git 작업 자동화의 핵심
Codex CLI Cursor 크레딧 소진 시 대안. OpenAI API Key로 동작. 터미널 기반
Cursor + OpenAI API Key Cursor UI 그대로 쓰면서 크레딧 대신 API 과금으로 전환
브랜치 main = 배포 코드(원본 보호). feature 브랜치에서 안전하게 작업 후 Merge
AI로 git 하기 "커밋하고 푸쉬해줘" 한 마디면 add → commit → push 전부 처리

전체 Vibe Coding 워크플로우 완성

브랜치 만들기 → AI에게 코딩 시키기 → 커밋 → Push → PR → Merge

이 다섯 단계가 전부 AI 프롬프트로 가능합니다. Cursor Agent 또는 Codex CLI를 열고, 원하는 것을 말하면 됩니다.

코드를 짜는 것뿐 아니라 Git까지 AI에게 맡기면
비전공자도 전문 개발자와 동일한 워크플로우로 프로젝트를 관리할 수 있습니다.