ChatGPT Codex 사용법｜Work와 Codex 차이·로컬 프로젝트 연결

많은 분들이 ChatGPT 데스크톱 앱을 설치한 후, ChatGPT와 Codex 모드가 왜 따로 있는지 헷갈립니다. 또한, 막상 ChatGPT를 선택하면, 이렇다 할 설명없이 다시 채팅과 Work 모드가 나와서 저 역시 처음에 뭐가 뭔지 정말 헷갈리더라구요. 아마 ChatGPT Codex 사용법을 검색해 이 글에 오신 분도 비슷하실 겁니다.

그런데 작업을 직접 시켜 보니 차이가 의외로 간단했습니다.

이 글에서는 ChatGPT와 Codex 차이와 ChatGPT 채팅 모드와 Work 모드 차이, 그리고 이 들 중 실제로 어떤 순간에 무엇을 선택해야하는지 알아보겠습니다.

프로젝트 연결 단계에서 막혔다면 “이 프로젝트를 로컬 채팅에 사용할 수 없습니다” 점검 순서부터 확인하세요.

챗GPT 채팅 vs. Work 차이: 제가 가장 헷갈렸던 건 선택 화면이 두 번 나온다는 점이었습니다

처음에는 챗GPT 채팅, Work, Codex가 모두 같은 단계의 선택지인 줄 알았습니다. 실제 구조는 아래처럼 두 단계로 나뉩니다.

ChatGPT 데스크톱 앱
├── ChatGPT
│   ├── 채팅
│   └── Work
└── Codex

첫 번째는 ChatGPT와 Codex 중 무엇을 사용할지 고르는 단계입니다.

ChatGPT를 선택하면 두 번째로 채팅과 Work 중 어떤 방식으로 진행할지 고르게 됩니다. 따라서 ‘ChatGPT와 Codex의 차이’와 ‘채팅과 Work의 차이’는 따로 생각해야 합니다.

여기서 한 가지는 정확히 알아두시면 좋습니다. 데스크톱 앱에서도 ChatGPT 채팅을 사용할 수 있습니다. 간단한 질문이나 대화가 필요하면 ChatGPT를 선택한 뒤 채팅으로 전환하면 되고, Codex 화면에서도 빠른 채팅을 열 수 있습니다.

다만 저처럼 로컬 폴더의 자료를 이용해 조사하고, 그 결과를 실제 파일이나 사이트에 반영하려는 사용자라면 주된 선택은 자연스럽게 Work와 Codex로 좁혀집니다. 단순 채팅과 로컬 파일 작업은 필요한 문맥과 도구가 다르므로, 선택한 프로젝트와 실행 방식을 함께 확인하는 것이 좋습니다.

ChatGPT Codex 사용법 30초 결론: 무엇을 선택해야 하나

• 간단한 질문·아이디어 정리 → ChatGPT 채팅: 빠른 대화와 탐색
• 웹 조사·자료 비교·보고서 작성 → ChatGPT Work: 여러 단계의 지식 작업
• 문서·슬라이드·스프레드시트 제작 → ChatGPT Work: 완성된 업무 결과물 중심
• 코드 수정·Git 작업·테스트 → Codex: 코드베이스와 개발 도구 중심
• 로컬 파일 수정·명령 실행 → Codex: 파일·명령·검증 흐름
• 조사 후 사이트나 코드에 적용 → Work → Codex: 조사와 실행을 나누는 혼합 흐름

OpenAI의 빠른 시작도 채팅은 질문과 아이디어 탐색, Work는 조사·분석과 문서·프레젠테이션·스프레드시트 같은 완성된 결과물, Codex는 코드베이스와 개발 도구를 이용한 소프트웨어 작업에 권장합니다. 다만 이는 절대적인 기능 제한이 아니라 좋은 출발점입니다.

ChatGPT Work와 Codex 차이: 채팅까지 한 번에 비교

ChatGPT 채팅은 짧은 질문을 하거나 아이디어를 정리할 때 사용합니다. “이 문장을 쉽게 바꿔 줘”, “이 두 가지 중 어느 쪽이 나을까?”처럼 대화를 주고받으며 방향을 잡는 데 잘 맞습니다. 아직 결과물의 형태가 정해지지 않았다면 저도 채팅부터 시작합니다.

