AI 에이전트와 함께하는 바이브 코딩 — 코드 한 줄부터 1인 SaaS까지
| 항목 | 내용 |
|---|---|
| 저자 | AI_Innovation_Studio |
| 기준 버전 | GPT-5.5 / Codex CLI (2026년 6월) |
| 집필일 | 2026년 6월 20일 |
| 대상 | 코딩 입문자 ~ 실무 개발자 |
| 분량 | 100개 절, 본문 약 19만 자 |
| 구성 | 초급 → 중급 → 고급 → 실전 프로젝트 → 부록 |
| 관통 프로젝트 | AI 할일 SaaS "TaskFlow" |
- "코드는 잘 모르지만 AI로 진짜 앱을 만들어 보고 싶다" — 초급자
- "Codex를 쓰긴 하는데 설정·MCP·스킬을 제대로 활용하고 싶다" — 중급자
- "에이전트 내부 동작을 이해하고 SDK로 직접 확장하고 싶다" — 고급자
세 부류 모두를 한 권으로 이어 줍니다. 터미널을 처음 여는 사람이 1번 절에서 출발해, 마지막에는 Codex의 Rust 코어 동작 원리를 이해하고 SDK로 자신만의 에이전트를 만드는 지점까지 도달하도록 설계했습니다.
- GPT-5.5 최신 기준 — 2026년 6월 현재 가장 강력한 모델을 기준으로 작성했습니다.
- 초급부터 천천히 — 터미널이 처음인 사람도 따라올 수 있게 단계별로 구성했습니다.
- 실습 중심 — 거의 모든 장에 손으로 따라 하는 예제가 있습니다.
[실습]표시가 붙은 절은 직접 결과물을 만듭니다. - 하나의 실전 프로젝트 — AI 할일 SaaS "TaskFlow"를 기획부터 배포·회고까지 처음부터 끝까지 완성합니다.
- 내부까지 — 공식 문서를 넘어 Codex 엔진의 실제 동작 원리(프로토콜·샌드박스·execpolicy·시스템 프롬프트)까지 파고듭니다.
| Part | 절 범위 | 난이도 | 무엇을 얻는가 |
|---|---|---|---|
| Part 0. 시작하기 전에 | 001–004 | — | 집필 의도, 학습법, 관통 프로젝트 소개, 핵심 용어 |
| Part 1. 초급 | 005–030 | 초급 | LLM·모델 라인업 이해, Codex 설치·첫 대화, TUI, 승인·diff, 좋은 프롬프트 3원칙, 첫 실습 결과물 |
| Part 2. 중급 | 031–060 | 중급 | config.toml, AGENTS.md, 샌드박스·승인정책·권한 프로필, MCP, Skills, codex exec 자동화, FastAPI 서버 실습 |
| Part 3. 고급 | 061–085 | 고급 | Rust 아키텍처, SQ/EQ 큐, 세션 수명주기, 컴팩션, apply_patch, execpolicy, 서브에이전트, Hooks, SDK(TS/Python), Cloud |
| Part 4. 실전 프로젝트 | 086–095 | 실전 | TaskFlow를 기획→백엔드→프런트→DB·인증→테스트→배포→출시·회고까지 완성 |
| Part 5. 부록 & 마무리 | 096–100 | 레퍼런스 | 슬래시 커맨드·config.toml·CLI 서브커맨드 전체 레퍼런스, 트러블슈팅 FAQ, 맺음말 |
- 입문자: 001번부터 순서대로. 각 Part 끝의 "마무리 & 체크리스트"로 점검하며 진행하세요.
- 경험자: Part 1을 훑고 바로 Part 2(설정·MCP·Skills)나 Part 3(내부 구조)으로 이동해도 됩니다.
- 실무 적용이 급하면: Part 4(TaskFlow)를 먼저 읽고, 막히는 개념을 Part 2·3에서 역참조하세요.
- 레퍼런스로만 쓰려면: Part 5(096–100)만 북마크해 두세요.
이 책의 모든 실습은 한 방향을 가리킵니다 — 1인 개발자가 AI 에이전트만으로 굴리는 SaaS "TaskFlow"(AI 할일 관리 서비스). Part 4에서 기획·요구사항 정의(AGENTS.md + Goal)부터 백엔드(FastAPI)·프런트엔드·데이터베이스·인증·테스트 자동화·배포(Cloud/CI)·출시·회고까지 한 흐름으로 완성합니다. 앞선 Part에서 익힌 도구가 어디에 쓰이는지 실전에서 확인하게 됩니다.
book/
├─ README.md 이 파일
├─ 000_전체_목차.md 전체 목차
├─ 001_*.md … 100_*.md 본문 100개 절 (파일명 = 절 번호 + 제목)
├─ _GPT_Codex_기초부터_고급까지_100_전체.md 100개 절 합본
├─ TOC.md 위키독스 연동용 목차
├─ templates/ 바로 쓰는 샘플 (AGENTS.md·config.toml·훅)
├─ assets/
│ └─ cover.png 책 표지 (위키독스 연동용 이미지 폴더)
└─ LICENSE
각 절은 독립된 마크다운 파일이며, 파일명 앞 세 자리 숫자가 읽기 순서입니다. 한 파일로 통독하려면 합본(_GPT_Codex_기초부터_고급까지_100_전체.md)을 보세요.
- 터미널을 쓸 수 있는 PC (Mac / Linux / Windows) — 설치는 013번 절에서 안내합니다.
- OpenAI 계정과 Codex 사용 요금제 — 012번 절 참고.
- 선택: VS Code 또는 Cursor (IDE 연동은 057번 절).
사전 프로그래밍 지식은 필요 없습니다. 필요한 개념은 그때그때 본문에서 설명합니다.
전체 목차는 000_전체_목차.md 를 참고하세요.
이 책은 2026년 6월 기준 GPT-5.5와 당시 Codex CLI를 기준으로 작성되었습니다. 모델 라인업·슬래시 커맨드·config 키는 버전에 따라 바뀔 수 있으니, 차이가 보이면 공식 문서(developers.openai.com/codex)와 codex --help를 함께 확인하세요.
- 이메일: leemanrank@gmail.com
- 인공지능 정보공유 단톡방(오픈채팅): https://open.kakao.com/o/s4OEqBai
오탈자·개선 제안은 언제든 환영합니다.
© 2026 AI_Innovation_Studio. 본 교재의 예제 코드는 자유롭게 사용할 수 있습니다. 라이선스 전문은 LICENSE를 참고하세요.
