프로젝트를 사용하면 관련 채팅을 정리하고 ChatGPT에 필요한 컨텍스트를 제공할 수 있습니다. ChatGPT 데스크톱 앱의 프로젝트 화면에는 ChatGPT 프로젝트와 내 컴퓨터의 폴더에 연결된 로컬 프로젝트가 함께 표시됩니다.
프로젝트를 사용할지 결정하기
작업을 계속 이어 가거나, 결과물을 여러 개 만들거나, 같은 파일과 소스를 사용해야 한다면 프로젝트를 만드세요. 하나의 채팅에서 마칠 수 있고 프로젝트의 공유 컨텍스트가 필요 없는 작업이라면 프로젝트 없이 채팅을 시작하세요.
프로젝트에 관련 채팅, 파일, 지침, 소스를 모아 두세요. Chat으로 시작한 채팅과 ChatGPT Work로 시작한 채팅을 같은 프로젝트에서 관리할 수 있습니다.
프로젝트에서 채팅할지 결정하기
작업을 계속 이어 가거나, 결과물을 여러 개 만들거나, 같은 파일과 소스를 사용해야 한다면 프로젝트를 만드세요. 하나의 채팅에서 마칠 수 있고 프로젝트의 공유 컨텍스트가 필요 없는 작업이라면 프로젝트 없이 채팅을 시작하세요.
각 프로젝트의 채팅 섹션에는 프로젝트에 속한 채팅이 표시되고, 소스 섹션에는 업로드한 파일과 연결된 컨텍스트가 표시됩니다. 프로젝트 지침은 해당 프로젝트의 모든 채팅에 적용됩니다. ChatGPT 프로젝트에서는 내 컴퓨터의 폴더에 직접 접근할 수 없으므로 ChatGPT가 사용할 소스를 업로드하거나 연결하세요.
어느 모드를 사용하든 프로젝트의 공유 파일과 지침을 사용하려면 해당 프로젝트에서 새 채팅을 시작하세요. 나중에 채팅 섹션에서 대화를 이어 갈 수 있습니다.
Codex CLI는 실행한 디렉터리를 해당 채팅의 프로젝트로 사용합니다. Codex가 작업할 디렉터리에서 codex를 실행하거나 --cd <directory>(-C)로 디렉터리를 직접 지정하세요. CLI에는 ChatGPT의 프로젝트 화면이 없습니다.
IDE 확장 프로그램은 IDE에 열려 있는 폴더나 워크스페이스를 로컬 프로젝트로 사용합니다. 루트가 여러 개인 워크스페이스에서는 채팅에 사용할 루트를 선택하세요. 확장 프로그램에는 웹이나 데스크톱 앱에서 볼 수 있는 ChatGPT 프로젝트 화면이 없습니다.
프로젝트에서 작업하기
프로젝트 화면에서 ChatGPT 프로젝트와 로컬 프로젝트를 한눈에 볼 수 있습니다. ChatGPT 프로젝트에서는 관련 채팅이 프로젝트 파일과 컨텍스트를 공유합니다. 로컬 프로젝트에서는 채팅이 내 컴퓨터에 있는 하나 이상의 폴더에 접근할 수 있습니다. 예를 들어 소스 파일을 모아 둔 폴더나 코드베이스를 연결할 수 있습니다.
관련 작업은 한 프로젝트에 모으되, 결과물마다 별도의 채팅을 시작하세요. 그러면 각 채팅의 메시지와 결과를 해당 목표에 맞게 정리할 수 있습니다.
프로젝트에서 작업하기
같은 ChatGPT 프로젝트에 속한 채팅에서는 업로드한 파일, 프로젝트 지침, 연결된 소스를 함께 사용할 수 있습니다. 간단한 대화에는 Chat을, 규모가 큰 결과물을 만들 때는 ChatGPT Work를 사용하세요. 두 모드에서 시작한 채팅 모두 프로젝트의 채팅 섹션에 표시됩니다. 결과물마다 별도의 채팅을 시작하면 프로젝트의 공유 컨텍스트를 유지하면서 각 채팅의 메시지와 결과를 해당 목표에 맞게 정리할 수 있습니다.
프로젝트 디렉터리에서 작업하기
채팅에서 참조할 파일이 있는 디렉터리에서 Codex를 실행하세요. 결과물마다 /new로 별도의 채팅을 시작하세요. 저장된 채팅을 이어 가려면 Codex 실행 중에 /resume 명령어를 사용하거나 codex resume 명령어를 실행하세요.
채팅에는 대화 기록과 작업 디렉터리 경로가 저장되며, Codex는 현재 작업 트리에서 파일을 읽습니다. 이후 채팅에서도 참조해야 할 프로젝트 지침은 AGENTS.md나 버전 관리에 포함된 문서에 작성하세요.
워크스페이스에서 작업하기
채팅에서 참조할 파일이 있는 폴더나 워크스페이스를 여세요. 결과물마다 새 채팅을 시작하고, 나중에 대화를 이어 가려면 최근 채팅 목록에서 해당 채팅을 선택하세요. 같은 프로젝트의 채팅은 동일한 파일로 작업할 수 있으며, 대화 기록은 채팅별로 보관됩니다.
현재 선택한 내용과 열려 있는 파일은 이번 턴의 컨텍스트로 사용됩니다. 이후 채팅에서도 참조해야 할 프로젝트 지침은 AGENTS.md나 버전 관리에 포함된 문서에 작성하세요.
프로젝트와 채팅 정리하기
진행 중인 작업은 찾기 쉽게 표시하고 완료한 작업은 따로 보관하세요.
- 프로젝트 고정 기능을 사용하면 프로젝트가 사이드바 상단 가까이에 표시됩니다. 프로젝트 화면에서도 고정할 수 있습니다.
- 채팅 고정 기능을 사용하면 프로젝트에 새 채팅이 생겨도 자주 사용하는 채팅을 쉽게 찾을 수 있습니다.
- 채팅 이름 변경 기능으로 결과물을 설명하는 짧은 제목을 붙이세요. 예를 들어 “3분기 출시 개요”나 “결제 화면 접근성 검토”처럼 작성하세요.
- 프로젝트 검색 기능은 프로젝트 화면에서 사용할 수 있습니다. 이전 채팅의 제목은 몰라도 문구나 브랜치 이름이 기억난다면 사이드바에서 채팅 검색을 여세요. 채팅 검색에는 기본 단축키가 없지만 설정 > 키보드 단축키에서 직접 지정할 수 있습니다.
- 채팅 보관 기능으로 완료한 작업을 정리하세요. 프로젝트 메뉴에서 채팅 보관을 선택하면 해당 프로젝트의 채팅을 한꺼번에 보관할 수 있습니다.
고정해도 컨텍스트가 추가되거나 ChatGPT의 접근 범위가 달라지지는 않습니다. 사이드바에서 프로젝트나 채팅이 표시되는 위치만 바뀝니다.
보관한 채팅은 설정 > 보관된 채팅에서 복원하세요.
프로젝트와 채팅 정리하기
진행 중인 작업은 찾기 쉽게 표시하고 완료한 작업은 따로 보관하세요.
- 프로젝트 고정 기능을 사용하면 프로젝트가 사이드바 상단 가까이에 표시됩니다. 프로젝트 화면에서도 고정할 수 있습니다.
- 채팅 고정 기능을 사용하면 프로젝트에 새 채팅이 생겨도 자주 사용하는 채팅을 쉽게 찾을 수 있습니다.
- 채팅 이름 변경 기능으로 결과물을 설명하는 짧은 제목을 붙이세요. 예를 들어 “3분기 출시 개요”나 “결제 화면 접근성 검토”처럼 작성하세요.
- 프로젝트 검색 기능은 프로젝트 화면에서 사용할 수 있습니다. 이전 채팅의 제목은 몰라도 문구나 브랜치 이름이 기억난다면 Cmd/Ctrl+K를 눌러 검색하세요.
- 채팅 보관 기능으로 완료한 작업을 정리하세요.
고정해도 컨텍스트가 추가되거나 ChatGPT의 접근 범위가 달라지지는 않습니다. 사이드바에서 프로젝트나 채팅이 표시되는 위치만 바뀝니다.
보관한 채팅은 설정 > 데이터 제어 > 보관된 채팅에서 복원하세요.
로컬 프로젝트에서 폴더와 코드베이스 사용하기
여러 기기에서 Work를 이어 갈 때 승인된 프로젝트 폴더를 사용하려면 워크스페이스에서 로컬 컴퓨터 접근을 허용한 후 새 클라우드 작업을 시작하세요. 해당 폴더가 있는 컴퓨터는 온라인 상태로 두고 연결을 유지하세요.
대화 동기화와 프로젝트 파일 접근은 별개입니다.
- 대화를 동기화해도 로컬 폴더 전체가 업로드되거나 다른 컴퓨터에서 해당 폴더를 사용할 수 있게 되지는 않습니다.
- 작업을 이어 갈 때는 해당 작업이 접근할 수 있는 소스와 도구를 확인하세요.
- Work 대화 기록은 Codex 기록과 별도로 관리됩니다.
ChatGPT가 내 컴퓨터의 파일을 읽거나 수정해야 한다면 로컬 프로젝트를 추가하세요. 프로젝트에 폴더가 꼭 필요한 것은 아니지만 필요에 따라 연결할 수 있습니다.
폴더를 추가하거나 변경하려면 프로젝트 메뉴를 열고 프로젝트 편집을 선택하세요. 폴더 추가를 선택하면 폴더를 여러 개 연결할 수 있습니다. ChatGPT는 연결된 모든 폴더에서 파일을 읽고 수정할 수 있습니다. 기본 작업 디렉터리를 변경하려면 원하는 폴더에 마우스 포인터를 올리고 기본 폴더로 설정을 선택하세요.
새 채팅은 기본 폴더에서 시작됩니다. Codex는 이 폴더를 Git 작업의 기본 디렉터리로 사용하며, 여기에서 AGENTS.md, 스킬, config.toml을 자동으로 찾습니다. 추가로 연결한 폴더에서도 파일을 검색하고 읽거나 수정할 수 있지만, Codex가 이 폴더들에서 해당 프로젝트 파일을 자동으로 찾지는 않습니다.
앱과 앱 문서, 웹사이트와 백엔드처럼 관련 작업이 서로 다른 위치에 있다면 여러 폴더를 사용하세요. 서로 관련이 없는 작업이거나 각 채팅에서 리포지터리의 일부에만 접근해야 한다면 프로젝트를 따로 만드세요. 이렇게 하면 각 작업에 필요한 컨텍스트만 유지할 수 있습니다. 현재 원격 프로젝트는 폴더 하나를 지원합니다.
로컬 환경에서 프로젝트의 설정 절차와 자주 사용하는 명령어를 정의하세요. 검토 창에서는 같은 프로젝트에 연결된 여러 리포지터리의 변경 사항을 확인할 수 있습니다. Pull request와 작업 트리 관련 작업은 기본 리포지터리를 대상으로 합니다. 작업 트리에서 채팅을 시작해도 다른 폴더는 계속 연결되어 있습니다.
프로젝트와 작업 트리는 작업을 정리하는 데 사용합니다. 로컬 명령어가 읽거나 수정할 수 있는 대상과 네트워크를 통해 접근할 수 있는 대상은 샌드박스가 제한합니다.
프로젝트 없이 채팅 시작하기
Codex에서 새 채팅을 선택하면 프로젝트 없이 채팅을 시작할 수 있습니다. 이 버튼은 최근 항목 옆에 있습니다. 공유 프로젝트 파일이나 지침, 폴더 접근이 필요 없고 하나의 채팅에서 마칠 수 있는 작업에 사용하세요. 여러 채팅에서 같은 컨텍스트를 사용해야 한다면 프로젝트를 먼저 만드세요.
프로젝트 없이 채팅 시작하기
프로젝트에서 공유하는 파일, 지침, 소스가 필요 없다면 ChatGPT 홈에서 채팅을 시작하세요. Chat과 ChatGPT Work 중에서 선택할 수 있으며, 웹에서는 어느 쪽을 사용해도 채팅이 생성됩니다.
작업 범위가 커지면 채팅을 프로젝트로 옮기고 각 채팅에 결과물이 드러나는 이름을 붙이세요. 한 프로젝트 안에서 조사, 초안 작성, 검토, 후속 작업을 별도의 채팅으로 병행하면 모든 메시지가 하나의 컨텍스트에 뒤섞이지 않습니다.
빠른 채팅으로 간단한 질문하기
빠른 채팅을 사용하면 일반 ChatGPT 채팅이 열립니다. Codex 사이드바에는 Codex 채팅과 프로젝트가 표시되며, ChatGPT 채팅은 표시되지 않습니다.
새 채팅에 마우스 포인터를 올린 다음 오른쪽에 있는 빠른 채팅 아이콘을 선택하세요. 단축키로도 열 수 있습니다.
macOS에서는 Cmd+Option+N을, Windows와 Linux에서는 Ctrl+Alt+N을 누르세요. 새 채팅에서 기존 ChatGPT 채팅을 열어 Codex 채팅에 추가할 수도 있습니다.