← 목차Part 0 · 코덱스 입문·온보딩·0-1-1 · 10분
이 클립 · 3계층·5대패러다임

코덱스란 무엇인가 — 비개발자 눈으로 본 앱·CLI·클라우드 3계층

학습목표 / 사전지식: 이 레슨을 마치면 코덱스를 채팅창 하나가 아니라 App·CLI·클라우드로 나눠 보는 입구 지도를 갖게 된다. 선수지식은 없어도 되고, 오늘은 App에서 여러 작업을 맡기며 CLI와 역할을 구분하는 감각만 잡는다. [OF-01, KO-21]

1. 왜 필요한가 — 개념·배경을 초보자 눈높이로

코덱스를 처음 보면 “질문을 입력하면 답이 나오는 도구”처럼 보인다. 그런데 Codex 앱은 macOS용으로 2026년 1월 30일 공개됐고, 여러 에이전트를 동시에 관리하는 강력한 새 인터페이스로 소개됐다. [OF-01]

에이전트란 한 문장으로 “내가 맡긴 일을 스스로 이어서 처리하는 작업 담당자”다. App은 그런 담당자를 하나씩 줄 세우는 곳이라기보다, 여러 담당자가 지금 어디까지 왔는지 보는 관제탑에 가깝다. [OF-01]

이 관점이 비개발자에게 왜 중요한지는 숫자에서도 드러난다. Codex는 주간 500만 명 넘게 쓰고, 그중 비개발자가 약 20%이며, 비개발자 사용자는 개발자보다 3배 넘게 빠르게 성장한다고 공개됐다. [OF-04]

CLI는 “Command Line Interface”의 줄임말로, 마우스 대신 글자 명령으로 세밀하게 조정하는 작업대라고 보면 된다. App이 병렬 관리에 강하다면 CLI는 슬래시 커맨드와 Skills를 통한 세밀한 제어에 강하므로, 둘은 선택지가 아니라 상황별 역할 분담이다. [KO-21] 클라우드는 이 레슨에서 세 번째 층으로만 표시한다. 오늘 확실히 외울 기준은 “App은 병렬, CLI는 세밀한 제어”이고, 클라우드의 세부 역할은 뒤 레슨에서 따로 다룬다. [KO-21]

2. 준비 — 코덱스 어디로 들어가 무엇을 누르나

시작은 App 화면이다. 이 레슨의 촬영과 실습에서는 왼쪽의 작업 목록, 가운데의 대화 또는 결과 영역, 아래쪽의 입력 영역을 차례로 찾으며 화면을 읽는다.

처음 할 일은 큰 기능을 외우는 게 아니라 “작업 하나를 열고, 결과를 기다리는 동안 다른 작업을 하나 더 여는 흐름”을 몸에 익히는 것이다. App은 여러 에이전트를 동시에 관리하는 인터페이스로 소개됐으니, 첫인상도 채팅창보다 작업판에 가깝게 잡는 편이 좋다. [OF-01]

비개발자는 App에서 방향을 잡고, 반복 규칙이나 정밀한 통제가 필요해질 때 CLI로 내려간다고 보면 된다. App은 병렬 관리, CLI는 슬래시 커맨드와 Skills 기반의 세밀 제어라는 역할 구분이 제시돼 있다. [KO-21]

3. 따라하기 — 단계별로 아주 세세하게

1단계. App을 열고 새 작업을 시작한다. 입력창에는 “이 폴더의 README를 읽고, 비개발자가 이해할 수 있게 세 문단으로 요약해줘”라고 넣는다.

화면에서는 작업이 만들어지고, 요청 문장이 대화 영역에 남는다. 여기서 중요한 점은 “내가 먼저 코드를 이해한 뒤 질문한다”가 아니라 “코덱스에게 먼저 읽고 설명하게 한다”는 순서다.

2단계. 첫 작업이 끝나기 전에 두 번째 작업을 연다. 이번에는 “설치 방법만 따로 뽑아서 체크리스트로 정리해줘”라고 입력한다.

이 장면이 App의 핵심이다. Codex 앱은 여러 에이전트를 한 번에 관리하는 인터페이스로 소개됐고, App의 역할은 병렬 관리로 정리된다. [OF-01, KO-21]

3단계. 두 작업을 번갈아 눌러 결과를 비교한다. 첫 작업은 전체 설명에 가깝고 두 번째 작업은 실행 순서에 가까운 결과가 나오도록 요청했으니, 같은 자료라도 목적에 따라 결과물이 달라진다는 점을 확인한다.

