코덱스 사용법으로 1주일 만에 MVP를 만들기 위한 준비는 무엇인가요?

코덱스 사용법의 첫 단계는 설치와 로그인부터 시작하나요?

코덱스 사용법은 ChatGPT 계정으로 로그인하고 데스크톱 앱이나 CLI를 설치하는 것부터 시작합니다. OpenAI가 제공하는 7개 요금제에 모두 포함되어 있어 별도 결제 없이 바로 이용할 수 있어요. 처음이라면 설치가 간단한 데스크톱 앱을 추천합니다.

데스크톱 앱으로 시작하는 단계

ChatGPT 데스크톱 앱을 열고 계정으로 로그인한 뒤, 작업할 폴더를 선택합니다. 드롭다운 메뉴에서 Codex를 골라 첫 요청을 보내면 됩니다. macOS·Windows·Linux 모두 지원하며, 별도 명령어 입력 없이 폴더만 열어 바로 쓸 수 있어 초보자에게 가장 편합니다.

CLI 설치와 로그인 방법

터미널이 익숙하다면 npm이나 Homebrew로 Codex CLI를 설치합니다. 설치 후 codex 명령을 실행하고 “Sign in with ChatGPT”를 선택해 로그인하면 됩니다. Windows는 PowerShell에서 winget으로 설치하고, 프로젝트 폴더 안에서 실행해야 작업 범위가 정확히 잡힙니다.

처음 코덱스를 쓸 때는 중요한 프로젝트 대신 연습용 폴더를 열고 “Tell me about this project”라고 보내는 게 안전합니다.

AGENTS.md와 config.toml 설정으로 매번 같은 품질을 유지할 수 있나요?

AGENTS.md와 config.toml을 한 번 제대로 설정해 두면 코덱스가 세션마다 같은 규칙과 권한으로 작업을 수행합니다. AGENTS.md는 코덱스가 작업 전에 읽는 마크다운 지침 파일입니다. 전역 파일에는 모든 프로젝트에 공통인 습관을, 저장소 루트에는 프로젝트만의 규칙을 적습니다.

코덱스는 전역 파일부터 시작해 저장소 루트까지 내려가며 파일을 읽고, 현재 폴더에 가까운 내용이 우선 적용됩니다. 합친 크기는 32KiB까지 읽으므로 자주 틀리는 규칙 위주로 짧게 쓰는 편이 좋습니다.

AGENTS.md에 담을 내용

• 프로젝트 한 줄 소개와 주요 폴더 구조
• 빌드·테스트·린트 명령과 완료 기준
• 코드 스타일과 커밋 메시지 규칙
• 건드리면 안 되는 파일과 사람에게 먼저 물어야 하는 작업

config.toml 권한 설정

config.toml은 모델 선택과 승인·샌드박스 범위를 정합니다. 사용자 설정은 ~/.codex/config.toml에, 저장소별 설정은 .codex/config.toml에 둡니다. 처음에는 approval_policy를 on-request로, sandbox_mode를 workspace-write로 시작하는 것이 안전합니다. 작업 폴더 밖 변경을 막고 익숙해진 뒤 범위를 넓혀도 됩니다.

AGENTS.md와 config.toml을 함께 두면 코덱스가 매번 같은 품질의 결과를 내는 가장 간단한 방법입니다.

스킬·MCP·record and replay로 복잡한 작업까지 자동화할 수 있나요?

스킬과 MCP, record and replay를 쓰면 AGENTS.md를 가볍게 유지하면서도 복잡한 작업을 자동화할 수 있습니다.

스킬로 반복 절차를 재사용하기

스킬은 .agents/skills/이름/SKILL.md에 이름과 설명, 절차를 적어 둡니다. 코덱스는 평소 이름과 설명만 보고 있다가 필요할 때 본문을 불러옵니다. CLI에서 /skills로 목록을 확인하고 $스킬이름으로 직접 호출할 수 있어요.

MCP로 외부 서비스 연결하기

MCP는 config.toml에 [mcp_servers.이름]를 추가하거나 codex mcp add 명령으로 등록합니다. 외부 서비스 권한은 계정 수준에서 관리되므로 공식 배포 서버만 사용하고 토큰은 환경변수로 넘기는 것이 안전합니다.

record and replay로 워크플로우 정의하기

복잡한 절차는 record and replay로 녹화한 뒤 스킬로 변환하면 AGENTS.md에 매번 적지 않아도 됩니다. 화면 조작이 고정된 작업이라면 이 방식으로 자동화 범위를 넓힐 수 있어요.

