초보자 맞춤형 튜토리얼: 중국에서 Codex 원활하게 사용하는 방법 (검증 완료)

안녕하세요, 저는 창허입니다.

CodexGuide가 엊그제上线된 후, 백엔드가 터져버렸습니다.

가장 많이 받은 질문은: 중국에서 Codex를 어떻게 사용하나요? Plus 구독 없이도 사용할 수 있나요?

솔직히 말해서, 이 고통을 이해합니다.

Plus를 구독하는 것도 나름의 장벽이 있고, 결제 수단도 알아내야 해서 정말 피곤한 일이죠.

그래서 저는 이틀 동안 인터넷에서 찾을 수 있는 모든 해결책을 테스트해보고, 많은 함정을 겪은 끝에 마침내 가장 신뢰할 수 있는 세 가지 접근 방식을 정리했습니다.

오늘 여러분 모두와 공유하니, 단계만 따라 하세요.

튜토리얼은 CodexGuide에서도 확인할 수 있으니 언제든지 참고하세요.

제가 이렇게 열심히 만든 걸 생각해서, 별표라도 하나 눌러주세요, ㅎㅎㅎ.

먼저, 전제 조건: Codex를 사용하는 가장 안정적인 방법은 여전히 공식 GPT 계정으로 로그인하는 것입니다.

타사 API에 연결하는 것은 고급 작업이며, config.toml, API Key, Base URL이 무엇인지 알아야 합니다.

모르셔도 괜찮습니다. 아래 단계만 따라 하면 됩니다.

세 가지 방식 중 선택하는 방법

자신에게 맞는 방식을 찾을 수 있도록 표를 준비했습니다.

솔직히, 초보자라면 그냥 방식 2를 보세요; 가장 편합니다.

Codex를 배우기 시작했다면, 타사 API를 건드리기 전에 제 이전 Codex 초보자 튜토리얼을 먼저 보는 것을 추천합니다.

방식 1: 수동 설정

이 방법의 단점은 Codex APP의 플러그인 기능을 사용할 수 없다는 것입니다.

플러그인을 사용하려면 바로 방식 2로 건너뛰세요.

수동 설정의 핵심은 하나의 파일을 수정하는 것입니다.

수정하기 전에 백업하세요. 좋은 습관을 들이는 겁니다:

두 가지 로그인 접근법

제안: 한 번에 너무 많은 것을 변경하지 마세요. 제공자 하나만 추가하고, 작동한 후에 여러 구성을 건드리세요.

GPT 로그인 상태 예시

즉, Codex가 먼저 GPT 계정에 로그인되어 있어야 합니다.

1단계: 설정 파일 수정:

~/.codex/config.toml을 열고 다음 구성을 추가하세요.

참고: 실제 서비스에 따라 필드와 값을 입력하세요:

몇 가지 흔한 함정:

• model_provider는 [model_providers.xxx]의 xxx와 정확히 일치해야 합니다; 한 글자라도 틀리면 안 됩니다.
• base_url은 /v1까지만 넣고, /v1/responses 전체 세그먼트는 포함하지 마세요.
• wire_api = "responses"는 Responses API 형식으로 요청한다는 뜻이니 변경하지 마세요.
• requires_openai_auth = false는 공식 로그인 상태를 사용하지 않는다는 뜻입니다.

2단계: 환경 변수 설정

터미널을 열고 입력하세요:

3단계: 터미널에서 Codex APP 시작

여기에 함정이 있습니다: Mac 사용자는 터미널에서 시작해야 하며, 아이콘을 직접 클릭하면 모델을 읽지 못할 수 있습니다.

시작하기 전에 Codex APP을 완전히 종료한 다음, 터미널에 입력하세요:

4단계: 효과 확인

Codex APP을 열면 모델이 성공적으로 전환된 것을 볼 수 있습니다:

이런, 진짜 날아오르네요.

API Key 로그인 예시

API Key 방식을 사용하는 경우, 한 가지 원칙을 기억하세요: 비밀 키는 환경 변수에 넣고, 설정 파일에 하드코딩하지 마세요.

해당 config.toml 구성:

한 가지 주의할 점: 업스트림이 Chat Completions만 지원하고 Responses API를 지원하지 않는 경우, 설정만 변경해서는 작동하지 않습니다. CCX와 같은 게이트웨이를 사용한 프로토콜 변환이 필요하며, 이는 방식 3에서 다룹니다.

인증 파일 수정

~/.codex/auth.json을 열고 OPENAI_API_KEY를 모델 제공자의 Key로 변경하세요:

설정 성공 확인 방법

설정 후 서두르지 말고 먼저 확인하세요:

1. Codex를 완전히 종료하고 다시 엽니다.
2. 읽기 전용 작업(예: 현재 디렉터리 구조 요약)을 수행하도록 합니다.
3. 오류가 발생하면 먼저 model_provider 이름, base_url 및 환경 변수를 확인하세요.
4. 인증 오류가 발생하면 먼저 백업 설정으로 되돌리세요; 당황하지 마세요.

방식 2: Codex++

수동 설정이 너무 번거롭다면 Codex++를 확인해보세요.

릴레이 구성을 원클릭으로 처리하는 그래픽 관리 도구로, toml 파일을 수동으로 작성할 필요가 없습니다.

또한, 플러그인 기능을 지원하며, 이는 방식 1에서는 할 수 없습니다.

