Codex 프로젝트 폴더 설정과 경로 확인

Codex 프로젝트 폴더 설정은 어느 로컬 폴더의 파일을 읽고 만들지 정하고, 실제 작업 경로를 확인하는 과정이다. Windows에서 전용 폴더를 연결한 뒤 경로와 파일 목록을 대조하면 된다. 이 장은 그 확인부터 기본 폴더 구조 만들기까지 안내한다.

이 책의 새 요청문에서는 프로젝트 이름을 auto-trading-lab으로 통일한다. 이 장의 화면에 보이는 kospi200_auto_trading도 같은 역할의 작업 폴더다. 이미 정한 폴더가 있다면 이름을 바꾸지 않고 실제 경로를 그대로 사용한다.

이 글은 《Codex로 시작하는 자동매매 시스템 만들기》 1장의 웹 편집본이다. Windows 로컬 프로젝트를 기준으로 설명한다. 예시 경로의 minjun은 가상 사용자명이므로 자신의 Windows 사용자명으로 바꾼다.

Codex 작업 폴더, 먼저 이렇게 확인하세요

설치와 로그인이 끝났다면 아래 세 단계부터 진행한다. 앱 준비가 필요하면 뒤의 설치 안내부터 읽는다.

1. Windows에서 자동매매 전용 폴더를 만들고 로컬 프로젝트에 연결한다. 예시는 C:\Users\minjun\auto-trading-lab이며 이미 쓰는 폴더가 있으면 그 실제 경로를 사용한다.
2. 여러 폴더가 연결돼 있다면 사용할 폴더를 가리켜 Make primary(기본 폴더)로 정한다. 연결 폴더를 추가하거나 바꾸려면 프로젝트의 Edit project를 연다. 메뉴가 다르면 공식 프로젝트 안내를 확인한다.
3. Codex에 아래 요청을 보내 기대한 경로와 보고된 경로가 같은지 확인한다. 다른 위치라면 파일을 만들기 전에 경로 문제 해결로 돌아간다.

현재 작업 폴더의 절대 경로와 바로 아래 파일·폴더 목록을 확인해줘.
기대한 경로는 C:\Users\minjun\auto-trading-lab 이야.
아직 파일을 만들거나 수정하지 말고, 실제 경로가 다른지 알려줘.

minjun은 가상 사용자명이다. 자신의 사용자명과 프로젝트 경로로 바꾼다. 이 블록은 터미널 명령이 아니라 Codex에 보내는 요청문이다.

경로가 맞으면 기본 구조 만들기로 이동한다. 이미 여섯 하위 폴더가 준비됐다면 완료 기준을 확인한 뒤 2장: Python 전용 가상환경 준비하기로 이어간다.

준비물과 이번 장의 결과

준비물은 Windows 컴퓨터, 인터넷 연결, ChatGPT 데스크톱 앱에서 Codex를 사용할 수 있는 계정이다. Python 설치와 API 계정 준비는 뒤의 장에서 다룬다.

완료 결과는 다음과 같다.

• 사용자가 위치를 정한 프로젝트 전용 폴더
• Codex가 보고한 현재 작업 경로와 폴더 목록
• docs, scripts, src, config, logs, outputs 기본 구조
• 파일 작업·민감정보·주문 기능에 대한 프로젝트 작업 규칙

1. 파일과 터미널을 함께 다루는 개발 도구

자동매매 시스템을 만들려면 Python 파일만 작성하는 것으로 끝나지 않는다. 설정 파일을 구분하고, 실행 스크립트를 만들고, 수집 결과와 오류 로그를 찾아야 한다. Codex는 프로젝트의 파일을 읽고 수정하며 명령을 실행하는 개발 작업에 사용할 수 있다. 이 책은 그 작업을 작은 단계로 나누어 진행한다.

처음부터 “자동매매 프로그램을 만들어줘”라고 요청하면 작업 범위가 너무 넓다. “현재 폴더를 확인해줘”, “폴더 구조만 제안해줘”, “아직 파일은 만들지 말고 계획만 설명해줘”처럼 결과가 분명한 요청부터 시작한다. 파일을 어디에 만들었는지, 어떤 명령을 실행했는지, 결과가 무엇인지 확인한 뒤 다음 단계로 넘어간다.

현재 앱 이름과 설치 경로

책 초안의 Codex Desktop은 당시 데스크톱 작업 환경을 가리키는 표현이다. 2026년 10월 26일 다시 확인한 공식 문서는 ChatGPT 데스크톱 앱에서 Codex를 선택하는 흐름으로 안내한다. 아래 순서로 준비한다.

