Skip to content

7장. 터미널에서 쓰기 — codex exec 한 줄로 정리도구 확인 ​

선택 필요할 때 읽으세요. 건너뛰어도 뒤 장을 따라갈 수 있습니다.

한 줄 요약: Codex CLI는 터미널에서 쓰는 Codex입니다. 실행한 폴더의 AGENTS.md와 스킬을 읽습니다. codex exec "할 일"은 한 번 실행하고 끝나며, 기본이 읽기 전용입니다. Claude Code의 claude -p와 비슷하지만 이 점이 다릅니다.

이 장은 2026년 11월 1일에 확인한 Codex 공식 문서와, macOS 터미널에서 Codex CLI를 실행한 결과를[1] 바탕으로 썼습니다. 터미널이 처음이라면 이 장은 건너뛰어도 됩니다. 터미널이 무엇인지는 Claude Code 10장에서 설명했습니다.

설치하고 시작하기 ​

공식 문서의 설치 명령은 이렇습니다.[2]

bash
# macOS, Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
powershell
# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

명령을 조각별로 풀면 이렇습니다.

  • curl -fsSL 주소: 주소에 있는 설치 스크립트(설치 순서를 적어 둔 파일)를 내려받습니다. -fsSL은 "오류가 나면 멈추기, 진행 표시 숨기기, 오류는 보여 주기, 주소가 옮겨졌으면 따라가기"라는 옵션 네 개를 붙여 쓴 것입니다.
  • |(파이프): 앞 명령의 결과를 뒤 명령에 넘깁니다.
  • sh: 넘겨받은 스크립트를 실행합니다.
  • Windows 쪽도 같습니다. irm이 내려받고, iex가 실행합니다. -ExecutionPolicy ByPass는 이번 한 번만 스크립트 실행 제한을 풀어 줍니다.

설치 명령은 공식 문서(learn.chatgpt.com)에 적힌 그대로인지 확인하고 실행하세요. 인터넷에서 받은 스크립트를 바로 실행하는 명령이기 때문입니다.

설치가 끝나면 정리도구 폴더로 이동해 codex를 칩니다. 처음에는 Sign in with ChatGPT를 고릅니다.[3]

bash
cd ~/hello-ai-연습/정리도구
codex

터미널의 Codex는 실행한 폴더를 그 대화의 프로젝트로 봅니다.[4] 앱에서 Choose project로 폴더를 고르던 일을 cd가 대신합니다.

확인 퀴즈

터미널에서 Codex CLI 설치 명령을 실행하기 전에 꼭 확인할 것은 무엇일까요?

codex exec — 한 번 묻고 끝내기 ​

codex exec는 대화 화면을 열지 않고 한 번 실행하고 끝나는 방식입니다.[5] Claude Code 10장과 같은 질문을 해 봤습니다.

bash
cd ~/hello-ai-연습/정리도구
codex exec "notes 폴더의 파일 목록을 보여 주고, 각 파일이 어떤 양식(templates 중 무엇)으로 쓰였는지 한 줄씩 알려 줘. 파일은 고치지 마. 답은 짧게 표로만."

답만 깔끔하게 나왔습니다(전체 출력: 7장-codex-exec-출력.txt).

notes 파일사용된 양식
공부-2026-10-28-프롬프트-강의.mdtemplates/공부노트.md
주간회고-2026-10-26.mdtemplates/주간회고.md
회의록-2026-10-27-주간회의.mdtemplates/회의록.md

출처: 이 가이드의 실습 결과(2026-11-01). 진행 기록은 따로 버리고 최종 답만 남겼다.

codex exec는 진행 상황과 최종 답을 다른 길로 내보냅니다.[6]

  • 진행 상황: 화면 옆길(stderr, 스탠다드 에러)로 나갑니다.
  • 최종 답: 정식 출력(stdout, 스탠다드 아웃)으로만 나갑니다.

이 차이는 결과를 파일로 받을 때 쓸모가 있습니다. 예를 들어 codex exec "…" > 결과.md를 쳐 보세요. >는 "정식 출력을 화면 대신 이 파일에 담아라"라는 기호입니다. 그러면 화면에는 진행 상황만 지나가고, 결과.md에는 최종 답만 담깁니다. 같은 이름의 파일이 이미 있으면 >가 그 내용을 지우고 새로 씁니다. 그러니 처음 쓰는 새 이름을 고르세요.

codex exec는 기본이 읽기 전용입니다. 파일을 고치게 하려면 --sandbox workspace-write를 붙입니다.[7] 이 가이드의 2·3·5장 실습도 이 옵션을 붙여 실행했습니다.

bash
codex exec --sandbox workspace-write '$weekly-review'

codex exec는 허락 방식을 미리 정해 두고 돌리는 방식입니다.[8] 이 가이드의 5장 실습에서는 .agents 폴더 쓰기가 막히자, Codex가 묻지 못하고 그대로 멈췄습니다. 허락이 필요한 일은 앱이나 대화형 codex에서 하는 편이 편합니다.

샌드박스와 허락을 모두 끄는 위험한 옵션도 있지만, 메모 정리에는 쓰지 마세요.

옛 글에 나오는 옵션과 위험한 옵션 (눌러서 펼치기)

