CC Switch로 SeedRouter에 연결해 Codex 사용하기

이 문서에 대하여

이 문서는 CC Switch의 통합 공급자(Universal Provider) 기능으로 OpenAI Codex 명령줄 도구를 지정한 API 게이트웨이에 연동하고 설정을 적용하는 방법을 설명합니다.

적용 버전: CC Switch v3.16.x 이상.

정보 출처: CC Switch 공식 저장소의 사용자 매뉴얼과 소스 코드입니다. 소프트웨어 업데이트가 빠르므로, 제품 화면이 이 문서의 설명과 다르면 앱에 실제로 표시되는 내용을 기준으로 합니다.

용어 설명

용어	설명
Codex	OpenAI에서 제공하는 명령줄 AI 코딩 도우미입니다. 설치한 뒤 터미널에서 `codex` 명령을 실행하여 시작합니다.
CC Switch	Codex, Claude Code, Gemini CLI 등 도구의 서비스 엔드포인트와 자격 증명을 관리하는 크로스 플랫폼 데스크톱 설정 관리 도구입니다. CC Switch 자체는 AI 기능을 제공하지 않으며, 설정 파일을 생성하고 전환하는 역할만 합니다.
공급자(Provider)	모델 추론 기능을 제공하는 서비스 측입니다. 모델 제공사의 공식 서비스일 수도 있고, 직접 구축하거나 구매한 API 게이트웨이일 수도 있습니다.
API Key	인증에 사용하는 키 문자열이며, 보통 `sk-`로 시작합니다.
통합 공급자(Universal Provider)	CC Switch의 기능입니다. 설정 하나를 Claude Code, Codex, Gemini CLI 세 도구에 동시에 동기화할 수 있으며, 여러 API 프로토콜을 함께 지원하는 게이트웨이(예: NewAPI)에 적합합니다.
앱 전용 공급자	단일 도구에만 적용되는 공급자 설정으로, 통합 공급자와 대응되는 개념입니다.

시작하기 전에

시스템 요구 사항

운영체제	최소 버전	아키텍처
Windows	Windows 10	x64
macOS	macOS 12 (Monterey)	Intel (x64) / Apple Silicon (arm64)
Linux	Ubuntu 22.04 / Debian 11 / Fedora 34 및 동등 버전	x64 / ARM64

이 외에 Node.js 18 이상이 필요합니다. 설치 단계는 "작업 1"을 참고하세요.

미리 받을 정보

설정을 시작하기 전에 API 서비스 제공자로부터 다음 네 가지 정보를 받으세요. 하나라도 없으면 설정을 완료할 수 없습니다.

항목	설명	예시
API 주소(Base URL)	게이트웨이의 서비스 주소	`https://seedrouter.net`
API Key	인증 키	`sk-xxxxxxxxxxxx`
모델 이름	Codex 측에서 사용하는 모델 식별자	`gpt-5.6-sol`
프로토콜 지원 여부	게이트웨이가 OpenAI Responses 프로토콜을 지원하는지 여부	지원 / 미지원

요점: 네 번째 항목이 이 문서의 적용 여부를 결정합니다. 통합 공급자가 Codex용으로 생성하는 설정에서 통신 프로토콜은 wire_api = "responses"로 고정되어 있으며 변경할 수 없습니다. 게이트웨이가 Responses 프로토콜을 지원하지 않고 Chat Completions 프로토콜만 지원하는 경우 통합 공급자를 사용할 수 없습니다. "문제 해결" 섹션의 방안 F를 사용하세요.

터미널 열기

이 문서의 여러 곳에서 터미널로 명령을 실행해야 합니다. 터미널을 여는 방법은 다음과 같습니다.

Windows: Win + R을 누르고 powershell을 입력한 다음 Enter 키를 누르세요.
macOS: Command + 스페이스를 누르고 terminal을 입력한 다음 Enter 키를 누르세요.
Linux: 배포판에 포함된 터미널 애플리케이션을 사용하세요.

작업 1: Node.js 설치

이 작업에 대해

