Codex 시작 전 알아둘 것
Codex에 저장소를 보여주면 코드를 설명하거나 수정하고, 개발 도구로 결과를 확인하는 작업을 맡길 수 있습니다. 처음에는 기능을 많이 켜기보다 어느 폴더에서 무엇을 해도 되는지 정하는 편이 좋습니다. 이 시리즈는 로컬 터미널의 Codex CLI를 기준으로 첫 작업부터 변경 검수까지 설명합니다.
이 글은 GodDaeHee가 공식 문서를 참고해 작성한 비공식 한국어 해설입니다. OpenAI 공식 번역이나 제품 지원 문서가 아닙니다. 문서 대조와 실제 실행 검증은 구분하며, 설치·인증·AI 작업 예제는 실행 미검증입니다.
먼저 사용 환경을 구분하세요
| 환경 | 시작점 | 이 시리즈의 범위 |
|---|---|---|
| CLI | 로컬 터미널의 codex |
설치·인증·프로젝트 작업의 기준 |
| IDE 확장 | 코드 편집기의 Codex 확장 | 공식 안내 링크로 별도 확인 |
| 데스크톱 앱 | 공식 앱에서 프로젝트·폴더 선택 | CLI와 버전·설정 화면이 같다고 가정하지 않음 |
| 클라우드 | 웹·앱에서 클라우드 환경 선택 | 저장소 연결·원격 환경 설정은 별도 절차 |
CLI에서 동작한 옵션을 앱 설정에 그대로 적용하거나, 로컬에서 설치한 도구가 클라우드에도 있다고 가정하면 문제가 생깁니다. 먼저 사용할 환경을 하나 고르세요. 앱과 웹의 명칭·화면은 바뀔 수 있으므로 공식 시작 안내를 함께 확인합니다.
첫 작업은 작은 저장소에서
업무 저장소 대신 공개해도 되는 합성 예제나 연습용 저장소를 준비하세요. 실제 고객 자료, 운영 환경변수, 개인 인증 파일이 들어 있는 폴더는 첫 실습에 적합하지 않습니다. 로컬 파일을 다룬다는 말이 모든 처리가 오프라인에서 끝난다는 뜻도 아닙니다. 사용하는 인증 방식과 조직의 데이터 정책을 확인해야 합니다.
시작 전에는 다음을 직접 확인합니다.
- 현재 디렉터리와 Git 브랜치가 의도한 대상인지
- 작업 전부터 수정된 파일이 있는지
- 프로젝트의 설치·테스트·빌드 명령이 무엇인지
- 읽기만 맡길지, 수정과 명령 실행도 허용할지
- 외부 요청·패키지 설치·커밋·push를 별도로 승인할지
맡길 일과 완료 조건을 함께 적으세요
다음은 이 가이드에서 만든 요청 예제입니다. 모델에 보내는 작업이므로 실제 사용 시 이용량이 발생할 수 있습니다.
이 연습 저장소의 실행 흐름을 설명해줘.
우선 파일만 읽고 수정하거나 명령을 실행하지 마.
진입점과 테스트 위치를 파일 경로와 함께 알려줘.
추측은 추측이라고 표시하고, 모르는 부분은 질문해줘.
이 요청은 행동 지침입니다. 기술적인 접근 제한을 대신하지는 않습니다. 실제 권한은 CLI의 샌드박스와 승인 설정도 함께 확인해야 합니다. 자세한 구분은 권한과 샌드박스에서 다룹니다.
이 순서로 읽으면 됩니다
설치에서 실행 파일을 확인하고, 인증에서 계정과 과금 경로를 구분합니다. 이어 첫 작업으로 작은 변경을 맡긴 뒤 AGENTS.md에 반복 규칙을 정리하세요. 수정 결과는 리뷰와 테스트 절차로 직접 확인합니다.
HTTP로 출처가 열리거나 CLI 버전이 출력되는 것만으로 이 흐름 전체가 검증되지는 않습니다. 각 글 상단의 적용 범위·실행 상태를 먼저 읽고, 환경이 다르면 공식 원문과 현재 CLI 도움말을 우선 대조하세요.
공식 한국어 도움말: ChatGPT 플랜과 Codex에서 계정별 이용 안내를 확인할 수 있습니다. 이 글은 해당 도움말의 공식 번역이 아니며, 계정 조건과 요금은 공식 안내를 우선합니다.
추가 공식 참조
다음은 관련 세부 기능과 전체 참조 문서입니다. 아래 항목은 원문 전체를 한국어로 설명하거나 실행 검증한 범위가 아닙니다. 적용 조건과 정확한 옵션은 공식 원문을 확인하세요.