쉬운 용어집

용어는 외우라고 있는 것이 아니라 작업을 덜 헷갈리게 하려고 있습니다. 이 페이지에서는 먼저 쉬운 말로 풀고, 필요할 때 원문을 함께 둡니다.

실행 표면

쉽게 말해 Codex가 일하는 장소입니다.

• CLI: 내 터미널에서 일합니다. 로컬 파일을 읽고, 수정하고, 테스트 명령을 돌리기 좋습니다.
• IDE extension: 내가 편집기에서 보고 있는 파일, 선택 영역, @file 맥락을 살려 수정하기 좋습니다.
• Codex app: 여러 작업 thread, review, worktree, automation, browser 작업을 한곳에서 다루기 좋습니다.
• Web/Cloud: 긴 작업을 클라우드에서 맡기고, GitHub와 연결해 PR 후보까지 만들기 좋습니다.

안전선과 승인

쉽게 말해 Codex에게 어디까지 허용할지 정하는 규칙판입니다.

예를 들어 “이 파일만 고쳐라”, “패키지 설치는 묻고 해라”, “비밀정보는 읽지 마라”, “테스트 삭제는 금지” 같은 기준입니다.

sandbox는 Codex가 기술적으로 닿을 수 있는 울타리이고, approval은 그 울타리를 넘을 때 사람에게 묻게 하는 규칙입니다.

신뢰 경계

쉽게 말해 무엇을 지시로 믿고, 무엇을 그냥 참고 자료로 읽을지 나누는 선입니다.

웹페이지, issue, log, PR 설명, MCP 응답 안에는 Codex를 속이는 명령형 문장이 들어갈 수 있습니다. 그런 문장은 작업 대상 데이터로 보고, 저장소 규칙과 사용자 요청과 승인 정책을 더 우선해야 합니다.

작업 패킷

쉽게 말해 일감 봉투입니다. 목표, 수정 범위, 금지할 행동, 확인할 증거를 한 번에 담습니다.

나쁜 요청은 “이거 알아서 고쳐줘”입니다. 좋은 작업 패킷은 “이 파일 범위에서 이 문제를 고치고, 테스트 결과와 diff를 남겨줘”에 가깝습니다.

패치 루프

쉽게 말해 고치고 확인하고 넘기는 한 바퀴입니다.

보통 범위 정하기 → 수정 diff 만들기 → 테스트/빌드 확인 → 리뷰 메모 → handoff 순서로 닫습니다.

goal

쉽게 말해 긴 작업을 끝까지 끌고 가기 위한 목표판입니다.

한 번에 끝나지 않는 리서치, 개선, 검증 루프를 돌릴 때 목표, 완료 기준, 남은 위험을 계속 붙잡는 데 씁니다. 좋은 goal은 “무엇을 만들지”뿐 아니라 “어떤 증거가 있으면 끝났다고 볼지”까지 포함합니다.

증거

쉽게 말해 사람이 결과를 믿을 수 있게 해 주는 흔적입니다.

대표 증거는 diff, 테스트 결과, 빌드 로그, 스크린샷, PR 리뷰 메모입니다. “잘 됐습니다”라는 말만으로는 증거가 아닙니다.

handoff

쉽게 말해 다음 사람이나 다음 세션에게 넘기는 인수인계 메모입니다.

무엇을 바꿨는지, 무엇을 확인했는지, 아직 불안한 점은 무엇인지 적습니다.

AGENTS.md

쉽게 말해 이 저장소에서 Codex가 먼저 읽는 작업 규칙입니다.

프로젝트 소개보다 명령어, 금지 행동, 승인 필요한 행동, 테스트 기준을 먼저 적는 것이 좋습니다.

worktree

쉽게 말해 같은 저장소를 여러 작업 책상으로 나누는 Git 기능입니다.

서로 다른 작업을 동시에 맡길 때 같은 파일을 덮어쓰지 않게 도와줍니다.

Skill

쉽게 말해 반복 작업 설명서입니다.

매번 같은 방식으로 해야 하는 작업이 있다면 SKILL.md에 절차, 참고 자료, 필요하면 스크립트를 묶어 둡니다.

Plugin

쉽게 말해 설치 가능한 기능 묶음입니다.

