코드를 새로 짜거나 리팩터링할 때마다 반복 작업에 시간을 뺏기고 있다면, OpenAI의 코딩 에이전트를 업무에 끌어들이는 방법부터 알아둘 필요가 있습니다. 이 글에서는 GPT Codex 사용법을 처음 접하는 실무자를 기준으로, 접근 경로 3가지와 승인 모드, 프로젝트 규칙을 알려주는 법까지 순서대로 정리했습니다. Codex는 2025년 10월 정식 출시(GA)된 이후 빠르게 팀 워크플로우에 자리 잡고 있는 도구입니다.
📌 핵심 요약
- 접근 경로는 ChatGPT 사이드바, 터미널 CLI, Slack 세 갈래입니다. 설치 없이 시작하려면 첫 번째, 실제 리포지토리를 다루려면 두 번째가 맞습니다.
- CLI 설치는
npm i -g @openai/codex한 줄이고 ChatGPT 계정으로 로그인하면 API 키가 필요 없습니다. - 권한은 Suggest·Auto Edit·Full Auto가 아니라
--sandbox(범위)와--ask-for-approval(승인 시점) 두 축으로 나뉩니다.
이 글은 이런 분께 추천합니다: 코딩 에이전트를 처음 업무에 붙여보려는 실무자, 자동화 수준을 어디까지 열어줄지 정해야 하는 팀 리드.
GPT Codex란 무엇인가
Codex는 OpenAI가 만든 코딩 에이전트로, 사람이 한 줄씩 코드를 치는 대신 작업 단위로 지시하면 에이전트가 코드 작성·수정·테스트까지 대신 처리합니다. 2025년 10월 정식 출시된 뒤 지속적으로 업데이트되며 실무 도구로 자리 잡았습니다.
OpenAI는 Codex를 코드 작성부터 리팩터링, 버그 수정, 테스트 실행까지 한 번에 위임할 수 있는 에이전트로 소개하고 있습니다. 2026년 7월 9일 업데이트로 기반 모델이 GPT-5.6 계열로 바뀌면서 복잡한 멀티파일 작업에서도 정확도가 올라갔습니다. 스크린샷 같은 이미지를 첨부해 “이 화면과 똑같이 UI를 고쳐줘”처럼 시각적 지시를 내리는 것도 가능해졌습니다.
예를 들어 오래된 API 응답 형식을 새 스키마로 바꾸는 작업을 지시하면, Codex는 관련 파일을 모두 찾아 수정하고 테스트를 돌려본 뒤 결과를 요약해서 보고합니다. 사람은 그 결과만 검토하면 됩니다. 파일을 하나씩 열어 고치는 시간이 그만큼 줄어듭니다.
접근 경로 3가지: ChatGPT, 터미널, Slack
Codex는 하나의 도구가 아니라 세 가지 경로로 접근할 수 있는 서비스입니다. 업무 환경에 따라 어떤 경로가 맞는지 먼저 파악해두면 도입이 훨씬 수월합니다.
가장 가벼운 건 ChatGPT 사이드바의 “Code” 버튼입니다. 누르면 클라우드 샌드박스에서 작업이 돌아갑니다. 로컬에 아무것도 깔지 않고 브라우저에서 바로 시작할 수 있어 진입장벽이 낮습니다. 그다음이 터미널에서 codex 명령어로 여는 CLI입니다. ChatGPT Plus·Pro·Business·Enterprise 계정으로 로그인하면 별도 API 키 없이 로컬 환경에서 바로 씁니다. 마지막은 Slack입니다. 채널에서 @Codex를 멘션해 그 자리에서 작업을 맡깁니다.
빠르게 아이디어를 검증하고 싶다면 ChatGPT 사이드바로 시작하고, 실제 리포지토리를 다루는 반복 작업은 터미널 CLI로 넘어가고, 팀원과 진행 상황을 공유해야 한다면 Slack 경로를 쓰는 식으로 상황별로 나눠 쓰는 것이 효율적입니다.
세 갈래가 기본이지만 CLI를 깔아보면 항목이 더 있습니다. codex app은 데스크톱 앱을 띄우고(없으면 설치 화면으로 넘어갑니다), codex cloud는 Codex Cloud의 작업을 가져와 로컬에 적용합니다. 다만 codex cloud는 도움말에 [EXPERIMENTAL]로 표시돼 있어 업무에 넣기 전에 한 번 더 확인하는 편이 좋습니다.
터미널 CLI로 시작하기: 설치부터 승인 모드까지
실제 리포지토리 작업에는 터미널 CLI가 가장 유용합니다. 설치하고 로그인하면 바로 쓸 수 있습니다. 관건은 권한을 어디까지 열어줄지 정하는 일입니다.
설치는 npm 한 줄입니다. 실제로 깔아보니 2초, 2개 패키지로 끝났습니다.
$ npm i -g @openai/codex
added 2 packages in 2s
$ codex --version
codex-cli 0.145.0
Rust로 빌드된 바이너리를 내려받는 방식이라 컴파일 단계가 없습니다. 로그인은 codex login으로 합니다. 이미 ChatGPT 계정이 연결돼 있으면 codex login status가 Logged in using ChatGPT를 돌려줍니다. 별도 API 키는 필요 없습니다.
2026년 7월 28일 실사용 확인: 여러 글에서 소개하는 Suggest·Auto Edit·Full Auto라는 승인 모드 이름은 0.145.0 CLI에 없습니다. 지금은 권한이 두 축으로 나뉘어 있고, 이 둘을 조합해서 씁니다.
codex --help에 그대로 나옵니다.
-s, --sandbox <SANDBOX_MODE>
[possible values: read-only, workspace-write, danger-full-access]
-a, --ask-for-approval <APPROVAL_POLICY>
untrusted: ls, cat 같은 "신뢰된" 명령만 승인 없이 실행
on-request: 승인을 물을 시점을 모델이 판단
never: 묻지 않음. 실행 실패는 모델에게 그대로 반환
--sandbox는 무엇을 건드릴 수 있는가를, --ask-for-approval은 언제 사람에게 묻는가를 정합니다. 예전 “Full Auto”에 해당하는 건 -s workspace-write -a never 같은 조합입니다. 옛 이름으로 검색해서 나오는 설명은 지금 화면과 맞지 않으니 codex --help를 먼저 보는 편이 빠릅니다.
샌드박스가 실제로 뭘 막는지는 codex sandbox로 직접 확인할 수 있습니다. 읽기는 통과하고 쓰기와 네트워크는 막힙니다.
$ codex sandbox -- sh -c 'head -2 /etc/hosts'
##
# Host Database
$ codex sandbox -- sh -c 'echo test > ~/probe.txt'
sh: /Users/…/probe.txt: Operation not permitted
$ codex sandbox -- sh -c 'curl -s -m 8 -o /dev/null -w "%{http_code}" https://example.com'
000
한 가지 헷갈리는 지점이 있습니다. 위 실험에서 -s workspace-write를 붙여도, git 리포지토리 안에서 돌려도 쓰기가 계속 막혔습니다. codex sandbox --help를 보면 이 하위 명령에는 -s가 아예 없고 --permission-profile을 씁니다. 즉 codex sandbox는 임시로 명령 하나를 가둬 돌리는 용도라 별도 프로파일을 따르고, -s는 에이전트 세션에 적용되는 옵션입니다. 두 개를 같은 것으로 보면 “workspace-write가 고장 났다”고 오해하게 됩니다.
처음 써본다면 -s read-only로 몇 번 지켜보다가 -s workspace-write -a on-request로 올리는 순서가 안전합니다. danger-full-access와 --dangerously-bypass-approvals-and-sandbox는 이름 그대로 외부에서 이미 격리된 환경에서만 쓰라고 도움말에 적혀 있습니다.
작업 중 자리를 비웠다가 이어가려면 codex resume으로 이전 세션을 불러옵니다. --last를 붙이면 가장 최근 세션이 바로 열립니다. 세션을 갈래로 나누는 codex fork, 보관·삭제용 archive·delete도 같이 있습니다. 설치나 인증이 꼬였을 때는 codex doctor가 버전·설치 경로·git 감지 여부까지 한 번에 점검해 줍니다.
--sandbox)와 승인 시점(--ask-for-approval)을 따로 정해 자동화 수준을 맞춥니다. (Photo by Jakub Zerdzicki on Pexels)AGENTS.md와 SDK로 프로젝트에 맞게 확장하기
Codex를 팀 전체 워크플로우에 붙이려면 리포지토리 규칙을 알려주는 AGENTS.md 파일과, 자체 파이프라인에 임베드할 수 있는 SDK·GitHub Action을 함께 알아둬야 합니다.
리포지토리 루트에 AGENTS.md 파일을 두면 Codex가 테스트 실행 명령어나 코딩 컨벤션 같은 프로젝트 고유 규칙을 참고해서 작업합니다. 매번 프롬프트에 같은 규칙을 반복해서 설명할 필요가 없어집니다. 더 나아가 TypeScript로 제공되는 Codex SDK를 쓰면 자체 CI/CD나 사내 도구 안에 Codex를 직접 임베드할 수 있습니다. GitHub Action을 등록하면 PR이 올라올 때마다 자동으로 리뷰나 수정 작업을 맡기는 것도 가능합니다.
신입 개발자가 프로젝트 컨벤션을 몰라도 됩니다. AGENTS.md에 “테스트는 npm test로 실행하고 커밋 메시지는 이런 형식을 따른다”고 적어두면 Codex가 그 규칙을 그대로 지켜서 작업합니다. GitHub Action으로 등록해두면 PR을 열 때마다 자동으로 린트·테스트 결과를 확인하는 식으로 팀 리뷰 부담을 줄일 수 있습니다.
마무리
핵심은 세 가지입니다. 접근 경로는 ChatGPT 사이드바·터미널 CLI·Slack 중 업무 환경에 맞는 것을 고르고, CLI에서는 --sandbox로 건드릴 범위를 --ask-for-approval로 물어볼 시점을 따로 정하고, 팀 단위로 쓸 계획이라면 AGENTS.md와 SDK·GitHub Action까지 챙겨두는 것입니다.
아직 안 써봤다면 npm i -g @openai/codex로 설치한 뒤 -s read-only로 첫 작업을 맡겨보시기 바랍니다. 읽기만 허용된 상태라 잘못 지시해도 파일이 바뀌지 않습니다.
콘텐츠 제작·자동화와 관련된 글도 함께 보면 흐름이 잘 잡힙니다.
이 글은 챗GPT 활용 묶음에 속합니다. 같은 주제의 글을 배우는 순서대로 묶어 두었으니 묶음 페이지에서 이어 보세요.
글쓴이 · K.Lee — 파티시에로 일하며 AI·자동화 도구를 실무에 매일 씁니다. 확인한 범위와 확인하지 못한 범위를 글 안에 밝힙니다. 운영자 소개 · 편집 원칙 · 수정 정책
답글 남기기