메인 콘텐츠로 건너뛰기
이 가이드는 GPT 시리즈만 사용합니다. Codex에서는 GPT 시리즈(GPT-6 Luna, GPT-6 Sol, GPT-6.1 Sol, GPT-6 Astra, GPT-6.1 Terra)와 제한이 없는 모델(GLM, Qwen, Kimi, MiniMax, DeepSeek)을 실행할 수 있습니다. Claude 시리즈는 Codex에서 사용할 수 없습니다. Claude Code를 참고하세요.

설치

공식 사이트에서 다운로드(macOS)

https://openai.com/codex/

명령줄로 설치

환경 변수 설정

설정 파일로 설정하기

  1. ~/.codex/config.toml 파일을 편집해 다음 내용을 추가합니다.
  1. ~/.codex/auth.json 파일을 편집해 다음과 같이 수정합니다.

cc-switch로 설정하기

  1. CC-Switch를 실행하고 제공업체를 추가합니다.
CC-Switch의 제공업체 추가 화면
  1. 프리셋 목록에서 “사용자 지정 설정”(Custom Configuration)을 선택합니다.
CC-Switch 프리셋 목록에서 Custom Configuration을 선택하는 화면
  1. 제공업체 이름, API 키, 엔드포인트(https://api.harogo.ai/v1) 등을 입력합니다. 모두 입력했다면 “추가”(Add)를 클릭합니다.
CC-Switch에서 API 키를 입력하고 저장하는 화면
  1. 홈 화면으로 돌아가 “harogo”를 선택하고 “활성화”(Enable)를 클릭하면 바로 사용할 수 있습니다.
CC-Switch에서 harogo 제공업체를 활성화하는 화면

Codex 사용하기

터미널에서 사용하기

  1. 터미널을 열고 프로젝트 디렉터리로 이동한 뒤 codex 명령을 실행합니다.
  1. 필요에 따라 권한을 설정합니다.
Codex 시작 시 승인 권한을 설정하는 화면
  1. 자연어로 프롬프트를 입력하세요. 정상적인 응답이 돌아오면 설정이 완료된 것입니다.