Codex를 챗봇처럼 쓰지 않습니다 — 오늘 AGENTS.md 네 섹션부터 적으십시오 | DAKER 커뮤니티

Codex CLI AGENTS.md 설명용 생성 이미지

설명용 생성 이미지입니다.

해커톤·개인 레포에서 Codex CLI를 열면, 많은 분이 터미널에 버그를 고치라는 한 줄만 넣고 부분 답변을 기다립니다. TechWhistle의 Codex CLI: 5 Tips Power Users Actually Use (2026) 영상은 그 방식이 Codex를 1단 기어로만 쓰는 것과 같다고 말합니다. Codex CLI는 터미널 자동완성이 아니라, 파일 시스템을 읽고 명령을 실행하며 코드를 고치고 하위 에이전트까지 띄울 수 있는 로컬 코딩 에이전트입니다.

오늘 글은 영상에서 검증한 다섯 가지 실전 팁을 정리합니다. 핵심은 하나입니다. 세션마다 프로젝트를 다시 설명하지 않도록, AGENTS.md를 먼저 남기는 것입니다. 그다음 /plan, 숨은 단축키, Git worktree 병렬, 세션 안 모델 전환 순으로 이어집니다. 숫자는 영상이 말한 범위만 따르고, 출처 없는 수치는 넣지 않습니다.

Codex CLI가 아닌 것, 맞는 것

영상에 따르면 Codex CLI는 터미널 안의 ChatGPT가 아닙니다. 로컬 에이전트로서 코드베이스를 탐색한 뒤 작업을 진행합니다. 공식 Codex 문서 기준으로 영상에서 소개한 동작 모드는 세 가지입니다.

일상 작업에는 Auto가 맞다고 영상은 말합니다. Full auto는 Codex의 판단을 이미 검증한 저장소용이고, Suggest는 위험을 낮춘 두 번째 의견용입니다. 모델도 중요합니다. 영상은 OpenAI 모델 페이지를 인용해 복잡한 코딩·계획에는 GPT-5.5를, 단순·반복 작업에는 더 빠르고 저렴한 GPT-5.4 Mini를 권합니다. 세션 도중에는 /model로 바꿀 수 있습니다.

1. AGENTS.md — 세션이 바뀌어도 규칙이 남습니다

대부분의 세션에서 Codex는 처음부터 시작합니다. 아키텍처 결정, 네이밍, 싫어하는 패턴을 모릅니다. 그래서 합리적이지만 원하는 것과 다른 추측을 합니다. 영상은 OpenAI 공식 문서를 인용해, Codex가 세션에서 일하기 전에 agents.md를 읽는다고 설명합니다. 한 번 써 두면 이후 세션에 계속 적용되는 온보딩 문서입니다.

효과적인 AGENTS.md는 영상 기준으로 네 섹션입니다.

  1. 기술 스택: 쓰는 프레임워크·라이브러리를 정확히 적습니다.
  2. 아키텍처 결정: 예) 리포지토리 패턴을 쓰고, DB 직접 호출로 우회하지 말 것.
  3. 컨벤션: 네이밍, 파일 구조, import 순서.
  4. 하지 말 것: 예) console.log 추가 금지, 설정 파일은 묻기 전에 수정 금지, 새 기능에는 테스트 작성.

공식 모범 사례 가이드를 인용한 영상 설명에 따르면, 전역 AGENTS.md와 프로젝트별 파일을 겹쳐 두면 여러 저장소에서 행동이 일정해집니다. 전역에는 스택 선호·코드 스타일·일반 원칙을, 저장소마다 프로젝트 규칙을 둡니다.

오늘 할 일: 지금 쓰는 해커톤·사이드 레포 루트에 AGENTS.md(또는 문서가 안내하는 agents.md)를 만들고, 위 네 섹션을 각각 3~5줄만 채우십시오. 완벽한 문서보다, 세션마다 반복해 말하던 한 줄을 파일로 옮기는 것이 목표입니다.

2. /plan first — 애매하면 경로를 먼저 고칩니다

