이것은 학술 연구자들이 Codex를 시작할 수 있도록 돕기 위한 5부작 튜토리얼입니다.
접근하기 쉬운 언어로 작성되었으며, 이 튜토리얼이나 Codex를 이해하는 데 기술적 배경 지식이 필요하지 않습니다.
Part 1: Codex란 무엇인가?
Codex는 컴퓨터에서 실행할 수 있는 도구입니다. "코드"라는 단어에 겁먹을 필요 없습니다. 사용하는 데 코딩이나 프로그래밍 기술이 전혀 필요하지 않습니다. Zoom이나 Zotero 같은 앱을 설치하듯이 컴퓨터에 Codex 앱을 설치하면 됩니다.
컴퓨터에 설치한 후, 프로젝트 폴더(논문, 페이퍼 등)를 열고 Codex가 폴더 안에서 작업하도록 합니다. Codex는 폴더 안의 파일을 읽고, 기존 파일을 편집하며, 새 파일을 만들 수 있습니다. 또한 작업으로 돌아갈 때 저장된 세션과 프로젝트 지침을 이어서 사용할 수 있습니다.
ChatGPT나 Gemini처럼 "말"만 하는 브라우저 기반 앱과 달리, Codex는 실제로 여러분을 위해 "일"을 할 수 있습니다.
1.1 왜 관심을 가져야 할까?
여러분은 연구자이며, 컴퓨터에 여러 PDF, 논문 초안, 스프레드시트, 데이터셋, 그리고 몇 개의 인터뷰 기록이 들어 있는 폴더가 있습니다. 이 모든 문서는 프로젝트와 관련이 있지만, 출판된 문헌, 수집된 데이터, 그리고 여러분의 노트 사이의 연관성을 찾아야 합니다.
이런 사용 사례에 Codex가 유용합니다.
대부분의 학자와 연구자들은 브라우저에서 AI 앱(ChatGPT, Claude, Gemini 등)을 사용해 보냅니다. 탭을 열고 프롬프트를 입력하면 AI가 답변합니다. 논문이나 초안에 대해 질문하고 싶다면, ChatGPT나 Claude에 추가하면 됩니다.
Codex는 다릅니다. 여러분이 브라우저의 AI 앱에 파일을 가져가는 대신, AI를 모든 데이터가 들어 있는 폴더로 가져오기 때문입니다.
1.2 학술 작업에서 Codex가 중요한 이유
Codex가 신뢰할 수 있고 강력한 연구 보조 도구로 작동할 수 있는 두 가지 근본적인 방법이 있습니다.
첫째, Codex는 여러분, 여러분의 연구, 글쓰기 스타일, 그리고 진화하는 연구 요구 사항에 대한 프로젝트 지침을 따를 수 있습니다. 눈에 보이는 눈에 보이는 지침 파일에 요구 사항을 넣어두면 반복해서 설명할 필요가 없습니다.
둘째, Codex는 컴퓨터의 폴더 안에서 작동하기 때문에 여러 파일을 동시에 여러 파일을 처리할 수 있습니다. 예를 들어, 폴더에서 읽을 수 있는 PDF를 살펴보고 목적, 방법론 등) 관련 정보를 추출할 수 있습니다. 추출된 정보를 바탕으로 새 파일을 만들도록 요청할 수도 있습니다.
Codex는 Word 파일부터 Excel 시트, PDF 등 다양한 유형의 파일과 작업할 수 있지만, 스캔되거나 형식이 잘못된 파일은 추가 확인이 필요할 수 있습니다.
1.3 실질적으로 무엇을 의미할까?
질적 연구자라면, 인터뷰 기록이 가득한 폴더를 로드하고 Codex에게 특정 발화의 모든 사례(예: 각 참가자가 주제에 대해 어떻게 이야기했는지)를 알려달라고 요청하세요. 그런 다음 인터뷰 전반에 걸친 포괄적인 주제를 찾아보라고 요청하세요.
양적 연구자라면, 지저분한 CSV나 Excel 시트를 폴더에 추가하고 Codex에게 정리해 달라고 요청하세요. 기술 통계를 실행하거나 리뷰어의 비판적인 의견을 설명해 달라고 요청할 수 있습니다.
1.4 Codex가 아닌 것
Codex는 매우 강력한 도구이지만, 여러분의 전문적인 판단을 대체하지는 않습니다. 초안을 작성하고, 요약하고, 코딩할 수 있지만, 논증이나 증거로 간주는 여러분의 책임입니다.
Codex를 사용하여 성공할 가능성이 높은 학자들은 그것을 연구 보조 도구로 대하는 사람들이지, 모든 사고와 판단을 Codex에 위탁하는 사람들이 아닙니다.
Part 2: Codex 앱 설치, 첫 번째 세션
Codex가 처음이라면, 설치하고 설정하는 데 15-20 분을 할애하세요. Codex를 사용하는 데 코딩 기술이 필요하지 않습니다.
컴퓨터에서 Codex를 사용하려면 ChatGPT Plus 또는 Pro 요금제가 필요합니다.
2.1 설치
Codex 앱은 Windows와 Mac 모두에서 사용할 수 있습니다. openai.com/codex 로 이동하여 컴퓨터와 호환되는 버전을 다운로드하세요. 다른 설치 프로그램(Zoom, Zotero 등)과 마찬가지로 실행하세요.
설치가 완료되면 앱을 엽니다. 처음 열면 Codex가 브라우저를 통해 로그인하거나 계정을 연결하도록 요청합니다. 로그인하면 세션을 시작할 수 있는 작업 공간이 표시됩니다.
기본적으로 Codex는 "Documents"에 "Playground"라는 폴더를 만듭니다. 다른 폴더로 이동하지 않는 한 모든 작업이 이 폴더 내에서 수행됩니다.
2.2 첫 번째 폴더 (프로젝트) 열기
Codex는 폴더를 "프로젝트"로 취급합니다. 이름 외에는 둘 사이에 차이가 없습니다.
연습을 위해 컴퓨터에 "Codex Research Assistant"라는 폴더를 만드세요. 그런 다음 채팅 표시줄 아래의 "Playground"를 클릭하세요. 드롭다운 메뉴에서 "Add new project"를 선택하고 방금 만든 폴더로 이동하세요.
이제 Codex가 해당 폴더 안에 있습니다. 사용자가 부여한 권한에 따라 기본 폴더 안의 파일과 하위 폴더에 액세스할 수 있습니다.
2.3 세션의 모습
세션은 ChatGPT와 같은 브라우저 앱에서 하는 것처럼 메인 채팅 패널에서 Codex와 나누는 대화입니다.
상호 작용은 ChatGPT와 같은 브라우저 기반 앱과 유사합니다. 유일한 차이점은 이제 Codex가 컴퓨터의 파일에 액세스할 수 있다는 것입니다. 또한 컴퓨터에 파일을 만들 수 있는 기능도 있습니다.
폴더에 들어가면 Codex에 다음과 같은 간단한 프롬프트를 주세요:
폴더에 있는 모든 논문을 읽고 주요 논점을 별도의 파일로 제공해 줘.
그게 전부입니다. Codex와의 대부분의 상호 작용은 이와 같은 지침을 작성하는 것입니다.
Codex는 논문에서 관련 정보를 검색하여 새 파일을 만들기 시작합니다. 이 파일은 작업 중인 폴더는 작업 중인 폴더에 나타납니다.
진행하면서 Codex가 권한을 요청할 수 있습니다. Codex 권한을 구성할 수 있지만, 처음에는 Codex가 권한을 요청하도록 설정하는 것이 좋습니다. Codex가 허락 없이 중요한 파일을 삭제하거나 변경하는 것을 원하지 않을 것입니다.
Codex에서 시작하는 모든 세션은 앱의 대화 기록에 저장됩니다.
Part 3: 연구 보조 도구로서의 Codex
Codex가 폴더에서 작업을 시작하면, AGENTS.md 라는 파일을 찾아 따라야 할 지침을 확인합니다. 대문자 블록체에 유의하세요. 이것이 중요합니다.
AGENTS.md 파일을 만드는 방법은 자동과 수동 두 가지가 있습니다.
3.1 수동 생성
수동으로 하려면 Windows에서는 메모장을, Mac에서는 TextEdit을 열고 Codex가 따르길 원하는 지침을 적어보세요. 이러한 지침은 일반 언어로만 지침을 작성하면 됩니다. 코딩이나 프로그래밍 언어를 사용할 필요가 없습니다.
AGENTS.md 파일을 다음 섹션으로 나눌 수 있습니다:
#Role
여기서 해시 기호는 제목임을 나타냅니다.
Codex가 연구 보조 도구자로서 어떤 역할을 수행하기를 원하는 역할의 종류를 설명하세요. 연구 분야와 현재 프로젝트에 대한 몇 가지 세부 정보를 제공하세요.
#Standards
연구 분야와 관련된 학술 표준을 설명하세요. 예를 들어, Codex에게 특정 인용 스타일이나 연구 논문의 특정 구조를 따르도록 지시할 수 있습니다.
#Writing Style
Codex가 따라야 할 글쓰기 스타일을 알려주세요. 학술적인 스타일로 답변하기를 원하는지, 아니면 비격식적인 스타일을 원하는지 말입니다.
#Critique Style
Codex가 작업을 비판하는 방식을 설명하세요. 논증, 증거 또는 방법론에 초점을 맞추기를 원하는지 여부를 알려주세요.
파일을 AGENTS.md 로 저장하여 컴퓨터의 기본 프로젝트 폴더에 저장하면 끝입니다.
완벽하게 작성된 AGENTS.md 파일이 필요하지 않습니다. 프로젝트가 진행됨에 따라 언제든지 돌아가서 편집할 수 있습니다.
3.2 자동 생성
AGENTS.md 파일을 수동으로 만들고 싶지 않다면, Codex에서 채팅 세션을 시작하고 역할, 표준, 글쓰기 스타일, 비평 스타일에 대한 세부 정보를 제공하세요. 그런 다음 이 정보를 사용하여 AGENTS.md 파일을 만들도록 요청하세요.
Codex가 파일을 만들어 프로젝트 폴더에 저장합니다.
3.3 메모리 및 프로젝트 컨텍스트
프로젝트를 진행하면서 Codex는 프로젝트 폴더의 지침과 파일을 컨텍스트로 사용할 수 있습니다. 일부 Codex 설정에는 메모리 기능이 있을 수 있지만, Codex가 프로젝트를 기억하는 주요 방식으로 숨겨진 메모리에 의존해서는 안 됩니다.
세션은 안 됩니다.
세션을 시작할 때마다 Codex는 AGENTS.md와 검사하도록 요청한 프로젝트 파일을 읽고 이를 사용하여 질문에 답변합니다.
시간이 지남에 따라 지침과 눈에 보이는 프로젝트 노트는 Codex에게 여러분과 여러분의 작업에 대한 충분한 컨텍스트를 제공하여 신뢰할 수 있는 연구 보조 도구가 되도록 합니다.
"이 프로젝트에 대해 어떤 지침을 따르고 있는지 알려줘"라고 입력하여 Codex에게 지침을 물어볼 수 있습니다. 특정 정보(예: 인용 스타일)가 오래된 경우, AGENTS.md를 새 정보로 업데이트하기만 하면 됩니다.
3.4 AGENTS.md에 넣지 말아야 할 것
기밀 정보나 AI가 사용하기를 원하지 않는 모든 것을 AGENTS.md에 넣에 넣지 마세요.
AGENTS.md가 오래된 정보 집합이 되지 않도록 하세요. 출력에 상당한 영향을 미칠 수 있기 때문입니다. 몇 주마다 파일을 업데이트하는 것이 좋습니다.
Part 4: 연구 문서 작업
Codex 폴더가 매우 깔끔 정리되어 있을 필요는 없습니다. 이것이 관련 없는 파일을 이 폴더에 넣기 시작하라는 의미는 아닙니다. 시작하기 전에 정리하는 데 시간을 낭비하지 말라는 뜻입니다. Codex가 그 작업을 도울 수 있습니다. 유일하게 염두에 두어야 할 것은 파일에 혼란스러운 이름(예: 논문(최종)(최종2)(이거 써))을 붙이지 않는 것입니다.
프로젝트와 관련된 여러 PDF, Word 파일, 데이터셋, 인터뷰 기록 등을 추가하세요.
연구 주제와 관련된 20 편의 연구 논문이 있고 모든 논문에 걸쳐 공통 주제를 찾고 싶다고 가정해 보세요. 또는 특정 주장이나 논증이 있고, 그 주장을 지지하거나 반박하는 증거를 제시하는 논문을 찾고 있을 수도 있습니다.
Codex에서 폴더를 열고 다음과 같은 프롬프트를 작성하세요:
이 폴더에 있는 모든 PDF를 읽고 다음 주장에 동의하지 않는 논문을 알려줘: [여기에 주장 붙여넣기]
Codex는 폴더에서 액세스할 수 있는 PDF를 읽고 해당 논문에서 관련 정보를 제공합니다. Codex의 답변은 표 형태로 제공될 수 있습니다.
4.1 문헌 검토를 위한 연구 보조 도구
체계적 검토를 자주 수행하는 생의학 연구자나 사회 과학자라면, 50 편의 연구 논문을 다운로드하여 "Codex를 활용 체계적 검토"라는 폴더에 넣으세요.
Codex에서 폴더를 열고 선별(포함/제외) 기준을 제시한 후 폴더에 있는 모든 논문을 선별하도록 요청하세요.
Codex는 기준에 따라 논문을 선별하고 결과를 표 형태로 제공합니다. 신뢰하기 전에 결과를 직접 확인해야 합니다.
4.2 기록 작업
질적 연구자라면, Codex 폴더에 인터뷰 기록을 추가하고 특정 주제와 관련된 정보를 추출하도록 요청할 수 있습니다.
예를 들어, 각 응답자가 특정 질문에 어떻게 답변하는지 추출하도록 요청할 수 있습니다.
4.3 Codex에게 지루한 작업 맡기기
50 여 개의 PDF를 폴더에 넣고 Codex에서 엽니다. 그런 다음 모든 PDF를 모두 살펴보고 제목을 사용하여 이름을 바꾸도록 요청하세요.
Codex가 몇 분 안에 필요한 작업을 수행한 것을 볼 수 있습니다. 처음에는 실제로 파일 이름을 바꾸기 전에 제안된 새 이름을 보여달라고 요청하세요.
4.4 Codex에게 파일 생성 요청하기
프로젝트가 진행됨에 따라 Codex가 특정 파일을 생성하도록 요청할 수도 있습니다. 필요할 때 다시 참조할 수 있도록 말이죠. 또한 프로젝트가 발전함에 따라 Codex가 쉽게 검색하는 데도 도움이 될 것입니다.
Codex에게 논문 선별이나 기록에서 정보 추출과 같은 중요한 작업을 요청할 때마다 답변을 폴더에 파일로 저장하라고 요청하세요.
일반적으로 Codex는 이러한 파일을 마크다운(md) 형식으로 저장하며, 이는 공간을 매우 적게 차지하고 Codex가 정보를 검색하기 매우 쉽습니다. 하지만 Word 파일이나 Excel 시트를 만들도록 요청할 수도 있습니다.
Part 5: Codex 스킬
스킬은 Codex를 특정 작업의 전문가로 만드는 지침 세트입니다. AGENTS.md 파일과 마찬가지로 스킬도 일반 영어로 작성되지만, Codex에서는 일반적으로 SKILL.md 라는 파일이 있는 폴더에 있습니다. 그리고 AGENTS.md와 마찬가지로 스킬 파일을 수동 및 자동으로 자동으로 만들 수 있습니다.
스킬을 만들면 Codex는 작업이 스킬 설명과 일치할 때 사용할 수 있습니다. 또한 "$스킬-이름"과 같은 프롬프트를 입력하여 직접 스킬을 직접 호출할 수도 있습니다.
스킬을 만드는 가장 쉬운 방법은 Codex에게 대신 만들어 달라고 요청하는 것입니다. 정기적인 Zoom 통화가 있고 해당 통화의 기록이 있다고 가정해 보겠습니다. 모든 통화 또는 기록에 대해 실행 가능한 항목이나 할 일을 추출하려고 합니다.
스킬을 만들려면 Codex 세션을 시작하고 Zoom 기록에서 실행 가능한 항목을 추출하는 스킬을 만들어 달라고 요청하세요.
Codex가 작업을 시작합니다. 후속 질문을 하고 원하는 경우 편집할 수 있는 스킬 파일을 만들 수 있습니다. Codex가 응답할 때 특정 구조를 따르기를 원할 수도 있습니다.
스킬이 생성되면 Codex를 다시 시작하거나 프로젝트를 다시 로드하면 스킬을 사용할 준비가 됩니다.
5.1 AGENTS.md와 스킬의 차이점
AGENTS.md에는 여러분과 여러분의 프로젝트에 대한 전역 또는 프로젝트 수준의 지침이 포함되어 있습니다. Codex에게 여러분과 여러분의 연구에 대한 큰 그림을 제공합니다.
반면 스킬은 특정 작업을 위한 것입니다. 이러한 파일에는 훨씬 더 구체적이고 세부적인 정보가 포함되어 있습니다. AGENTS.md, 스킬 및 눈에 보이는 프로젝트 노트가 함께 작동하여 최상의 응답을 제공합니다.
5.2 Codex에 위임하지 말아야 할 것
Codex는 노동 집약적이고 시간이 많이 소요되고 반복적인 작업에 탁월합니다. 이러한 작업을 Codex에 아웃소싱하세요. 하지만 Codex는 실제로 학문으로 인정되는 것을 창출할 수 없습니다. 새롭고 독창적인 논증을 제공할 수 없기 때문입니다.
Codex는 정보를 종합하여 논증에 활용할 수 있도록 도와줄 수 있지만, 독창적인 논증을 생각해 내는 작업은 연구자로서 여러분 연구자의 몫입니다.
