활용 사례 · Codex

Codex로 하는 데이터 분석: 쿼리, CSV, 구조화된 결과

Codex는 답 뒤에 있는 SQL과 Python을 쓰고 실행하며, 숫자를 확인하고 설명합니다. 미리 계획해 둘 부분은 샌드박스입니다. 기본적으로 명령이 네트워크에 닿지 못하므로 웨어하우스나 API 쿼리에는 네트워크 접근을 켜야 하고, 워크스페이스에 있는 CSV는 그대로 쓸 수 있습니다. 이 페이지에서는 접근 설정, AGENTS.md 규칙, 그리고 결과를 JSON으로 받는 방법을 다룹니다.

데이터 분석에서 Codex가 하는 일

  • 읽기 전용 역할이나 복제본에 SQL을 실행해 질문에 답하고, 답과 함께 쿼리를 보여 줍니다.
  • CSV 내보내기 파일을 Python으로 정리하고 분석하며 차트를 그립니다.
  • 주간 지표 다이제스트를 씁니다: 무엇이 얼마나 움직였는지, 그리고 추정되는 이유.
  • 가입 감소나 오류 급증 같은 이상 징후를 누가 알아채기 전에 알립니다.

데이터 분석에 쓰는 Codex 기능

기능하는 일시작 방법
데이터베이스 CLI 또는 MCP 서버읽기 전용 역할로 데이터베이스나 웨어하우스를 쿼리합니다샌드박스 안의 CLI, 또는 config.toml의 MCP 서버
네트워크 접근명령이 웨어하우스나 API에 닿게 합니다. 기본값은 꺼짐입니다[sandbox_workspace_write] 아래 network_access = true
--output-schema최종 답을 내 스키마에 맞는 JSON으로 반환합니다codex exec --output-schema schema.json -o result.json
예약 작업ChatGPT 데스크톱 앱이나 웹에서 주간 다이제스트를 받습니다Scheduled에서 생성

데이터 분석용 Codex 설정 방법

  1. 도구 연결하기

    Codex에 읽기 전용 역할을 주고, 데이터가 워크스페이스에 없을 때만 네트워크 접근을 켜세요. 프로젝트 폴더의 CSV 내보내기 파일에는 따로 필요한 것이 없습니다.

    # ~/.codex/config.toml: 명령이 웨어하우스에 닿을 수 있게
    [sandbox_workspace_write]
    network_access = true
  2. AGENTS.md에 규칙 쓰기

    Codex는 일을 시작하기 전에 AGENTS.md를 읽습니다. 먼저 ~/.codex/AGENTS.md를, 이어서 저장소 루트부터 작업 중인 폴더까지의 파일을 읽습니다. 이 일의 규칙을 여기에 넣거나, 길다면 .agents/skills/ 아래 스킬로 만드세요. AGENTS.md 가이드를 참고하세요.

    ## 데이터 규칙
    - 읽기 전용: 앱의 데이터베이스 사용자가 아니라 분석용 역할을
      쓰세요. INSERT, UPDATE, DELETE, 스키마 변경은 하지 마세요.
    - 모든 숫자에 그 뒤에 있는 쿼리나 스크립트를 보여 주세요.
    - 이전 기간과 비교하고, 변화가 평소 변동 범위 안이면
      그렇다고 말하세요.
    - 개인 데이터는 내보내지 마세요. 무엇이든 적기 전에
      집계하세요.
    - 주간 다이제스트: 중요한 숫자 다섯 개, 무엇이 움직였는지,
      다음 주에 던져 볼 만한 질문 하나.
  3. 대화형 화면 없이 실행하기

    codex exec 명령은 작업 하나를 실행하고 종료합니다. 진행 상황은 stderr로, 최종 메시지는 stdout으로 나옵니다. -o는 최종 메시지를 파일에도 쓰고 --json은 이벤트를 스트리밍합니다. --sandbox workspace-write를 넘기지 않으면 샌드박스는 읽기 전용입니다.

    # 지난주 수치를 내 스키마에 맞는 JSON으로
    codex exec --sandbox workspace-write --output-schema metrics.schema.json \
      -o metrics.json "지난주 가입, 활성화, 매출을 계산하고 그 전주와 비교해 줘"
  4. 일정에 올리기

    ChatGPT 데스크톱 앱이나 웹에서 예약 작업을 만들거나(CLI로는 관리할 수 없습니다), cron에서 codex exec 명령을 실행하세요. Codex를 능동적으로 만드는 방법을 참고하세요.

