Codex 인증 방식과 자격 증명 보호
Codex를 실행하기 전에 어느 계정으로 이용하고 비용이 어디에 연결되는지 확인하세요. ChatGPT 구독으로 로그인하는 방법과 OpenAI Platform API 키를 사용하는 방법은 과금·데이터 정책이 같은 경로가 아닙니다.
이 글은 공식 인증 문서를 참고한 비공식 해설입니다. 실제 로그인이나 키 입력을 수행하지 않았습니다. 요금·사용 한도·플랜별 제공 기능은 자주 바뀌므로 숫자를 고정해 안내하지 않습니다.
두 인증 경로를 구분하세요
| 방식 | 확인할 대상 | 주의점 |
|---|---|---|
| ChatGPT 로그인 | 사용할 계정·워크스페이스·해당 플랜의 이용 조건 | 개인 계정과 조직 워크스페이스를 혼동하지 않기 |
| API 키 인증 | 키 소속 OpenAI Platform 조직·프로젝트·결제 정책 | ChatGPT 구독에 포함된 이용량이라고 가정하지 않기 |
공식 문서는 로컬 CLI에서 두 방식을 지원한다고 설명합니다. 클라우드 사용에는 ChatGPT 로그인이 필요하며, 인증 방식에 따라 일부 기능과 관리 정책이 달라질 수 있습니다. 회사 코드라면 개인 계정 사용이 허용되는지부터 확인하세요.
브라우저 로그인
CLI에서 다음 명령으로 로그인 흐름을 시작할 수 있습니다. 이 명령은 계정 인증 상태를 바꾸며, 브라우저 확인은 사용자가 직접 해야 합니다.
codex login
브라우저에서 계정과 워크스페이스를 확인하고 공식 로그인 흐름을 완료합니다. 비밀번호·일회용 코드·리디렉션 URL을 채팅이나 이슈에 붙이지 마세요. 인증 요청을 시작하지 않았는데 코드 입력을 요구받으면 진행하지 않습니다.
원격·헤드리스 환경에서는 브라우저 콜백이 작동하지 않을 수 있습니다. 공식 문서는 사용 가능한 경우 device code 인증을 안내합니다. 계정·조직 설정에 따라 허용 여부가 다르므로 헤드리스 인증 절차를 확인하세요. 이를 해결하려고 인증 보호를 우회하거나 개인 인증 캐시를 무작정 복사하지 않습니다.
API 키가 필요한 경우
자동화 등의 이유로 API 키 방식을 선택한다면 조직의 비밀값 관리 절차를 따르세요. 실제 키를 명령줄 인수에 직접 적거나, 저장소의 예제 파일·AGENTS.md·프롬프트에 넣지 않습니다. 공식 문서는 표준 입력을 통한 키 전달 방법을 제공합니다. 키 생성·입력·저장 위치 선택은 비용과 보안에 영향을 주므로 이 입문 실습에서는 실행하지 않습니다.
키 인증이 성공해도 결제·조직 권한·모델 접근이 모두 준비되었다고 보장되지는 않습니다. 요청 실패를 해결하려고 다른 계정의 키를 받아 공유하는 방식도 피하세요.
상태 확인과 저장된 인증 정보
사용자가 자신의 환경에서 확인할 때 사용할 수 있는 명령입니다. 출력은 그대로 공개하지 말고 민감한 정보가 포함되는지 검토하세요.
codex login status
공식 문서에 따르면 인증 정보는 설정에 따라 OS 자격 증명 저장소 또는 Codex 홈의 인증 파일에 보관됩니다. 파일 기반 auth.json에는 접근 토큰이 포함될 수 있습니다. 문제 해결을 위해 그 내용을 출력하거나 업로드해서는 안 됩니다. CLI와 확장이 인증 캐시를 공유할 수 있으므로 한쪽의 로그아웃이 다른 쪽에도 영향을 줄 수 있습니다.
로그인 다음에 확인할 것
인증은 계정을 확인하는 단계이지 파일 수정·명령 실행 전체에 대한 동의가 아닙니다. 권한과 샌드박스에서 작업 경계를 확인한 뒤 첫 작업을 시작하세요. 과금 경로를 아직 설명할 수 없다면 AI 요청을 보내기 전에 멈추고 공식 요금 안내나 조직 관리자에게 확인하는 편이 안전합니다.
공식 한국어 도움말: ChatGPT 플랜과 Codex에서 계정별 이용 안내를 확인할 수 있습니다. 이 글은 해당 도움말의 공식 번역이 아니며, 계정 조건과 요금은 공식 안내를 우선합니다.