4단계. 3계층 지도를 말로 정리한다. App은 여러 작업을 펼쳐 놓고 보는 관제탑, CLI는 슬래시 커맨드와 Skills로 더 세밀하게 다루는 작업대, 클라우드는 오늘은 이름만 표시하는 세 번째 층이라고 말한다. [KO-21]

5단계. 비개발자 진입점을 표시한다. 처음에는 App에서 작게 맡기고, 방식이 반복되면 Skills로 고정할 후보를 적고, 세밀한 제어가 필요할 때 CLI를 쓴다고 메모한다. [KO-21]

4. 복붙 템플릿 — 그대로 쓰는 프롬프트/Skills + 해설

첫 번째 템플릿은 “무엇인지 모르겠는 폴더”를 설명받을 때 쓴다.

현재 폴더를 먼저 읽고, 비개발자인 내가 이해할 수 있게 프로젝트 목적, 실행 방법, 주의할 점을 각각 3문장 이내로 정리해줘. 모르는 내용은 추측하지 말고 “확인 필요”라고 표시해줘.

“현재 폴더를 먼저 읽고”는 작업 범위를 좁히는 말이고, “비개발자인 내가 이해할 수 있게”는 설명의 눈높이를 지정하며, “확인 필요”는 모르는 내용을 그럴듯하게 채우지 말라는 안전장치다.

두 번째 템플릿은 App의 병렬 감각을 연습할 때 쓴다.

같은 폴더를 기준으로, 내가 오늘 바로 할 수 있는 작업 5개를 체크리스트로 만들어줘. 각 항목은 20분 안에 끝낼 수 있는 크기로 쪼개줘.

이 템플릿은 결과를 “행동 목록”으로 바꾼다. App에서 첫 번째 작업은 이해용, 두 번째 작업은 실행용으로 나누면 병렬 관리의 장점을 체감하기 쉽다. [OF-01, KO-21]

Skills로 고정할 문장은 짧게 시작한다. “비개발자에게 설명하듯 말하기”, “작업 순서를 체크리스트로 만들기”, “추측하지 말고 확인 필요라고 쓰기” 정도면 충분하다. Skills는 CLI에서 세밀한 제어와 함께 다루는 축으로 설명되므로, 반복되는 말투와 출력 형식을 Skills 후보로 모아 두면 나중에 CLI에서 같은 규칙을 다시 쓰기 쉽다. [KO-21]

5. 응용·함정 — 변형, 자주 막히는 곳과 해결

첫 번째 함정은 App을 답변창 하나로만 쓰는 것이다. App은 여러 에이전트를 동시에 관리하는 인터페이스로 소개됐고, 핵심 역할도 병렬 관리로 정리된다. [OF-01, KO-21] 해결법은 간단하다. “요약해줘” 하나만 열지 말고 “위험한 부분 찾아줘”, “오늘 할 일로 쪼개줘”, “비개발자용 용어집 만들어줘”처럼 목적이 다른 작업을 따로 열어 비교한다.

두 번째 함정은 CLI를 무작정 어렵게만 보는 것이다. CLI는 슬래시 커맨드와 Skills로 세밀하게 제어하는 층이고, App과 CLI는 선택이 아니라 역할 분담이다. [KO-21] 이때는 App에서 먼저 성공한 요청 중 반복할 만한 문장만 Skills 후보로 적어 두고, 나중에 CLI를 배울 때 “내가 이미 자주 쓰던 방식”으로 연결하면 된다. [KO-21]

세 번째 함정은 처음부터 너무 큰 일을 맡기는 것이다. 이 레슨에서는 큰 요청을 이해용, 실행용, 검토용으로 나누어 App에 병렬로 맡기는 방식을 권한다. [OF-01, KO-21]

6. 정리·체크리스트

오늘의 한 줄은 “App은 관제탑, CLI는 작업대, 클라우드는 뒤에서 따로 확인할 세 번째 층”이다. 확인된 핵심 기준은 App은 병렬 관리, CLI는 슬래시 커맨드와 Skills를 통한 세밀 제어라는 역할 분담이다. [KO-21]

마지막으로 숫자 감각을 붙여 두자. Codex는 주간 500만 명 넘게 쓰고, 비개발자가 약 20%이며, 비개발자 사용자는 개발자보다 3배 넘게 빠르게 성장한다고 공개됐다. [OF-04]

출처

본문의 [...] 표기는 아래 근거에서 확인할 수 있습니다.

← 에이전트를 잘 굴리는 기초 — 컨텍스트 엔지코덱스 vs ChatGPT — 생각 정리는 →
코덱스 100가지 스킬스 활용 바이블 · 0-1-1 · 근거 기반 교재 · 2026-06 기준