[OpenAI - Codex] ChatGPT Cli 사용법, 오류 해결방법

Codex란?

오픈AI 코덱스는 오픈AI가 개발한 인공지능 모델이다. 응답 시 자연어의 구문을 분석하고 코드를 생성한다. 비주얼 스튜디오 코드와 Neovim 등의 선별된 통합 개발 환경을 위한 프로그래밍 자동 완성 도구인 깃허브 코파일럿을 지원한다.

쉽게 말하면 GPT 사촌같은 녀석이다. 웹에서 비동기 에이전트 역할을 하기도 하고 Cli로도 사용이 가능하다.

Codex Cli(ChatGPT Cli) 설치

# npm
npm i -g @openai/codex
# 또는 Homebrew
brew upgrade codex

codex 시작하기

#로그인(OpenAI Pro, Plus에 가입되어 있거나 API KEY 발급 필수)
codex login

#시작
codex

#즉시 명령
codex "hi"

#에이전트 모드
codex --full-auto "create the fanciest todo-list app"

오류 원인과 결과

처음 시작 시 다양한 이유로 오류가 발생한다. 시작 시 가장 만나게 되는 오류 중 하나는 아래와 같다.

BackgroundEvent(BackgroundEventEvent { message: "stream error: unexpected status 400 Bad Request: {\n  \"error\": {\n    \"message\": \"Your organization must be verified to generate reasoning summaries.    ││
│Please go to: https://platform.openai.com/settings/organization/general and click on Verify Organization. If you just verified, it can take up to 15 minutes for access to propagate.\",\n    \"type\":        ││
│\"invalid_request_error\",\n    \"param\": \"reasoning.summary\",\n    \"code\": \"unsupported_value\"\n  }\n}; retrying 10/10 in 2.139s…" })

말 그대로 해당 링크에 가서 조직 설정을 완료하면 된다.

이후에 신분증 앞, 뒷면을 촬영하고 안면도 정면, 좌우를 촬영하여 제출하여야 한다.

이렇게까지 복잡해야하나 싶기는 하지만 GPT Plus나 Pro만 결제하고 GPT Cli(Codex Cli)를 사용할 수 있다는것에 의의를 둔다면 썩 나쁘지는 않은 과정이긴 한 것 같다. 아직 본격적으로 테스트해보지는 않았지만 직접 GPT <-> Code를 왔다갔다 하는 것 보다 Claude Code나 Cli처럼 Ide에서 (콘솔을 통해) 바로 프로젝트를 수정할 수 있다는건 꽤나 매력적인 것 같다. 하지만 클로드에서 가능한 MCP 지원 기능이나 관련 프레임워크 등 나온지 오래 됐지만 아직은 커뮤니티가 작은 GPT Cli(Codex)이기 때문에 누릴 수 있는 이점도 있다고 본다.

 

그리고 많이 겪는 오류 중 하나다

event
BackgroundEvent(BackgroundEventEvent {
message: "stream error: stream disconnected before completion: stream closed before response.completed; retrying 1/10 in 191ms…"
})

해당 이슈의 원인은 다양한데, 현재 OpenAI에서 제대로 된 오류 메시지를 매핑하지 않았기 때문에 저렇게 뭉뚱그려서 연결을 할 수 없는 문제만 발생한다.

이럴 때 확인해야 하는 사항이 몇가지 있다.

1. ChatGPT 프로모션 크레딧으로 로그인하려면 ChatGPT Plus 또는 Pro 구독을 시작한 지 7일 이상
2. API 조직에 기본 결제 방법이 설정되어 있어야 한다

엥? 난 GPT 계정이 있는데 저건 뭐야? 라고 생각하실텐데... 왠지 몰라도 OpenAI의 API 플랫폼에 가입 후 결제 방법(신용카드 등록)이 되어 있어야 사용이 가능하다.

하지만 이런 귀찮음을 메리트도 있으니 걱정말자

 

ChatGPT 유료 사용자 리워드

ChatGPT로 Codex CLI에 로그인하는 Plus 사용자는 5달러 상당의 API 크레딧을 , Pro 사용자는 50달러 상당의 API 크레딧을 받을 수 있다. 하지만 모든 프로모션 크레딧은 발급 후 30일 후에 만료되니 빠르게 사용해보자.

 

다양한 사용법

✨	입력 값	Codex가 해주는 일
1	codex "Refactor the Dashboard component to React Hooks"	Codex는 클래스 구성 요소를 다시 작성하고 실행한 npm test다음 차이점을 보여줍니다.
2	codex "Generate SQL migrations for adding a users table"	ORM을 추론하고, 마이그레이션 파일을 생성하고, 샌드박스 DB에서 실행합니다.
3	codex "Write unit tests for utils/date.ts"	테스트를 생성하고 실행하며 통과할 때까지 반복합니다.
4	codex "Bulk-rename *.jpeg -> *.jpg with git mv"	안전하게 파일 이름을 바꾸고 가져오기/사용법을 업데이트합니다.
5	codex "Explain what this regex does: ^(?=.*[A-Z]).{8,}$"	단계별 인간 설명을 출력합니다.
6	codex "Carefully review this repo, and propose 3 high impact well-scoped PRs"	현재 코드베이스에서 영향력 있는 PR을 제안합니다.
7	codex "Look for vulnerabilities and create a security review report"	보안 버그를 찾아 설명합니다.

이 외에도 상당히 많은 프롬프트를 이용할 수 있고 활용할 수 있어 보인다.

 

https://github.com/openai/codex

GitHub - openai/codex: Lightweight coding agent that runs in your terminal