Codex 설정

Codex는 OpenAI의 코딩 어시스턴트입니다.

먼저 환경 설정 장을 완료하고 Node.js와 npm이 설치되어 있는지 확인하세요.

Linux / MacOS

1단계: Codex 설치

npm install -g @openai/codex@latest

2단계: 설정 폴더 생성

홈 디렉터리 아래에 .codex 폴더를 만듭니다.

mkdir -p ~/.codex

3단계: config.toml 생성

.codex 안에 config.toml을 만들고 다음 내용을 붙여넣습니다:

model_provider = "icodeeasy"
model = "gpt-5.3-codex"
disable_response_storage = true
suppress_unstable_features_warning = true
preferred_auth_method = "apikey"
personality = "pragmatic"

[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = true

현재 네트워크에서 api.icodeeasy.cc가 느리면 base_url을 https://jp.icodeeasy.cc로 변경하세요.

4단계: 환경 변수 설정

~/.bashrc 또는 ~/.zshrc에 추가합니다:

export OPENAI_API_KEY="your API Key"
export OPENAI_BASE_URL="https://api.icodeeasy.cc"

현재 네트워크에서 api.icodeeasy.cc가 느리면 OPENAI_BASE_URL을 https://jp.icodeeasy.cc로 변경하세요.

파일을 저장한 뒤 source ~/.bashrc 또는 source ~/.zshrc를 실행합니다.

5단계: Codex 시작

cd your-project-folder
codex

Windows

1단계: Codex 설치

npm install -g @openai/codex@latest

2단계: 설정 폴더 생성

사용자 디렉터리를 확인합니다:

echo $env:USERPROFILE

.codex 폴더를 만듭니다:

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

3단계: config.toml 생성

.codex 안에 config.toml을 만들고 다음 내용을 붙여넣습니다:

model_provider = "icodeeasy"
model = "gpt-5.3-codex"
disable_response_storage = true
suppress_unstable_features_warning = true
preferred_auth_method = "apikey"
personality = "pragmatic"

[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = true

[features]
elevated_windows_sandbox = true

현재 네트워크에서 api.icodeeasy.cc가 느리면 base_url을 https://jp.icodeeasy.cc로 변경하세요.

4단계: PowerShell에서 API Key 설정

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "your API Key", "User")

설정 후 새 PowerShell 창을 여세요.

5단계: Codex 시작

새 PowerShell 창을 열고 프로젝트 디렉터리로 이동한 뒤 시작합니다:

cd your-project-folder
codex

VSCode

먼저 Codex CLI 설정을 완료하고 명령줄에서 Codex가 시작되는지 확인하세요. VSCode 확장은 같은 .codex/config.toml 파일과 시스템 환경 변수를 사용합니다.

1단계: Codex 설치 Extension

VSCode 확장 마켓플레이스에서 Codex를 검색해 설치합니다.

2단계: 설정 파일 열기

Codex VSCode 확장은 사용자 디렉터리의 .codex/config.toml을 재사용합니다. 위의 Linux / MacOS 또는 Windows 절차에 따라 .codex 폴더와 config.toml을 만드세요.

3단계: API Key 설정

VSCode 확장이 API Key를 요청하면 API Keys 페이지에서 복사해 붙여넣으세요.