1. OpenAI 공식 데스크톱 앱 안내에서 운영체제에 맞는 설치 안내를 연다.
2. 앱을 실행하고 ChatGPT 계정으로 로그인한다.
3. 새 작업에서 ChatGPT 선택 메뉴의 Codex를 선택한다.
4. 프로젝트 또는 폴더를 열고 이번 작업이 사용할 위치를 확인한다.

메뉴 이름이나 위치가 다르면 공식 시작 안내의 데스크톱 설정을 확인한다. 여기서 사용하는 것은 로컬 폴더의 파일을 다루는 작업이다.

2. 시작 전에 확인할 비용과 실행 조건

컴퓨터를 계속 켜두어야 하나요?

이번 장은 컴퓨터에서 프로젝트 폴더를 만들고 상태를 확인하는 작업이다. 작업하는 동안 앱과 컴퓨터가 실행 중이어야 한다. 자동매매 프로그램을 장중에 반복 실행하는 환경은 별도로 정한다. 개인 PC, 미니 PC, 서버 등 어느 환경을 사용하든 전원·인터넷·스케줄러·로그·중단 조건을 함께 관리해야 한다.

이 책에서 만드는 자동매매 프로그램의 일일 실행 환경과 Codex를 사용하는 개발 환경을 구분한다. 먼저 로컬 폴더, 데이터 조회, 저장과 검증을 준비하고 운영 환경은 뒤에서 다룬다.

유료 구독이 꼭 필요한가요?

사용 가능한 기능과 사용량은 로그인 방식, 계정의 플랜, 워크스페이스 설정과 제공 시점에 따라 달라진다. 현재 공식 가격·기능 안내에는 무료 플랜의 일부 Codex 제공도 안내되어 있으며 적용 여부는 계정에서 확인해야 한다. 이 장을 위해 특정 유료 상품을 먼저 구입할 필요가 있다고 가정하지 않는다.

앱에서 Codex 작업을 시작할 수 있는지 먼저 확인한다. 개발량이 늘어난 뒤 현재 사용량과 필요한 기능을 보고 이용 방식을 결정한다. 이 글에는 바뀔 수 있는 가격이나 고정된 작업 횟수를 적지 않는다.

토큰과 사용량은 어떻게 이해하면 되나요?

Codex는 요청, 파일, 대화 기록, 도구 결과를 읽고 답변을 생성하면서 사용량을 쓴다. 여러 파일을 비교하거나 오류 수정을 반복하면 작업량이 커질 수 있다. 필요한 파일과 성공 기준을 함께 전달하면 결과를 확인하기 쉽다.

구독의 포함 사용량과 API 사용료는 서로 다른 기준이다. 잔여 사용량과 초기화 시점은 자신의 계정에 표시되는 정보를 확인한다. 자세한 기준은 공식 가격 안내의 사용량 설명을 따른다.

ChatGPT 로그인과 API 키 로그인은 무엇이 다른가요?

공식 문서는 구독 접근을 위한 ChatGPT 로그인과 사용량 기반 접근을 위한 API 키 로그인을 구분한다. API 키로 사용하면 OpenAI Platform의 API 사용료가 적용되고 일부 기능의 제공 범위가 달라질 수 있다. 이 장은 ChatGPT 계정 로그인으로 설명하며 API 키를 발급하거나 문서에 입력하지 않는다. OpenAI 공식 인증 안내

Codex가 자동매매 프로그램을 계속 운영하나요?

이 책에서는 Codex를 설계·구현·오류 확인을 돕는 개발 도구로 사용한다. 매일 실행되는 자동매매 프로그램은 사용자가 정한 실행 환경에서 동작하도록 구성한다. 실행 환경이 켜져 있는지, 로그가 남는지, 오류가 났을 때 멈추는지는 프로그램의 운영 항목으로 확인한다.

3. 현재 작업 위치부터 확인하기

설치와 로그인이 끝났다면 현재 폴더를 먼저 확인한다. 아래 블록은 PowerShell 명령이 아니라 Codex에 입력할 요청문이다. 교육용 화면은 누르면 원본 크기로 열어 볼 수 있다.

현재 Codex가 보고 있는 작업 폴더 위치를 알려줘.
파일 생성이나 수정은 하지 말고, 현재 경로만 확인해줘.