Codex는 Node.js의 패키지 관리자 npm을 통해 배포됩니다. CC Switch의 원클릭 설치 방식을 사용하더라도 먼저 Node.js 실행 환경이 필요합니다.

절차

Node.js 공식 웹사이트에 방문하세요.
LTS(장기 지원 버전)로 표시된 설치 패키지를 다운로드하세요. Current 버전은 다운로드하지 마세요.
설치 프로그램을 실행하고 기본 옵션으로 설치를 완료하세요. 구성 항목은 변경할 필요가 없습니다.

Homebrew가 이미 설치되어 있는 macOS 사용자는 터미널에서 brew install node를 실행할 수도 있습니다.
현재 열려 있는 터미널 창을 모두 닫고 새 터미널 창을 다시 여세요.
다음 명령을 순서대로 실행하여 설치를 확인하세요.
```
node --version
      npm --version
```

결과

두 명령이 모두 버전 번호(예: v22.14.0 및 10.9.2)를 출력하고 Node.js 버전이 v18 이상이면 설치에 성공한 것입니다.

참고: "내부 또는 외부 명령" 또는 "command not found"가 표시되면 대개 터미널 창을 다시 열지 않았기 때문입니다. 새로 설치한 명령은 새로 연 터미널 세션에서만 적용됩니다.

작업 2: CC Switch 설치

이 작업에 대해

CC Switch는 무료 오픈 소스 소프트웨어이며, 다음 두 채널을 통해서만 배포됩니다.

공식 웹사이트: ccswitch.io
GitHub 릴리스 페이지: farion1231/cc-switch Releases

경고: 결제나 충전을 요구하거나 계정 로그인 자격 증명을 요구하는 "CC Switch" 웹사이트 또는 클라이언트는 모두 공식 채널이 아닙니다. 다운로드하거나 사용하지 마세요.

절차

Windows

GitHub 릴리스 페이지를 열고, 최신 버전 항목 아래 Assets 영역에서 CC-Switch-v3.16.x-Windows.msi를 찾으세요.
다운로드한 다음 설치 프로그램을 두 번 클릭하여 실행하고, 안내에 따라 설치를 완료하세요.

두 번 클릭해도 반응이 없으면 시스템 보안 정책에 의해 파일이 잠긴 것입니다. 해당 파일을 마우스 오른쪽 단추로 클릭하고 속성을 선택한 다음, 일반 탭 하단의 보안 영역에서 차단 해제를 선택하고 확인을 클릭한 뒤 다시 실행하세요.

시스템에 설치하지 않으려면 CC-Switch-v3.16.x-Windows-Portable.zip 무설치 버전을 다운로드하고, 압축을 푼 다음 CC-Switch.exe를 바로 실행할 수도 있습니다.

macOS

다음 방법 중 하나를 사용하세요.

방법 1(Homebrew가 이미 설치된 경우 권장): 터미널에서 실행하세요.
```
brew install --cask cc-switch
```
방법 2: CC-Switch-v3.16.x-macOS.dmg를 다운로드하고 두 번 클릭하여 연 다음, CC Switch 아이콘을 "응용 프로그램" 폴더로 드래그하세요.

참고: macOS 버전은 Apple 코드 서명 및 공증을 통과했으므로 바로 설치하고 열 수 있습니다. "개발자를 확인할 수 없기 때문에" 메시지가 나타나지 않으며, 추가 격리 해제 작업은 필요하지 않습니다.

Linux

배포판에 따라 선택하세요.

Debian / Ubuntu: .deb 패키지를 다운로드한 다음 실행하세요.

sudo dpkg -i CC-Switch-v3.16.x-Linux-*.deb
      sudo apt-get install -f

Arch Linux: paru -S cc-switch-bin
기타 배포판: .AppImage를 다운로드하고 chmod +x를 실행하여 실행 권한을 추가한 다음 바로 실행하세요.

결과

