메인 콘텐츠로 건너뛰기
모델 요청에는 DGrid Model API Key를 사용하세요. Management API Key는 관리용 자격 증명이므로 이 가이드에 사용할 수 없습니다. 키에 사용 가능한 잔액과 선택한 모델의 접근 권한이 있는지 확인하세요.
API 키, Responses API Base URL 및 전체 모델 ID로 Codex CLI 또는 데스크톱 앱의 Codex를 DGrid에 연결합니다. 현재 데스크톱 다운로드는 Codex가 포함된 ChatGPT 데스크톱 앱입니다. 기존 설치에서는 Codex라는 이름이 남아 있을 수 있습니다. 공식 다운로드 페이지에서 앱을 받으세요. 이 가이드는 openai/gpt-6-sol을 사용합니다. 스크린샷과 데스크톱 상세 절차는 macOS 기준이며 Windows 설치 및 CLI 안내도 포함합니다.

시작하기 전에

  • 사용 가능한 잔액과 Responses API 지원 모델의 접근 권한이 있는 DGrid 계정이 필요합니다.
  • DGrid에 로그인하여 API Keys에서 API 키를 만들거나 복사하세요.
  • npm 설치에는 Node.js와 npm이 필요합니다. 데스크톱 앱은 CLI와 독립적으로 사용할 수 있습니다.
스크린샷과 공유 파일에 전체 키를 노출하지 마세요. openai/ 접두사를 포함한 전체 모델 ID를 유지하세요.
모델 메타데이터 또는 카탈로그 오류가 발생하면 Codex 버전에 맞는 카탈로그 설정을 DGrid에 문의하세요. 사용자 지정 모델 별칭에는 해당 메타데이터가 필요할 수 있습니다. 카탈로그 URL을 추측하지 마세요. 공식 게이트웨이 설정 안내를 참고하세요.

설정 방법 선택

CLI 프로필은 해당 프로필로 시작한 실행에서 DGrid를 선택합니다. 데스크톱 기본 파일을 수정하면 이 파일을 읽는 클라이언트의 기본 공급자가 바뀝니다. 현재 데스크톱 환경을 업무에 사용 중이라면 다른 컴퓨터에서 데스크톱 절차를 진행하세요. 두 방법 모두 다음 연결 설정을 사용합니다.

1. Node.js 및 Codex CLI 설치

필요하면 Node.js 다운로드 페이지에서 현재 LTS 버전을 설치하세요. macOS 또는 Windows용 설치 프로그램을 실행하세요. 표준 설치 프로그램에는 npm이 포함됩니다.macOS 터미널 또는 Windows PowerShell에서 확인하세요.
공식 Codex npm 설치 방법에 따라 설치하세요.macOS: 사용자 디렉터리에 설치하세요.
PATH 명령은 현재 터미널에만 적용됩니다. 새 터미널에서 다시 실행하거나 셸 PATH 설정에 디렉터리를 추가하세요.
PowerShell이 npm.ps1을 차단하면 npm 대신 npm.cmd를 사용하세요.CLI 스크린샷은 codex-cli 0.163.0을 사용합니다. 아래 독립 프로필 파일 형식은 Codex 0.134.0 이상에 적용됩니다. 프로필 설정을 참고하세요.

2. DGrid 프로필 생성

macOS에서 ~/.codex/dgrid.config.toml, Windows에서 %USERPROFILE%\.codex\dgrid.config.toml을 만드세요. 다음 내용을 붙여넣으세요.
macOS에서는 다음 명령으로 파일을 만들고 열 수 있습니다.
프로필이 이미 있으면 해당 설정을 수정하세요. 일반 텍스트로 저장하고 곧은 따옴표를 사용하세요. env_key는 변수 이름이므로 DGRID_API_KEY로 유지하세요.
터미널에서 Codex CLI 설치 및 별도 DGrid 프로필 생성

터미널에서 Codex CLI 설치 및 별도 DGrid 프로필 생성

3. API 키 입력

Codex를 시작할 동일한 터미널을 사용하세요.
프롬프트에 키를 붙여넣고 Enter를 누르세요. 입력한 문자는 표시되지 않습니다. 터미널 프롬프트가 돌아온 뒤 다음 명령을 실행하세요.Windows PowerShell: 첫 줄을 실행하고 숨겨진 입력 프롬프트에 키를 입력한 다음 나머지 줄을 실행하세요.
현재 터미널 세션에 키가 설정됩니다. 새 터미널에서는 다시 입력해야 합니다.

4. Codex 시작 및 메시지 전송

macOS에서 실행하세요.
Windows PowerShell에서 실행하세요.
폴더 신뢰 여부를 물으면 방금 만든 예제 폴더를 신뢰하도록 선택하세요. 선택한 모델이 openai/gpt-6-sol인지 확인하세요. /status로 세션을 확인할 수도 있습니다.다음을 보내세요.
예상 응답은 다음과 같습니다.
DGrid 모델을 선택하고 응답을 표시하는 Codex CLI

DGrid 모델을 선택하고 응답을 표시하는 Codex CLI

시작 시 Running without the shared background server: --profile requires embedded mode.가 표시되면 프로필 세션의 실행 방식에 대한 안내입니다. F2로 확인하고 Esc로 닫은 다음 계속하세요. 일부 Mac 키보드는 Fn + F2를 사용합니다.

DGrid에서 요청 확인

DGrid 요청 기록에서 요청 시간과 전체 모델 ID가 일치하는 항목을 찾으세요. 완료된 요청에는 Success 상태가 표시됩니다.
openai/gpt-6-sol과 Success가 표시된 DGrid 요청 기록. Key Name은 흐림 처리됨

openai/gpt-6-sol과 Success가 표시된 DGrid 요청 기록. Key Name은 흐림 처리됨

개인정보 보호를 위해 Key Name을 흐림 처리했습니다. 토큰 수와 비용은 모델 및 Codex가 보내는 컨텍스트에 따라 달라집니다.

문제 해결

Codex 설정 참고 문서에서 공급자 설정을 확인할 수 있습니다. 이 가이드는 연결 및 응답 수신을 다룹니다. 도구, 웹 검색 및 긴 에이전트 작업은 선택한 모델과 게이트웨이의 지원 범위에 따라 달라집니다.

관련 자료