최근 출시한 Codex 앱 직접 써봤습니다 — Automations·Skills·멀티 에이전트까지

요새 링크드인에서는 AI 생산성과 관련된

• "이 지침으로 개발을 끝냈습니다",
• "클로드 코드 해커톤에서 사용된 Skills"

같은 포스팅들을 자주 볼 수 있습니다.
기존 OpenAI 환경에서는 해당 기능이 없었기 때문에 ChatGPT와 Codex를 사용하던 입장에서는 아쉬움이 있었습니다.

그러나 최근 Codex 앱이 Mac 환경에서 우선 출시되었고 관련 문서를 통해 서브 에이전트와 스킬 같은 개념들을 확인할 수 있었습니다.

Codex 앱을 소개합니다 | OpenAI

공식 문서의 설명을 참고하면서 개인으로 진행했던 프로젝트에 직접 적용해 사용법을 익혀보겠습니다.

---

1. 설치 및 시작하기

위 링크로 들어가서 최상단을 보면 다운로드 버튼이 있다.

다운 받은 후
처음 화면을 열면

이때 "Loading projects..." 문구와 로딩 인디케이터(스피너)가 계속 표시되는 현상이 발생했습니다.
아마 오류로 보이는데 실제로 “Loading projects에서 멈춘다”는 후기도 확인할 수 있었습니다.

지금은 고쳐졌을 지 잘 모르겠지만, 아래 순서에 따라

1. 프로젝트 추가
2. 원하는 프로젝트 폴더 선택

을 해주면

이렇게 프로젝트가 추가된 걸 볼 수 있다.(추가해도 여전히 로딩은 계속됨..)

현재는 수정됐을 수도 있는 오류지만 만약 동일한 문제가 발생할 때 해결하려면 앱을 강제 종료한 후 다시 들어가면 최초로 추가한 프로젝트가 자동 설정됩니다.

다음 화면으로 진입하면 꽤 깔끔한 UI가 보입니다.

각 영역별 어떤 기능이 있는지 살펴보겠습니다.

---

2. 좌측 UI

2-1. New thread

• 진행중인 스레드가 있다면 새로운 스레드를 만들어서 대화할 수 있는 화면으로 이동시킵니다.
• 이후 설명할 Threads 영역에서도 해당 기능을 사용할 수 있습니다.

2-2. Automations(자동화, 관련 문서)

자동화 관련된 기능인데 Skills나 Rules와 결합해서 사용할 수 있고 보안 또는 권한 부여를 위한 샌드박스 설정도 할 수 있으니 관련 문서를 꼼꼼히 읽어보고 작업하는게 좋을 듯 합니다.

예시로는

• 새로운 Skill을 자동으로 생성합니다.(현재 Skill에 개선할 부분을 업데이트 하는 등)
• 프로젝트 진행 상황을 최신 상태로 유지하세요 (메인 브랜치의 커밋 기록을 확인해 경영진 브리핑 자료를 자동으로 생성) → 개인적으로 꽤 유용해 보였습니다.
• 직접 버그를 수정하세요.(최근 1주 내 내 커밋이 만든 버그만 찾아서 작게 고치고 가능하면 바로 검증한 뒤 원인-수정-검증을 연결해서 보고하라)

이런 내용들이 있습니다.

• 반복적인 작업을 백그라운드에서 자동화 할 수 있습니다.
• 이후 설명할 Skills랑 결합해서 사용이 가능합니다.
• Git 저장소에서는 각 Automations 실행이 새로운 작업 트리(worktree)에서 시작되므로 메인 체크아웃에 영향을 주지 않습니다.
  • 이 부분이 중요해보이는데 요즘 에이전트 기반 AI 툴에서 핵심 개념으로 보입니다.
  • AI 생산성이 높아지면서 여러 작업을 에이전트가 동시에 실행하다보니 작업이 꼬일 가능성을 최소화하고자 각 작업(스레드)별로 분리된 환경을 구성하게 한 방법
  • 다양한 기능들에서 활용된다.