CC Switch를 실행한 뒤 메인 창이 정상적으로 표시되고, 시스템 트레이 영역(Windows에서는 오른쪽 아래, macOS에서는 메뉴 막대 오른쪽)에 CC Switch 아이콘이 나타나면 설치가 완료된 것입니다.

처음 실행할 때 기존 CLI 도구 설정을 가져오라는 안내가 표시되면 가져오기를 선택하는 것을 권장합니다. 이 작업은 현재 있는 설정을 기본 프로바이더로 저장하며, 설정이 손실되지 않습니다.

작업 3: Codex 설치

이 작업에 대하여

CC Switch 그래픽 인터페이스로 설치할 수 있고, 명령줄로도 설치할 수 있습니다. 처음 사용하는 사용자에게는 방식 A를 권장합니다.

절차

방식 A: CC Switch로 설치(권장)

CC Switch를 실행합니다.
Settings > About 순으로 이동합니다.
Local Environment Check 영역에서 Codex 행의 상태를 확인합니다.
감지되지 않음으로 표시되면 해당 행 오른쪽의 Install 버튼을 클릭합니다.

설치 과정은 백그라운드에서 조용히 실행되며, 버튼에 진행 상태가 표시되고, 완료되면 버전 번호가 자동으로 새로 고쳐집니다.

참고: 이후 업그레이드도 이 화면에서 진행합니다. 새 버전이 감지되면 개별적으로 업그레이드할 수 있고, Upgrade All를 클릭하여 일괄 처리할 수도 있습니다.

방식 B: 명령줄로 설치

터미널을 엽니다.
다음 명령을 실행합니다.
```
npm install -g @openai/codex
```
다운로드 속도가 너무 느리면 미러 소스로 바꿔 사용할 수 있습니다.
```
npm install -g @openai/codex --registry=https://registry.npmmirror.com
```
미러 소스를 장기적으로 사용하려면 다음 명령을 먼저 한 번 실행하여 전역으로 설정할 수 있습니다.
```
npm config set registry https://registry.npmmirror.com
```

결과

터미널을 닫았다가 다시 연 뒤 다음 명령을 실행합니다.

codex --version

버전 번호가 출력되면 설치가 완료된 것입니다.

참고: 이 시점에는 프로바이더 설정이 아직 완료되지 않았습니다. codex을 바로 실행하면 유효한 자격 증명이 없어 오류가 발생하며, 이는 예상된 동작입니다. 설정은 작업 4에서 완료됩니다.

작업 4: 통합 프로바이더 만들기

이 작업에 대하여

이 작업에서는 CC Switch에서 통합 프로바이더 설정을 만들고, 이를 Codex의 프로바이더 목록에 동기화합니다.

절차

CC Switch를 실행합니다.
상단 앱 전환기에서 Codex으로 전환합니다.

Claude 또는 Gemini 패널로 전환해도 마찬가지로 통합 프로바이더 진입점으로 들어갈 수 있으며, 세 패널이 동일한 설정을 공유합니다.
오른쪽 위의 ＋ 버튼을 클릭하여 프로바이더 추가 패널을 엽니다.
패널 상단에서 Unified Provider 탭을 선택합니다.

제한: OpenCode, OpenClaw, Hermes 및 Claude Desktop 패널은 통합 프로바이더를 지원하지 않으며, 이러한 패널에서는 해당 탭이 표시되지 않습니다. 이 탭이 보이지 않으면 먼저 Claude, Codex 또는 Gemini 패널로 전환하세요.
Add Unified Provider를 클릭합니다.

아래 표에 따라 양식 필드를 입력합니다.