화면 예시 1-A. 교육용 재현 화면이다. 현재 앱의 실제 캡처가 아니며, 응답과 화면 구성은 앱 버전 및 프로젝트 상태에 따라 달라질 수 있다.

현재 폴더를 모른 채 작업을 시작하면 파일이 예상하지 못한 곳에 생길 수 있다. 다음 세 가지를 확인한다.

확인 항목	정상 기준	문제가 있을 때
Codex 작업 시작	Codex에서 요청을 보낼 수 있다	로그인 상태와 계정의 사용 가능 범위를 확인한다
로컬 폴더 접근	선택한 프로젝트 폴더의 경로를 확인할 수 있다	프로젝트에 연결한 폴더와 접근 권한을 확인한다
현재 경로	사용자가 의도한 폴더가 표시된다	올바른 폴더를 연결하고 기본 작업 위치를 확인한다

공식 문서에 따르면 로컬 프로젝트에는 여러 폴더를 연결할 수 있다. 새 작업의 기본 위치는 기본 폴더에 영향을 받으므로, 처음에는 자동매매 전용 폴더 하나로 시작한다. 공식 프로젝트·폴더 안내

4. 전용 프로젝트 폴더의 위치 정하기

이 책에서는 사용자가 Windows 파일 탐색기에서 직접 폴더를 만들고 Codex의 로컬 프로젝트로 여는 방식으로 진행한다. 먼저 위치를 정해두면 파일을 찾거나 백업할 때 기준이 된다.

Windows 사용자 폴더의 예시는 다음과 같다.

C:\Users\사용자명\

가상 사용자 minjun의 프로젝트 위치는 다음과 같다.

C:\Users\minjun\auto-trading-lab

사용자 폴더 아래의 전용 경로를 쓰면 시스템 프로그램 폴더와 구분하기 쉽다. C:\Program Files처럼 프로그램 설치를 위한 경로는 이번 프로젝트 위치로 사용하지 않는다. 프로젝트를 백업할 때도 폴더 하나를 기준으로 관리할 수 있다. 실제 비밀값이 들어 있는 설정과 로그는 공유용 사본에 포함하지 않는다.

폴더를 연 뒤 작업 범위를 다음처럼 전달한다. 요청문에 적는 경로도 자신의 실제 작업 폴더로 바꾼다.

앞으로 모든 작업은 C:\Users\minjun\auto-trading-lab 폴더 안에서만 진행해줘.

화면 예시 1-B. 프로젝트 범위를 전달하는 교육용 재현 화면이다. 요청문은 작업 목적을 설명하는 예시이며 앱의 폴더 권한 설정을 대신하지 않는다.

5. 폴더를 만들고 Codex에서 확인하기

1. 파일 탐색기에서 자신의 Windows 사용자 폴더를 연다.
2. auto-trading-lab이라는 새 폴더를 만든다.
3. 앱에서 이 폴더를 로컬 프로젝트에 연결해 연다.
4. 여러 폴더가 연결되어 있다면 이번 폴더가 기본 작업 위치인지 확인한다.

현재 문서의 메뉴 안내와 앱이 다르면 공식 프로젝트 문서를 참고한다. Codex에 아래 확인을 요청한다.

현재 작업 폴더가 C:\Users\minjun\auto-trading-lab 인지 확인해줘.
파일 생성이나 수정은 하지 말고, 현재 경로와 폴더 안의 파일 목록만 알려줘.

화면 예시 1-C. 프로젝트 폴더와 파일 목록을 확인하는 교육용 재현 화면이다.

정상 결과는 사용자가 정한 경로와 실제 파일 목록이 함께 보고되는 것이다. 새 폴더라면 비어 있거나 사용자가 알고 있는 파일만 있어야 한다. 이미 파일이 있다면 삭제부터 하지 말고 어떤 자료인지 확인한다.

프로젝트 위치 확인 흐름

그림 1-1. 원고의 Mermaid 흐름도를 웹용 SVG로 다시 그렸다. 원하는 경로가 아니면 전용 폴더를 열고 경로 확인으로 돌아간다.

도표를 읽기 어려운 경우에는 로그인 → 현재 경로 확인 → 올바른 전용 폴더 열기 → 파일 목록 확인 → 기본 폴더 구조 제안 순서로 진행하면 된다.

6. 기본 폴더 구조를 제안받고 만들기

프로젝트 위치가 확인되었다면 필요한 기본 구조만 먼저 제안받는다.

