codex --no-alt-screen 은 Codex TUI의 alternate screen을 이번 실행에서만 끄는 명령입니다. OpenAI 공식 CLI 레퍼런스는 이 옵션이 현재 실행의 tui.alternate_screen 설정을 덮어쓴다고 설명합니다.

처음에는 비민감 빈 폴더에서 Codex를 열고 아무 프롬프트도 보내지 않은 채 종료하세요. 설치된 CLI가 옵션을 인식하는지, 종료 뒤 시작 화면이 터미널 스크롤백에 남는지만 확인하면 됩니다. 이 옵션은 샌드박스나 파일 권한을 바꾸지 않습니다.

• alternate screen과 terminal scrollback의 차이
• --no-alt-screen 을 운영체제 셸에서 시작하는 위치
• 빈 시험 폴더로 확인하는 6단계
• 선택적인 두 번째 스크롤백 테스트 프롬프트
• 이 옵션으로 바뀌지 않는 권한과 기록 한계

OpenAI 공식 CLI 레퍼런스는 --no-alt-screen 을 Codex TUI의 alternate screen mode를 끄는 전역 옵션으로 정의합니다. 이 플래그는 tui.alternate_screen 값을 현재 실행에서 덮어씁니다. 설치된 codex-cli 0.144.6 의 도움말은 이를 inline mode로 실행해 terminal scrollback을 보존하는 옵션이라고 표시했습니다.

alternate screen은 터미널의 기본 화면과 분리된 화면 버퍼입니다. 종료하면 원래 셸 화면으로 돌아가기 쉽습니다. 다만 터미널에 따라 TUI에서 본 줄이 평소 스크롤백에 남지 않을 수 있습니다. 이전 출력을 자주 되짚어야 한다면 --no-alt-screen 을 시험해 볼 만합니다.

이 옵션은 ChatGPT 웹 설정이나 Codex 안에서 입력하는 슬래시 명령이 아닙니다. Codex를 시작하기 전에 운영체제 셸에 붙이는 플래그입니다. 공식 문서에서 요금제, 계정, 지역, 언어, 운영체제, 최소 버전 조건은 확인되지 않았습니다. 현재 설치본의 codex --help 를 기준으로 판단하세요.

첫 화면 시험을 통과한 뒤, Codex 응답도 여러 줄 남는지 확인할 때만 아래 프롬프트를 사용합니다. 보내기 전에 입력 범위와 출력 형식을 사람이 승인하세요.

목표: terminal scrollback 표시 확인을 위해 비민감 텍스트 12줄을 만든다.

허용 입력: 이 프롬프트에 적힌 scrollback-prompt-check 문자열과 1부터 12까지의 번호만 사용한다.

제외 입력: 파일, 폴더, 저장소, 환경 변수, 자격증명, 네트워크, 외부 도구, 이전 대화의 다른 정보는 읽거나 사용하지 않는다.

출력 형식: 설명 없이 scrollback-prompt-check-01 부터 scrollback-prompt-check-12 까지 한 줄에 하나씩 출력한다.

완료 기준: 정확히 12줄만 출력하고 파일 변경과 도구 호출은 0건이어야 한다. 출력 뒤 사람이 위로 스크롤해 첫 줄과 마지막 줄을 확인한다.

추정 금지: 입력 문자열, 번호, 줄 수를 바꾸거나 누락된 정보를 만들어내지 않는다. 조건을 지킬 수 없으면 실행하지 않고 이유만 말한다.

승인 지점: 프롬프트를 보내기 전에 사람이 비민감 입력과 12줄 출력 조건을 확인한다. 파일·명령·네트워크 작업은 별도 승인 전 실행하지 않는다.

한 번만 필요한 세션은 codex --no-alt-screen 처럼 실행 플래그로 확인하는 게 단순합니다. 공식 설정 레퍼런스에는 지속 설정인 tui.alternate_screen = auto | always | never 도 있습니다. 하지만 이번 글은 한 번 실행하는 플래그까지만 다룹니다. 설정 파일을 편집하려면 기존 값을 백업하고 별도 변경으로 검토하세요.

스크롤백은 편리한 재검토 수단이지 감사 로그가 아닙니다. 창을 닫거나 기록 한도를 넘으면 사라질 수 있습니다. 중요한 결정, 명령 결과, 코드 변경은 저장소 diff나 승인된 기록 체계에서 따로 확인해야 합니다.

• --no-alt-screen 은 화면 표시만 바꿉니다. 샌드박스, 승인 정책, 파일·네트워크 권한, 인증, 모델 선택은 그대로입니다.
• 옵션을 사용했다는 사실만으로 모든 터미널에서 스크롤백 보존이 보장되지는 않습니다. 현재 터미널에서 종료 후 직접 확인하세요.
• 공식 문서는 Zellij의 auto 동작을 명시합니다. 다른 터미널의 같은 동작까지 보장하지는 않습니다.
• 첫 시험에 실제 저장소나 민감 폴더를 열지 마세요. 모델 요청과 파일 변경도 첫 완료 기준에서 제외합니다.
• terminal scrollback에는 민감한 출력이 남을 수 있습니다. 공유 화면과 공동 장비에서는 조직의 기록·보안 정책을 먼저 확인하세요.
• tui.raw_output_mode 와 /raw 는 별도의 copy-friendly raw scrollback 기능입니다. 이번 --no-alt-screen 흐름과 섞지 않습니다.

--no-alt-screen 은 Codex 안에서 입력하는 명령인가요?

아닙니다. Codex를 시작하기 전에 운영체제 셸에서 codex --no-alt-screen 으로 실행하는 플래그입니다. /no-alt-screen 이라는 슬래시 명령으로 설명하면 진입 위치가 달라집니다.

매번 이 옵션을 넣어야 하나요?

--no-alt-screen 은 현재 실행의 tui.alternate_screen 값을 덮어씁니다. 공식 설정 레퍼런스는 지속 설정에 auto , always , never 를 제공합니다. 먼저 한 번 실행해 환경별 동작을 확인한 뒤 지속 설정은 별도로 검토하세요.

사용하면 파일이나 권한이 바뀌나요?

아닙니다. 공식 설명의 범위는 TUI의 alternate screen 제어입니다. 샌드박스, 승인, 파일, 네트워크 권한을 변경하는 옵션으로 해석하면 안 됩니다.

종료 뒤에도 기록이 없으면 실패인가요?

이 글의 완료 기준에서는 실패입니다. 다만 원인이 곧바로 Codex 지원 문제라는 뜻은 아닙니다. 터미널과 중첩 환경의 스크롤백 동작부터 확인하세요. 설치 버전과 codex --help 출력도 함께 기록합니다.

• OpenAI Codex CLI command reference
• OpenAI Codex configuration reference