필드	입력 설명
Select Preset Type	게이트웨이가 NewAPI면 NewAPI를 선택합니다. 그 외의 경우이거나 확실하지 않으면 Custom Gateway를 선택합니다. 두 유형의 필드는 완전히 동일하며, 기본값만 다릅니다.
Name	사용자 지정 식별 이름입니다. 예: `NewAPI 게이트웨이`. 이 이름은 Codex 프로바이더 카드에 표시됩니다.
API Address	미리 받아 둔 Base URL을 입력합니다. 입력 규칙은 아래 "API 주소의 처리 규칙"을 참조하세요.
API Key	미리 받아 둔 키를 입력합니다. 오른쪽 눈 아이콘을 클릭하면 평문 표시를 전환할 수 있습니다.
Official Website	선택 사항입니다. 입력하면 프로바이더 카드에서 바로 이동할 수 있습니다.
Notes	선택 사항입니다. 키 출처와 유효 기간 등의 정보를 기록하는 것을 권장합니다.
Enabled Apps	Claude Code, OpenAI Codex, Gemini 스위치 세 개가 포함됩니다. OpenAI Codex은 반드시 켜야 합니다. 이 게이트웨이를 나머지 두 도구에도 동시에 사용하는 경우 함께 켤 수 있습니다.
Model Configuration > Codex > Model	미리 받아 둔 모델 이름을 입력합니다. 예: `gpt-5.6-sol`.
Model Configuration > Codex > Reasoning Effort	추론 강도입니다. 값은 `low`, `medium` 또는 `high`입니다. 특별한 요구 사항이 없으면 `high`를 입력합니다.

참고: Unified Provider 양식에는 "Get Models" 버튼이 없으며, 모델 이름은 직접 입력해야 하고 대소문자를 구분합니다.

Add를 클릭합니다.

결과

화면에 "Unified Provider added and synced"라고 표시됩니다. 이때 CC Switch는 Codex의 공급자 목록에 같은 이름의 공급자 카드를 하나 생성한 상태입니다. 다른 앱을 체크한 경우 해당 목록에도 카드가 생성됩니다.

요점: 동기화는 활성화를 의미하지 않습니다. 이 시점의 구성은 아직 Codex 실행 구성 파일에 기록되지 않았으므로, 작업 5를 이어서 수행해야 합니다.

API 주소 처리 규칙

CC Switch가 Codex용 구성을 생성할 때 입력한 API 주소를 다음과 같이 처리합니다.

입력한 주소 형식	처리 결과
경로 없이 도메인만 입력한 경우. 예: `https://seedrouter.net`	자동으로 `https://seedrouter.net/v1`로 보완합니다
이미 `/v1`로 끝나는 경우. 예: `https://seedrouter.net/v1`	그대로 사용합니다
다른 경로가 포함된 경우. 예: `https://api.example.com/openai`	그대로 사용하며, `/v1`은 보완하지 않습니다

판정 기준은 처리된 주소 뒤에 /responses를 붙인 결과가 게이트웨이에서 실제로 사용할 수 있는 인터페이스 경로여야 한다는 것입니다. 입력하기 전에 서비스 제공자에게 전체 인터페이스 주소를 확인한 다음, 위 표에 따라 입력할 내용을 역으로 정하는 것을 권장합니다. 주소가 올바르지 않으면 요청이 404를 반환합니다.

작업 5: 공급자를 활성화하고 구성을 적용합니다

이 작업에 대해

공급자 카드가 생성된 뒤에는 수동으로 활성화해야 구성이 Codex 구성 파일에 기록됩니다. Codex는 구성 핫 리로드를 지원하지 않으므로, 활성화한 뒤에는 터미널을 다시 시작해야 합니다.

절차

Add Provider 패널을 닫습니다.
상단 앱 전환기에서 Codex로 전환합니다.
공급자 목록에서 작업 4에서 만든 같은 이름의 카드를 찾습니다.
카드의 Enable 버튼을 클릭합니다.

카드가 파란색 테두리로 표시되고 "Currently Enabled" 레이블이 붙으면, 구성이 기록된 것입니다.

현재 터미널 창을 완전히 닫습니다. 그런 다음 새 터미널 창을 다시 엽니다.

요점: 여기서는 터미널 창 전체를 닫는 것을 말하며, codex 프로세스를 종료한 뒤 codex 명령을 다시 실행하는 것이 아닙니다. 도구별 적용 방식의 차이는 다음과 같습니다.