• Automations를 위한 작업 트리 정리도 중요해보입니다.
  • Git 리포지토리의 경우 Automations는 작업 트리에서 실행됩니다.
  • 때문에 자주 Automations를 실행하면 시간이 지남에 따라 많은 작업 트리가 생성될 수 있습니다.
  • 더 이상 필요하지 않은 Automations 실행은 보관하고, 작업 트리를 유지할 의도가 아니라면 실행을 고정하지 않도록 설정해야합니다.
• 권한 및 보안 모델
  • Automations는 무인으로 실행되도록 설계되었으며 기본 샌드박스 설정을 사용합니다.
    • 샌드박스 모드가 워크스페이스 쓰기 모드 인 경우 워크스페이스 외부의 파일을 수정하거나 네트워크에 액세스하거나 컴퓨터의 앱과 상호 작용해야 하는 도구 호출은 실패합니다.
    • Rules을 사용하여 샌드박스 외부에서 실행할 수 있는 명령을 선택적으로 허용 목록에 추가할 수 있습니다 .
    • 샌드박스 모드가 전체 액세스로 설정되어 있는 경우 Codex가 허락 없이 파일을 수정하거나 명령을 실행하고 네트워크에 액세스할 수 있으므로 백그라운드 자동화로 인한 위험이 높아집니다.

이렇게 정리했는데 해당 기능을 사용하기 위해 버튼을 누르면

이런 식으로 특정 작업을 위한 템플릿들을 추천해준다. 좌측 상단에 위치한 "Scan recent commits"를 선택해보니

원하는 프로젝트를 선택해서
최근 커밋에서 버그를 찾아내는 자동화 작업을 생성할 수 있다. 특정 요일 또는 특정 간격으로 설정할 수 있다.

2-3. Skills

단순히 코드를 작성하는 에이전트로 시작했던 Codex는 이제 코드를 활용해 컴퓨터에서 실제 작업을 수행하는 에이전트로 진화하고 있습니다.

에이전트 스킬이란

• 안정적으로 Codex와 도구를 연결
• 지정된 워크플로를 실행(작업 끝난 후 커밋 메세지 생성, 보고 메세지 작성 등)
• 작업을 완료할 수 있도록 함께 묶어 제공하는 지침, 리소스, 스크립트

등의 역할을 하며 이전에 존재하던 지침의 업그레이드 버전이라 생각됩니다.
좀 더 살펴보니 다양한 앱들과 연동해서 사용할 수 있도록 제공되는 추천 스킬(OpenAI에서 관리)들이 많이 있습니다.

• 디자인 구현: Figma⁠에서 디자인 맥락, 에셋, 스크린샷을 가져와 프로덕션 수준의 UI 코드로 변환하여 시각적으로 1:1에 가까운 결과물을 구현합니다.
• 프로젝트 관리: Linear에서 버그 분류, 릴리스 추적, 팀 업무량 관리 등 다양한 작업을 수행해 프로젝트를 원활하게 진행합니다.
• 클라우드 배포: Cloudflare, Netlify, Render, Vercel 같은 주요 클라우드 호스트에 웹 앱을 배포합니다.
• 이미지 생성: GPT Image 기반의 이미지 생성 스킬을 사용해 웹사이트, UI 목업, 제품 비주얼, 게임 에셋으로 활용할 이미지를 생성하고 편집합니다.
• OpenAI API로 개발: OpenAI API를 활용해 개발 시 최신 문서를 참고합니다.
• 문서 생성: 전문 서식과 레이아웃으로 PDF⁠, 스프레드시트, docx 파일을 읽고 생성하고 편집합니다.

스킬을 팀 단위로 사용하기 위해 Github 저장소를 활용한 방법에 관한 공식 문서도 제공되어 있습니다.

---

3. 중앙 UI

3-1. 채팅 영역

가장 많이 사용할 영역이며

• 모델 선택(OpenAI의 모델만 사용할 수 있습니다)
• 추리 능력: Low, Medium, High, Extra High 중에 선택할 수 있습니다.(높은 수준으로 갈수록 답변 시간이 오래 걸림)
• 권한 설정: Default permission으로 설정되어 있습니다.

와 같은 항목들이 있습니다.

---

4. 우측(상단) UI

4-1. Run

