Codex 독립 앱(Codex App)

• 공식 사이트 및 다운로드: https://openai.com/codex

적용 시나리오

• Codex 독립 앱(Codex App) 을 사용 중이며, 그 안에서 Codex의 대화 및 AI 기능을 사용하고 싶습니다.
• Mole API 를 Codex의 모델 연결 지점으로 사용하여 사용량과 키를 통합 관리하고 싶습니다.

사전 요구 사항

• Mole API 콘솔에서 API Key 를 발급받아야 합니다(개인 센터 또는 토큰 관리 페이지에서 생성 후 복사).

1단계: Codex 다운로드 및 설치

1. 브라우저에서 Codex 공식 사이트에 접속합니다: https://openai.com/codex
2. 페이지 안내에 따라 Codex 앱을 다운로드하고 설치합니다.

설치가 완료되면 Codex 앱을 실행합니다.

2단계: API Key로 로그인

1. Codex 앱에서 API Key 방식으로 로그인/인증을 선택합니다.
2. Mole API 콘솔에서 발급받은 API Key 를 입력합니다.

여기서는 키 입력만 완료된 상태이며, Codex가 실제로 Mole API에 요청하도록 하려면 구성에서 모델 제공자를 지정해야 합니다.

3단계: 설정 열기 및 구성 선택

1. 로그인 후 설정 → 설정 을 클릭합니다.
2. 설정에서 구성 을 선택하여 config.toml을 엽니다.

4단계: config.toml에서 Mole API 구성

열린 config.toml에 다음 내용을 추가합니다:

model_provider = "moleapi"

[model_providers.moleapi]
name = "moleapi"
base_url = "https://api.moleapi.com/v1"
wire_api = "responses"

또한 model = "사용하려는 moleapi 제공 모델(예: claude-opus-4-6)"을 추가할 수도 있습니다.

config.toml을 저장한 후 Codex를 다시 시작하여 구성을 적용합니다.

5단계: 구성이 성공했는지 확인

1. Codex를 다시 열고 입력창에 메시지 하나를 보냅니다(예: "안녕하세요").
2. Codex가 정상적으로 응답하고, Mole API 콘솔의 요청 로그에서 해당 API Key의 요청 기록을 확인할 수 있다면, Mole API가 Codex의 모델 제공자로 성공적으로 구성된 것입니다.

자주 묻는 질문

메시지 전송 시 응답이 없거나 오류가 발생하는 경우

• config.toml에서 model_provider = "moleapi" 및 [model_providers.moleapi]가 올바르게 입력되었고 저장되었는지 확인하세요.
• base_url이 https://api.moleapi.com/v1인지 확인하세요. /v1를 빠뜨리거나 경로를 추가로 작성하면 안 됩니다.
• 입력한 API Key가 Mole API 콘솔의 값과 일치하고 만료되지 않았는지 확인하세요. 구성을 수정한 후에는 Codex를 다시 시작해야 합니다.

모델 또는 엔드포인트를 변경하고 싶은 경우

Mole API 콘솔에서 사용 가능한 모델과 사용량을 관리할 수 있습니다. Codex 측에서 엔드포인트 또는 제공자를 변경해야 하는 경우, config.toml에서 model_provider 및 해당 [model_providers.*] 구성을 수정한 후 Codex를 다시 시작하세요.

참고 링크

• Mole API 공식 사이트
• Codex 공식 사이트
• VS Code의 Codex 플러그인