도구	공급자 전환 후 적용 방식
Claude Code	즉시 적용되며, 핫 리로드를 지원합니다
Gemini CLI	즉시 적용되며, 요청마다 구성을 다시 읽습니다
Codex	터미널을 닫았다가 다시 열어야 합니다
OpenCode / OpenClaw	터미널을 닫았다가 다시 열어야 합니다

새 터미널에서 다음을 실행합니다.
```
codex
```
시작한 뒤 테스트 문장을 하나 입력합니다. 예: "안녕하세요, 간단히 자기소개를 해 주세요".

결과

모델이 정상적으로 응답을 반환하면 구성이 완료된 것이며, Codex가 지정한 게이트웨이에 연결된 것입니다.

참조: 생성된 구성 파일

CC Switch는 최소 침입 원칙을 따릅니다. 공급자를 활성화하면 구성이 Codex 자체 구성 파일에 직접 기록됩니다. CC Switch를 제거해도 Codex는 계속 정상적으로 동작합니다.

관련 파일은 다음과 같습니다. 경로의 ~는 현재 사용자 디렉터리를 나타냅니다. Windows에서는 C:\Users\<사용자명>\이고, macOS와 Linux에서는 /Users/<사용자명>/ 또는 /home/<사용자명>/입니다.

~/.codex/auth.json — 자격 증명을 저장합니다:

{
        "OPENAI_API_KEY": "<API Key>"
      }

~/.codex/config.toml — 모델과 엔드포인트 구성을 저장합니다:

model_provider = "cliproxyapi"
      model = "gpt-5.6-sol"
      model_reasoning_effort = "max"
      sandbox_mode = "workspace-write"
      model_context_window = 372000
      model_auto_compact_token_limit = 334800
      model_auto_compact_token_limit_scope = "total"
      service_tier = "priority"
      
      [model_providers.cliproxyapi]
      name = "SeedRouter"
      base_url = "https://seedrouter.net/v1"
      wire_api = "responses"
      requires_openai_auth = true
      experimental_bearer_token = "sk-xxxxxxxxxx"

CC Switch 자체의 데이터는 ~/.cc-switch/ 디렉터리에 저장되며, 이 중 데이터베이스 파일은 cc-switch.db이고, 자동 백업은 backups/ 하위 디렉터리에 있으며 최근 10개가 보관됩니다.

유지 관리

구성 수정

API Key, 모델 이름 또는 서비스 주소를 수정할 때:

＋ 버튼을 클릭하고 통합 프로바이더 탭으로 전환합니다.
대상 카드에서 편집 아이콘을 클릭합니다.
해당 필드를 수정합니다.

편집 모드에서는 양식 하단에 구성 JSON 미리보기 영역이 제공되며, 동기화 전에 각 앱에 기록될 실제 내용을 확인할 수 있습니다.
저장 및 동기화를 클릭합니다.
확인 대화상자에서 작업을 확인합니다. 이 작업은 Claude, Codex, Gemini에 연결된 프로바이더 구성을 덮어씁니다.
터미널을 닫았다가 다시 엽니다.

프로바이더 카드 작업 설명

작업	설명
동기화	현재 구성을 연결된 각 앱에 수동으로 다시 푸시하며, 구성이 일치하지 않을 때 복구하는 데 사용합니다.
복사	현재 구성을 바탕으로 사본을 하나 만들어, 예비 키를 구성하기 쉽게 합니다.
편집	구성 내용을 수정합니다.
삭제	통합 프로바이더를 삭제하고, 그 프로바이더가 Claude, Codex, Gemini에 생성한 연결된 프로바이더 카드도 함께 삭제합니다.

빠른 전환

시스템 트레이의 CC Switch 아이콘을 마우스 오른쪽 버튼으로 클릭하고, Codex 하위 메뉴에서 대상 프로바이더 이름을 직접 클릭하면 전환됩니다. 메인 화면을 열 필요가 없습니다. 전환한 뒤에도 마찬가지로 터미널을 다시 시작해야 합니다.

장애 진단

A. 401 또는 403 인증 실패가 반환됨