다음과 같은 사용자에게 적합합니다:

• 주로 Codex 데스크탑 App을 사용하는 사용자.
• 설정 파일을 수동으로 작성하고 싶지 않은 사용자.
• 언제든지 공식 모드로 전환하고 싶은 사용자.

설치 단계

1. Codex++ Releases를 열고 설치 패키지를 다운로드하세요.

"Codex++ Management Tool"과 "Codex++ app" 두 가지 설치 패키지가 보일 것입니다; 둘 다 설치하세요.

1. 설치 후 "Codex++ Management Tool"을 엽니다.

처음 열 때 이 오류가 팝업되어도 당황하지 마세요:

"시스템 설정" - "개인정보 보호 및 보안"으로 이동하여 "무시하고 열기"를 클릭하세요:

열면 관리 인터페이스가 나타납니다:

같은 방식으로 Codex++ app을 설치하세요; 관리 도구 감지가 모두 초록색이면 정상입니다:

GPT 로그인 상태가 감지되었는지 확인하세요.

1. 릴레이 구성을 추가합니다.

"Provider Configuration" - "Add Provider"를 선택하고 Base URL과 Key를 입력하세요.

참고: 액세스 방식은 "Pure API"를 선택하세요:

모델 목록은 업스트림에서 자동으로 가져올 수 있습니다; 릴레이 스테이션을 구성하는 경우 선택할 수 있는 모델이 많을 것입니다:

본질적으로 이 도구는 구성을 더 편리하게 작성할 수 있도록 도와주며, 수동 파일 편집을 하지 않아도 됩니다:

저장 후 연결을 테스트하세요; 문제가 없으면 바로 사용하세요:

1. Codex++ 진입점에서 Codex를 시작합니다.

참고: 원래 Codex가 아닌 Codex++에서 시작하세요:

재시작 후 Codex가 이미 사용자 정의 모델 제공자를 사용하고 있으며, 선택 가능한 모델 수가 갑자기 늘어난 것을 볼 수 있습니다:

플러그인도 직접 사용할 수 있습니다; 이것이 완전한 경험입니다:

인정할 수밖에 없네요, 이 방식이 제가 지금까지 사용해본 것 중 가장 매끄럽습니다; 강력 추천합니다.

롤백하려면 어떻게 하나요?

• 관리 도구에서 API 모드를 지우고 공식 구성으로 전환하세요.
• Codex 업데이트 후 Codex++가 작동을 멈추면, 적응될 때까지 기다리세요; 원본 버전 사용에는 영향을 미치지 않습니다.

방식 3: CCX + CC Switch

이 방식은 고급 사용자에게 적합하며, "게이트웨이"와 "전환 도구"를 분리합니다:

• CCX: API 프록시 게이트웨이, 프로토콜 변환 및 라우팅 담당. Claude, OpenAI, Codex, Gemini 등 다양한 진입점을 지원합니다.
• CC Switch: 데스크탑 관리 도구, 다양한 제공자 구성을 원클릭으로 전환.

이 방식을 언제 사용하나요? 여러 개의 국내 모델 API, 여러 릴레이 서비스, 여러 Key가 있거나, 업스트림이 Chat Completions만 지원하여 Responses API로 변환이 필요할 때 사용합니다.

1단계: CCX 배포

Docker를 사용하여 한 줄 명령으로 배포:

시작 후 브라우저를 열면 확인할 수 있습니다.

2단계: 업스트림 채널 추가

CCX 관리 인터페이스에서 채널을 추가하세요:

1. 업스트림 서비스 유형을 선택합니다.
2. API Key와 Base URL을 입력합니다.
3. 모델 매핑 및 라우팅 규칙을 구성합니다.
4. 내장 테스트 기능을 사용하여 연결을 확인합니다.

여기서 핵심은 Codex에 Responses API 진입점이 필요하다는 것입니다. 업스트림에 Chat Completions만 있는 경우 CCX가 프로토콜 변환을 도와주며, 이것이 CCX를 사용하는 핵심 이유입니다.

3단계: CC Switch 설치

명령줄 설치:

초기화:

초기화 중에 CCX 주소를 릴레이 진입점으로 입력하세요.

4단계: 구성 전환 및 시작

한 줄 명령으로 제공자 전환:

그런 다음 Codex를 재시작하여 적용하세요.

전환 후 ~/.codex/config.toml을 열어 확인하는 것이 좋습니다:

• model_provider가 방금 선택한 것과 일치합니까?
• base_url이 CCX를 가리키고 있습니까?
• Key를 실수로 공개 저장소에 작성하지 않았습니까? (매우 중요합니다)

흔한 함정 요약

마지막으로 문제 해결 표를 제공합니다; 문제가 발생하면 먼저 확인하세요:

솔직히 세 가지 방식을 모두 성공적으로 실행해봤지만, 일상적으로는 방식 2인 Codex++를 가장 많이 사용합니다; 정말 편합니다.

여러 개의 Key와 여러 제공자를 가진 고급 사용자라면 방식 3이 더 적합합니다.

자, 오늘 공유는 여기까지입니다.

이 튜토리얼이 도움이 되었다면, 좋아요를 눌러서 알려주세요. 앞으로도 더 많은 Codex 실용 사용법을 계속 업데이트하겠습니다.

질문이 있으면 댓글에 직접 남겨주세요; 보는 대로 모두 답변해 드리겠습니다.