선택된 프로젝트를 실행할 커맨드를 설정하는 기능입니다.
Tell Codex how to install dependencies and start your app.
(번역: Codex에 종속성 설치 및 앱 시작 방법을 알려주세요.)

환경 변수도 설정 가능합니다.

4-2. Open In

특정 앱을 통해 프로젝트를 열 수 있습니다.

4-3. Github 관련 기능

• Commit
• Push
• Commit & Create PR / View PR

기능을 사용할 수 있다. 커밋 메세지나 PR 메세지의 경우 자동으로 생성도 가능합니다.

4-4. Terminal

토글 기능을 통해 툴 하단에 터미널을 활성/비활성화 할 수 있습니다.

4-5. diff panel

커밋할 준비(add)가 된 요소(Staged)와 그렇지 않은 요소(Unstaged)를 선택해서
각각의 변경점과 기존 코드를 비교해서 바뀐 부분을 표시해줍니다.

---

5. 사용 후기

개발 작업이 멈춘 토이 프로젝트에 직접 사용해봤습니다

리팩토링을 위한 작업을 요청했는데 다양한 개선 포인트들은 제안해줍니다.
이후 특정 작업(가장 간단한 작업)을 요청했습니다
기존 브랜치 명칭들을 참고해서 브랜치를 만들고 해당 브랜치를 통해 작업 진행 후 PR까지 한국말로 생성해.
라 요청한 후 조금 기다렸더니

이렇게 사용자가 편리하게 선택할 수 있는 UI로 제공해줍니다.
CLI에 익숙한 개발자 입장에서는 큰 장점으로 느껴지지는 않을 것 같습니다.

이후 우측 상단 Commit 버튼을 통해서 commit을 생성할 수 있습니다.

• Commit message란을 비워두면 자동으로 메세지가 생성됩니다.
• Commit, Commit 후 push, Commit 후 PR까지 생성 중 선택할 수 있습니다.
• 저는 Commit and create PR을 선택했습니다.
• PR이 추가된 걸 볼 수 있는데, 평소 작성하던 양식이랑은 많이 달라서 이런 부분을 Skills로 통일시키면 좋을 듯 합니다.

---

6. 여러 에이전트를 병렬로 사용하기

여러 스레드를 동시에 작업하는 기능입니다.
아래에서 예를 들면

• 프로젝트에서 개선해야 할 부분을 찾는 스레드와
• 프로젝트를 문서화 하는 스레드
  

두 가지 스레드가 동시에 실행되고 있습니다.

이런 병렬 작업이 원활하게 돌아가도록 Codex 앱에서는 git의 worktree 기능을 활용합니다.
또한 각 스레드에서 에이전트의 변경 사항을 검토하고 diff에 코멘트를 남기거나 에디터에서 파일을 열어 직접 수정할 수도 있습니다.

이를 통해 여러 에이전트가 충돌 없이 동일한 리포지터리에서 작업할 수 있는 환경을 제공합니다.

---

7. 마치며

개인적으로 Codex 앱은 개발자뿐만 아니라 바이브 코더들도 주요 타겟층으로 삼고 있는 것처럼 느껴졌습니다.
깔끔한 UI와 Automations, Skills가 라이브러리와 유사한 형태로 구성되어 있어 전반적으로 편리한 앱이라고 생각합니다.

별도로 현재 AI 관련 서비스들(Codex, Cursor, Antigravity, Claude Code 등)이 지속적으로 발전하고 있으며 생산성을 높이기 위한 다양한 팁과 사례들이 매우 많다는 인상을 받았습니다.

그러다 문득 생산성을 높이기 위해 들이는 시간이
오히려 생산성을 저해하고 있는 것은 아닐까 하는 생각도 들었습니다.

현재 제게는 AI를 다루는 능력 역시 중요하지만
AI와 함께 작업하더라도 방향을 잃지 않기 위해 근본적인 지식을 충분히 공부하는 것이 더 중요하다고 느꼈습니다.

당분간은 AI 기능들을 꾸준히 학습하면서 기본적인 학습 또한 더욱 성실히 이어가고자 합니다.

8. 참고

현재는 Mac 버전으로만 먼저 출시된 상태이며 Windows 환경에서는 아직 사용이 어렵습니다. 🥹