가능한 원인	해결 방법
API Key를 복사할 때 불필요한 공백이나 줄바꿈 문자가 포함됨	다시 복사하여 붙여넣고, 선택 범위에 유의합니다
API Key가 만료되었거나 한도가 소진됨	서비스 제공자에게 키 상태를 확인합니다
API Key와 API 주소가 일치하지 않음	둘이 같은 서비스에서 온 것인지 확인합니다

B. 404가 반환되거나 인터페이스가 존재하지 않는다고 표시됨

대부분의 경우 API 주소를 처리한 결과가 올바르지 않습니다. "작업 4 > API 주소 처리 규칙"을 참조하여 다시 확인하고, 서비스 제공자에게 전체 인터페이스 주소를 확인하세요.

C. 구성을 수정한 뒤 아무런 변화가 없음

터미널을 다시 시작하지 않은 경우입니다. 터미널 창을 완전히 닫은 뒤 다시 여세요. Codex를 사용하는 과정에서 가장 흔한 문제입니다.

D. 화면 상단에 환경 변수 충돌 경고가 표시됨

시스템에 OPENAI_API_KEY 등의 환경 변수가 있습니다. 환경 변수는 구성 파일보다 우선순위가 높아 CC Switch가 기록한 구성을 덮어쓰며, 그 결과 요청이 잘못된 엔드포인트로 전송되거나 잘못된 키가 사용됩니다.

처리 단계:

경고 배너의 펼치기를 클릭하여 충돌 변수의 이름, 값, 출처를 확인합니다.
삭제할 변수를 체크하거나 전체 선택을 클릭합니다.
선택 항목 삭제를 클릭하고 확인합니다.

CC Switch는 삭제 전에 ~/.cc-switch/env-backups/에 자동으로 백업합니다. 복원이 필요하면 해당 디렉터리의 JSON 파일에서 수동으로 되돌릴 수 있습니다.

E. 터미널에 codex 명령이 존재하지 않는다고 표시됨

가능한 원인	해결 방법
설치 후 터미널을 다시 열지 않음	모든 터미널 창을 닫은 뒤 다시 엽니다
Node.js가 올바르게 설치되지 않음	작업 1로 돌아가 `npm --version`이 정상적으로 출력되는지 확인합니다
npm 전역 디렉터리가 PATH에 추가되지 않음	CC Switch의 설정 > 정보 > 로컬 환경 검사를 사용하여 다시 설치합니다

F. 게이트웨이가 Chat Completions 프로토콜만 지원함

통합 프로바이더의 통신 프로토콜은 Responses로 고정되어 있어 이 경우에는 해당하지 않으므로, 앱 전용 프로바이더로 바꿔야 합니다.

CC Switch에서 Codex 패널로 전환하고 ＋ 버튼을 클릭합니다.
왼쪽의 Codex 프로바이더 탭을 유지하고, 통합 프로바이더로는 전환하지 않습니다.
프리셋 드롭다운에서 해당하는 서비스 업체를 선택합니다. DeepSeek, Zhipu GLM, Kimi, MiniMax, StepFun, Bailian, ModelScope, SiliconFlow, Doubao Seed, Xiaomi MiMo, Novita AI 등은 모두 Chat Completions 유형 프리셋에 속합니다.
이러한 프리셋을 선택하면 CC Switch가 "로컬 라우팅 매핑 필요" 스위치를 자동으로 켜고 모델 매핑 테이블을 구성하며, 로컬 프록시가 프로토콜 변환을 수행하므로 수동으로 설정할 필요가 없습니다.
API Key를 입력하고 추가를 클릭한 다음, 해당 프로바이더를 활성화하고 터미널을 다시 시작합니다.

G. 공식 계정 로그인으로 되돌려야 함

Codex 패널에서 "OpenAI 공식" 프리셋의 프로바이더를 추가합니다.
해당 프로바이더를 활성화하고 터미널을 다시 시작합니다.
Codex 자체의 로그인 절차에 따라 인증을 완료합니다.

완료하면 공식 로그인과 서드파티 프로바이더 사이를 자유롭게 전환할 수 있습니다.

