Codex는 무엇이며 어떻게 사용하는 것인가?

 

 

GPT에 Codex와 프로젝트를
연동하여 개발하라는 알람이 왔다.
그래서 한 번 도전해보기로 했다!
Codex 어떻게 사용하는 것일까?

 

 

 

 

 

1. Codex

• OpenAI 코딩 에이전트이다. (클로드 같은)
• 코드 작성, 기존 코드베이스 이해, 코드 리뷰, 디버깅, 반복 작업 자동화에 사용할 수 있다.
• 단순 자동완성 도구가 아닌, 기능을 바꾸라고 시키면 프로젝트 구조를 읽고 수정안을 만들 수 있는 도구이다.
  
  

 

 

---

 

 

 

 

2. Codex의 사용방법

• Codex App
  - Codex 앱은 Codex 스레드를 병렬로 작업하는데 특화된 데스크톱 환경으로, 워크트리 지원, 자동화 및 Git 기능이 내장되어 있다.
  - 구조가 큰 프로젝트와 로컬 환경인 경우 적합한 방법일 것 같다.
• Codex CLI
   - 터미널에서 프로젝트 폴더 안으로 들어가서 사용하는 방식이다. Codex CLI는 로컬 터미널에서 실행되며, 선택한 디렉터리 안의 코드를 읽고, 변경하고, 명령을 실행할 수 있다. 
  -  백엔드, Docker, Gradle, 자동화작업 관련 프로젝트에 잘 맞을 것 같다.
  - npm을 사용하는 경우 [ npm i -g @openai/codex ] -> [ cd 프로젝트 폴더 ] -> [ codex ]
• IDE 확장 프로그램
  - VS Code 계열, Cursor, Windsurf, JetBrains 계열 IDE(IntelliJ, PyCharm, WebStorm)에서도 사용할 수 있다. 
  - 파일을 보면서 바로 수정하는게 편한 경우와 위의 환경에서 작업하는 경우 가장 적합할 듯 하다.  
• Codex WEb/Cloud
  - GitHub 저장소를 연결해서 클라우드 환경에서 작업을 맡기는 방식이다. CodexWeb은 GitHub 계정을 연결해 저장소 코드로 작업하고 PR을 만들 수 있다.
  - 팀 협업, PR 리뷰, CI 수정 프로젝트에 적합할 것 같다.
• 아래 사용 방법 별로 출처를 남겨놨다. 읽어보고 본인의 상황에 맞는 것을 따라가면 될 것 같다.
  
  

 

- Codex App

App – Codex | OpenAI Developers

 

 

- Codex IDE

IDE extension – Codex | OpenAI Developers

 

 

- Codex CLI

CLI – Codex | OpenAI Developers

 

 

- Codex Web/Cloud

Web – Codex | OpenAI Developers

 

 

 

---

 

 

 

 

3. Codex 활용 방법

• 작은 단위로 나눠서 맡기면 정확도가 올라간다.
  
• 예시
   : 고객 목록 화면에서 CUSTOMER_DELETE 권한이 없으면 삭제 버튼을 비활성화해줘. 권한 정보는 /api/auth/me 응답의 authorities 배열을 기준으로 판단해줘. 수정할 파일을 먼저 알려주고, 그 다음 변경해줘. 변경 후 npm run build로 확인해줘.
  
• AGENTS.md 파일을 프로젝트 루트에 만들어서 프로젝트의 지속적인 규칙을 적어두는 방식이 좋다. 
•  DB 마이그레이션(기존 시스템의 데이터 환경을 새로운 시스템으로 이동하거나 이전하는 작업), 대규모 리팩토링, 자동 배포 설정(운영환경변수나 비밀키 노출 위험)은 Codex에게 조심히 맡겨야 한다.

 

 

 

---

 

 

 

 

4. 내가 선택한 방법_ Codex APP

카테고리를 보면 VIP 초대장이라는 프로젝트가 있다. 이 프로젝트는 VIP 등급 이상의 고객을 관리하고, 고객을 관리하는 관리자도 관리하는 페이지이다. 이 프로젝트는 솔로 프로젝트치고는 복잡한 편이라고 생각한다.아닐수도...

프로젝트에는 사용된 것들은 Docker, ElasticSearch, Keycloak, MySQL이 있다. 기능으로는 고객 관리 - 조회, 추가, 수정, 삭제, 검색이 있고 관리자마다 부여 받은 권한에 맞춰서 각 기능에 제한을 걸어뒀다. 그리고 그 관리자를 관리하는 최고관리자가 있다. 최고관리자는 모든 고객의 관리 권한을 가지고 있는 동시에, 관리자를 관리하는 권한도 갖고 있다. 관리자 관리도 고객 관리처럼 조회, 추가, 수정, 삭제, 검색 기능을 가지고 있다.

암튼 이런식으로 구성되어있는 프로젝트를 수정하려고 한다. 그래서 여러 사용 방법을 봤을 때, 앱으로 설치하는게 현재로서 가장 나은 선택지로 생각된다. Git에 올릴 예정이라 GitHub로 사용해볼까 고민도 했는데, Codex가 GitHub Cloud에서 코드를 고쳐도 Keycloak 컨테이너, 환경 변수, Docker 상태 등... 제대로 읽지 못할 것 같아서 로컬 환경을 중심으로 사용할 수 있는 Codex 앱을 선택했다.

더 찾아보니까 꼭 한가지 방법으로 프로젝트를 관리할 필요는 없는 것 같다. 그래서 만약 전체 구조 분석이 필요하고, 여러 파일 리팩토링을 해야하는 등 큰 부분을 고칠 예정이면 App을 사용하고 현재 파일에 대한 설명을 듣길 원하거나, 바뀐 코드를 확인하거나, 컴포넌트 한 부분을 수정하는 등 작은 수정 담당이면 IDE를 사용하는 방향으로 가면 될 것 같다. 대신 같은 파일을 Codex App과 Codex IDE에게 맡기는 건 주의해야한다. 동시에 수정해서 충돌이 일어날 수 있다.

다음 포스팅에서 어떻게 다운로드하고 사용하면 되는지 알아보겠다.