OpenCodex 설치 가이드 · Codex 하나에서 GPT와 Claude 쓰기

2026년 10월 14일 업데이트

GPT로 초안을 쓰고 Claude로 검수한 다음, 다시 GPT로 고쳐요. OpenCodex를 연결하면 Codex 작업창에서 모델만 바꿔 이 흐름을 이어갈 수 있어요.

1. 내가 먼저 준비할 것

  • Codex 앱 또는 CLI에 ChatGPT 계정으로 로그인해 주세요. 이 가이드는 Codex 작업창에서 쓰는 방법이에요.
  • Claude 쪽은 Claude Pro/Max 로그인 또는 Anthropic API 키 중 한 방식이 필요해요. 로그인한 구독 또는 API 계정에서 사용량이 적용돼요.
  • 로그인과 설치·권한 승인은 직접 처리하고, 프로그램 설치·설정·경로 확인은 아래 요청문으로 맡겨요.

OpenCodex는 MIT 라이선스의 커뮤니티 중계 도구예요. 제작사 README는 제공사가 외부 중계를 통한 계정 사용을 제한할 수 있다고 안내해요. 연결할 계정의 이용 조건을 확인하고 본인이 사용할 계정을 선택하세요.

2. Codex에 이 요청문을 통째로 붙이기

붙일 곳: Codex 앱의 새 작업창 또는 Codex CLI. 일반 ChatGPT 웹 채팅창에서는 내 컴퓨터에 프로그램을 설치할 수 없어요.

텍스트
이 컴퓨터의 Codex에서 GPT와 Claude를 한 창에서 바꿔 쓰도록 OpenCodex를 설치·연결해 줘.

원본: https://github.com/lidge-jun/opencodex
설치: https://opencodex.me/getting-started/installation/
시작: https://opencodex.me/getting-started/quickstart/
제공사 연결: https://opencodex.me/guides/providers/

1. 위 문서와 현재 CLI 도움말을 먼저 확인해. 운영체제, Node.js(18 이상), npm, 기존 ocx 설치와 실행 상태를 확인해. Node가 없으면 이 환경에 맞는 설치를 진행하되 필요한 설치·관리자 승인만 내가 하게 해.
2. 이미 OpenCodex가 있으면 재설치·업데이트·재시작하지 말고 현재 상태부터 확인해. 기존 Codex와 OpenCodex의 설정을 통째로 덮어쓰지 마. 설정 변경이 필요하면 원본을 날짜가 붙은 백업에 보관하고 접근 권한을 제한해. 계정 토큰·API 키·auth 파일 내용은 읽어 출력하거나 대화에 붙이지 마.
3. 처음 설치라면 npm install -g @bitkyc08/opencodex로 설치하고 ocx --version, opencodex --version을 확인해. Bun 설치가 차단됐다는 실제 오류가 있을 때만 공식 문서의 npm install -g --allow-scripts=bun @bitkyc08/opencodex로 복구해. 임의로 다른 패키지로 바꾸지 마.
4. 처음 설정이라면 현재 ocx init 안내에 따라 기존 ChatGPT 로그인을 사용하는 경로를 유지하고 Claude 연결을 추가해. 기본 제공사를 무조건 Claude로 바꾸지 마.
5. Claude는 내 Pro/Max 로그인 방식으로 연결할게. ocx login anthropic의 로그인 화면을 열고 내가 직접 로그인할 때 기다려 줘. 이미 연결된 계정이 있다면 로그아웃하거나 교체하지 마. API 키 방식으로 바꾸거나 다른 유료 서비스로 대체하지 마.
6. 로그인 완료 후 필요할 때만 ocx start로 연결을 켜고, ocx status와 모델 목록을 읽기만 해서 상태를 확인해. 모델 이름은 현재 계정에서 반환된 값을 써. 예전 모델 이름을 고정해서 넣지 마.
7. Codex에서 Claude 모델을 고르는 위치를 알려 줘. 앱을 다시 열어야 한다면 먼저 현재 작업을 저장하도록 안내해. 실제 모델 목록에 Claude가 있는지 확인하고, 표시되지 않으면 원인과 남은 단계를 알려 줘.

설치·연결 확인까지만 진행해. 테스트 질문을 Claude·GPT에 보내거나 내 계정 사용량을 소모하는 생성 호출은 하지 마.
마지막에 설치 버전, 실행 상태, 실제 Claude 모델 이름, Codex에서 선택할 위치와 복구 방법을 짧게 알려 줘.
복구 안내는 현재 공식 문서의 ocx stop(중지하고 기본 Codex 복구), ocx restore(프록시는 켜 둔 채 기본 Codex 복구)를 확인해서 설명만 해. 지금 복구 명령은 실행하지 마.

