[Codex] 5편: Codex로 코드 분석하기

← Codex Guide

1편2편3편 4편5편6편7편

5편 · Analysis

Codex로
코드 분석하기

남이 짠 코드, 오픈소스 프로젝트, 또는 내가 오래전에 작성한 코드도 Codex와 함께라면 쉽게 이해할 수 있습니다.

독자 목표  ·  ✅ 남의 코드 읽기

프로젝트 구조 이해하기

처음 보는 프로젝트를 이해해야 할 때, Codex에게 전체 구조를 먼저 파악해 달라고 요청합니다.

"이 프로젝트의 전체 폴더 구조를 보고,
각 폴더와 주요 파일의 역할을 초보자도 이해할 수 있게 설명해줘.
그리고 이 앱이 전체적으로 어떻게 동작하는지 흐름도 설명해줘."

함수 단위 설명 요청

"auth/middleware.js 파일의 verifyJWT 함수가
어떤 역할을 하는지, 입력/출력은 무엇인지,
어떤 상황에서 에러를 던지는지 설명해줘."

코드 흐름 파악

사용자가 버튼을 클릭했을 때 어떤 일이 벌어지는지, 데이터가 어떻게 흘러가는지 물어볼 수 있습니다.

"사용자가 '주문하기' 버튼을 눌렀을 때부터
주문 완료 화면이 뜰 때까지 코드 흐름을
파일명과 함수명을 포함해서 단계별로 설명해줘."

문서 자동 생성

Codex는 코드를 읽고 README나 API 문서를 자동으로 작성할 수 있습니다.

"api/routes 폴더의 모든 엔드포인트를 분석해서
Markdown 형식의 API 문서를 만들어줘.
각 엔드포인트의 URL, HTTP 메서드, 파라미터, 응답 예시를 포함해줘."

💡 CLI 사용 팁
Codex CLI는 실제 파일을 직접 읽기 때문에 "이 파일을 분석해줘"라고 하면 파일 내용을 직접 읽고 답합니다. 웹에서는 코드를 직접 붙여넣기 해야 합니다.

✅이 편의 목표: 처음 보는 코드도 Codex와 함께 구조와 흐름을 파악할 수 있게 됐습니다.

← 이전 편Codex로 첫 프로그램 만들기 다음 편 →Codex로 버그 찾고 수정하기

AI 초보자를 위한 OpenAI Codex 사용법

5편 / 7편 · 정보 기준: 2026년 6월