이 폴더는 한국투자증권 Open API를 이용해 코스피200 자동매매 시스템을 만들기 위한 프로젝트 폴더다.
아직 파일을 만들지 말고, 필요한 기본 폴더 구조만 제안해줘.
각 폴더의 역할도 함께 설명해줘.

화면 예시 1-D. 폴더를 만들기 전에 구조를 검토하는 교육용 재현 화면이다.

초기 구조는 다음 정도면 충분하다.

폴더	용도	보관할 내용
docs/	문서	설계 메모와 오류 해결 기록
scripts/	실행 스크립트	PowerShell 실행 파일
src/	소스 코드	Python 코드와 계산 로직
config/	설정	설정 항목의 예시와 개인용 설정 파일
logs/	로그	실행 과정과 오류 기록
outputs/	결과	CSV, 리포트, 시뮬레이션 결과

공개 예시 설정에는 필요한 항목 이름만 담고, 실제 인증정보는 개인용 설정으로 구분한다. 이번 장에서는 인증정보를 만들거나 입력하지 않는다.

제안한 구조가 적절하고 작업 위치도 맞다면 폴더 생성을 요청한다. 이 예시의 생성 대상은 위의 여섯 하위 폴더다.

방금 제안한 구조대로 docs, scripts, src, config, logs, outputs 폴더를 생성해줘.
기존 파일은 덮어쓰지 말고, 생성 후 실제 폴더가 존재하는지 확인해줘.
새로 만든 폴더와 원래 있던 폴더를 구분해서 알려줘.

화면 예시 1-E. 생성 뒤 존재 여부를 확인하는 교육용 재현 화면이다. 화면의 문구는 앞선 원고 예시를 바탕으로 했으며 실제 결과 보고 형식은 달라질 수 있다.

탐색기에서도 여섯 폴더가 프로젝트 폴더 바로 아래에 있는지 확인한다. 생성했다고 답한 것과 실제 경로가 일치하는지 확인하는 과정까지가 이 단계의 완료 기준이다.

7. 프로젝트 작업 규칙을 전달하기

파일을 만들고 명령을 실행하는 작업에서는 범위와 완료 기준을 함께 전달해야 한다. 다음은 독자가 자신의 프로젝트에 맞춰 사용할 수 있는 요청문 예시다.

앞으로 이 프로젝트에서는 다음 규칙을 지켜줘.

1. 모든 작업은 C:\Users\minjun\auto-trading-lab 폴더 안에서 진행해줘.
2. 작업 목적과 수정할 범위를 설명하고, 요청한 범위의 결과를 확인해줘.
3. 읽기 전용으로 확인해 달라고 한 단계에서는 파일을 수정하지 마.
4. App Key, App Secret, 계좌번호, 비밀번호는 공개 예시와 로그에 직접 쓰지 마.
5. 이번 학습 단계에서는 실전 주문 기능을 구현하거나 주문 API를 호출하지 마.
6. 명령을 실행할 때는 실행 목적과 예상 결과를 알려줘.
7. 작업 후에는 수정한 파일, 실행한 명령, 확인 결과를 정리해줘.

화면 예시 1-F. 기존 원고에 포함된 교육용 재현 화면이다. 위 웹 요청문은 읽기 전용 확인과 승인된 파일 생성을 구분하도록 다듬었다. 화면에는 당시 원고의 확인 문구가 남아 있어 현재 요청문과 일부 다르다.

요청문으로 범위를 설명하는 것과 앱에서 허용한 접근 권한은 별개다. 프로젝트에 필요한 폴더만 연결하고 실제 실행 결과를 확인한다. 작업 규칙을 전달한 뒤 Codex가 작업 위치, 민감정보 처리, 이번 단계의 실행 범위와 결과 보고 방법을 이해했는지 확인한다.

8. 이 장의 완료 기준과 문제 해결

항목	완료 기준
앱과 계정	Codex 작업을 시작할 수 있다
작업 위치	사용자가 정한 프로젝트 폴더가 현재 위치로 보고된다
기본 구조	여섯 하위 폴더가 실제로 존재한다
작업 범위	읽기 전용 확인과 폴더 생성 요청이 구분되어 실행된다
설정과 주문	인증정보 입력과 주문 API 호출을 하지 않았다
결과 확인	만든 폴더와 실행 결과를 사용자가 확인할 수 있다

작업 경로가 다르거나 폴더가 보이지 않을 때

