Codex CLI 설치 튜토리얼

GPT / Codex 시리즈 모델을 사용할 예정이라면 Codex CLI를 미리 설치해 두는 것도 좋습니다. 설치가 끝나면 마찬가지로 CC-Switch를 통해 NextHub에 연동할 수 있습니다.

설치 단계

1. Node.js 환경 확인

Codex CLI 역시 Node.js 환경이 필요하므로, 먼저 버전을 확인하는 것을 권장합니다:

node -v
npm -v

2. Codex CLI 전역 설치

터미널에서 다음 명령어를 실행하여 Codex를 설치하세요:

npm install -g @openai/codex

3. Codex 설치 성공 여부 확인

아래 명령어를 실행하여 버전 번호가 정상적으로 출력되거나 Codex가 실행되면 됩니다:

codex --version
codex

연동 방법 1: CC-Switch(권장)

설치가 끝나면 바로 CC-Switch 튜토리얼로 이어서 진행하면 됩니다. CC-Switch에서 Codex를 선택하고 요청 주소에 https://api.nexthub.cc/v1를 입력한 뒤(OpenAI Responses 프로토콜은 /v1이 필요합니다), ApiKey를 입력하면 GPT-Azure 그룹(0.47x)을 통해 사용할 수 있습니다.

연동 방법 2: 수동 설정

설정 도구를 사용하고 싶지 않다면 Codex의 설정 파일 두 개를 직접 편집하면 됩니다.

1. Codex 설정 디렉터리 열기

Windows (CMD)

start "" "%USERPROFILE%\.codex"

macOS (Terminal)

open "$HOME/.codex"

디렉터리에 해당 파일이 없으면 직접 생성하세요.

2. config.toml 설정

다음 내용을 ~/.codex/config.toml에 작성하세요:

model = "gpt-5.6"
model_provider = "nexthub"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.nexthub]
name = "nexthub"
base_url = "https://api.nexthub.cc/v1"
wire_api = "responses"
requires_openai_auth = true

요청 주소에 /v1이 필요합니다

Codex는 OpenAI Responses 프로토콜(/v1/responses)을 사용하므로 base_url에 /v1이 포함되어야 합니다. model에는 필요에 따라 GPT-Azure / GPT-Pro 그룹이 제공하는 모델 ID(예: gpt-5.6, gpt-6-astra)를 입력하며, 모델 광장의 실시간 데이터를 기준으로 합니다.

3. auth.json 설정

ApiKey를 ~/.codex/auth.json에 작성하세요(GPT-Azure 또는 GPT-Pro 그룹의 API 키):

{
  "OPENAI_API_KEY": "당신의 NextHub ApiKey"
}

4. 검증

터미널에서 codex를 실행하고 테스트 메시지를 하나 보내세요. 화면 상단에 선택한 모델이 표시되고 정상적으로 응답이 오면 연동에 성공한 것입니다.

전역 프롬프트

~/.codex/AGENTS.md는 Codex의 전역 프롬프트 파일이며, 존재하지 않으면 자동으로 생성됩니다. 필요에 따라 작업 규칙을 작성해 두세요.