API 키로 연결하고 싶다면 요청문의 5번만 다음으로 바꾸세요. 키는 AI 대화에 붙이지 않고 제공사 설정 화면에 직접 입력해요.

텍스트
Claude는 Anthropic API 키 방식으로 연결할게. 현재 설정 마법사에서 anthropic-apikey를 선택하고, 키를 내가 직접 입력할 지점에서 기다려 줘. 기존 ChatGPT 경로와 다른 제공사 설정은 보존해. API 키 내용은 출력하거나 기록하지 마. 모델 생성 호출은 하지 마.

3. 설치 완료 확인하기

AI가 아래 네 가지를 알려 주면 연결을 확인한 거예요.

  • 설치된 OpenCodex 버전
  • 프록시 실행 상태
  • 현재 계정에서 확인한 Claude 모델 이름
  • Codex 모델 메뉴에서 그 모델을 고를 위치

모델 목록이 보이는 것과 실제로 답하는 것은 별개예요. 아래 초안·검수 요청부터 본인 계정 사용량으로 실행하면 돼요.

4. 같은 대화에서 초안 → 검수 → 수정

모델 메뉴에서 GPT를 선택하고 보내세요.

텍스트
인스타 릴스 캡션 초안 써 줘.
주제: [내 제품·서비스·콘텐츠]
대상: [누구]
내가 확인한 사실: [사실·숫자·경험]
원하는 행동: [저장·댓글·구매 중 하나]
첫 줄은 짧고 구체적으로. 해시태그는 관련된 것 5개 이하로.
주어진 사실에 없는 수치나 경험은 만들지 마.

같은 대화에서 모델만 Claude로 바꾸고 보내세요. 답변을 다른 창으로 옮길 필요가 없어요.

텍스트
위 캡션을 마케터 입장에서 검수해 줘.
1. 첫 줄이 약하면 이유와 더 좋은 첫 줄 2개.
2. 내가 준 사실에 없는 숫자·경험·주장을 표시하고 대체 문장.
3. 대상이 바로 할 행동이 분명한지 확인.
고칠 점만 번호로 짧게 정리해 줘.

다시 GPT로 바꾸고 보내세요.

텍스트
방금 Claude가 짚은 내용을 반영해 최종 캡션으로 고쳐 줘.
바뀐 부분만 굵게 표시하고, 추가 확인이 필요한 사실은 맨 끝에 따로 적어 줘.

블로그·상세페이지·광고 문구도 같은 흐름으로 검수할 수 있어요. 모델 이름과 선택 가능한 항목은 연결한 계정·버전에 따라 달라져요.

5. 원래 Codex로 돌아가기

이것도 설치한 AI에게 부탁하면 돼요.

텍스트
OpenCodex 연결을 해제하고 기본 Codex로 돌아가고 싶어.
현재 실행 상태와 복구 명령의 도움말을 확인하고 ocx stop으로 프록시를 중지한 뒤, 기본 Codex 설정으로 복구됐는지 확인해 줘.
기존 계정 로그인·작업 파일·원래 설정은 지우지 마. 복구 결과와 앱을 다시 열어야 하는지만 알려 줘.

프록시는 유지하고 Codex 연결만 풀고 싶을 때는 위 요청문의 ocx stop을 ocx restore로 바꾸면 돼요.

6. 확인한 범위

2026년 10월 14일 공식 설치·시작·제공사 문서, npm 패키지의 원본 저장소와 최신 배포 버전, 이 Mac의 OpenCodex 2.84.0 및 로그인 도움말을 확인했어요. 기존 로그인·설정을 바꾸거나 GPT·Claude에 테스트 질문을 보내지는 않았어요.

설치 요청문을 처음부터 실행한 결과와 실제 Claude 응답은 본인 환경에서 위 완료 기준으로 확인하세요.

출처: 설치 문서 · 빠른 시작 · 제공사 연결.

같이 해요

  • YouTube

    AI로 업무 시스템을 만드는 과정과 실제 결과를 영상으로 전해요.

    채널 보기
  • 오픈채팅방

    꿀팁을 써 보며 생긴 질문을 나누는 방이에요.

    들어가기
  • 무료 키트 받기

    AI 자동화 키트(직접 돌려 본 자동화 레시피 3개 + 프롬프트 10개)를 PDF로 메일에 바로 보내드려요.

    준비 중