Codex CLI 자동 완성 시작 방법: codex completion을 Bash에 처음 적용하는 법
TL;DR
codex completion
은 Codex CLI용 셸 자동 완성 스크립트를 생성하는 Stable 명령입니다. 이 글은 Bash에서 생성 결과를 먼저 살펴본 뒤 현재 세션에만 불러오는 첫 실행 방법을 다룹니다.
처음부터
.bashrc
를 수정하지 않습니다.
complete -p codex
가 등록 정보를 출력하는지 확인한 다음, 시작 파일에 추가할지는 사람이 별도로 결정합니다.
핵심 3줄 요약
운영체제의 Bash 셸에서
codex completion bash
로 스크립트를 생성합니다.생성된 스크립트를 먼저 확인한 뒤 현재 Bash 세션에만
source
합니다.complete -p codex
와 실제 Tab 입력으로 확인하고 시작 파일 수정은 별도 승인으로 남깁니다.이 글에서 다룰 내용
Codex CLI 자동 완성의 한 문장 정의, 공식 지원 셸 경계, Bash에서 처음 적용하는 6단계, 복사해 쓸 검증 프롬프트, 현재 세션과 영구 설정의 차이, 주의점과 FAQ를 다룹니다.
Codex CLI 자동 완성은 무엇이고 언제 쓰면 좋은가
Codex CLI 자동 완성은 설치된 Codex CLI가 제공하는 명령과 옵션 후보를 셸의 Tab 완성으로 불러오기 위한 스크립트입니다.
Codex CLI 자동 완성은 설치된 Codex CLI가 제공하는 명령과 옵션 후보를 셸의 Tab 완성으로 불러오기 위한 스크립트입니다. OpenAI 공식 명령 레퍼런스는
codex completion
을 Stable로 표시하고 Bash, Zsh, Fish, PowerShell용 스크립트를 생성한다고 설명합니다.
하위 명령이나 옵션 철자를 자주 확인한다면 유용합니다. 다만 자동 완성이 명령의 의미, 안전성, 실행 권한까지 판단해 주는 것은 아닙니다. 표시된 후보를 고른 뒤에도 실행 전 명령 전체를 사람이 확인해야 합니다.
이 글은 Bash의 첫 적용만 설명합니다. Zsh, Fish, PowerShell은 공식 지원 대상이지만 생성 인자와 로딩 방식이 다르므로 Bash 명령을 그대로 옮기지 않습니다.
시작 전에 기능과 셸 경계를 확인합니다
codex completion bash
는 Codex 대화형 화면에 입력하는 슬래시 명령이 아닙니다. Codex를 실행하기 전, 운영체제의 Bash 셸에서 입력하는 CLI 하위 명령입니다.
공식 출처는 completion 스크립트 생성을 확인하지만 모든 환경에 공통인 영구 설치 경로나 시작 파일 편집 순서를 제시하지 않습니다. 이번 완료 기준은 현재 Bash 세션 등록까지입니다.
.bashrc
나 다른 시작 파일은 수정하지 않습니다.
플랜, 계정, 지역, 언어, 가격 조건도 해당 공식 명령 설명에는 따로 명시되어 있지 않습니다. 기능이 보이지 않으면 조건을 추정하지 말고 현재
codex completion --help
와 공식 문서를 확인합니다.
codex completion을 Bash에 처음 적용하는 순서
1. 현재 셸이 Bash인지 확인합니다
Bash 프롬프트에서 다음 명령을 실행합니다.
printf '%s\n' "$BASH_VERSION"
버전 문자열이 출력되는지 확인합니다. 현재 셸이 Zsh, Fish, PowerShell이라면 이 글의
source
명령을 그대로 사용하지 말고 해당 셸의 로딩 방법을 따릅니다.
2. Codex CLI와 completion 도움말을 확인합니다
다음 두 명령으로 Codex CLI가 실행되는지, 현재 설치본이 어떤 셸을 받는지 확인합니다.
codex --version
codex completion --help
2026년 7월 28일 이 작업의 로컬 검증에서는
codex-cli 0.144.6
이 실행됐고 도움말은 Bash를 기본값으로 표시했습니다. 이 버전 문자열은 사용 조건이나 최소 버전을 뜻하지 않습니다. 독자는 자신의 현재 출력으로 판단합니다.
3. Bash용 스크립트 출력을 확인합니다
기존 시작 파일을 건드리지 않고 생성 결과를 읽기 전용 화면으로 확인합니다.
codex completion bash | less
Bash completion 함수와 Codex 등록문이 보이는지 확인한 뒤
q
로 나옵니다. 이 단계에서는 생성 결과를 현재 셸에 아직 실행하지 않았습니다.
4. 생성된 스크립트를 먼저 살펴봅니다
자동 완성 결과는 현재 셸에서 실행할 코드이므로 불러오기 전에 확인합니다. 앞 단계의
less
화면에서 Codex 명령과 옵션의 Bash completion 함수·등록문인지 살펴본 뒤
q
로 나옵니다. 비밀값이나 고객 데이터는 이 과정에 넣을 필요가 없습니다.
5. 현재 Bash 세션에만 불러옵니다
검토가 끝났다면 현재 세션에서 다음 명령을 실행합니다.
source <(codex completion bash)
complete -p codex
로컬 검증에서는
complete -p codex
가
_codex
함수를 Codex 명령에 연결한 등록 정보를 출력했습니다. 오류 없이 등록 정보가 보이면 현재 Bash 세션의 기계적 완료 기준을 통과한 것입니다.
6. Tab 동작을 확인하고 현재 세션 범위를 기록합니다
명령줄에
codex
를 입력하고 Tab 키를 눌러 하위 명령 후보가 나타나는지 확인합니다. 실제 Codex 작업을 시작하지 않아도 입력 후보만 점검할 수 있습니다.
현재 세션에서 등록 정보와 Tab 후보가 확인됐다고 기록합니다. 새 터미널에서도 유지하려면 시작 파일을 별도로 설계해야 하며, 이번 첫 실행의 완료 기준에는 포함하지 않습니다.
그대로 복사해 쓸 검증 프롬프트
허용 입력: 현재 codex --version 출력, codex completion --help 출력, codex completion bash 생성 결과, complete -p codex 결과, Tab 후보 표시 여부.
제외 입력: API 키, 토큰, 비밀번호, 고객 데이터, 저장소 파일, ~/.bashrc를 포함한 셸 시작 파일, Codex 인증·모델·권한 설정.
출력 형식: 셸 확인 | 스크립트 생성 | 내용 검토 | 현재 세션 등록 | Tab 확인 | 미확인 사항의 6개 항목으로 작성한다.
완료 기준: 사람이 생성 결과를 검토한 뒤 현재 Bash 세션에서 complete -p codex가 등록 정보를 출력하며, 시작 파일은 수정되지 않은 상태다.
추정 금지: 다른 셸의 로딩 명령, 플랜·계정 제공 조건, 영구 설정 경로, Tab 실패 원인을 현재 출력 없이 만들어 내지 않는다.
승인 지점: 생성된 스크립트 source와 ~/.bashrc 등 시작 파일 수정은 사람이 명령과 경로를 확인한 뒤 각각 승인한다.
이 프롬프트는 자동 완성 등록만 확인합니다. Codex 로그인, 저장소 접근, 파일 수정, 실제 작업 실행은 완료 기준에 넣지 않습니다.
실전 활용 팁
현재 세션 검증과 영구 설정을 분리하면 복구가 쉽습니다. 먼저 생성 결과를 현재 세션에만 불러와 등록 정보와 Tab 동작을 확인합니다. 문제가 있으면 새 Bash를 열어 원래 상태로 돌아갈 수 있습니다.
영구 적용이 필요하다면 현재 셸의 공식 시작 파일과 조직 정책을 확인하고 별도 변경으로 다룹니다. 기존 파일 백업, 추가할 한 줄, 되돌릴 조건을 정한 뒤 승인받는 편이 안전합니다.
주의할 점
-
codex completion bash는 운영체제 Bash 셸에서 실행하는 CLI 명령입니다. Codex 대화형 입력창의 슬래시 명령이 아닙니다. - 공식 레퍼런스는 Bash, Zsh, Fish, PowerShell을 명시합니다. Bash의
source절차를 다른 셸에 일반화하지 않습니다. - 생성된 completion은 실행 가능한 셸 코드입니다. 내용을 확인하지 않은 채 시작 파일에 넣지 않습니다.
- 자동 완성 후보는 실행 승인이나 안전 판정이 아닙니다. 명령을 보내기 전에 전체 입력을 사람이 검토합니다.
-
codex completion --help의 로컬 출력이 공식 페이지와 다르면 현재 버전과 공식 문서를 함께 확인하고 차이를 기록합니다. - 이번 절차는
.bashrc, Codex 설정, 인증 정보, 저장소 파일을 수정하지 않습니다.
자주 묻는 질문
codex completion은 Codex 안에서 입력하나요?
아닙니다. 운영체제 셸에서 실행하는 Codex CLI 하위 명령입니다. 이 글의 예시는 Codex 대화형 화면을 열기 전 Bash 프롬프트에서 실행합니다.
Bash 외에 어떤 셸이 공식 문서에 나오나요?
현재 OpenAI 공식 명령 레퍼런스는 Bash, Zsh, Fish, PowerShell용 completion 스크립트 생성을 명시합니다. 이 글은 Bash만 검증했으므로 다른 셸의 로딩 명령은 각 셸 문서를 확인합니다.
source 명령이 Codex 설정이나 저장소를 바꾸나요?
이 글의
source <(codex completion bash)
는 생성된 completion 함수를 현재 Bash 프로세스에 불러옵니다. 시작 파일과 Codex 설정을 직접 수정하지 않습니다. 다만 실행 가능한 셸 코드이므로 먼저 내용을 검토합니다.
새 터미널에서도 자동 완성을 유지하려면 어떻게 하나요?
셸 시작 파일에 completion 로딩을 추가해야 할 수 있지만 공식 명령 설명은 모든 환경에 공통인 경로를 정하지 않습니다. 현재 셸, 운영체제, 조직 정책을 확인한 뒤 백업과 되돌리기 조건을 갖춘 별도 변경으로 진행합니다.
출처
마무리
Codex CLI 자동 완성을 처음 켤 때는 현재 Bash 세션만 대상으로 삼습니다.
codex completion bash
의 출력을 먼저 살펴본 뒤
source
하고,
complete -p codex
와 Tab 입력으로 확인합니다.
이 순서라면 시작 파일을 바꾸지 않고 기능부터 검증할 수 있습니다. 새 터미널에 영구 적용하는 작업은 현재 셸의 경로와 정책을 확인한 다음 별도 승인으로 진행합니다.