plugin은 skill, 외부 앱 연결, MCP server를 함께 담을 수 있습니다. 반복 작업 설명만 필요하면 skill로 충분하고, 다른 사람이 설치해서 쓰게 만들거나 외부 앱 연결까지 묶고 싶으면 plugin을 봅니다.

MCP

쉽게 말해 Codex가 다른 도구나 문서를 안전하게 찾아갈 수 있게 해 주는 연결 규격입니다.

브라우저, Figma, 사내 문서, 외부 개발 도구처럼 Codex 기본 환경 밖의 도구를 붙일 때 씁니다. 붙이기 전에 어떤 데이터가 오가는지와 승인선을 확인해야 합니다.

non-interactive mode

쉽게 말해 대화창을 열지 않고 Codex를 스크립트나 CI에서 실행하는 방식입니다.

codex exec처럼 한 번 실행하고 결과를 파일, JSONL, PR 댓글, CI 요약으로 남기는 작업에 씁니다. 자동 실행일수록 sandbox, approval, secret, 재검증 명령을 더 좁게 정해야 합니다.

Codex용 CLI

쉽게 말해 Codex가 반복 검증을 정확히 실행할 수 있게 만든 명령 도구입니다.

예를 들어 링크 검사, redirect 동기화, 콘텐츠 금칙어 검사처럼 사람이 읽으면 놓치기 쉬운 기준을 명령 하나로 실패하게 만듭니다. 좋은 CLI는 인자, 종료 코드, 예시 출력이 명확해야 Codex도 CI도 같은 기준으로 사용할 수 있습니다.

codex doctor

쉽게 말해 Codex CLI 상태 점검표입니다.

Codex CLI가 이상하게 동작할 때 runtime, 인증, terminal, network, config, local state 같은 기본 상태를 먼저 확인하는 진단 명령입니다. 결과를 외부에 공유하기 전에는 로컬 경로, 사용자 이름, 내부 주소, secret 단서가 들어 있지 않은지 확인해야 합니다.

eval

쉽게 말해 품질이 좋아졌는지 반복해서 비교하는 작은 시험지입니다.

AI 기능이나 문서 품질처럼 단순 테스트만으로 보기 어려운 영역에서 샘플 입력, 기대 기준, 실패 요약을 둡니다. eval은 사람 리뷰를 없애는 장치가 아니라 리뷰어가 같은 기준으로 판단하게 돕는 장치입니다.

Codex GitHub Action

쉽게 말해 GitHub Actions workflow 안에서 Codex를 실행하는 방법입니다.

CI 실패 자동 분류, PR 리뷰 보조, 릴리스 메모 작성처럼 반복 작업에 쓸 수 있습니다. 다만 workflow 권한, secret, PR 생성 권한을 사람 리뷰 범위에 포함해야 합니다.

remote connection

쉽게 말해 다른 기기에서 연결된 컴퓨터의 Codex를 조종하는 방식입니다.

휴대폰에서 지시하더라도 실제 파일, 명령, 로그인된 웹사이트, plugin, MCP, browser 권한은 연결된 host 기준입니다. 그래서 host 이름, 접근 권한, 회수 절차를 남겨야 합니다.

Memories와 Chronicle

쉽게 말해 Codex가 나중에 다시 참고할 수 있는 개인 기억 층입니다.

Memories는 반복 맥락과 선호를 줄이는 데 도움을 줍니다. Chronicle은 화면 맥락으로 기억을 만들 수 있으므로 민감 화면이나 회의 앞에서는 꺼야 합니다. 팀 규칙은 Memories가 아니라 AGENTS.md나 저장소 문서에 둡니다.

auto-review

쉽게 말해 사람에게 묻는 승인 요청을 별도 reviewer agent가 먼저 위험 평가하는 방식입니다.

자동 검토가 켜져도 sandbox 안에서 허용된 작업과 승인 필요한 작업은 구분됩니다. 거절, 타임아웃, high-risk 판단을 사람이 어떻게 볼지 정해야 합니다.

review note

쉽게 말해 리뷰어가 바로 판단할 수 있게 남기는 짧은 변경 설명입니다.

어떤 파일을 왜 바꿨는지, 어떤 테스트를 돌렸는지, 어떤 위험이 남았는지 적습니다.