스프쌤
도구

codex-switch로 Codex 다계정 전환, 한계와 주의점

✍ 야금야금⏱ 14분 소요2026-11-14👁
← 목록으로 돌아가기

개인 ChatGPT와 회사 ChatGPT를 오가며 Codex까지 매번 다시 로그인하고 있나요? codex-switch는 그 반복을 줄이려는 비공식 도구입니다.

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: Codex 다계정 전환 도구 codex-switch의 실체와 경계

✦ KR 핵심 요약: codex-switch는 Windows와 macOS에서 Codex가 사용 중인 ChatGPT 로그인 정보를 프로필 단위로 바꿔, 개인·업무 계정을 빠르게 전환하려는 비공식 커뮤니티 도구다. 핵심은 Codex의 로컬 auth.json을 이동하는 방식이며, 대화 스레드와 설정을 유지한다는 점이 장점이지만 파일 형식이 비공식이고 OpenAI 약관상 사용량 제한 우회 목적의 다중 계정은 금지된다. 따라서 도구 자체보다 계정 소유권과 사용 목적이 더 중요한 판단 기준이다.

🌐 Global Takeaway: codex-switch is an unofficial Windows/macOS utility that swaps Codex's local auth.json to move between ChatGPT accounts while preserving threads and settings. It is useful for clearly owned personal/work account separation, but it is not affiliated with OpenAI, depends on an undocumented file, and must not be used to evade usage limits.

아래 흐름도는 codex-switch가 프로필 선택 뒤 Codex를 다시 여는 과정을 보여줍니다.

개인 ChatGPT와 회사 ChatGPT를 오가며 Codex까지 매번 다시 로그인하고 있나요? codex-switch는 그 반복을 줄이려는 비공식 도구입니다. 2026년 9월 12일 Threads 게시물에서 개발자가 직접 만들어 쓰고 있다고 소개했고, 저장소는 github.com/lpaiu-cs/codex-switch로 연결됩니다. 핵심 문구는 Windows와 macOS에서 여러 ChatGPT 계정을 Codex와 함께 쓰되, 전환은 1초 수준으로 빠르고 로그인 상태·스레드·설정을 유지한다는 것입니다.

이 도구가 흥미로운 이유는 단순한 계정 전환기가 아니라 Codex의 로컬 인증 저장 방식을 건드리는 도구이기 때문입니다. Codex 데스크톱 앱이나 codex CLI로 최소 한 번 로그인해 두면, 이후 프로필을 고를 때 인증 정보를 바꿔 Codex를 다시 열도록 설계되어 있습니다. 다만 README와 사용설명서는 이를 OpenAI와 무관한 커뮤니티 도구로 명시하고, auth.json이 비공식 파일이며 릴리스마다 바뀔 수 있다고 경고합니다.

1-1. 확인된 사실

항목 내용
공식 명칭 codex-switch
저장소 github.com/lpaiu-cs/codex-switch
지원 환경 Windows 10/11, macOS
전제 조건 Codex 데스크톱 앱 또는 codex CLI로 최소 1회 로그인
주장 기능 계정 전환을 빠르게 수행하고 로그인 상태·스레드·설정 유지
구현 방식 Codex의 로컬 auth.json을 이동
성격 OpenAI와 무관한 비공식 커뮤니티 도구
관련 프로젝트 Claude Desktop용 claude-switch, 내부 구현은 다름

확인된 파일 구성도 단서가 됩니다. 저장소에는 Windows용 menu.cmd, status.cmd, list.cmd, stop.cmd와 codex-switch.ps1, macOS/Linux 쪽 codex-switch.sh, 한국어 사용설명서.md, 영문·한국어 README, CHANGELOG, LICENSE, docs/DESIGN.md가 보입니다. 수집 시점의 커밋 수는 7개로, 대형 제품이라기보다 개인이 실사용하며 다듬는 규모의 도구에 가깝습니다.

1-2. 아직 확인되지 않은 것

수집 자료만으로는 정확한 설치 절차, 각 cmd 파일의 인자 형식, macOS에서의 권한 요구사항, 실제 전환 성공률, Codex 업데이트 후 호환성 주기, 라이선스 종류를 단정하기 어렵습니다. 따라서 이 글은 다운로드 링크나 실행 명령을 대신 만들어 주지 않고, 확인된 동작 원리와 위험 경계를 중심으로 읽는 것이 안전합니다. 특히 auth.json이 undocumented file이라는 문구는 파일 위치가 고정되어 있지 않거나 형식이 바뀔 수 있다는 뜻으로 받아들여야 합니다.

