Codex/ChatGPT
Codex/ChatGPT의 Provider 설정은 CC Switch로 관리하는 것을 권장합니다. getapi.one과 getapi.pro를 별도 Provider로 저장하면 서비스나 모델을 전환할 때 Key를 매번 수정하지 않아도 됩니다.
TIP
권장 흐름: 먼저 CC Switch를 설치하고 사용할 Codex/ChatGPT 클라이언트를 준비한 뒤 GetAPI를 OpenAI Compatible Provider로 추가합니다.
이 문서에서는 현재 Codex 관련 클라이언트 경험과 ChatGPT 데스크톱 워크플로를 통틀어 Codex/ChatGPT라고 부릅니다.
다운로드 및 설치
CC Switch 다운로드
우선 CDN 패키지를 사용하세요. 다른 빌드가 필요하면 CC Switch Releases 페이지를 대체 경로로 사용합니다.
| 클라이언트 | 시스템 / 상황 | CDN 다운로드 | 대체 경로 |
|---|---|---|---|
| CC Switch | macOS | 다운로드 | GitHub Releases |
| CC Switch | Windows | 다운로드 | GitHub Releases |
| CC Switch | 추가 버전 | — | GitHub Releases |
Codex/ChatGPT 다운로드
현재 데스크톱 사용은 ChatGPT 데스크톱 앱을 우선 권장합니다. 독립 Codex 클라이언트가 필요하면 아래에서 맞는 패키지를 받으세요. Intel Mac 사용자는 OpenAI Codex Releases에서도 해당 빌드를 받을 수 있습니다.
| 클라이언트 | 시스템 / 상황 | 권장 다운로드 | 공식 / 대체 |
|---|---|---|---|
| ChatGPT 데스크톱 앱 | macOS / Windows / Linux | 공식 다운로드 | 문서 |
| Codex 클라이언트 | macOS Apple Silicon | 다운로드 | GitHub Releases |
| Codex 클라이언트 | macOS Intel | 다운로드 | GitHub Releases |
| Codex 클라이언트 | Windows | 다운로드 | GitHub Releases |
| Codex IDE 확장 | VS Code / Cursor / Windsurf / JetBrains | 문서 | 문서 |
터미널에서 사용하려면 별도의 Codex CLI 설정 문서를 확인하세요.
시작 전 준비
- CC Switch가 설치되어 있습니다.
- 사용할 ChatGPT 데스크톱 앱, Codex 클라이언트 또는 IDE 확장이 설치되어 있습니다.
- GetAPI 가입 및 로그인을 완료했습니다. 아직이라면 가입 및 로그인 개요부터 시작하세요.
- GetAPI API Key를 만들었습니다. 아직 만들지 않았다면 API Key 개요를 확인하세요.
- 이번에 사용할 서비스가 getapi.one인지 getapi.pro인지 확인합니다.
- 사용할 모델 이름을 확인합니다.
GetAPI 서비스 선택
API Key와 Base URL은 같은 서비스에서 가져와야 합니다. Codex와 CC Switch에서는 Base URL에 /v1이 포함되어야 합니다. getapi.one Key를 getapi.pro 릴레이 주소와 섞어 쓰지 마세요.
| 서비스 | Codex Base URL | API Key 출처 | 신청 안내 |
|---|---|---|---|
| getapi.one | https://www.getapi.one/v1 | getapi.one API Keys | 신청 안내 |
| getapi.pro | https://relay-api.getapi.pro/v1 | getapi.pro API Keys | 신청 안내 |
CC Switch로 설정
1. CC Switch 열기
먼저 CC Switch를 실행하고 Codex Provider 설정 영역으로 이동할 준비를 합니다.
2. Codex Provider 탭 열기
CC Switch 상단에서 Codex Provider 탭을 선택한 다음 오른쪽 위의 더하기 버튼으로 새 Provider를 추가합니다.
3. 사용자 지정 설정 선택
Provider 추가 화면에서 사용자 지정 설정을 선택합니다. 보이지 않으면 아래로 스크롤하세요.
4. GetAPI Provider 입력
Provider 이름, 해당 API Key, /v1이 포함된 API 요청 주소를 입력합니다. 예: https://relay-api.getapi.pro/v1.
| 설정 항목 | getapi.pro | getapi.one | 설명 |
|---|---|---|---|
| Provider 이름 | GetAPI Pro | GetAPI One | 나중에 식별하기 쉬운 사용자 지정 이름입니다. |
| 공식 웹사이트 | https://www.getapi.pro | https://www.getapi.one | Provider 공식 웹사이트입니다. CC Switch에서 필수가 아니면 비워도 됩니다. |
| API Key | getapi.pro API Key | getapi.one API Key | 해당 서비스에서 복사하세요. Key와 주소를 서로 다른 서비스로 섞지 마세요. |
| API 요청 주소 | https://relay-api.getapi.pro/v1 | https://www.getapi.one/v1 | /v1을 반드시 포함해야 합니다. |
| 기본 모델 | 예: gpt-5.6-sol | 예: gpt-5.6-sol | 해당 GetAPI 콘솔에서 사용할 수 있는 모델명을 입력합니다. |
5. Provider 활성화
저장 후 Provider 목록으로 돌아가 방금 추가한 GetAPI Provider를 활성화합니다.
연결 확인
1. Codex/ChatGPT에서 확인
Codex/ChatGPT를 열고 짧은 메시지를 보내세요. 모델이 정상 응답하면 Provider를 사용할 수 있습니다.
자주 발생하는 문제
| 문제 | 가능한 원인 |
|---|---|
| 401 / Unauthorized | API Key가 잘못되었거나 비활성화되었거나 선택한 서비스 주소와 맞지 않습니다. |
| 404 / Not Found | Base URL이 잘못되었거나 /v1이 빠졌거나 클라이언트가 호환되지 않는 경로를 붙였습니다. |
| Model not found | 모델명이 잘못되었거나 선택한 그룹에서 해당 모델이 활성화되지 않았습니다. |
| 응답 없음 또는 시간 초과 | 잔액, 할당량, 속도 제한, 네트워크 또는 서비스 상태 문제입니다. |
보안 안내
API Key를 공개 스크린샷, 공개 저장소, 프런트엔드 코드 또는 공유 문서에 넣지 마세요. 문제 해결용 스크린샷을 공유하기 전에 Key, 계정 정보, 잔액을 가리세요.
참고 링크
OpenAI 공식 문서는 ChatGPT App, Codex CLI, Codex IDE 확장에 대한 참고 자료를 제공합니다. 위 CDN 다운로드 링크는 프로젝트에서 제공하는 미러입니다.