Skip to content

Codex 설치 및 설정 가이드

Fast-Token에서 Codex 사용하기

Windows 버전

시스템 요구 사항

  • Windows 10 또는 Windows 11
  • Node.js 22+
  • npm 10+
  • 네트워크 연결

설치 단계

사전 준비: Git Bash를 설치합니다. Git - Downloads에서 PC에 맞는 버전을 받아 「다음」을 반복해 설치를 완료합니다.

1. Node.js 설치

Node.js 공식 사이트에서 최신 LTS를 받아 설치합니다.

2. codex 설치

명령 프롬프트(CMD) 또는 PowerShell에서 실행:

bash
npm install -g @openai/codex

3. 설치 확인

명령 프롬프트(CMD) 또는 PowerShell에서 실행:

bash
codex --version

API 구성

1. Auth Token 발급

Fast-Token 플랫폼에서 다음을 진행합니다.

  • 콘솔 → API 토큰 페이지로 이동
  • 토큰 추가 클릭
  • 토큰 그룹: codex专属 선택(반드시 이 그룹, 아니면 사용 불가)
  • 토큰 이름: 임의
  • 할당량: 무제한 권장
  • 기타 옵션: 기본값 유지

API 토큰 생성

2. 설정 파일

중요: 아래 sk-xxx를 Fast-Token 플랫폼에서 생성한 실제 API 키로 바꿉니다.

  1. 사용자 홈의 .codex 폴더로 이동합니다. 예: C:\Users\testuser\.codex. (참고: 폴더가 보이지 않으면 탐색기에서 「숨긴 항목 표시」를 켜세요.)

.codex 폴더 열기

  1. .codex 폴더가 없으면 만들고, 그 안에 config.tomlauth.json을 생성합니다.

설정 파일 생성

  1. 설정 입력 (sk-xxx를 실제 SK로 교체).

a. auth.json:

json
{"OPENAI_API_KEY": "sk-xxx"}

b. config.toml (아래 내용을 그대로 붙여넣기):

model_reasoning_effort 선택 값은 high, medium, low이며, 각각 모델 추론 노력도(높음·중간·낮음)를 뜻합니다.

toml
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://fast-token.com/v1"
wire_api = "responses"

codex 실행

터미널을 재시작하세요! 터미널을 재시작하세요! 터미널을 재시작하세요!

프로젝트 디렉터리로 이동:

bash
cd your-project-folder

다음으로 실행:

bash
codex

codex 실행

VSCode 확장 codex

위 설정이 끝나면 VSCode 확장 마켓에서 codex를 검색해 설치합니다.

VSCode 확장 설치

설치 후 사이드바에 표시됩니다.

확장 사이드바

Mac 버전

시스템 요구 사항

  • macOS 12 이상
  • Node.js 22+
  • npm 10+
  • 네트워크 연결

설치 단계

1. Node.js 설치

bash
# Homebrew가 없으면 먼저 실행
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Node.js 설치
brew install node

2. codex 설치

터미널에서 실행(필요 시 sudo):

bash
npm install -g @openai/codex

3. 설치 확인

터미널에서 실행:

bash
codex --version

API 구성

1. Auth Token 발급

Fast-Token 플랫폼에서 다음을 진행합니다.

  • 콘솔 → API 토큰 페이지로 이동
  • 토큰 추가 클릭
  • 토큰 그룹: codex特供 선택(반드시 이 그룹, 아니면 사용 불가)
  • 토큰 이름: 임의
  • 할당량: 무제한 권장
  • 기타 옵션: 기본값 유지

API 토큰 생성

2. 설정 파일

중요: 아래 sk-xxx를 Fast-Token 플랫폼에서 생성한 실제 API 키로 바꿉니다.

  1. 디렉터리와 파일 생성:
bash
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  1. auth.json 편집:
bash
vi ~/.codex/auth.json

i로 삽입 모드에 들어가 아래를 붙여넣고(sk-xxx를 본인 키로 교체), ESC:wq로 저장·종료.

json
{ "OPENAI_API_KEY": "sk-xxx" }
  1. config.toml 편집:
bash
vi ~/.codex/config.toml

i로 삽입 모드에 들어가 아래를 붙여넣고, ESC:wq로 저장·종료.

toml
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://fast-token.com/v1"
wire_api = "responses"

codex 실행

터미널을 재시작하세요! 터미널을 재시작하세요! 터미널을 재시작하세요!

프로젝트 디렉터리로 이동:

bash
cd your-project-folder

다음으로 실행:

bash
codex

codex 실행

VSCode 확장 codex

위 설정이 끝나면 VSCode 확장 마켓에서 codex를 검색해 설치합니다.

VSCode 확장 설치

설치 후 사이드바에 표시됩니다.

확장 사이드바

Linux 버전

시스템 요구 사항

  • 주요 Linux 배포판(Ubuntu 20.04+, Debian 10+, CentOS 7+ 등)
  • Node.js 22+
  • npm 10+
  • 네트워크 연결

설치 단계

1. Node.js 설치

  • Ubuntu/Debian
bash
sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
  • CentOS/RHEL/Fedora
bash
# dnf(Fedora) 또는 yum(CentOS/RHEL)
sudo dnf install nodejs npm
# 또는
sudo yum install nodejs npm
  • Arch Linux
bash
sudo pacman -S nodejs npm

2. codex 설치

터미널에서 실행:

bash
sudo npm install -g @openai/codex

3. 설치 확인

터미널에서 실행:

bash
codex --version

API 구성

1. Auth Token 발급

Fast-Token 플랫폼에서 다음을 진행합니다.

  • 콘솔 → API 토큰 페이지로 이동
  • 토큰 추가 클릭
  • 토큰 그룹: codex渠道-gpt 선택(반드시 이 그룹, 아니면 사용 불가)
  • 토큰 이름: 임의
  • 할당량: 무제한 권장
  • 기타 옵션: 기본값 유지

API 토큰 생성

2. 설정 파일

중요: 아래 sk-xxx를 Fast-Token 플랫폼에서 생성한 실제 API 키로 바꿉니다.

  1. 디렉터리와 파일 생성:
bash
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  1. auth.json 편집:
bash
vi ~/.codex/auth.json

i로 삽입 모드에 들어가 아래를 붙여넣고(sk-xxx를 본인 키로 교체), ESC:wq로 저장·종료.

json
{ "OPENAI_API_KEY": "sk-xxx" }
  1. config.toml 편집:
bash
vi ~/.codex/config.toml

i로 삽입 모드에 들어가 아래를 붙여넣고, ESC:wq로 저장·종료.

toml
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://fast-token.com/v1"
wire_api = "responses"

codex 실행

터미널을 재시작하세요! 터미널을 재시작하세요! 터미널을 재시작하세요!

프로젝트 디렉터리로 이동:

bash
cd your-project-folder

다음으로 실행:

bash
codex

codex 실행

VSCode 확장 codex

위 설정이 끝나면 VSCode 확장 마켓에서 codex를 검색해 설치합니다.

VSCode 확장 설치

설치 후 사이드바에 표시됩니다.

확장 사이드바

자주 묻는 질문

오류가 나면 다음 순서로 확인하세요.

  1. API Key 생성이 맞는지 확인: 할당량은 무제한, 모델 제한 없음, 그룹은 codex渠道-gpt를 선택.

Codex 추가 설정·사용 방법은 codex 공식 튜토리얼을 참고하세요.