ChatGPT Work는 조사와 분석을 여러 단계로 진행하고, 그 내용을 글·문서·슬라이드·스프레드시트처럼 확인할 수 있는 결과물로 만들 때 사용합니다. 여기서 Work는 회사의 ‘워크스페이스’가 아니라 ChatGPT 안에서 고르는 작업 방식입니다.

Codex는 폴더 안의 파일을 읽고 수정하거나 필요한 명령을 실행하고, 변경 결과까지 확인해야 할 때 사용합니다. 꼭 개발자만 쓸 필요는 없습니다. 저처럼 WordPress 사이트를 운영하거나 여러 파일을 정리하고 자동화 작업을 점검하는 사람에게도 유용합니다.

그래서 만약 혼합해서 사용할 경우, 중요한 내용은 대화에만 남겨 두지 않고 파일로 기록해서 전달하는 것이 좋습니다.

이 프로젝트를 로컬 채팅에 사용할 수 없습니다 — 원인과 점검 순서

프로젝트를 선택하거나 기존 ChatGPT 대화를 로컬 작업으로 이어가려는데 “이 프로젝트를 로컬 채팅에 사용할 수 없습니다”가 나타났나요? 이 문구만으로 프로젝트가 삭제됐거나 Codex를 쓸 수 없다고 판단할 필요는 없습니다.

확인된 범위: 2026년 9월 9일 설치된 데스크톱 앱 26.901.51231의 오류 처리 코드를 확인한 결과, 이 알림은 ChatGPT 프로젝트 컨텍스트를 로컬 작업용으로 동기화하지 못했을 때 표시됩니다. 프로젝트 조회, 파일 다운로드 링크 발급·다운로드, 로컬 파일 저장, 로컬 프로젝트 등록 등 여러 단계의 실패가 같은 문구로 표시될 수 있습니다. 특정 사용자의 원인은 오류 로그 없이 단정할 수 없습니다.

1. 프로젝트 접근 확인: 같은 계정으로 ChatGPT에서 원래 프로젝트를 열고 필요한 파일을 확인합니다. 프로젝트 자체가 열리지 않는다면 계정·워크스페이스·공유 권한부터 확인하세요. 이는 원인을 좁히기 위한 점검이지 모든 경우에 해당하는 원인은 아닙니다.
2. 원본 파일 다운로드 확인: 필요한 프로젝트 파일이 정상적으로 내려받아지는지 확인합니다. 다운로드가 실패하면 네트워크와 해당 파일 접근 상태를 먼저 점검하세요. 일부 파일만 동기화되지 않았다는 별도 경고가 있다면, 작업을 진행하기 전에 빠진 자료를 확인해야 합니다.
3. 로컬 폴더 확인: 직접 파일을 다룰 작업이라면 프로젝트 메뉴의 Edit project에서 연결 폴더를 확인합니다. 필요한 폴더는 Add folder로 추가하고 시작 폴더는 Make primary로 지정할 수 있습니다. 이는 공식 문서의 폴더 설정 방법이며, 동기화 오류 자체의 해결을 보장하지는 않습니다.
4. 작업 목적에 맞는 우회: 단순 질문은 프로젝트 없는 새 채팅에서 진행할 수 있습니다. 로컬 파일 작업이 급하면 필요한 원본을 직접 내려받아 별도 작업 폴더에 보관하고 새 로컬 작업에 연결하는 방법을 고려하세요. 이 경우 기존 프로젝트 지침과 자료가 자동으로 모두 이전됐다고 가정하면 안 됩니다.
5. 반복 오류 보고: 발생 시각, 앱 버전, 프로젝트 선택인지 대화 인계인지, 일부 파일만 실패하는지를 기록해 앱의 피드백으로 보냅니다. 스크린샷과 로그에서는 이메일·개인 경로·비밀정보를 가리세요.

