Codex Desktop

​

1. 사전 준비

• Codex 인터페이스를 정상적으로 열 수 있는 앱이 설치되어 있어야 합니다.
• GravitexAI 계정에 충분한 잔액이 있어야 합니다.
• API 키의 그룹이 대상 GPT 모델과 Responses API를 지원해야 합니다.

ls /Applications/ChatGPT.app
/Applications/ChatGPT.app/Contents/Resources/codex-cli/bin/codex --version

​

2. API 키와 모델 권한 확인

curl https://api.gravitex.ai/v1/responses \
  -H "Authorization: Bearer sk-your-gravitex-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","input":"say ok"}'

$headers = @{ Authorization = "Bearer sk-your-gravitex-key" }
$body = @{ model = "gpt-6.1-sol"; input = "say ok" } | ConvertTo-Json
Invoke-RestMethod -Uri "https://api.gravitex.ai/v1/responses" -Method Post -Headers $headers -ContentType "application/json" -Body $body

​

3. 공급자 설정

mkdir -p ~/.codex
if [ -f ~/.codex/config.toml ]; then
  cp ~/.codex/config.toml ~/.codex/config.toml.backup-$(date +%Y%m%d-%H%M%S)
fi
nano ~/.codex/config.toml

$codexConfigDir = Join-Path $env:USERPROFILE ".codex"
if ($env:CODEX_HOME) { $codexConfigDir = $env:CODEX_HOME }
New-Item -ItemType Directory -Path $codexConfigDir -Force | Out-Null
$codexConfigPath = Join-Path $codexConfigDir "config.toml"
if (Test-Path $codexConfigPath) {
  Copy-Item $codexConfigPath "$codexConfigPath.backup-$(Get-Date -Format yyyyMMdd-HHmmss)"
} else {
  New-Item -ItemType File -Path $codexConfigPath | Out-Null
}
notepad $codexConfigPath

model = "gpt-6.1-sol"
model_provider = "gravitex"
model_reasoning_effort = "medium"

[model_providers.gravitex]
name = "GravitexAI"
base_url = "https://api.gravitex.ai/v1"
wire_api = "responses"

[model_providers.gravitex.http_headers]
Authorization = "Bearer sk-your-gravitex-key"
Content-Type = "application/json"

• macOS: Command + Q를 사용하세요.
• Windows: 앱 메뉴의 종료 명령을 사용하고 시스템 트레이에 남아 있다면 트레이 메뉴에서도 종료하세요. 필요하면 작업을 저장한 뒤 작업 관리자에서 해당 앱과 남은 Codex 프로세스를 종료하고 시작 메뉴에서 다시 여세요.

​

4. CC Switch로 연결

1. CC Switch 가이드에 따라 설치하고 Codex 페이지에서 GravitexAI 공급자를 추가하세요.
2. API 키, Base URL https://api.gravitex.ai/v1, 검증된 GPT 모델 ID(예: gpt-6.1-sol)를 입력하세요. 프로토콜 선택 항목이 있다면 Responses를 선택하세요.
3. 저장 후 현재 공급자로 전환하세요. CODEX_HOME을 포함해 데스크톱 앱과 같은 사용자 설정 디렉터리에 기록되는지 확인하세요.
4. Codex Desktop을 완전히 종료하고 다시 연 뒤 아래 절차로 채팅과 도구를 검증하세요.

​

5. Magpie로 연결

1. Magpie 가이드에 따라 설치하고 gravitex 공급자에 GravitexAI 키 및 Responses 기본 주소 https://api.gravitex.ai/v1을 설정하세요. 스크린샷의 공급자 ID는 gravitexai이고 아래 명령은 gravitex를 사용합니다. 스크린샷과 같은 ID를 사용한다면 명령도 바꾸세요. 예: magpie codex gravitexai/gpt-6.1-sol.
2. Codex Desktop을 완전히 종료하고 설정을 백업하세요.
3. 아래 명령에서 공급자 및 모델 ID를 실제 사용 가능한 값으로 바꾸어 실행하세요.

magpie ls
magpie provider set gravitex responses=https://api.gravitex.ai/v1
magpie codex gravitex/gpt-6.1-sol

magpie.exe ls
magpie.exe provider set gravitex responses=https://api.gravitex.ai/v1
magpie.exe codex gravitex/gpt-6.1-sol

4. 또는 Magpie의 Agent 페이지에서 Codex 연결을 활성화하고 GravitexAI 모델을 선택하세요. 데스크톱 앱이 사용하는 Codex 디렉터리와 일치하는지 확인하세요.
5. Magpie를 실행한 상태로 Codex Desktop을 다시 열고 채팅과 도구를 검증하세요. 연결 실패 시 기본 게이트웨이 포트 3425, 로컬호스트 프록시 및 상위 공급자 권한을 확인하세요.

​

6. 연결 확인

1. 로컬 프로젝트를 열고 새 채팅을 만드세요. 모델 또는 공급자를 확인하세요. 버전에 따라 Custom으로 표시될 수 있으며 표시 이름만으로 연결을 판단하지 마세요.
2. hello를 보내 정상 응답을 확인하세요.
3. “현재 디렉터리의 파일을 나열해 줘”라고 요청하세요. 파일 또는 터미널 도구가 실행되고 결과를 바탕으로 답변하는지 확인하세요. 필요한 로컬 권한을 허용하세요.
4. GravitexAI 콘솔에서 해당 요청의 모델 및 사용량을 확인하세요.

​

7. 문제 해결

​

8. 선택 설정 및 주의 사항

• 모델 변경 시 최상위 model을 수정하고 사용 권한을 검증한 뒤 재시작하세요.
• 모델이 지원하는 범위에서 model_reasoning_effort를 low, medium, high로 설정하세요. 높은 강도는 보통 시간과 토큰을 더 사용하며 더 나은 결과를 보장하지 않습니다.
• 원래 설정은 백업으로 복원하세요. 공식 공급자로 돌아가려면 최상위 model_provider = "openai"와 공식 계정에서 사용 가능한 모델을 설정하고 재시작 후 로그인하세요.
• 키를 저장소나 공개 스크린샷에 포함하지 마세요. 유출 시 즉시 폐기하고 재발급하세요.
• 클라우드 작업과 플러그인 등의 기능은 클라이언트, 계정 및 공급자 지원에 따라 달라집니다.

​

9. 참고 자료

• Codex CLI 가이드
• GravitexAI API 키
• GravitexAI 모델 카탈로그
• OpenAI 설정 참고 문서
• Windows desktop configuration
• CC Switch documentation
• Magpie reference