코덱스 사용법으로 1주일 만에 MVP를 만들기 위한 준비는 무엇인가요?

코덱스 사용법으로 MVP를 만들려면 ChatGPT 계정으로 로그인한 뒤 AGENTS.md와 config.toml을 먼저 갖추고, 필요한 스킬을 최소한으로 준비하는 순서가 핵심입니다. 이 준비가 되어 있어야 코덱스가 프로젝트 규칙을 반복해서 물어보지 않고, 승인 절차도 줄어들어 실제 작업에 집중할 수 있습니다.

로그인과 기본 실행 환경

ChatGPT 계정 하나로 데스크톱 앱이나 CLI에서 바로 시작할 수 있습니다. 처음에는 데스크톱 앱을 열어 폴더를 지정하고 Codex를 선택하는 것만으로 충분합니다. 이 단계에서 API 키 대신 계정 로그인을 선택하면 요금제에 포함된 사용량을 그대로 쓸 수 있습니다.

최소한의 지침과 권한 설정

AGENTS.md에는 프로젝트 한 줄 소개, 빌드·테스트 명령, 완료 기준 정도만 적으면 됩니다. config.toml에서는 approval_policy를 on-request로, sandbox_mode를 workspace-write로 시작하는 조합이 안전합니다. 이 두 파일만 있어도 코덱스가 세션마다 같은 품질로 동작합니다.

설치와 로그인, AGENTS.md·config.toml 세팅, 최소 스킬 준비까지 마치면 간단한 MVP 제작을 위한 기반이 완성됩니다.

이제 기본 세팅이 끝났으니 실제로 작은 프로젝트부터 맡겨보는 게 가장 빠른 학습 방법입니다. 처음엔 간단한 작업으로 시작해서 점차 복잡한 부분까지 넓혀 가면 돼요. 설정이 잘 잡히면 이후 작업이 훨씬 가벼워질 거예요.

자주 묻는 질문

코덱스 로그인 시 ChatGPT 계정과 API 키 중 어떤 방식을 추천하나요?

ChatGPT 계정 로그인을 추천합니다. API 키로 로그인하면 요금제에 포함된 사용량 대신 표준 API 요금으로 별도 과금되기 때문입니다. 처음이라면 ChatGPT 계정으로 로그인하는 편이 안전하고, 데스크톱 앱이나 CLI에서 바로 시작할 수 있습니다.

AGENTS.md 파일은 전역과 저장소 루트 중 어디에 두고 어떤 내용을 넣어야 하나요?

전역 파일은 ~/.codex/AGENTS.md에, 프로젝트별 규칙은 저장소 루트에 둡니다. 전역에는 모든 프로젝트에 공통인 습관을, 저장소 루트에는 프로젝트 소개, 빌드·테스트 명령, 코드 스타일, 금지 파일 같은 내용을 넣으면 됩니다. 코덱스는 전역부터 저장소까지 순서대로 읽어 합치므로 현재 폴더에 가까운 내용이 우선 적용됩니다.

config.toml에서 approval_policy와 sandbox_mode는 처음에 어떻게 설정하는 게 안전한가요?

처음에는 approval_policy를 on-request로, sandbox_mode를 workspace-write로 설정하는 게 안전합니다. on-request는 코덱스가 필요하다고 판단할 때만 승인을 묻고, workspace-write는 작업 폴더 안의 쓰기만 허용하기 때문입니다. 익숙해진 뒤 범위를 넓히는 방식이 권장됩니다.

Claude Code를 쓰고 있는데 Codex로 마이그레이션하거나 함께 쓰는 방법이 있나요?

AGENTS.md 하나를 원본으로 두고 Claude Code가 그 파일을 읽게 하면 됩니다. CLAUDE.md에 @AGENTS.md 한 줄을 적거나 심볼릭 링크로 연결하면 되고, 스킬 폴더도 한 곳을 원본으로 두고 링크로 공유할 수 있습니다. Codex는 .claude 폴더가 있으면 import해서 설정을 가져올 수도 있고, Claude Code 안에서 Codex 플러그인을 설치해 호출하는 방법도 있습니다.

참고 자료

• 코덱스(Codex) 사용법 | AGENTS.md·config.toml 세팅 | 다글로daglo.ai
• 코덱스 사용법 2026: 처음 쓰는 비개발자를 위한 앱 설치·로그인qjc.app
• OpenAI에서 직접 알려주는 Codex 사용법tech.channel.io