orca설치 및 codex연동 + AGENT.md 작성 후 적용

About this offer

여러 ai에이전트 활용을 도와주는 Orca를 설치하고 Codex를 연동한 뒤, AGENTS.md 를 작성해서 사용해 보려고 한다. 이번에는 워크스페이스 폴더를 만들고, 내가 어떤 일을 하고 무엇을 알고 있는지 지침 파일에 정리했다. 이후 Codex에 파일을 요약하고 수정하도록 요청하면서 사용해 봤다. 1. Orca 설치 먼저 Orca GitHub 저장소에 들어간 뒤, 다운로드 페이지에서 Windows용 설치 파일을 내려받아 설치했다. Orca는 Codex , Claude 같은 코딩 에이전트를 실행하고 작업을 관리할 수 있는 도구다. 이번에는 Codex를 연결해 온보딩 문서를 작성하는 데 사용했다. 설치 후에는 Orca의 온보딩 체크리스트를 따라 초기 설정을 진행했다. 2. Orca CLI와 Codex CLI 설치 온보딩 과정에서 Orca CLI를 설치했다. CLI는 터미널에서 명령어로 사용하는 인터페이스를 뜻한다. 새 노트북이라 개발 도구가 준비되어 있지 않았고, 기억하기로는 이 과정에서 Node.js와 Visual C++ 관련 구성 요소 를 추가로 설치한 뒤 Orca CLI 설치를 진행했다. 정확한 Visual C++ 패키지명과 설치 순서는 당시 기록이 없어 확실하지 않다. 이후 Codex CLI를 설치하고 로그인 했다. 설치 흐름은 다음과 같다. Orca Windows 앱 설치 ↓ 온보딩 체크리스트에 따라 CLI 설치 준비 ↓ Orca CLI 설치 ↓ Codex CLI 설치 및 로그인 ↓ 온보딩 폴더에서 Codex 사용 이 순서는 내가 진행한 과정을 정리한 것이며, 모든 Windows 환경에서 같은 추가 프로그램이 필요하다는 의미는 아니다. 3. 온보딩 폴더에 AGENTS.md 작성 파일 위치와 역할 문서 폴더 아래에 Codex 온보딩용 디렉터리를 만들고 지침 파일 초안을 작성했다. 당시 대화 기록에서 확인한 위치는 다음과 같다. Documents/ └─ Codex/ └─ 온보딩/ └─ AGENTS.md AGENTS.md 는 Codex에 작업 규칙과 프로젝트 맥락을 전달하는 Markdown 파일이다. Codex는 작업을 시작할 때 적용 대상인 지침 파일을 읽는다. OpenAI 공식 문서 이번 파일에는 코드 작성 규칙뿐 아니라 내 학습 배경과 설명을 받고 싶은 방식 도 넣었다. 처음 작성한 지침 초안의 주요 내용은 다음과 같았다. 아래는 Codex가 당시 파일을 읽고 요약한 내용을 정리한 것이다. 항목 지침 내용 목적 Orca와 Codex의 작업 흐름을 익히는 연습 공간 소통 한국어로 설명하고 개발 용어는 짧게 풀이하기 정보 구분 사실과 추정, 완료한 작업과 미완료 작업 구분하기 파일 수정 기존 파일과 변경 사항을 확인하고 요청한 범위만 수정하기 동작 확인 설치·연동은 실제 실행으로 확인하고, Orca 작업 전 설치 버전의 스킬과 도움말 확인하기 보안 API 키, 토큰, 비밀번호를 문서나 저장소에 기록하지 않기 검증·보고 관련 검사를 실행하고 변경 파일, 확인 방법, 남은 작업을 간결하게 보고하기 4. Codex로 지침을 확인하고 수정하기 파일 요약 요청 처음에는 다음과 같이 요청했다. 현재 위치에 있는 ANGENT.md 파일 요약해줘. 파일명을 잘못 입력했지만, Codex가 현재 폴더에서 관련 이름을 찾아 실제 파일이 AGENTS.md 라는 것을 확인했다. 이후 파일을 읽고 목적, 소통 방식, 수정 원칙 등을 요약했다. 이번에 확인한 기본 지침 파일명은 AGENTS.md 다. 잘못 입력한 이름을 대화 중에 찾아준 것과, 해당 이름의 파일이 자동으로 지침으로 인식되는 것은 별개의 동작이다. 사용자 배경과 학습 방향 추가 초안 확인 후에는 내 업무와 앞으로의 학습 방향을 설명하고 파일을 수정하도록 요청했다. 요청 내용을 정리하면 다음과 같다. AGENTS.md에 내용을 업데이트해줘. 나는 Elastic Stack과 MinIO를 다루는 주니어 데이터 엔지니어야. 앞으로 Elastic Stack을 먼저 배우고 관련 질문을 할 예정이고, 이후에는 MinIO에 관한 질문도 할 수 있어. Codex는 기존 지침을 유지하면서 사용자 배경과 학습 방향 을 추가했다. Elastic Stack과 MinIO를 다루는 주니어 엔지니어 현재는 Elastic Stack을 우선 학습 이후 MinIO로 학습 범위 확장 가능 주니어 눈높이에 맞춰 기초 개념과 업무 예시로 설명 사전 지식과 프로젝트 경험 추가 이어서 기존에 공부했던 내용과 프로젝트 경험도 전달했다. 리눅스 기본 명령어와 Docker, Kubernetes는 기초 정도 알고 있어. 이전에 AWS 클라우드를 공부했고, 온프레미스에서 Kubernetes 환경을 구성해 본 경험이 있어. AWS에서는 EKS를 활용해 MSA를 구성해 봤어. Elastic Stack은 온프레미스 프로젝트에서 ELK를 Helm chart로 간단히 설치하고 사용한 경험이 전부야. 이 내용은 사전 지식과 프로젝트 경험 으로 추가됐다. 구분 전달한 경험 Linux 기본 명령어 사용 Docker·Kubernetes 기초 지식 보유 온프레미스 Kubernetes 환경 구성 AWS 클라우드 학습 및 EKS 기반 MSA 구성 Elastic Stack Helm chart로 ELK를 간단히 설치하고 사용 설명 방식도 함께 보완됐다. Elastic Stack을 설명할 때 기존 AWS·Kubernetes 경험과 연결하되, Elastic Stack의 내부 동작과 운영 개념은 처음부터 설명하도록 반영했다. Codex는 각 수정 후 파일을 다시 읽어 반영된 내용을 확인하고, 무엇을 추가했는지 보고했다. 이번에는 질문에 대한 답변을 받는 데서 끝나는 것이 아니라 실제 Markdown 파일이 수정되는 과정을 확인했다. 주니어 데이터 엔지니어라는 배경과 기존 프로젝트 경험을 지침에 추가했다. 5. 새 세션과 다른 프로젝트에서 활용하기 같은 온보딩 폴더에서 새 세션 시작 같은 폴더를 작업 위치로 선택하면 그 위치의 AGENTS.md 를 활용할 수 있다. 새 세션에서 다음과 같이 요청해 어떤 지침과 배경을 참고하는지 확인할 수 있다. 현재 적용된 지침과 내 학습 배경을 요약해줘. 다른 프로젝트에서 사용 새 프로젝트의 최상위 폴더에 AGENTS.md 를 복사하거나 필요한 내용을 옮긴다. 이미 지침 파일이 있다면 전체를 덮어쓰기보다 사용자 배경, 학습 방향, 사전 지식 처럼 필요한 부분을 기존 내용에 추가하는 방식으로 활용한다. 공통 지침으로 사용 여러 프로젝트에서 공통으로 사용할 내용은 Codex 사용자 설정 폴더인 CODEX_HOME 의 AGENTS.md 에 둘 수 있다. 기본 위치는 ~/.codex/AGENTS.md 이지만, 실행 환경에 따라 달라질 수 있으므로 실제 경로를 확인해야 한다. 전역·프로젝트 지침 안내 당시에는 전역 설정을 변경하지 않고, 현재 파일을 학습용 원본으로 유지한 뒤 다른 프로젝트에 필요한 내용을 가져가는 방식으로 안내받았다. 학습 진도는 별도로 기록 AGENTS.md 에 학습 배경을 적어 두는 것과 이전 대화·학습 진도가 모두 이어지는 것은 다르다. 배운 내용, 막힌 부분, 다음에 할 일은 별도의 학습기록.md 에 정리하는 방법도 안내받았다. AGENTS.md와 학습기록.md를 읽고, 내 수준과 이전 학습 진도에 맞춰 이어서 설명해줘. 이 요청은 앞으로 사용할 수 있는 예시다. 이번 실습에서는 별도의 학습기록 파일까지 만들지는 않았다. 6. 실습 결과 요약 설치 및 연동 Orca 다운로드 페이지에서 Windows용 앱을 설치했다. 온보딩 체크리스트를 따라 Orca CLI를 설치하고, Codex CLI 설치와 로그인을 진행했다. AGENTS.md 작성 및 수정 Documents/Codex/온보딩/AGENTS.md 에 작업 지침을 작성했다. Codex에 파일 요약을 요청해 기존 지침을 확인했다. 주니어 데이터 엔지니어라는 배경과 Elastic Stack 우선 → 이후 MinIO 학습 방향을 추가했다. Linux·Docker·Kubernetes 기초 지식과 온프레미스·EKS·Helm 기반 ELK 사용 경험을 반영했다. Codex가 파일을 수정하고 다시 읽어 변경 내용을 확인하는 과정을 살펴봤다. 재사용 방법 같은 작업 폴더의 새 세션에서는 기존 지침 파일을 활용한다. 다른 프로젝트에는 필요한 지침을 복사하거나 기존 파일에 합친다. 전역 지침 설정과 별도 학습기록 작성 방법은 안내받았으며, 이번에는 실행하지 않았다. 7. 핵심 정리 AGENTS.md 에는 작업 규칙뿐 아니라 사용자 배경과 학습 수준도 정리할 수 있다. 자연어로 수정할 내용을 전달하면 Codex가 실제 파일을 수정하고 결과를 보고할 수 있다. 새 작업에서 사용할 때는 파일명과 위치를 확인하고, 적용 중인 지침을 요약하도록 요청한다. 반복해서 사용할 배경·규칙과 매번 달라지는 학습 진도는 나누어 기록한다.