연사가 두 달간 한 실수는, 복잡한 작업을 바로 돌린 뒤 절반은 맞고 절반은 다른 결정을 사후에 발견하는 것이었습니다. 해결은 슬래시 명령 /plan입니다. 뻔하지 않은 작업에서는 먼저 /plan을 실행합니다. Codex가 바꿀 파일, 접근 방식, 이유를 스레드에 적습니다. 사용자는 계획을 검토·수정한 뒤 실행합니다. 영상은 스레드에서 계획을 직접 고칠 수 있어, 실행 전에 방향을 정할 수 있다고 강조합니다.

명확한 작업(예: 47번 줄 오타 수정)은 계획을 건너뛰어도 됩니다. 애매한 작업(예: OAuth를 지원하도록 인증 모듈 리팩터)은 항상 plan first입니다. 영상은 Codex 모범 사례 가이드를 인용해, 애매한 작업에 plan을 기본값으로 두는 사람이 더 많이 배포한다고 말합니다. 연사 주장으로는 계획 패스만으로 수정 사이클이 절반으로 줄어든다고 하나, 이는 영상 발언이며 별도 측정 자료는 이 글에서 확인하지 않았습니다.

오늘 할 일: 지금 머릿속에 있는 애매한 작업 하나에 /plan을 먼저 돌리고, 스레드에서 파일 목록이 맞는지 확인한 뒤에만 실행하십시오.

3. 숨은 단축키 — 기다리는 대화를 실시간 안내로

영상은 공식 Codex CLI 기능 페이지에 이미 있는 단축키 세 가지를 소개합니다. 시니어 개발자 세 명에게 보여 줬을 때 아무도 몰랐다고 말합니다.

이 셋이 합쳐지면 턴제 대화가 아니라, 동작 중인 에이전트를 실시간으로 안내하는 세션에 가깝습니다.

오늘 할 일: 다음 Codex 세션에서 긴 경로를 타이핑하지 말고 @로 파일을 고르고, 잘못된 방향으로 가면 Enter로 한 줄만 정정하십시오.

4. Git worktree와 /subagent — 독립 작업만 병렬로

영상 오프닝은 미팅 중에 세 개의 Git worktree에서 Codex가 각각 테스트·버그·문서를 돌리는 장면입니다. worktree는 같은 저장소에서 여러 브랜치를 서로 다른 디렉터리에 동시에 체크아웃합니다. 디렉터리마다 Codex 세션을 두면 서로 막지 않고 격리된 채 병렬로 일합니다.

영상은 ovox.ai의 실전 Codex CLI 가이드를 인용해, 3~4개 worktree가 적정이라고 말합니다. 하나는 현재 기능, 하나는 테스트 커버리지, 하나는 문서처럼 나눕니다. 세션 안에서는 /subagent로 하위 에이전트를 띄워 패턴 조사·코드베이스 탐색을 병렬로 맡길 수 있습니다. 공식 서브에이전트 문서를 인용한 설명에 따르면 Codex가 생성·대기·결과 취합을 오케스트레이션합니다.

솔직한 주의도 있습니다. 브랜치가 크게 갈라지면 머지가 어려워집니다. 상태가 겹치지 않는 독립 작업에만 병렬을 쓰라고 영상은 말합니다.

오늘 할 일: 현재 작업과 겹치지 않는 문서·테스트 중 하나를 골라 worktree 디렉터리 하나를 만들고, 그 안에서만 Codex를 돌리십시오. 공유 상태 작업은 병렬로 두지 마십시오.

5. /model과 skills — 루틴은 Mini, 설계는 5.5

모든 작업에 GPT-5.5가 필요하지는 않습니다. 파일 요약, 문서 생성, 테스트 스캐폴딩 같은 루틴은 GPT-5.4 Mini가 더 빠르고 저렴하다고 영상은 말합니다. 파워 유저 패턴은 루틴은 Mini, 아키텍처 결정은 5.5입니다. 세션을 나가지 않고 /model로 바꿉니다.