원본 프로젝트·파일 삭제, 설정 폴더 초기화, 보안 설정 전체 해제는 우선 조치로 권하지 않습니다. 위 순서는 확인된 동기화 흐름과 공식 프로젝트 사용법을 바탕으로 원인을 좁히는 안내입니다. 오류를 직접 재현해 특정 조치로 해결됐다고 검증한 사례는 아닙니다.

관련 공식 안내: 프로젝트와 로컬 폴더 설정 · 앱 문제 해결·피드백. 정확한 한국어 오류 문구에 대한 별도 공식 해결 문서는 확인하지 못했습니다.

Codex 사용법: 데스크톱 앱에서 시작하는 5단계

처음이라면 아래 내용만 기억하셔도 코덱스 사용하기엔 충분합니다. 이 글에서 설명하는 Codex 사용법은 ChatGPT 데스크톱 앱 기준입니다.

1. 앱 위쪽의 제품 선택기에서 Codex를 고릅니다.
2. 새 로컬 프로젝트를 만들거나 작업할 컴퓨터 폴더를 엽니다.
3. 바로 수정부터 시키지 말고 “이 폴더의 구조와 현재 상태를 먼저 확인해 줘”라고 요청합니다.
4. 확인 결과를 들은 뒤 바꿀 대상과 건드리면 안 되는 범위를 알려줍니다.
5. 작업이 끝나면 변경한 파일, 실행한 검사, 실제 반영 여부를 다시 물어봅니다.

제가 써 보니 처음에 요청 사항을 바로 던지는 것보다 ‘현재 상태 확인 → 기획 → 수정 및 변경 → 검증’ 순서로 맡기는 편이 훨씬 효율이 좋았습니다. 아래 프롬프트를 기억해두세요!

먼저 현재 상태를 확인해줘.
기존 작업은 되돌리지 말고, 내가 [요청한 부분]을 달성하기 위해 어떤 자업을 해야할지 생각해줘.

전문 용어를 몰라도 괜찮습니다. 위 프롬프트를 실행 후, 기획안을 보고 조정 할 부분이 있다면 수정하고, 변경을 맡기면 됩니다.

대상 파일이나 페이지 주소, 원하는 결과, 그대로 두어야 할 부분만 설명하면 Codex가 필요한 작업 방법을 찾아갈 수 있습니다. 수정이 끝나면 무엇을 바꿨고 어떻게 확인했는지 확인만 해주면 됩니다.

ChatGPT 프로젝트 vs. Codex 프로젝트의 차이

챗GPT와 코덱스를 사용함에 있어서 ‘프로젝트’라는 말이 또 한 번 사람을 헷갈리게 합니다. 이름은 비슷하지만 역할은 다릅니다.

로컬 프로젝트는 챗GPT와 연결된 내 컴퓨터의 실제 폴더(작업 공간)입니다. 허용된 범위 안에서 그 폴더의 파일을 읽거나 바꿀 수 있습니다. 반면 ChatGPT 프로젝트는 업로드한 파일, 연결한 자료, 프로젝트 지침을 여러 채팅이 함께 쓰도록 모아 둔 공간입니다. 내 컴퓨터 폴더와 자동으로 연결되는 것은 아닙니다.

프로젝트 및 채팅 공식 문서에 따르면 같은 프로젝트의 채팅들은 공통 파일과 지침을 사용할 수 있지만 대화 기록은 채팅마다 따로 유지됩니다. 즉, 같은 프로젝트 폴더를 사용해도 다른 채팅에서 나눈 대화까지 자동으로 전달되지는 않습니다.

실행 위치도 꼭 살펴보셔야 합니다. ChatGPT Work 개요에 따르면 로컬 Work는 데스크톱 앱을 통해 사용자가 허용한 로컬 파일과 애플리케이션을 대상으로 작업할 수 있습니다. 하지만 웹에서 실행한 Work는 내 컴퓨터의 파일이나 열린 브라우저 탭을 바로 볼 수 없습니다.

이때는 파일을 올리거나 프로젝트 또는 연결 앱을 통해 자료를 건네야 합니다. 같은 데스크톱 앱에서 시작했다고 해서 모든 작업이 자동으로 로컬에서 실행되는 것도 아닙니다.

