Source: https://aiprimetech.io/ko/docs/guides/codex-cli/

[문서](/ko/docs/) / [Codex API](/ko/codex-api/)

# Codex CLI: API 키 및 사용자 지정 공급자 설정 

이 가이드를 따라 로컬 Codex CLI 작업을 AI Prime Tech에 연결하세요. 게이트웨이 계정, 사용할 Codex 그룹의 활성 키, 해당 키로 이용할 수 있는 모델이 필요합니다. 아직 이용 유형을 선택하는 중이라면 먼저 다음 문서를 확인하세요: [Codex API 개요](/ko/codex-api/) 아직 이용 유형을 선택하는 중이라면 이 문서부터 확인하세요. 

## 1. 키 및 그룹 확인 

대시보드에서 키를 생성하세요. 선불 GPT 이용에는 다음 그룹을 사용합니다: Codex 그룹입니다. 기간제 Codex 이용권이 제공되는 경우, 해당 요금제에 표시된 그룹과 조건을 따르세요. Claude 이용 권한은 별개입니다. 사용할 키의 모델 목록을 확인하세요. 

현재 터미널에서 키를 설정하세요. 플레이스홀더를 로컬에서 실제 키로 바꾸고, 키를 저장소에 커밋하지 마세요. 

PowerShell 

```
$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

```

bash 또는 zsh 

```
export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

```

환경 변수를 설정하기 전에 실행한 터미널이나 편집기에서 해당 변수를 인식하지 못하면 다시 시작하세요. 이 예제는 현재 프로세스와 하위 프로세스에 변수를 설정합니다. 

## 2. 공급자 구성 

이 구성을 다음 사용자 수준 파일에 병합하세요: ~/.codex/config.toml. Windows에서 이에 해당하는 경로는 다음과 같습니다: %USERPROFILE%\.codex\config.toml. 공급자 인증 정보는 저장소의 구성 파일이 아닌 사용자 구성에 저장해야 합니다: .codex/config.toml. 

```
model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

```

다음과 같은 공급자 ID를 사용하세요: aiprimetech 그리고 다음 항목이 model_provider 해당 테이블과 일치하도록 유지하세요. 현재 Codex는 Responses 프로토콜을 사용합니다. 기본 URL은 게이트웨이의 다음 루트입니다: /v1 루트이며, Codex가 요청 경로를 추가합니다. 이 구성은 HTTP/SSE 전송을 사용합니다. 

## 3. 연결 확인 

다음 명령을 실행하세요: codex doctor CLI 구성을 확인합니다. 다음을 시작하세요: codex, 그런 다음 다음 명령을 사용하세요: /status 공급자와 모델을 확인합니다. 더 큰 규모의 저장소 작업을 허용하기 전에 짧은 답변을 요청하세요. AI Prime Tech 사용량 페이지에 요청이 표시되는지 확인하세요. 

Codex와 별개로 키의 모델 목록을 확인할 수 있습니다: 

```
Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

```

```
curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

```

반환된 목록에 모델이 포함되어 있지만 요청이 실패한다면 실제 오류와 현재 그룹의 이용 가능 여부를 확인하세요. ID가 목록에 있다는 사실만으로 추론 테스트가 성공한 것은 아닙니다. 

## 선택적으로 CLI 프로필 유지하기 

특정 CLI 세션에서만 이 공급자를 선택하려면 위 구성을 다음 위치에 저장하세요: ~/.codex/aiprimetech.config.toml 그런 다음 다음 명령으로 실행하세요: 

```
codex --profile aiprimetech

```

Codex 0.134.0 이상에서는 CLI 프로필에 별도의 파일을 사용합니다. 이전의 [profiles.aiprimetech] 예제는 현재 프로필 형식이 아닙니다. IDE 확장 프로그램은 사용자 수준 구성을 사용합니다. CLI 프로필 전환이 IDE에도 적용되었다고 가정하지 말고, 확장 프로그램을 다시 시작한 후 활성 공급자를 확인하세요. 

## 모델 선택 

다음을 사용하세요: gpt-6.1-sol 코딩을 시작할 때 사용하고, gpt-6-astra 까다로운 작업에 사용하거나, gpt-6-luna 집중적인 작업에 사용하세요. gpt-6-sol 는 기존 Sol 워크플로를 위한 별도의 ID입니다. 참고: [모델 세부 정보](/ko/openai-api/) 및 [비교 방법](/ko/blog/gpt-6-models-for-codex/). 

## 문제 해결 

  | 증상  | 확인할 항목:    

  | 환경 변수 누락  | 설정할 항목: AIPRIMETECH_API_KEY Codex를 실행하는 프로세스에서.  

  | 401 인증 오류  | 키가 활성 상태인지, 전체가 복사되었는지, 이 게이트웨이에서 발급되었는지 확인하세요.  

  | 403 또는 사용할 수 없는 모델  | 키 그룹, 요금제의 접근 권한, 정확한 모델 ID를 확인하세요.  

  | 404 또는 HTML 응답  | 다음을 사용하세요: https://aiprimetech.io/v1; 중복된 항목을 제거하세요: /v1 또는 뒤에 추가된 /responses.  

  | wire_api 거부됨  | 다음을 사용하세요: responses; 이전 chat 제공자 예제는 더 이상 유효하지 않습니다.  

  | 잔액, 요금제 또는 요청 한도 오류  | 오류를 읽고 계정을 확인한 다음, 동시 작업 수를 줄인 후 다시 시도하세요.  

  | 응답 도중 연결 종료  | 짧은 요청 하나를 시도하고, 네트워크 및 프록시 연결을 확인하고, 지원 문의를 위해 요청 ID를 기록하세요.    

## Claude 및 호스팅된 Codex 기능 

게이트웨이의 Responses 변환을 통해 Claude를 사용하려면 다음을 따르세요: [Codex에서 Claude 사용](/ko/learn/use-claude-api-with-codex/) 호환되는 Claude 그룹 키를 사용하세요. 위의 GPT 예제는 Codex 그룹 접근용입니다. 

게이트웨이 접근 권한에는 ChatGPT 워크스페이스 이용 권한이나 Codex 클라우드 접근 권한이 포함되지 않습니다. 다음을 참고하세요: [로그인 방식 비교](/ko/blog/codex-api-key-vs-chatgpt-subscription/) 에서 제품별 제공 범위를 확인하세요. 

## 참고 자료  
- [OpenAI: 게이트웨이를 통한 제공자 인증 정보 사용](https://learn.chatgpt.com/docs/enterprise/connect-to-a-gateway) 
- [OpenAI: 구성 참조](https://learn.chatgpt.com/docs/config-file/config-reference) 
- [OpenAI: 고급 구성 및 프로필](https://learn.chatgpt.com/docs/config-file/config-advanced)