계정 전환의 허용 경계
계정 소유
본인 계정 정리
  • 개인·업무 분리
  • 설정 유지
다중 계정 우회
  • 사용량 제한 회피
  • 약관 위반 위험
회사 정책 계정
  • 관리자 승인 필요
  • 로그아웃 충돌
임시 테스트 계정
  • 소유권 확인
  • 기록 남김
용도
본인 계정 관리와 사용량 제한 우회는 같은 도구라도 판단이 다릅니다.

2. codex-switch가 실제로 하는 일

codex-switch의 본질은 Codex가 기억하는 로그인 정보를 프로필 단위로 보관하고 필요할 때 바꿔 끼우는 것입니다. README 예시에는 main, work 같은 프로필 이름 옆에 이메일과 plus, team 같은 플랜 표기가 붙고, 번호를 골라 Enter를 누르면 Codex가 그 계정으로 다시 열린다고 설명합니다. 새 프로필 추가와 종료 선택지도 있으므로, 완전 자동 전환이라기보다 대화형 메뉴를 통해 계정을 선택하는 구조로 읽는 편이 맞습니다.

중요한 표현은 stay logged in과 keep your threads and settings입니다. 일반적인 로그아웃 후 로그인은 세션과 대화 기록이 끊길 수 있지만, 이 도구는 Codex의 로컬 인증 상태를 통째로 옮기는 방식이라 스레드와 설정이 남는다고 주장합니다. 다만 이는 Codex가 인증 파일만으로 모든 상태를 복원한다는 보장은 아니며, 계정별 플랜·권한·조직 정책에 따라 보이는 기능이 달라질 수 있습니다.

목록에 보이는 status.cmd와 list.cmd는 현재 활성 프로필과 저장된 프로필을 확인하는 진입점으로 해석할 수 있고, stop.cmd는 실행 중인 전환·Codex 프로세스를 정리하는 역할로 추정됩니다. 다만 자료에 각 파일의 정확한 출력 예시는 없으므로, 실제 사용 전에는 저장소의 사용설명서와 README를 먼저 읽는 순서가 필요합니다.

3. 지원 환경과 전제 조건

Windows에서는 PowerShell이 기본 포함되어 있어 별도 설치 없이 시작할 수 있다고 안내합니다. Windows 10/11와 macOS를 지원한다고 명시되어 있으므로, Linux는 스크립트 파일 이름에 .sh가 있어도 공식 지원 표기와는 구분해 보는 것이 좋습니다. 저장소에 codex-switch.sh가 있다는 사실과 macOS 지원 문구를 같이 보면 셸 스크립트가 macOS 쪽 진입점일 가능성이 높지만, 자료가 잘려 있어 Linux 배포판별 동작은 담겨 있지 않다.

전제 조건은 Codex에 이미 로그인되어 있다는 점입니다. Codex 데스크톱 앱은 Windows에서 Microsoft Store, macOS에서 ChatGPT.app 경로로 언급되고, codex CLI로도 같은 로그인을 공유한다고 설명합니다. 즉 도구가 Codex 로그인을 새로 만들어 주는 것이 아니라, 이미 만들어진 인증 상태를 프로필로 나누는 보조 장치라는 점이 핵심입니다.

실행 관점에서는 계정 전환이 일어나기 전에 Codex가 완전히 닫혀 있는지, 회사 계정이라면 관리자 정책이나 기기 관리와 충돌하지 않는지 확인해야 합니다. 저장소가 auth.json을 이동시킨다고 밝힌 만큼, 동시 실행 중인 Codex가 있으면 상태가 꼬일 수 있는지 여부도 공식 문서 기준으로 검증할 필요가 있습니다.

4. 왜 1초 전환과 로그인 유지를 노리는가

로그인 반복의 원인은 보통 Codex가 현재 계정의 인증 토큰을 로컬에 저장하고, 새 계정으로 바꾸려면 기존 세션을 해제해야 하기 때문입니다. codex-switch는 이 과정을 프로필 선택 한 번으로 압축하려 합니다. 내부적으로는 Codex의 로컬 auth.json을 이동시키는 방식이므로, 계정 A의 인증 정보를 안전한 프로필 위치로 옮기고 계정 B의 인증 정보를 Codex가 읽는 위치에 놓은 뒤 다시 실행하는 흐름으로 이해하면 됩니다.

