Codex 설정

이 가이드에서는 Codex를 Modelflare에 연결하고 첫 번째 요청을 실행합니다. 자동 설정을 위해서는 옵션 A를 사용하세요. 옵션 B를 사용하여 먼저 Codex를 설치한 다음 필요한 각 파일을 직접 만드세요.

1. API 키 생성

Modelflare 콘솔에 로그인하고 API 키를 열고 gpt-5.6-sol에 액세스할 수 있는 키를 만듭니다. 모델을 나열하는 사용 가능한 기본이 아닌 그룹을 선택하십시오. 단일 필수 그룹은 없습니다.

열쇠를 준비하세요. 설치 프로그램을 사용하거나 동일한 파일을 수동으로 구성할 수 있습니다.

2. 설정방법을 선택하세요

옵션 A: 설치 프로그램 실행

아직 단말기가 불편하신가요? 대화형 첫 실행 가이드로 시작하세요. 이것은 단지 시각적인 리허설일 뿐이며 컴퓨터를 바꾸지는 않습니다.

macOS 또는 Linux

일반 사용자로 다음 명령을 실행하세요.

bash

curl -fsSL https://modelflare.dev/install/codex.sh | sh

이미 VPS 또는 컨테이너에 root으로 로그인한 경우 다음을 사용하세요.

bash

curl -fsSL https://modelflare.dev/install/codex.sh | MODELFLARE_ALLOW_ROOT=1 sh

일반 개인용 컴퓨터에는 sudo을 추가하지 마십시오. 스크립트는 Codex를 설치 또는 업데이트하고, 기존 파일을 백업하고, Modelflare API 키를 요청하고, ~/.codex 아래에 공급자 구성을 작성합니다.

윈도우 파워셸

일반 Windows 사용자로 PowerShell을 열고 다음을 실행합니다.

PowerShell

irm https://modelflare.dev/install/codex.ps1 | iex

설치 프로그램은 언어와 Modelflare API 키를 요청하고, gpt-5.6-sol에 대한 액세스를 확인하고, 기존 파일을 변경하기 전에 백업합니다. 완료되면 연결 확인을 계속 진행하세요.

옵션 B: 각 Codex 파일을 직접 생성

Modelflare 설정 스크립트를 실행하지 않으려면 이 옵션을 사용하세요. 순서대로 단계를 따르고 모든 단계에서 운영 체제에 맞는 명령 블록을 사용하십시오.

옵션 B는 사용자 수준 .codex 디렉터리에 config.toml 및 auth.json라는 두 개의 파일을 생성합니다.

1단계: Codex CLI 설치

윈도우 파워셸

PowerShell

irm https://chatgpt.com/codex/install.ps1 | iex
codex --version

리눅스

bash

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

맥OS

bash

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

2단계: .codex 디렉터리 생성 및 입력

윈도우 파워셸

PowerShell

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Location "$HOME\.codex"

리눅스

bash

mkdir -p ~/.codex
cd ~/.codex

맥OS

bash

mkdir -p ~/.codex
cd ~/.codex

3단계: config.toml 생성

윈도우 파워셸

PowerShell

$config = @'
cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "config.toml"),
  $config,
  $utf8NoBom
)

리눅스

bash

cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
chmod 600 config.toml

맥OS

bash

cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
chmod 600 config.toml

4단계: auth.json 생성

JSON 개체의 YOUR_MODELFLARE_API_KEY을 Modelflare 콘솔에서 생성한 전체 API 키로 바꿉니다. 이 파일은 유효한 JSON으로 유지되어야 하며 OPENAI_API_KEY 필드를 사용해야 합니다. 공급자 auth 명령 블록을 추가하지 마십시오. 현재 Codex 릴리스에는 이 API 키 경로에 requires_openai_auth = true가 필요합니다.

윈도우 파워셸

PowerShell

$authJson = @'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "auth.json"),
  $authJson,
  $utf8NoBom
)

리눅스

bash

cat > auth.json << 'EOF'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
EOF
chmod 600 auth.json

맥OS

bash

cat > auth.json << 'EOF'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
EOF
chmod 600 auth.json

5단계: Codex 시작

윈도우 파워셸

PowerShell

Set-Location $HOME
New-Item -ItemType Directory -Force "my-codex-project" | Out-Null
Set-Location "my-codex-project"
codex --model gpt-5.6-sol

리눅스

bash

cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol

맥OS

bash

cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol

3. 연결 확인

설치 프로그램을 사용한 경우 이미 열려 있는 Codex CLI, IDE 또는 데스크톱 세션을 완전히 닫습니다. 새 터미널을 열고 프로젝트 디렉터리를 입력한 후 다음을 실행합니다.

bash

codex --model gpt-5.6-sol

설정을 마친 후 Codex 앱을 다운로드할 수도 있습니다.

그런 다음 Codex에 문의하세요.

Text

Reply with one sentence confirming the active model and provider.

정상적인 응답은 설정이 완료되었음을 의미합니다.

일반적인 문제

증상	해야 할 일
401	API 키를 다시 복사하고 삭제되거나 비활성화되지 않았는지 확인하세요.
model_not_found	API 키를 편집하고 gpt-5.6-sol에 접근할 수 있는 그룹을 선택하세요.
ChatGPT 로그인이 나타납니다	모든 Codex 세션을 완전히 종료하고 CLI를 다시 엽니다.
codex을 찾을 수 없습니다	새 터미널을 엽니다. Windows에서는 codex.cmd을 사용해 보세요.