Codex 설정
Codex는 OpenAI의 코딩 어시스턴트입니다.
먼저 환경 설정 장을 완료하고 Node.js와 npm이 설치되어 있는지 확인하세요.
설치 후 모델, Provider, 권한, 세션 및 토큰 사용량은 Codex config.toml 고급 가이드를 참고하세요.
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.6-sol"
cli_auth_credentials_store = "file"
suppress_unstable_features_warning = true
personality = "pragmatic"
[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
wire_api = "responses"
requires_openai_auth = true
현재 네트워크에서 api.icodeeasy.cc가 느리면 base_url을 https://jp.icodeeasy.cc 또는 https://sg.icodeeasy.cc로 변경하세요.
4단계: 로그인하고 auth.json 생성
API Keys에서 API Key를 복사한 뒤 아래 명령을 실행하세요. 키를 붙여넣고 Enter를 누르면 됩니다. 입력은 표시되지 않으며 셸 시작 파일에도 저장되지 않습니다.
read -s OPENAI_API_KEY
printf '\n'
printf '%s' "$OPENAI_API_KEY" | codex login --with-api-key
unset OPENAI_API_KEY
codex login status
Codex는 자격 증명을 ~/.codex/auth.json에 저장합니다. 이 파일을 직접 만들거나 편집하지 마세요. config.toml은 모델과 Provider를, auth.json은 로그인 자격 증명만 관리합니다. 두 파일을 현재 사용자만 읽고 쓸 수 있게 제한하세요.
chmod 600 ~/.codex/config.toml ~/.codex/auth.json
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.6-sol"
cli_auth_credentials_store = "file"
suppress_unstable_features_warning = true
personality = "pragmatic"
[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
wire_api = "responses"
requires_openai_auth = true
[features]
elevated_windows_sandbox = true
현재 네트워크에서 api.icodeeasy.cc가 느리면 base_url을 https://jp.icodeeasy.cc 또는 https://sg.icodeeasy.cc로 변경하세요.
4단계: 로그인하고 auth.json 생성
API Keys에서 API Key를 복사한 뒤 실행하세요.
$secureKey = Read-Host "API Key" -AsSecureString
$plainKey = [System.Net.NetworkCredential]::new("", $secureKey).Password
$plainKey | codex login --with-api-key
$plainKey = $null
codex login status
Codex는 자격 증명을 $env:USERPROFILE\.codex\auth.json에 저장합니다. 파일을 직접 편집하거나 영구 사용자 환경 변수 OPENAI_API_KEY를 설정할 필요가 없습니다.
5단계: Codex 시작
새 PowerShell 창을 열고 프로젝트 디렉터리로 이동한 뒤 시작합니다:
cd your-project-folder
codex
VSCode
먼저 Codex CLI 설정을 완료하고 codex login status가 성공하는지 확인하세요. VSCode 확장은 같은 config.toml과 Codex 로그인 캐시를 재사용합니다.
1단계: Codex 설치 Extension
VSCode 확장 마켓플레이스에서 Codex를 검색해 설치합니다.
2단계: 설정 파일 열기
Codex VSCode 확장은 사용자 디렉터리의 .codex/config.toml을 재사용합니다. 위의 Linux / MacOS 또는 Windows 절차에 따라 .codex 폴더와 config.toml을 만드세요.
3단계: API Key 설정
일반적으로 API Key를 다시 입력할 필요가 없습니다. 로그인 안내가 계속되면 VSCode 통합 터미널에서 codex login status를 실행한 뒤 Developer: Reload Window를 실행하세요.