4-1. 인증 정보 이동 방식

auth.json은 Codex가 로그인 상태를 읽는 파일로 보이지만, 비공식 문서화된 파일이며 릴리스 간 레이아웃이 바뀔 수 있다고 README가 경고합니다. 이 말은 곧 도구의 편의성이 Codex 내부 구현에 강하게 의존한다는 뜻입니다. 파일 위치나 JSON 구조가 바뀌면 전환은 실패하거나, 더 나쁘게는 로그인은 되지만 일부 설정이 사라지는 식의 부분 실패가 생길 수 있습니다.

따라서 보안상 중요한 질문은 auth.json을 어디에 복사하는가입니다. 프로필 파일이 평문이면 대화 내용이 아니라도 접근 토큰 성격의 정보가 남을 수 있으므로, 개인 PC 전용인지, 동기화 폴더나 공유 드라이브에 두지 않는지 확인해야 합니다. 자료에는 암호화 방식이 명시되지 않았으므로, 민감한 작업 계정에는 최소 권한 원칙을 적용하는 편이 안전합니다.

4-2. 유지되는 것과 깨질 수 있는 것

스레드와 설정이 유지된다는 주장은 이 도구의 가장 큰 가치이자 가장 큰 가정입니다. Codex가 대화 기록을 계정 서버 쪽에 저장하고 로컬에는 인증과 환경 설정만 둔다면 전환이 자연스럽지만, 로컬 설정이 계정별로 섞여 있으면 전환 후 UI 상태, 모델 선택, 플러그인 설정, 권한 모드가 예상과 다를 수 있습니다. 자료에는 스레드가 서버에 남는지, 계정 간 완전 격리되는지에 대한 상세 검증이 없으므로 절대 표현은 피해야 합니다.

플랫폼 차이도 변수입니다. Windows는 PowerShell과 .cmd/.ps1 조합이 중심이고 macOS는 ChatGPT.app과 셸 스크립트가 중심으로 보입니다. 같은 auth.json 개념이라도 데스크톱 앱과 CLI가 로그인 상태를 공유한다는 설명은 유용하지만, 앱 업데이트가 파일 경로를 바꾸면 기존 프로필이 무효화될 수 있습니다. 사용자는 업데이트 직후 status.cmd 또는 list.cmd로 프로필 인식 여부를 먼저 확인하는 습관이 필요합니다.

5. 본인 계정 전환과 약관 리스크의 경계

codex-switch가 합법적으로 읽히는 영역은 본인이 소유한 계정을 목적별로 정리하는 경우입니다. 예를 들어 개인 구독 계정과 회사 제공 계정을 섞지 않고, 실험용과 실무용을 분리하며, 업무 계정으로 돌아갈 때 개인 설정이 섞이지 않게 하는 용도입니다. 이 경우 도구는 로그아웃·로그인 반복을 줄이는 생산성 보조 도구에 가깝습니다.

반대로 사용량 제한을 피하려 여러 계정을 돌려 쓰는 목적이라면 이야기가 달라집니다. README는 OpenAI 약관상 여러 계정을 사용해 사용량 제한을 우회하는 것이 금지된다고 명시합니다. 따라서 계정 전환 자체가 문제가 아니라, 전환의 목적이 쿼터·레이트리밋 회피인지가 판단 기준입니다. 이 경계는 시각적으로도 분명합니다.

Unofficial community tool. Not affiliated with or endorsed by OpenAI. It moves Codex's local auth.json, an undocumented file whose layout can change between releases.

이 인용이 보여주는 것은 기능 설명보다 신뢰 범위입니다. OpenAI가 검증하지 않은 파일을 건드리므로, 장애가 나도 공식 지원 대상이 아닐 가능성이 높습니다. 회사 계정이면 IT 정책, 정보보안 규정, 라이선스 감사와 충돌할 수 있고, 개인 계정이어도 토큰이 평문 프로필에 남는다면 기기 분실 시 피해 범위가 커집니다. 따라서 좋은 사용법은 자동화가 아니라 사전 확인과 최소 권한입니다.

6. 실행 전 체크리스트와 대안

처음 접할 때는 저장소 README와 사용설명서.md를 공식 문서처럼 읽어야 합니다. 확인 순서는 Codex 로그인 상태, 지원 OS, PowerShell 또는 셸 환경, 프로필 저장 위치, status·list 명령의 실제 출력, stop 명령의 동작 범위입니다. 실행 전에는 Codex를 닫고, 기존 auth.json이 손상되지 않도록 백업 가능 여부를 검토하며, 회사 계정이라면 관리자에게 비공식 도구 사용 가능성을 확인하는 것이 좋습니다.