선택 참고: 통합 공급자와 앱 전용 공급자

사용 시나리오	권장 방안
단일 게이트웨이로 Claude Code, Codex, Gemini CLI를 동시에 서비스하고 Responses 프로토콜을 지원하는 경우	통합 공급자
Codex 도구 하나만 사용하는 경우	둘 다 가능하며, 앱 전용 공급자의 설정 경로가 더 짧습니다
게이트웨이가 Chat Completions 프로토콜만 지원하는 경우	앱 전용 공급자, 내장 프리셋과 함께 사용
각 도구를 서로 다른 서비스 측에 연결하는 경우	앱 전용 공급자로 각각 설정
OpenCode, OpenClaw 또는 Hermes를 설정해야 하는 경우	앱 전용 공급자. 이 세 도구는 통합 공급자를 지원하지 않습니다

보안 주의사항

API Key는 계정 자격 증명과 동등한 민감도를 가집니다. 메신저로 전달하거나, 스크린샷으로 공유하거나, 코드 저장소에 제출하지 마세요.
CC Switch 설치 패키지는 CC Switch 공식 사이트 또는 공식 GitHub 저장소에서만 받으세요.
기기를 변경하거나 키 유출이 의심되면 즉시 키를 교체하세요.
CC Switch의 설정 내보내기 기능은 모든 공급자 정보를 평문으로 .sql 백업 파일에 기록합니다. 내보낸 파일은 안전하게 보관하고, 공유 디렉터리에는 두지 마세요.

빠른 참고

1. Node.js 설치               nodejs.org에서 LTS 버전 선택
      2. CC Switch 설치             ccswitch.io 또는 GitHub Releases
      3. Codex 설치                 CC Switch > 설정 > 정보 > 로컬 환경 검사 > 설치
      4. 통합 공급자 생성           Codex 패널로 전환 > ＋ > 통합 공급자 > 통합 공급자 추가
                                    이름, API 주소, API Key 입력
                                    OpenAI Codex 스위치를 켜고 모델 이름 입력
      5. 공급자 활성화              Codex 패널 > 대상 카드 > 활성화
      6. 터미널 다시 시작           터미널 창을 완전히 닫은 뒤 다시 열기
      7. 확인                       codex 명령을 실행하고 테스트 메시지 보내기

문제 피드백을 제출할 때는 원인 파악 시간을 줄일 수 있도록 전체 오류 정보 스크린샷과 작업 4에 입력한 API 주소(키 부분은 마스킹 필요)를 함께 제공하세요.

CC Switch 통합 공급자로 Codex 설정

이 문서에 대하여

용어 설명

시작하기 전에

시스템 요구 사항

미리 받을 정보

터미널 열기

작업 1: Node.js 설치

이 작업에 대해

절차

결과

작업 2: CC Switch 설치

이 작업에 대해

절차

Windows

macOS

Linux

결과

작업 3: Codex 설치

이 작업에 대하여

절차

방식 A: CC Switch로 설치(권장)

방식 B: 명령줄로 설치

결과

작업 4: 통합 프로바이더 만들기

이 작업에 대하여

절차

결과

API 주소 처리 규칙

작업 5: 공급자를 활성화하고 구성을 적용합니다

이 작업에 대해

절차

결과

참조: 생성된 구성 파일

유지 관리

구성 수정

프로바이더 카드 작업 설명

빠른 전환

장애 진단

A. 401 또는 403 인증 실패가 반환됨

B. 404가 반환되거나 인터페이스가 존재하지 않는다고 표시됨

C. 구성을 수정한 뒤 아무런 변화가 없음

D. 화면 상단에 환경 변수 충돌 경고가 표시됨

E. 터미널에 codex 명령이 존재하지 않는다고 표시됨

F. 게이트웨이가 Chat Completions 프로토콜만 지원함

G. 공식 계정 로그인으로 되돌려야 함

선택 참고: 통합 공급자와 앱 전용 공급자

보안 주의사항

빠른 참고