화면에 보이는 선택 항목은 계정, 요금제, 지역, 회사의 관리자 정책에 따라 조금씩 다를 수 있습니다. 내 화면이 다른 사람의 화면과 다르더라도 먼저 권한과 실행 위치를 확인해 보세요.

ChatGPT Work와 Codex 연동 방법

제가 여러 번 오가며 써 본 뒤 정착한 순서는 이렇습니다.

1. 데스크톱 앱에서 로컬 프로젝트를 만들고 두 작업이 함께 볼 폴더를 연결합니다.
2. Work에서 검색 의도와 자료를 조사하고 글의 방향이나 수정 요구사항을 정리합니다.
3. 근거와 결정 사항을 프로젝트 폴더의 Markdown 문서에 저장합니다.
4. Codex를 열어 “같은 폴더의 인수인계 문서를 먼저 읽어 줘”라고 요청합니다.
5. Codex가 파일이나 사이트 설정을 고치고 필요한 검증을 진행하게 합니다.
6. 무엇을 실제로 바꿨는지, 검증 결과는 어땠는지를 다시 인수인계 문서에 적게 합니다.
7. 필요하면 Work가 그 내용을 읽고 사용자용 보고서나 게시글로 다듬습니다.

중요한 요령이 하나 있습니다. Work와 Codex가 같은 파일을 동시에 고치게 하지 마세요. 저는 한쪽이 작업을 끝내고 CURRENT.md를 업데이트한 다음, 다른 쪽이 이어받게 합니다. 이 순서만 지켜도 내용이 덮어써지거나 빠지는 일이 크게 줄어듭니다.

AGENTS.md 사용법: Work와 Codex의 대화 연결하기

my-project/
├── AGENTS.md
├── docs/
│   ├── PROJECT_CONTEXT.md
│   └── handoffs/
│       └── CURRENT.md
└── src/

파일 이름이 낯설어 보여도 역할은 어렵지 않습니다.

• AGENTS.md는 Codex가 이 프로젝트에서 계속 지켜야 할 작업 규칙입니다.
• PROJECT_CONTEXT.md는 프로젝트 목표와 용어처럼 오래 유지할 기본 정보입니다.
• CURRENT.md는 현재 진행 상태와 다음 작업을 정리한 인수인계 기록입니다.

저는 대화 내용을 길게 복사하기보다 이 세 파일에 꼭 필요한 내용만 나눠 적는 방식이 가장 편했습니다. 새 채팅을 열어도 파일을 먼저 읽게 하면 설명을 처음부터 반복할 일이 줄어듭니다.

Codex는 작업을 시작할 때 프로젝트 루트에서 현재 작업 폴더까지 AGENTS.md 또는 우선순위가 더 높은 재정의 파일을 찾아 읽습니다. 자세한 원리는 AGENTS.md 공식 문서에서 확인할 수 있습니다.

다만 Work도 모든 환경에서 이 파일을 Codex와 똑같이 자동 적용한다고 생각하면 안 됩니다. 저는 Work용 프로젝트 지침이나 첫 요청에 “AGENTS.md와 CURRENT.md를 먼저 확인해 주세요”라는 문장을 직접 넣어 둡니다.

ChatGPT Work용 프로젝트 지침

이 로컬 프로젝트는 ChatGPT Work와 Codex가 함께 사용한다.

작업 시작 전에 프로젝트 루트의 AGENTS.md와
docs/handoffs/CURRENT.md를 확인한다.

Work는 조사, 분석, 비교, 콘텐츠 초안과 작업 명세를 우선 담당한다.
중요한 판단, 근거, 생성한 파일, 실제 적용 여부, 검증 결과와 남은 작업은
상대 작업자가 대화 기록 없이도 이어받을 수 있도록 CURRENT.md에 기록한다.

추측과 확인된 사실을 구분한다. 비밀번호, API 키, 쿠키와 같은
비밀정보는 프로젝트 파일에 기록하지 않는다.

Codex용 AGENTS.md 공통 규칙

# Working agreement