출처: Codex 문서

한계와 안전

  • 읽기 전용 역할을 주세요. 데이터베이스에 쓰기 권한이 있는 에이전트는 데이터를 바꿀 수 있습니다.
  • 열의 의미를 잘못 이해할 수 있습니다. 짧은 데이터 사전을 쓰고 처음 몇 개의 답을 확인하세요.
  • 결과가 크면 컨텍스트와 사용량이 듭니다. 행을 읽기 전에 쿼리로 집계하세요.
  • Codex는 기본적으로 명령을 샌드박스 안에서 실행합니다. 쓰기는 워크스페이스 안에서만 되고 네트워크는 꺼져 있습니다. danger-full-access는 격리된 러너나 컨테이너에서만 쓰세요.

데이터 분석에는 Claude Code와 Codex 중 무엇을 쓸까요?

규칙은 그대로 옮겨 쓸 수 있습니다. AGENTS.md에 한 번 쓰고 CLAUDE.md에 @AGENTS.md를 넣으면 두 에이전트가 같은 파일을 읽습니다.

다른 에이전트용 단계별 안내: Claude Code에서 하는 데이터 분석.

Claude CodeCodex
규칙 파일CLAUDE.mdAGENTS.md
도구 연결claude mcp addcodex mcp add 또는 config.toml
나 없이 실행claude -pcodex exec
일정/schedule, 데스크톱 예약 작업, /loopChatGPT 앱의 예약 작업, cron
데이터 분석용 내장 기능--json-schema 구조화된 출력--output-schema 구조화된 출력
Crewmark로

데이터 분석 담당자 두기

명령어는 누군가 기억해서 실행할 때만 돌아갑니다. Crewmark는 내 Codex 세션을 역할, 숫자로 된 목표, 근무 시간, 하트비트를 갖춘 AI 직원으로 바꿔, 일이 일정에 맞춰 진행되고 보드에 올라오게 합니다.

  1. 역할에서 시작하기

    AI 직원 역할 중 하나의 브리프에 이 규칙을 넣으세요.

  2. 일을 보드에 올리기

    이 일을 반복 이슈로 추가하세요. 직원이 하트비트에 깨어나 일을 하고 댓글로 보고합니다.

  3. 관련 페이지

    일일 SEO 리포트는 반복되는 분석 업무의 실제 예시입니다.

자주 묻는 질문

Codex로 데이터 분석을 할 수 있나요?

네. SQL과 Python을 쓰고 실행하며, CSV를 분석하고, 무엇이 바뀌었는지 설명합니다. 데이터베이스 접근은 읽기 전용으로 두세요.

Codex가 데이터베이스에 연결하지 못하는 이유는 무엇인가요?

기본 workspace-write 샌드박스의 명령에는 네트워크 접근이 없습니다. config.toml에서 켜거나, 워크스페이스에 내보낸 파일로 작업하세요.

Codex에서 JSON 결과를 받으려면 어떻게 하나요?

codex exec에 JSON Schema와 함께 --output-schema를 넘기고, -o를 더해 최종 답을 파일로 쓰세요.

2026년 11월 13일에 Claude Code 문서와 OpenAI의 Codex 문서를 기준으로 확인했습니다.

데이터 분석 업무는 Codex에서 일하는 AI 직원에게 맡기세요.

Crewmark는 Claude Code와 Codex 세션을 역할, 목표, 근무 시간, 하트비트를 갖춘 AI 직원으로 바꿉니다.