# 데이터를 한 폴더에 모아 Codex로 분석하기

입문30분 · 5단계 · 설치·로그인 다음, 01 공식 통계 실습 이전. 필수115분은 그대로 진행한다.

## 1. 어디서 받을까

먼저 업무 질문에 맞는 출처 한 곳을 고른다. 아래는2026-10-13 공식 페이지 확인 기준이다. 검색어는 수업용 예시이며 특정 파일의 상시 제공을 보장하지 않는다. 화면·다운로드·로그인 조건은 자료마다 다르다.

| 출처 | 적합한 주제 / 검색어 | 받는 방법 | 확인할 점 |
| --- | --- | --- | --- |
| [KOSIS 국가통계포털](https://kosis.kr/) | 인구·가구·고용·지역경제 / 시도별 1인가구, 고령인구, 고용률 | 통계표 검색 → 항목·지역·시점 선택 → 조회 → 다운로드에서 CSV 또는 XLSX 선택. 표명·표ID·단위·주석도 기록. | 같은 연도·지역 단위로 시작. 표 머리글 병합을 해제할 수 있으면 해제. [공식 안내](https://kosis.kr/ext/kosisGuide/pdf/KOSIS_search.pdf) |
| [공공데이터포털](https://www.data.go.kr/) | 시설·사업·행정 현황 / 지역명 공공도서관, 무인민원발급기, 공공시설 | 검색 결과에서 파일데이터 선택 → 상세의 파일 형식·갱신일 확인 → 다운로드 또는 제공기관 원문 링크 이용. | API 전용 자료는 다음 실습으로 미룬다. 로그인·신청·이용조건은 자료별로 확인. [공식 안내](https://www.data.go.kr/ugs/selectPublicDataUseGuideView.do) |
| [한국은행 ECOS](https://ecos.bok.or.kr/) | 물가·금리·환율·GDP / 소비자물가지수, 기준금리, 원/달러 환율 | 통계검색에서 지표·주기·기간을 고르고 조회 결과의 다운로드 기능 확인. 보조 경로는 한국은행 금융·경제 스냅샷의 데이터 다운로드. | 월/분기/연, 명목/실질, 계절조정, 기준연도와 단위를 구분. [공식 안내](https://snapshot.bok.or.kr/dashboard/D2) |
| [지표누리 e-나라지표](https://www.index.go.kr/) | 정책 성과지표·지표 해설 / 청년고용률, 합계출산율, 사회복지 지표 | 지표 검색 → 통계표·지표 해설 확인 → 제공되는 표 다운로드 또는 원자료 기관 링크 이용. | 파일이 없으면 원자료 기관으로 이동. 해설과 수치의 기준시점을 따로 기록. [공식 안내](https://www.index.go.kr/) |
| [서울 열린데이터광장](https://data.seoul.go.kr/) | 생활인구·교통·시설·자치구 / 자치구별 인구, 공공시설, 따릉이 | 데이터 검색 → 파일 제공 여부·용량·기간 확인 → 내려받을 수 있는 파일 선택. API만 있는 자료는 대체 파일 선택. | 대용량 이동자료보다 자치구 집계표로 시작. API 인증키는 이번 입문에서 사용하지 않음. [공식 안내](https://data.seoul.go.kr/together/guide/useGuide.do) |
| [지방재정365](https://www.lofin365.go.kr/) | 지자체 예산·결산·재정공시 / 지자체명 세출결산, 재정자립도 | 재정통계·재정공시에서 연도·지자체·회계 범위를 조회하고 다운로드 가능한 표/첨부자료 선택. | 예산과 결산, 당초와 최종, 일반회계와 통합회계를 혼합하지 않음. PDF만 있으면 표 파일이 있는 자료로 변경. [공식 안내](https://www.lofin365.go.kr/) |
| [World Bank Open Data](https://data.worldbank.org/) | 국가별 인구·경제·개발 / Population total, GDP per capita, urban population | 지표 선택 → 국가·기간 확인 → CSV/Excel 다운로드. ZIP이면 압축을 풀고 데이터와 메타데이터를 함께 보관. | 국가코드·지표코드와 통화·현재가격/불변가격·PPP 여부를 확인. [공식 안내](https://datatopics.worldbank.org/world-development-indicators/) |
| [OECD Data Explorer](https://data-explorer.oecd.org/) | 국제 고용·교육·복지 비교 / Employment rate, education, social expenditure | 데이터셋 선택 → 국가·지표·기간 필터 → Download의 CSV/Excel 옵션 확인. 현재 다운로드 제한은 플랫폼 상태 안내 확인. | 연령 범위·분모·국가별 정의를 맞춘다. 다운로드가 막히면 범위를 줄이거나 World Bank 자료로 대체. [공식 안내](https://www.oecd.org/en/blogs/2025/09/oecd-data-explorer-find-understand-and-use-the-data-you-need.html) |

## 2. KOSIS 다운로드 예시

1. KOSIS에서 “시도별 1인가구”를 검색하고 가구 관련 통계표를 연다.
2. 표명과 작성기관을 확인하고 지역·항목·시점을 선택한다. 처음에는 전국+17개 시도, 같은 연도 하나를 고른다.
3. 조회 후 다운로드에서 CSV 또는 XLSX를 선택한다. 표명/표ID와 단위·주석도 저장한다. CSV가 초보 실습에 편하다.
4. raw/에 파일을 넣고 sources.csv에 원문URL·다운로드일·수치기준기간 등을 기록한다. 불확실한 값은 “확인 필요”로 둔다.
5. 새로 받은 표는 제공 샘플과 열·시점이 다를 수 있다. 샘플용 분석 요청을 그대로 쓰기 전에 파일 점검부터 한다.

공식 [KOSIS 이용 안내](https://kosis.kr/ext/kosisGuide/pdf/KOSIS_search.pdf). API 키는 파일 다운로드 입문에 필요하지 않다. API만 제공되는 다른 자료는 별도 신청·인증이 필요할 수 있다.

## 3. 한 폴더의 구성

```text
kdi-data-starter/
  AGENTS.md                  작업 규칙
  README.md                  시작 안내
  sources.csv                파일별 출처·단위·분모·조건
  raw/                       받은 표 원본
    2024-regional-households.csv
  references/                주석·설명·출처 가이드
    source-notes.md
    data-folder-guide.md
  prompts/                   복사용 요청문
    01-inventory.txt
    02-analysis-plan.txt
    03-analysis-run.txt
  work/                      계산·정리·방법 기록
  output/                    제출용 표·메모
```

ZIP을 풀고 최상위 kdi-data-starter를 Codex 로컬 프로젝트에 연결한다. Projects의 프로젝트 메뉴에서 폴더를 연결하고 현재 작업 경로를 확인한다. UI 명칭은 앱 버전에 따라 다를 수 있다. [OpenAI 공식 로컬 프로젝트 안내](https://learn.chatgpt.com/docs/projects).

raw/는 사람이 고치지 않는 원본 보관 장소다. 정리는 work/의 사본에서 한다. AGENTS.md에 적은 원본 보존 규칙은 앱 파일 권한을 자동 설정하지 않는다. 폴더에 넣는다고 모든 파일이 즉시 읽히는 것도 아니므로 읽을 경로를 명시한다.

## 4. 출처 기록

sources.csv의 열: file, provider, table_title, table_id, source_url, downloaded_on, reference_period, geography, unit, denominator, license_notes.

제공 CSV는 **2025 공식 보고서의2024년 표를 교육용으로 전사한 가공본**이다. KOSIS 다운로드 원본이 아니다. 원문 PDF는 재배포하지 않으며 references/source-notes.md의 링크에서 확인한다. 배포본 sources.csv의 downloaded_on은 원자료 수집일을 확인할 수 없어 “원자료 수집일 미기록; 수업 복사2026-10-13”으로 표시했다. 직접 받은 파일은 실제 다운로드 날짜를 기록한다.

내 파일 추가: 원본→raw/, 설명→references/, 파일별 sources.csv 행 추가. 개인식별정보·비공개 기관자료는 공개 실습에 사용하지 않는다. 사용·재배포 조건을 확인한다. 첫 수업은 집계 CSV/XLSX1개로 끝낸다.

## 5. Codex에 요청하는 순서

### 읽기 점검
```text
현재 프로젝트 kdi-data-starter의 AGENTS.md, sources.csv, raw/, references/를 읽어 주세요. 지금은 읽기만 하고 파일을 만들거나 수정하지 마세요.
파일별 경로·형식·크기·행 수·열 이름·기준연도·지역 범위·단위·분모·출처·결측·중복을 표로 정리하세요. XLSX는 시트와 표 머리글을 확인하고 CSV는 인코딩을 확인하세요. 전국 합계와 지역 행이 섞였는지 확인하세요.
직접 확인할 수 없는 파일은 이유를 밝히고, 필요한 도구가 없으면 설치하지 말고 CSV 대안을 제안하세요. 수치나 출처를 추측하지 마세요.
```

### 계획 검토
```text
아직 파일을 수정하지 말고 분석 계획을 제안하세요.
질문: 2024년 어느 시도의 1인가구 비율이 높고 낮은가?
입력: raw/2024-regional-households.csv, references/source-notes.md, sources.csv.
전국은 비교 기준으로 분리하고 17개 시도만 정렬하세요. 공표 비율을 사용하고 반올림된 천 가구 값으로 다시 계산한 비율과 구분하세요. 전국 비율을 지역 비율의 단순평균으로 구하지 마세요.
제안할 산출물: work/analysis-method.md, output/regional-summary.csv, output/first-analysis.md.
결측·중복·분모 점검, 정렬·상하위 검산, 원본 보존 방법과 실제 생성할 파일을 설명하고 실행 승인을 기다리세요.
```

### 승인한 계획 실행
```text
위 분석 계획대로 실행해 주세요. raw/, references/, sources.csv와 AGENTS.md는 변경하지 마세요.
work/analysis-method.md에 사용한 입력·계산·제외 기준을 기록하세요. output/regional-summary.csv에는 17개 시도의 원본 열과 비율 내림차순 순위를 저장하세요. 전국은 지역 순위에서 제외하세요.
output/first-analysis.md에는 질문, 기준연도, 단위·분모, 전국 비교값, 상위3/하위3 지역, 확인된 사실3개, 해석의 한계, 출처 URL을 쓰세요. 인과관계나 정책 효과를 추정하지 마세요.
실제 입력·출력 행 수, 결측/중복 여부, 상하위3 수치 대조, 원본 변경 여부를 검사하고 결과와 미확인 사항을 보고하세요. 파일 생성 실패를 성공으로 보고하지 마세요. 패키지 설치·추가 다운로드가 필요하면 먼저 알려주세요.
```

## 6. 검산과 문제 해결

- 샘플:18행/4열, 전국+17시도,2024년. 지역 순위는 전국 제외17행.
- 비율 분모는 각 지역 전체 일반가구. 공표 비율과 천 가구 단위로 반올림된 수의 나눗셈은 다를 수 있다. 전국 비율은 지역 비율의 단순평균으로 계산하지 않는다.
- 상위3:서울39.9,대전39.8,강원39.4%. 하위3:울산31.6,경기31.7,인천32.5%. 출력과 원본을 직접 대조한다.
- XLSX:시트·병합 머리글·단위를 확인. CSV:인코딩·구분자·빈칸·중복키 확인. -, …, 비공개 기호를0으로 채우지 않는다.
- 두 표 결합:지역코드/기간/집계단위를 맞추고 키 중복·결합 후 행 수를 확인. 시설 건수를 인구로 나누려면 같은 지역·기간과 올바른 인구 분모가 필요하다.
- PDF/HWP/이미지는 설명자료다. 스캔 표의 숫자를 자동 추측하지 말고 공식CSV/XLSX를 우선 찾는다.
- 도구가 없으면 필요한 도구와 CSV 대안을 먼저 확인한다. 파일 생성·검산 실패는 미완료로 남긴다.

완료:work/analysis-method.md,output/regional-summary.csv,output/first-analysis.md를 열어 확인하고 codex-kdi-lab 프로젝트로 돌아가01 공식 통계 실습을 진행한다.