코덱스 CLI 사용법: 초보 블로거를 위한 GEO 인용 검사 도구 만들기 과정
코덱스 CLI는 터미널에서 파일을 직접 읽고 만드는 코딩 도구입니다. 빈 폴더에서 시작해 내 글이 AI 답변에 인용되기 쉬운지 확인하는 GEO 점검 도구가 나올 때까지, 시킬 말 전문과 명령을 그대로 정리했습니다.
설치 다음에 멈추는 단계
코덱스 CLI를 설치하는 순서는 이미 여러 곳에 나와 있습니다. 그래서 설치까지는 어렵지 않게 끝납니다. 문제는 그다음입니다. 검은 화면에 커서만 깜빡이는데 무엇을 쳐야 할지는 어디에도 적혀 있지 않습니다.
그래서 설치만 해 두고 몇 주 동안 열어 보지 않게 되는 경우가 생깁니다. 도구가 낯설어서가 아니라 첫 한 줄을 못 정해서입니다.
코덱스 CLI는 터미널에서 파일을 직접 읽고 만드는 코딩 도구입니다. 시킬 일을 한국어로 적어 주면 폴더 안에서 스스로 파일을 만들고 실행까지 해 봅니다.
아직 설치 전이시라면 윈도우 설치 가이드 (윈도우 설치 순서 바로가기)나 맥 설치 가이드 (맥 설치 순서 바로가기)를 먼저 보시면 됩니다. 이 글은 설치를 마친 상태를 전제하고, 그 첫 한 줄부터 시작합니다.
시작 화면은 이렇습니다. 파일이 하나도 없는 폴더입니다.
만들려는 도구: GEO 점검기
무엇을 만들지부터 정하겠습니다. 어떤 도구이고 왜 하필 이것인지 먼저 설명드리고, 만드는 과정은 그다음에 보여드리겠습니다.
몇 년 전만 해도 검색창에 무언가를 치면 링크 목록이 나왔습니다. 지금은 챗GPT나 제미나이가 답을 문장으로 만들어 주고, 그 문장 아래에 참고한 글을 몇 개 붙여 줍니다. 사람이 링크를 하나씩 열어 보며 고르던 일을 기계가 대신하게 된 셈입니다.
이런 변화에 붙은 이름이 GEO(Generative Engine Optimization), 즉 생성형 엔진 최적화입니다. 검색 결과 순위를 올리는 일이 검색엔진 최적화(SEO)였다면, GEO는 AI가 만든 답변 안에 내 글이 인용되게 만드는 일이라고 볼 수 있습니다. 개념을 더 보고 싶으시면 생성형 엔진 최적화 (GEO) 이해하기 (GEO 개념 설명 바로가기)와 답변 엔진 최적화 (AEO) 이해하기 (AEO 개념 설명 바로가기)에 정리해 두었습니다.
요즘 이 주제를 묻는 분이 부쩍 늘었습니다. 검색으로 들어오던 방문자가 줄었다는 말이 여기저기서 나오기 때문입니다. 실제로 AI 답변이 검색 결과 위에 붙은 뒤 클릭률이 눈에 띄게 떨어졌다는 조사가 나왔고, 준이아빠블로그에서도 검색 트래픽 변화를 직접 확인해 (트래픽 실측 결과 바로가기) 정리한 적이 있습니다. 무엇부터 손대야 하는지는 GEO 최적화 하는 법 (실행 순서 바로가기)에 순서대로 적어 두었습니다.
문제는 점검입니다. 원칙은 알아도 내 글이 그 원칙을 지키고 있는지는 눈으로 세어 봐야 알 수 있습니다. 글이 늘어날수록 이 확인이 밀립니다.
쉽게 말해 이번에 만들 것은 블로그 글 주소를 넣으면 그 글이 AI 답변에 인용되기 쉬운 구조인지 항목별로 점수를 매겨 주는 명령줄 도구입니다. GEO 원칙 가운데 기계가 셀 수 있는 것만 골라 자동으로 확인하는 셈입니다.
점검할 항목은 다섯 가지로 잡았습니다.
| 항목 | 무엇을 보는지 | 왜 보는지 |
|---|---|---|
| 단정형 정의 문장 | 첫 문단에 X는 Y입니다 형태의 문장이 있는지 | 기계가 그대로 인용할 수 있는 완결 문장이 필요합니다 |
| JSON-LD | 글의 종류와 작성자를 기계용으로 적어 둔 조각이 있는지 | 사람 눈에는 안 보이지만 기계는 이것부터 읽습니다 |
| 질문형 소제목 | 물음표로 끝나는 소제목이 몇 개인지 | 질문과 답이 짝을 이루면 답변에 통째로 실리기 쉽습니다 |
| 인용 블록 | 따로 떼어 강조한 문장이 몇 개인지 | 인용 부분은 기계가 핵심으로 다루는 경향이 있습니다 |
| 대상 일치 | 메타 설명, 첫 문단, JSON-LD가 같은 것을 말하는지 | 세 곳이 어긋나면 무엇에 관한 글인지 판단하기 어려워집니다 |
이 다섯 가지는 준이아빠블로그에서 글을 쓸 때 실제로 지키는 기준입니다. 눈으로 확인하던 것을 명령 한 줄로 바꾸는 것이 이번 목표라고 볼 수 있습니다.
코덱스에 일을 시키는 방식
코덱스에 일을 시키는 것은 부엌에 요리사를 들여보내는 것과 비슷합니다. 어느 부엌을 쓸지, 그 안에서 무엇까지 해도 되는지를 먼저 정해 주고, 만들 음식을 적은 종이를 건네는 방식입니다.
부엌 문을 여는 명령이 codex exec입니다. 대화창을 띄우지 않고 한 번에 실행하는 방식이고, OpenAI 공식 문서는 이 방식을 스크립트와 CI, 즉 자동 실행 환경에서 쓰라고 안내합니다.
대화하며 시키는 방식도 물론 됩니다. 다만 한 번에 넘기는 방식을 고르면 명령과 결과가 전부 글자로 남습니다. 같은 명령을 다시 실행해 같은 순서를 되짚을 수 있다는 점도 이 방식의 장점이라고 볼 수 있습니다.
시킬 말 쓰기
시킬 말은 터미널에 바로 치지 않고 prompt.txt 파일에 적었습니다. 요리사에게 구두로 설명하는 대신 레시피를 종이에 적어 건네듯, 파일로 적어 두면 나중에 고쳐서 다시 돌리기도 편합니다.
아래가 실제로 적은 전문입니다. 그대로 복사해서 항목만 바꿔 쓰셔도 됩니다.
내 블로그 글 주소를 넣으면 AI 검색에 인용되기 좋은 글인지 점검해 주는 도구를 만들어 줘.
명령줄에서 이렇게 쓰고 싶어.
node check.mjs https://example.com/글주소
점검할 항목은 이거야.
1. 첫 문단에 "X는 Y입니다" 같은 단정형 정의 문장이 있는지
2. JSON-LD 구조화 데이터가 있는지, 있다면 어떤 종류인지 (Article, FAQPage, BreadcrumbList 등)
3. H2 소제목 가운데 질문형이 몇 개인지
4. 인용 블록(blockquote)이 몇 개인지
5. 메타 설명과 본문 첫 문단과 JSON-LD가 같은 대상을 말하고 있는지
마지막에 100점 만점 점수와 함께, 뭘 고치면 되는지 한 줄씩 알려 줘.
결과는 터미널에서 읽기 좋게 색을 넣어서 보여 줘.
조건:
- 외부 패키지는 쓰지 말고 Node.js 기본 기능만 써 줘. npm install 없이 바로 돌아갔으면 좋겠어.
- 한국어 글을 점검할 거라 한국어 문장 판별이 되어야 해.
- 주소가 잘못됐거나 접속이 안 되면 친절하게 알려 줘.
- README.md에 쓰는 법을 적어 줘.
중간에 나한테 되묻지 말고, 판단이 필요한 부분은 네가 알아서 정한 다음
끝까지 다 만들고 실제로 한 번 돌려서 되는지까지 확인해 줘.터미널에서는 이렇게 보입니다.
네 부분으로 나눠 적었고, 순서에 이유가 있습니다.
- 어떻게 쓸 것인지를 맨 앞에:
node check.mjs 주소형태로 쓰고 싶다고 먼저 적습니다. 무엇을 만들지보다 어떻게 쓸지를 먼저 알려 주는 편이 정확합니다. - 점검할 항목을 번호로: 다섯 가지를 나눠 적습니다. 한 문장에 몰아 넣으면 빠뜨리는 항목이 생깁니다.
- 조건을 따로 묶어서: 외부 패키지 사용 금지, 한국어 판별, 오류 안내, 설명서 작성처럼 만드는 방식에 관한 요구를 한데 모읍니다.
- 끝까지 하라는 지시를 맨 뒤에: 되묻지 말고 알아서 정하라고 적습니다.
마지막 문장이 특히 중요합니다. codex exec에는 대화창이 없어서 코덱스가 되물어도 답을 받을 방법이 없습니다. 이 문장이 빠지면 배점 방식 같은 것을 물어보고 질문만 남긴 채 그대로 종료됩니다.
명령 한 줄로 실행하기
시킬 말을 다 적었으면 명령은 한 줄입니다.
codex exec --sandbox workspace-write "$(cat prompt.txt)"--sandbox 옵션이 부엌에서 무엇까지 해도 되는지를 정합니다. 세 가지 중에서 고릅니다.
| 값 | 할 수 있는 일 | 쓰는 경우 |
|---|---|---|
read-only | 파일을 읽기만 합니다 | 코드 검토, 구조 파악 |
workspace-write | 그 폴더 안에서 파일을 만들고 고칩니다 | 이 글처럼 뭔가를 만들 때 |
danger-full-access | 제한이 없습니다 | 신뢰할 수 있는 작업에만 |
기본값은 read-only입니다. OpenAI 공식 문서도 아무 옵션 없이 codex exec를 실행하면 읽기 전용 샌드박스에서 돌아간다고 설명합니다. 이 옵션을 빼면 파일이 하나도 만들어지지 않습니다.
한 가지가 더 있습니다. workspace-write를 붙여도 인터넷은 열리지 않습니다. 직접 확인해 보니 주소를 찾는 단계부터 막혔습니다.
curl: (6) Could not resolve host: example.com
이번에 만들 도구는 인터넷에서 페이지를 받아 와야 합니다. 코덱스가 그 도구를 직접 시험해 보게 하려면 설정을 하나 더 켭니다. 요리사를 부엌 밖 시장까지 내보내는 셈입니다.
codex exec --sandbox workspace-write \
-c sandbox_workspace_write.network_access=true "$(cat prompt.txt)"3분 12초 뒤에 나온 것
실행이 끝나자 폴더에 파일 두 개가 생겼습니다.
check.mjs가 실행 파일이고 README.md가 사용 설명서입니다. 외부 패키지를 하나도 쓰지 않아서 npm install 없이 바로 실행됩니다. 점수 배점은 정해 주지 않았는데 코덱스가 항목별로 알아서 나눠 놓았습니다.
실제로 돌려 본 화면입니다. 준이아빠블로그의 Orca 사용법 글 주소를 넣었습니다.
Orca 사용법 글은 85점이 나왔습니다. 정의 문장과 구조화 데이터는 채웠는데 질문형 소제목이 하나도 없어서 그 항목만 0점입니다. 눈으로 읽을 때는 몰랐던 부분입니다.
이렇게 항목별로 나오면 어디를 고쳐야 할지가 분명해집니다. 다른 글에 돌려 보니 정의 문장이 빠진 글, 인용 블록이 없는 글이 각각 다른 항목에서 점수를 잃었습니다.
다만 이 점수는 어느 AI 서비스의 공식 지표도 아닙니다. GEO 원칙 가운데 기계가 셀 수 있는 것만 추려 만든 기준이라, 글을 고칠 곳을 찾는 신호로 보는 편이 맞습니다. 실제로 무엇을 고쳐야 성과가 달라지는지는 실제 적용 사례로 알아보는 AEO 잘하는 법 (적용 사례 바로가기)에 정리해 두었습니다.
이어서 고쳐 달라고 말하기
한 번에 원하는 결과가 나오지는 않았습니다. 출력에 쓰지 않기로 한 기호가 섞여 있어서 고쳐 달라고 다시 말했습니다. 이럴 때는 처음부터 다시 시키지 않고 앞 작업을 이어받습니다.
codex exec resume --last "출력에서 가운뎃점을 쓰지 말고 쉼표로 바꿔 줘. 되묻지 말고 고친 다음 실제로 돌려서 확인해 줘."resume --last는 마지막 작업을 이어받는 명령입니다. 코덱스가 앞에서 무엇을 만들었는지 이미 알고 있어서 설명을 처음부터 하지 않아도 됩니다.
여기서 걸린 점이 하나 있습니다. resume은 codex exec가 받는 옵션을 전부 받지는 않습니다. --sandbox나 --cd를 붙이면 오류가 나면서 그대로 종료됩니다. 샌드박스는 아래처럼 설정 형태로 넘깁니다.
codex exec resume --last -c sandbox_mode="workspace-write" "고칠 내용"터미널 화면을 이미지로 남기는 방법
이 글의 터미널 이미지는 전부 VHS라는 도구로 뽑았습니다. 대본 파일에 칠 명령과 캡처할 시점을 적어 두면 이미지가 나옵니다. 글을 고칠 때 이미지를 다시 뽑는 것이 명령 한 줄이라, 글과 화면이 어긋나지 않습니다.
Set FontFamily "D2Coding"
Set Height 700
Type "node check.mjs https://example.com/글주소"
Enter
Sleep 15s
Screenshot "04-result.png"한국어 화면을 찍을 때는 폰트를 지정해야 합니다. 기본 폰트에 한글이 없어서 글자 사이가 벌어진 채로 나옵니다. D2Coding처럼 한글이 들어 있는 고정폭 폰트를 지정하면 해결됩니다.
코덱스 CLI는 무료로 쓸 수 있나요?
챗GPT 계정으로 로그인해서 씁니다. 2026년 8월 기준 OpenAI 안내에 따르면 코덱스는 무료 요금제를 포함한 챗GPT 요금제 전반에 포함됩니다. 다만 쓸 수 있는 양은 요금제마다 다르고, 한도에 닿으면 추가로 구매하거나 상위 요금제로 올리는 방식입니다. 한도 기준은 자주 바뀌므로 결제 전에 공식 안내를 확인하시는 편이 정확합니다.
코딩을 몰라도 쓸 수 있나요?
이 글에서 손으로 친 명령은 codex exec, codex exec resume, node check.mjs 세 종류입니다. 나머지는 한국어로 무엇을 만들지 적은 것이 전부입니다. 만들어진 코드를 읽지 않아도 실행하고 결과를 보는 데는 지장이 없습니다.
다만 결과가 맞는지 판단하는 몫은 남습니다. 이 글의 도구도 처음에는 원하지 않은 기호를 출력했고, 돌려 보고 나서야 알았습니다. 요리사가 만든 음식을 한 번은 맛봐야 하듯, 만들게 하는 것보다 확인하는 것이 실제로 더 중요한 단계라고 볼 수 있습니다.
만든 것을 다른 사람에게 주려면 어떻게 하나요?
파일 두 개를 그대로 보내면 됩니다. 외부 패키지를 쓰지 않았기 때문에 받는 쪽에서도 Node.js만 설치되어 있으면 실행됩니다. 설명서를 함께 만들어 달라고 시킨 이유가 여기에 있습니다.
3줄 요약
- 코덱스 CLI는 터미널에서 파일을 직접 읽고 만드는 코딩 도구입니다.
codex exec에 시킬 말을 넘기면 폴더 안에서 파일을 만들고 실행해 봅니다. 이 글에서는 GEO 점검 도구를 3분 12초 만에 만들었습니다. - 시킬 말은 완성된 사용 모습, 점검 항목, 조건, 끝까지 하라는 지시 순서로 적습니다. 마지막 지시가 빠지면 질문만 남기고 종료됩니다.
- 파일을 만들게 하려면
--sandbox workspace-write가 필요합니다. 기본값은 읽기 전용이고, 인터넷 접근은 이 옵션과 별개로 따로 켭니다.
Sources
이 글이 도움이 되셨다면 공유해 주세요
메신저로 바로 보내거나 링크를 복사할 수 있습니다.
Written by
데이터로 설명하는 마케터
디지털마케터 뉴스레터
GA4, SEO, AI 마케팅 실무 인사이트를 월 1~2회 이메일로 보내드립니다.
다음으로 읽어볼 글
마크다운은 더 이상 개발자의 문서 도구가 아닙니다. AI 에이전트의 행동 규칙을 정하고, 스킬을 정의하고, 프롬프트 품질을 높이는 AI 시대의 핵심 소통 수단이 된 마크다운의 변화를 초보자 눈높이에서 설명합니다.
2026. 2. 21.
AI 배포 경쟁은 같은 모델을 몇 개의 화면에 넣어 두느냐로 우열이 정해지는 경쟁입니다. 2026년 8월 12일부터 15일 사이에 나온 발표 다섯 건을 놓고, 각 회사가 모델을 어디까지 밀어 넣었는지 공식 자료 기준으로 정리했습니다.
2026. 8. 15.
클로드 코드를 설치했는데 검은 PowerShell 창이 부담스러운 분을 위해, VS Code를 설치하고 그 안 터미널에서 클로드 코드를 실행하는 순서를 화면 그림과 함께 정리했습니다. 승인 질문을 건너뛰는 bypass 모드까지 담았습니다.
2026. 8. 12.
챗GPT 리눅스 데스크톱 앱은 오픈AI가 2026년 8월 11일 프리뷰로 공개한 리눅스용 공식 앱으로, ChatGPT와 Work, Codex를 하나의 앱에서 쓸 수 있습니다. 설치 패키지 4종과 테스트된 배포판, 요금 조건에서 확인된 것과 아직 확정되지 않은 것을 구분해 정리했습니다.
2026. 8. 12.codex exec를 아무 옵션 없이 실행하면 코덱스는 무엇을 할 수 있을까요?