Windows라면 .cmd 파일들이 더 익숙한 진입점이고, macOS라면 ChatGPT.app 로그인과 codex CLI 공유 여부를 먼저 확인해야 합니다. codex-switch.ps1, codex-switch.sh 같은 파일 이름은 직접 호출할 수 있는 형태로 보이지만, 정확한 인자와 실행 순서는 자료에 충분히 드러나지 않습니다. 따라서 명령어를 지어내 실행하기보다 저장소의 시작하기.cmd 또는 README가 안내하는 경로를 따르는 것이 안전합니다.

대안도 있습니다. 계정이 하나뿐이라면 공식 로그인·로그아웃만으로 충분하고, Claude Desktop에서도 같은 문제를 겪는다면 형제 프로젝트 claude-switch가 참고점이 될 수 있습니다. 다만 DESIGN.md 비교에 따르면 Claude와 Codex는 계정 저장 방식이 달라 내부 구현이 다르므로, 한쪽 경험을 다른쪽에 그대로 옮기면 안 됩니다. 목적이 단순 분리라면 브라우저 프로필이나 OS 계정 분리처럼 더 단순한 방법도 함께 비교할 필요가 있습니다.

7. 지금 판단할 수 있는 결론

codex-switch는 Codex에서 ChatGPT 계정을 빠르게 바꾸고 싶을 때 auth.json을 이동해 로그인 상태와 설정을 유지하려는 비공식 도구입니다. Windows 10/11과 macOS를 지원하고, Codex 데스크톱 앱 또는 codex CLI 로그인만 있으면 시작할 수 있다는 점은 실용적입니다. 그러나 비공식 파일에 의존하고 OpenAI와 제휴 관계가 없으며, 다중 계정으로 사용량 제한을 우회하는 것은 약관상 금지된다는 경고가 함께 붙습니다.

따라서 도입 여부는 기능 목록이 아니라 계정 소유권과 목적에서 결정해야 합니다. 본인이 관리하는 개인·업무 계정을 명확히 나누고, 회사 정책을 확인했으며, 업데이트 후 호환성을 감수할 수 있다면 시험해 볼 만한 보조 도구입니다. 반대로 쿼터를 늘리기 위한 계정 순환, 공유 계정, 출처 불명 인증 파일이 목적이라면 사용하지 않는 편이 맞습니다. 2026년 기준으로는 편의성과 리스크가 같은 크기로 공존하는 도구이며, 스레드 유지가 필요하다면 공식 지원이 생기기 전까지는 검증된 절차와 백업이 전제 조건입니다.

자주 묻는 질문

Q. codex-switch는 공식 OpenAI 도구인가요?
A. 아닙니다. README 기준 OpenAI와 제휴되지 않은 비공식 커뮤니티 도구이며, Codex의 로컬 auth.json을 이동하는 방식으로 동작합니다. 따라서 업데이트 호환성과 지원 범위를 스스로 확인해야 합니다.

Q. 어떤 환경에서 쓸 수 있나요?
A. Windows 10/11과 macOS가 지원 환경으로 안내됩니다. 전제 조건은 Codex 데스크톱 앱 또는 codex CLI로 최소 한 번 로그인되어 있는 것이며, Windows는 기본 PowerShell을 사용합니다.

Q. 계정을 바꾸면 대화 기록과 설정이 사라지나요?
A. codex-switch는 로그인 상태와 스레드, 설정을 유지한다고 설명합니다. 다만 auth.json이 비공식 파일이고 계정별 정책에 따라 결과가 달라질 수 있으므로 절대적인 보장은 아닙니다.

Q. 사용량 제한을 피하려 여러 계정을 돌려 써도 되나요?
A. 안 됩니다. OpenAI 약관상 여러 계정을 사용해 사용량 제한을 우회하는 것이 금지된다고 README가 경고합니다. 도구는 본인이 소유한 계정의 목적별 분리와 관리에 한정해 판단해야 합니다.

원본

https://www.threads.com/@lpaiu.cs/post/DdK6aDvmrMR

https://github.com/lpaiu-cs/codex-switch

https://github.com/lpaiu-cs/codex-switch/blob/main/docs/DESIGN.md

함께 보면 좋은 글

댓글 0개