두 번째는 skills입니다. /skills 또는 $로 접근합니다. skills는 필요할 때 적용하는 재사용 가능한 작업 파일입니다. 영상은 커뮤니티의 Compozio HQ awesome Codex skills 저장소를 언급하며, 커밋 메시지·PR 리뷰·테스트 커버리지 분석 등 필수 스킬이 있다고 소개합니다. 직접 skill.md를 쓰면 Codex가 자동으로 불러와 적용합니다.

오늘 할 일: 문서·요약 작업 하나에서 /model로 Mini로 바꾼 뒤 실행하고, 설계 질문으로 돌아갈 때만 5.5로 되돌리십시오.

해커톤 참가자에게 바로 쓰는 하루 루틴

영상 마무리를 참가 일정에 맞춰 짧게 옮기면 다음과 같습니다. 아침에 worktree를 준비하고, AGENTS.md는 이미 써 둡니다. 복잡한 기능에는 /plan, 분명한 버그는 바로 실행합니다. @로 파일을 집고, Tab으로 다음 지시를 넣습니다. 문서는 Mini, 구조 결정은 GPT-5.5입니다. 이렇게 하면 세션마다 “우리 프로젝트는 이렇게 한다”를 반복 설명할 필요가 줄어듭니다.

영상도 분명히 말합니다. 이 워크플로는 어려운 문제를 없애지 않습니다. 아키텍처와 코드 리뷰 판단은 사람 몫입니다. 대신 주의를 잡아먹는 낮은 가치 반복을 줄입니다.

오늘 한 가지 액션

다섯 팁을 하루에 다 하지 않아도 됩니다. 지금 레포에 AGENTS.md 네 섹션 초안을 20분 안에 적으십시오. 기술 스택, 아키텍처에서 지키려는 한 줄, 네이밍 규칙, 하지 말 것 세 줄이면 충분합니다. 그다음 Codex 세션을 새로 열어, 같은 설명을 다시 타이핑하지 않는지 확인하십시오. 애매한 작업이 있으면 그 세션에서 /plan을 한 번만 추가하십시오.

이 영상이 말하는 것과 말하지 않는 것

이 글은 TechWhistle 영상의 다섯 팁을 해커톤·사이드 프로젝트 참가자가 같은 날 적용할 수 있게 옮긴 요약입니다. 영상이 말하는 것은 Codex CLI를 로컬 에이전트로 다루는 운영 습관입니다. 영상이 말하지 않는 것은 DAKER·DACON 플랫폼 점수, 특정 대회 순위, 모델 벤치마크 수치입니다. 그런 숫자는 넣지 않았습니다.

모델 이름(GPT-5.5, GPT-5.4 Mini)과 모드 이름(Auto, Full auto, Suggest)은 영상 시점의 설명입니다. 제품 UI·권장 모델은 바뀔 수 있으므로, 실제 터미널에서 /model 목록과 공식 문서를 한 번 더 확인하는 것이 안전합니다. 영상에서 언급한 ovox.ai 가이드·Compozio HQ skills 저장소·공식 서브에이전트 문서도 같은 이유로, 링크가 자막에 완전히 나오지 않은 항목은 원문 YouTube를 1차 출처로 둡니다.

Claude Code의 CLAUDE.md와 Codex의 AGENTS.md는 비슷한 목적(프로젝트 기억을 파일로 남김)을 갖지만, 도구·파일명·명령이 다릅니다. 이 글은 Codex CLI 영상만 다룹니다. Claude Code 규칙을 그대로 복사하지 마십시오.

출처

본문은 위 영상 자막·설명을 기준으로 정리했으며, 영상에서 언급한 공식 문서·외부 가이드의 구체 URL은 자막에 모두 나오지 않아 여기서는 원문 링크로 갈음합니다. 운영·모델 권장값은 시간이 지나면 바뀔 수 있으니, 실제 적용 전 최신 Codex 문서와 모델 페이지를 확인하십시오.

본문 상단 이미지는 설명용 생성 이미지입니다.