옛 글에 나오는 --full-auto 옵션은 더 이상 지원하지 않습니다.[9] 샌드박스와 허락을 모두 끄는 --dangerously-bypass-approvals-and-sandbox 같은 옵션도 있지만[10], 메모 정리에는 필요 없습니다.

확인 퀴즈

codex exec로 파일을 고치게 하려는데 아무것도 바뀌지 않았습니다. 가장 알맞은 이유는 무엇일까요?

대화형 codex 안의 명령 ​

codex로 대화형을 열면 /로 시작하는 명령을 씁니다.

명령하는 일
/permissions권한 바꾸기(앱의 권한 메뉴)
/importClaude Code·Cursor 설정 가져오기
/resume저장된 대화 이어 가기
/status대화 정보와 남은 한도 보기
/skills스킬 목록 보기

출처: Codex 공식 문서[11][12][13][14][15]

대화형을 끝낸 뒤 밖에서 이어 가려면 codex resume을 칩니다.[13:1]

/permissions와 /import는 터미널 쪽 명령입니다. 앱에서는 입력창 아래 권한 메뉴(4장)와 설정의 Import 메뉴(3장)를 씁니다.

확인 퀴즈

Codex CLI 대화형 화면에서 대화 정보와 남은 한도를 보려면 어떤 명령을 쓸까요?

직접 해 보기 ​

  1. 공식 문서의 설치 명령과 위 명령이 같은지 확인한 뒤 설치한다(이미 있으면 codex --version).
  2. 정리도구 폴더로 이동해 위의 읽기 전용 codex exec 질문을 실행한다.
  3. codex로 대화형을 열고 /status를 쳐 본다.
  4. $를 치거나 /skills를 실행해 5장의 스킬 이름이 보이는지 확인한다.[15:1]

이어지는 과제: 8장에서는 비용·데이터·안전을 정리하고, 숨은 지시가 든 메모를 Codex가 어떻게 다루는지 확인합니다.

정리 ​

  • 터미널의 Codex는 실행한 폴더를 프로젝트로 보고, 그 폴더의 AGENTS.md·스킬을 읽는다.
  • 설치 명령은 공식 문서와 같은지 확인하고 실행한다.
  • codex exec는 한 번 실행하고 끝나며, 기본이 읽기 전용이다. 고치려면 --sandbox workspace-write.
  • codex exec는 허락 방식을 미리 정해 두고 돈다. 허락이 필요한 일은 앱이나 대화형에서.

용어 정리 ​

용어읽는 법한 줄 뜻
Codex CLI코덱스 씨엘아이터미널에서 쓰는 Codex
codex exec코덱스 이그젝한 번 실행하고 끝내는 방식
stdout / stderr스탠다드 아웃 / 스탠다드 에러정식 출력 / 진행 상황·오류가 나가는 옆길

이 장을 다 읽었나요?

기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.

다음 장: 8장. 비용·데이터·안전, 그리고 도구 고르기

참고 자료 (15개)
  1. 이 가이드가 실행한 버전은 Codex CLI 0.166.0입니다. ↩︎

  2. Codex 공식 문서, 「Codex CLI」. "curl -fsSL chatgpt.com | sh" / "powershell -ExecutionPolicy ByPass -c "irm chatgpt.com | iex"" learn.chatgpt.com (확인일 2026-11-01) ↩︎

  3. Codex 공식 문서, 「Codex CLI」. "Open a project directory and run codex. The first time you run Codex, choose Sign in with ChatGPT or another available sign-in method." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  4. Codex 공식 문서, 「Projects and chats」. "Codex CLI treats the directory where you start it as the project for the chat." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  5. Codex 공식 문서, 「Non-interactive mode」. "Non-interactive mode lets you run Codex from scripts (for example, continuous integration (CI) jobs) without opening the interactive TUI." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  6. Codex 공식 문서, 「Non-interactive mode」. "While codex exec runs, Codex streams progress to stderr and prints only the final agent message to stdout." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  7. Codex 공식 문서, 「Non-interactive mode」. "By default, codex exec runs in a read-only sandbox." / "Allow edits: codex exec --sandbox workspace-write "<task>"" learn.chatgpt.com (확인일 2026-11-01) ↩︎

  8. Codex 공식 문서, 「Non-interactive mode」. "Run with explicit, pre-set sandbox and approval settings." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  9. Codex 공식 문서, 「Non-interactive mode」. "--full-auto is no longer supported." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  10. Codex 공식 문서, 「Agent approvals & security」. "--dangerously-bypass-approvals-and-sandbox (alias: --yolo)" learn.chatgpt.com (확인일 2026-11-01) ↩︎

  11. Codex 공식 문서, 「Permissions」. "In the CLI, enter /permissions." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  12. Codex 공식 문서, 「Import from another agent」. "Start a local Codex CLI session and type /import." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  13. Codex 공식 문서, 「Projects and chats」. "Use /resume while Codex is open, or run codex resume, to continue a saved chat." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  14. Codex 공식 문서, 「Pricing」. "If you want to see your remaining limits during an active Codex CLI session, you can use /status." learn.chatgpt.com (확인일 2026-11-01) ↩︎

  15. Codex 공식 문서, 「Build skills」. "In Codex CLI or the IDE extension, run /skills or type $ to mention a skill." learn.chatgpt.com (확인일 2026-11-01) ↩︎