보이는 증상	먼저 확인할 것	다음 행동
다른 프로젝트의 경로가 나온다	현재 대화가 열린 프로젝트와 연결 폴더	올바른 폴더에서 새 Codex 대화를 시작하고 경로를 다시 확인한다
여러 폴더 중 다른 폴더에서 시작한다	프로젝트의 기본 폴더	프로젝트에서 사용할 폴더를 Make primary로 정하고 새 대화에서 확인한다
폴더에 접근하지 못한다	실제 폴더 존재 여부와 프로젝트에 연결한 범위	파일 탐색기에서 경로를 확인한 뒤 필요한 폴더만 연결한다
만든 파일을 찾을 수 없다	응답에 나온 절대 경로와 실제 파일 목록	두 경로를 대조하고 기존 파일을 지우거나 옮기기 전에 위치부터 확인한다

요청문에 경로를 적는 것만으로 앱의 접근 권한이나 연결 폴더가 바뀌지는 않는다. 폴더 연결과 권한은 앱에서 확인하고, 현재 대화의 위치는 다시 조회한다.

위치가 헷갈리면 다음 요청으로 돌아간다.

현재 Codex가 보고 있는 작업 폴더 위치를 알려줘.
파일 생성이나 수정은 하지 말고, 현재 경로와 폴더 안의 파일 목록만 확인해줘.

자주 막히는 질문

폴더 이름은 예시와 똑같아야 하나요?

아니다. 이미 쓰는 전용 폴더가 있다면 이름을 바꿀 필요가 없다. 예제의 경로를 실제 위치로 바꾸고 요청·응답·파일 탐색기에 표시된 경로가 같은지 확인한다.

기본 폴더를 바꾼 뒤에는 바로 작업해도 되나요?

새 대화가 시작하는 기본 위치와 현재 대화의 위치를 구분한다. 기본 폴더를 바꾼 뒤에도 파일을 만들기 전 경로를 확인한다. 기존 대화의 위치가 다르면 원하는 폴더에서 새 Codex 대화를 시작하는 편이 확인하기 쉽다.

이 장에서 Python이나 증권사 API 키도 준비하나요?

이 장의 완료 기준은 작업 위치와 기본 폴더 구조다. Python과 가상환경은 2장, 증권사 API 준비는 3장에서 진행한다. 아직 실행 코드가 없다는 이유로 이 단계에서 키나 계좌 정보를 입력할 필요는 없다.

지금 상태에 맞는 다음 문서

• 폴더와 기본 구조를 확인했다면: 2장: Python 실행 경로와 빈 venv 확인하기. 다음 장에서는 이 프로젝트에서 사용할 Python 환경을 준비한다.
• 결과를 읽는 순서부터 알고 싶다면: KOSPI200 백테스트의 기간·청산 거래·비용 읽기. 개발 환경 준비와 결과 해석을 구분해 볼 수 있다.
• 전체 읽기 경로를 보관하려면: 주간 읽기 01: 자동매매를 시작하는 순서. 준비·인증·검증 중 자신의 단계에 맞는 문서를 고를 수 있다.

출처와 웹 편집 기록

원고의 1장에 있던 작업 위치 확인, 폴더 구조, 오류 점검, 여섯 교육용 화면을 바탕으로 웹에서 읽을 수 있도록 편집했다. 프로젝트·시작·인증·사용량 공식 문서의 이번 확인일은 2026년 10월 26일이다. 앱 메뉴와 계정 안내는 아래 공식 문서를 대조했으며, 새 컴퓨터에서 설치부터 재현한 검증을 뜻하지 않는다.

• OpenAI 공식 데스크톱 앱 안내: 현재 앱 명칭과 시작 흐름.
• OpenAI 공식 시작 안내: 로그인, 폴더 선택, Codex 작업 시작.
• OpenAI 공식 프로젝트 안내: 로컬 폴더 연결과 기본 작업 위치.
• OpenAI 공식 인증 안내: ChatGPT 로그인과 API 키 로그인 구분.
• OpenAI 공식 가격·사용량 안내: 계정별 기능과 이용 범위 확인.

이번 웹 개정에서는 경로 확인 요청문을 앞에 두고, 폴더 문제 해결 표와 자주 묻는 질문, 단계별 다음 읽기를 추가했다. 기존의 앱 명칭 안내, 비용·로그인 구분, 여섯 교육용 화면과 흐름도, 완료 기준은 유지했다. 원본 출판 원고와 교육용 화면 파일은 수정하지 않았다.

이 책은 자동매매 시스템 개발을 설명하는 교육 자료다. 특정 금융상품의 매매를 권유하거나 수익을 보장하지 않는다.