공식 빠른 시작 문서는 설치와 실행에 쓰는 핵심 명령을 각각 안내합니다. Codex CLI 공식 빠른 시작을 기준으로 설치와 계정 인증을 마친 뒤, 대상 프로젝트 폴더에서 도구를 실행하세요. 코드 작성이나 수정이 끝나면 변경 내용을 검토하고 프로젝트 테스트를 실행해야 합니다. 이번 주에는 먼저 테스트 프로젝트에서 이 흐름을 한 번 진행해 보세요.
처음 설치하는 개발자라면 터미널과 프로젝트 준비부터 확인하세요.
기존 프로젝트의 코드를 맡기려면 작업 범위와 되돌릴 방법을 먼저 정하세요.
팀에서 쓸 Mac 환경을 준비한다면 계정 권한과 프로젝트 의존성도 점검하세요.
시작 전: 준비된 프로젝트와 무방비 상태의 프로젝트
Codex CLI는 프로젝트 파일을 읽고, 요청에 따라 수정하거나 명령을 실행하는 도구입니다. 따라서 실행 전에 프로젝트 상태를 정리해야 합니다. 기존 작업물이 있는 상태에서 바로 변경을 허용하면, 원래의 수정 사항과 도구가 만든 변경을 구별하기 어려워질 수 있습니다.
시작 전에 다음 항목을 확인하세요.
- [ ] 터미널을 열고 프로젝트 폴더로 이동할 수 있습니다.
- [ ] 필요한 프로젝트 의존성을 설치했거나, 설치 방법을 알고 있습니다.
- [ ] 작업할 저장소의 현재 변경 사항을 확인했습니다.
- [ ] 중요 파일은 버전 관리나 별도 백업으로 복구할 수 있습니다.
- [ ] 처음 사용하는 경우 중요한 저장소가 아닌 테스트 프로젝트를 골랐습니다.
- [ ] 시스템 요구 사항과 설치 전제 조건을 공식 문서에서 확인했습니다.
프로젝트에서 Git을 사용한다면 작업 전에 git status로 저장되지 않은 변경이 있는지 확인합니다. 이 명령이 보여 주는 파일 상태의 의미는 Git 상태 확인 안내를 참고하세요. 미리 저장하지 않은 변경이 있다면 Codex CLI를 실행하기 전에 커밋하거나, 다른 방식으로 보존하세요.
Mac의 시스템 버전이나 의존성 조건은 임의로 단정하지 마세요. 설치 시점의 요구 사항을 Codex CLI 설치 안내에서 확인하고, 설치가 막히면 오류 메시지와 현재 환경을 함께 대조하는 편이 좋습니다.
설치: 공식 안내에 따른 방식과 확인되지 않은 명령
공식 안내에서 현재 지원하는 설치 방법을 확인한 다음 진행하세요. 공식 CLI 문서와 저장소의 설치 안내를 기준으로 삼고, 검색 결과나 오래된 메모에 나온 명령을 그대로 복사하지 마세요.
공식 문서에서 안내하는 npm 설치 명령은 다음과 같습니다.
npm install -g @openai/codex
설치가 끝나면 터미널에서 실행 명령을 확인합니다.
codex
위 명령은 문서에 나온 설치와 실행 예시입니다. 실행 환경이나 지원 방식이 변경될 수 있으므로, 실제 작업에서는 공식 CLI 빠른 시작과 공식 저장소의 설치 설명을 다시 확인하세요. 명령을 입력했는데 실행 파일을 찾지 못하거나 설치가 실패하면, 오류 문구와 npm 환경을 먼저 살펴보세요. 출처가 불분명한 권한 변경이나 우회 설치부터 시도하지 않는 것이 안전합니다.
로그인과 권한: 계정 인증과 작업 범위 구분
설치 후 codex를 실행하고, 화면에 표시되는 인증 안내를 따라 계정을 연결하세요. 지원되는 인증 방법과 진행 절차는 변경될 수 있으므로 Codex CLI 공식 인증 설명을 확인해야 합니다. 인증이 끝나기 전에 계정 정보나 비밀 키를 프로젝트 파일에 적어 두지 마세요. 터미널 화면을 공유하거나 캡처할 때도 민감한 정보가 드러나지 않는지 확인합니다.
계정에 로그인하는 것과 프로젝트 변경 권한을 넓게 허용하는 것은 별개의 판단입니다. 요청한 작업에 필요한 권한만 선택하고, 도구가 파일을 읽거나 수정하려는 범위를 검토하세요. 공식 권한 안내는 권한 선택의 기준을 설명하며, 샌드박스 안내는 실행 환경의 제한과 동작을 다룹니다. 작업 편의를 이유로 제한을 무조건 해제하기보다, 요청한 변경을 수행하는 데 꼭 필요한지 먼저 판단하세요.
프로젝트 작업: 루트 폴더와 구체적인 요청
프로젝트에서 작업할 때는 터미널에서 대상 폴더로 이동한 뒤 Codex CLI를 실행합니다. 예를 들어 프로젝트의 루트 디렉터리에 들어가 codex를 실행하면, 대화 중에 해당 프로젝트와 요청한 작업을 분명히 지정할 수 있습니다. 폴더 위치와 실행 방식은 현재 공식 사용 안내에 맞춰 확인하세요.
요청은 “코드를 개선해 주세요”처럼 넓게 쓰기보다 결과를 확인할 수 있게 작성합니다. 예를 들어 다음 정보를 함께 전달하세요.
- 바꾸려는 동작과 기대하는 결과
- 관련 코드나 파일의 위치
- 수정하지 않아야 할 영역
- 프로젝트에서 사용하는 규칙이나 의존성
- 작업이 완료됐다고 판단할 테스트나 검증 방법
시연용 요청은 “입력값이 비어 있을 때 오류 메시지를 표시하고, 기존 화면 구조는 유지한 뒤 해당 동작의 테스트를 추가해 주세요”처럼 범위를 한정할 수 있습니다. 이는 예시일 뿐입니다. 실제 파일 구성과 테스트 방식은 프로젝트에 따라 다르므로, 도구가 선택한 파일과 변경 내용을 확인한 뒤 다음 단계로 진행하세요.
변경 방식 비교: 로컬 Mac과 임시 클라우드 환경
작업 환경은 프로젝트의 특성과 이용 기간에 맞춰 선택하세요. 클라우드 Mac을 고려한다면 계정 보안, 접속 방식, 필요한 개발 도구를 실제 제공 조건과 대조해야 합니다. 이용 절차나 접속 관련 안내가 필요하면 Hashvps 도움말도 함께 확인하세요.
| 선택지 | 적합한 상황 | 확인할 점 |
|---|---|---|
| 보유한 Mac | 현재 개발 환경이 이미 갖춰져 있고, 작업을 직접 이어갈 때 | 개발 도구 설치와 업데이트, 저장 공간, 작업 중인 프로젝트의 백업을 직접 관리해야 합니다. |
| 임시 클라우드 Mac | 별도 작업 환경이 필요하거나 일시적인 개발 작업을 분리하려는 경우 | 실제 제공되는 구성, 접속 방법, 계정과 파일 관리 조건을 확인해야 합니다. |
| 중요 프로젝트에서 바로 실행 | 작업이 급하고 익숙한 프로젝트라 하더라도 처음 시도하는 경우에는 권장하지 않습니다. | 기존 변경 사항을 보존하고, 테스트 가능한 복사본이나 별도 작업 공간에서 먼저 검증하는 편이 안전합니다. |
코드 변경과 검증: 생성 결과를 완료로 보지 않기
Codex CLI가 코드를 작성하거나 수정한 뒤에는 파일을 직접 검토해야 합니다. 먼저 변경 파일 목록과 내용을 살펴보고, 요청하지 않은 파일이 함께 바뀌지 않았는지 확인하세요. Git 사용 프로젝트라면 git diff로 차이를 확인할 수 있으며, 출력과 옵션은 Git 차이 보기 문서에서 확인할 수 있습니다.
이 순서로 검증하면 변경 원인을 분리하기 쉽습니다.
- 변경된 파일이 요청한 범위에 들어가는지 확인합니다.
- 코드 차이를 읽고, 의도하지 않은 삭제나 설정 변경이 없는지 살펴봅니다.
- 프로젝트의 기존 테스트 명령과 빌드 명령을 확인합니다.
- 관련 테스트를 실행하고 실패한 경우 오류를 읽습니다.
- 수정 결과가 요구 사항에 맞는지 직접 확인한 뒤 변경을 보존합니다.
테스트가 통과했다는 사실만으로 모든 동작이 올바르다고 단정할 수는 없습니다. 테스트가 요청한 사례를 다루는지, 생성된 코드가 프로젝트 규칙과 맞는지도 확인해야 합니다. 실패가 발생하면 오류 메시지와 영향받은 파일을 좁혀 다시 요청하세요. 권한 오류라면 범위를 무작정 확장하기 전에 공식 권한 안내와 샌드박스 설명을 다시 살펴보세요.
자주 묻는 질문
첫 설치 전에 준비할 항목
Mac에서 터미널을 사용할 수 있는지 확인하고, 작업할 프로젝트 디렉터리와 필요한 의존성을 준비합니다. 기존 프로젝트라면 변경 사항을 보존하고, 처음에는 테스트 프로젝트를 선택하세요. 설치 명령과 지원 환경은 바뀔 수 있으므로 공식 문서를 확인한 뒤 실행해야 합니다.
계정 연결과 권한 설정
터미널에서 Codex CLI를 실행한 뒤 공식 인증 안내에 따라 계정을 연결합니다. 인증 방법과 권한 선택지는 현재 문서에서 확인하세요. 작업에 필요한 범위만 허용하고, 인증 정보가 기록이나 프로젝트 파일에 남지 않도록 주의합니다.
프로젝트 코드 자동 작성 요청
프로젝트 폴더에서 도구를 실행한 다음, 기대 결과와 수정 대상, 지켜야 할 제약, 확인할 테스트를 구체적으로 설명합니다. 완료 여부는 생성 결과만으로 판단하지 마세요. 코드 차이를 검토하고 프로젝트에 맞는 테스트나 빌드를 실행해야 합니다.
기존 코드 수정 후 검토
변경 파일과 코드 차이를 먼저 확인해 요청하지 않은 수정이 없는지 살펴봅니다. 이어서 관련 테스트와 빌드를 실행하고, 실패한 항목은 오류 내용을 기준으로 점검하세요. 마지막으로 요구 사항이 충족됐는지 직접 확인합니다.
다음 작업 환경 선택
보유한 Mac에서 계속 개발하면 이미 설치된 도구를 활용할 수 있지만, 환경 설정과 유지 관리도 직접 맡아야 합니다. 작업용 Mac이 따로 없거나 개발 환경을 분리해야 한다면 임시 클라우드 Mac을 검토할 수 있습니다. 다만 장기간 계속되는 작업이나 물리 장치 연결이 필요한 업무라면 대여보다 직접 관리하는 Mac이 맞을 수 있습니다.
먼저 테스트 프로젝트에서 Codex CLI의 설치, 로그인, 코드 수정, 검증을 끝까지 실행해 보세요. 그다음 별도 환경이 필요하다고 판단되면 Hashvps 안내에서 실제 제공 구성과 이용 조건을 확인하고 선택하세요. Hashvps 환경 안내에서 확인할 수 없는 구성이나 조건은 이용 전에 별도로 확인하는 것이 좋습니다.
FAQ
코드 작업을 위한 전용 클라우드 맥을 시작해 보세요
Hashvps의 맥 미니 M4를 대여해 맥 개발 환경을 원격으로 이용할 수 있습니다.
전용 공인 인터넷 주소와 최대 초당 1기가비트 대역폭으로 빌드와 파일 전송을 지원합니다.