- 작업을 시작하기 전에 `docs/handoffs/CURRENT.md`가 있으면 확인한다.
- 사용자의 요청과 관련 없는 기존 변경은 되돌리지 않는다.
- 수정 전 현재 상태를 확인하고, 변경 후 적절한 검증을 수행한다.
- 중요한 결정, 변경 파일, 외부 시스템 반영 여부, 검증 결과와 남은 작업을
  `docs/handoffs/CURRENT.md`에 기록한다.
- 비밀번호, API 키, 쿠키 등 비밀정보를 저장소에 기록하지 않는다.

인수인계 파일 예시

# Current Handoff

- 업데이트: YYYY-MM-DD HH:MM KST
- 작성자: ChatGPT Work 또는 Codex
- 상태: 조사 중 / 적용 대기 / 검증 중 / 완료

## 목표
## 확인된 사실과 근거
## 결정 사항
## 생성·수정한 파일
## 외부 시스템에 실제 적용한 변경
## 검증 결과
## 남은 작업과 다음 권장 행동

실제 사례: WordPress 사이트 개선

제가 WordPress 글을 손볼 때도 이 방식이 잘 맞았습니다. 먼저 Work에 검색 의도를 조사하고 경쟁 글을 비교하게 한 뒤, SEO 제목 후보와 수정할 내용을 정리하게 합니다. 이때 바꿀 URL, 판단 근거, 건드리면 안 되는 부분까지 CURRENT.md에 남깁니다.

그다음 Codex가 그 문서를 읽고 운영 서버의 현재 상태를 확인하게 합니다. 백업을 한 뒤 WP-CLI 같은 도구로 필요한 부분만 고치고, 캐시를 비운 다음 실제 HTML까지 확인합니다. 이렇게 나누면 ‘좋아 보이는 아이디어’와 ‘운영 사이트에 실제로 반영된 변경’을 헷갈리지 않게 됩니다.

물론 Codex가 처음부터 SSH나 WP-CLI에 마음대로 접속하는 것은 아닙니다. 사용할 수 있는 계정과 권한, 환경 설정이 준비되어 있어야 하고 작업에 따라 사용자의 승인이 필요할 수 있습니다.

자주 생기는 실수

저도 처음에는 첫 번째 항목을 놓치기 쉬웠습니다. 아래 내용만 미리 알고 시작하셔도 시행착오를 많이 줄일 수 있습니다.

• Work와 Codex가 앞 채팅 내용을 알아서 공유할 것이라고 생각하는 것
• 두 작업에 같은 파일을 동시에 고치게 하는 것
• 조사한 제안과 운영 환경에 실제 반영한 변경을 구분하지 않는 것
• 모든 프로젝트 규칙을 개인 지침 하나에 몰아넣는 것
• 정확한 이름인 AGENTS.md 대신 agent.md처럼 다른 파일명을 쓰는 것
• 데스크톱 앱에서 시작했으니 무조건 로컬 실행이라고 생각하는 것
• 인수인계 문서에 비밀번호, API 키, 쿠키를 적는 것

최종 선택 체크리스트

마지막으로 이것만 기억하시면 됩니다.

1. 가볍게 묻고 생각을 정리하고 싶다 → ChatGPT 채팅
2. 조사하고 비교해 완성된 자료를 만들고 싶다 → ChatGPT Work
3. 코드나 로컬 파일을 실제로 고치고 확인하고 싶다 → Codex
4. 조사한 내용을 사이트나 파일에 반영하고 싶다 → Work에서 정리하고 Codex에서 실행
5. 다음 채팅에서도 자연스럽게 이어가고 싶다 → 같은 폴더에 인수인계 파일을 남기기

처음부터 완벽하게 나눌 필요는 없습니다. 작업하다가 조사와 정리가 많아지면 Work로, 실제 수정과 검증이 필요해지면 Codex로 넘기시면 됩니다. 두 도구의 역할을 나누고 파일로 연결하는 것이 제가 찾은 가장 편한 사용법이었습니다.

FAQ

공식 출처

• ChatGPT 빠른 시작
• 프로젝트 및 채팅
• ChatGPT Work 개요
• AGENTS.md를 활용한 사용자 지정 지침