Codex 사용 가이드

Codex에서 ego (lite)를 제어하고 전용 에이전트 Space에서 작업할 수 있습니다. 이 예제에서는 Anthropic의 X 프로필을 열고 처음 게시물 5개를 읽은 뒤 대화에 결과를 반환합니다. 위 전체 영상은 데스크톱 앱의 과정을 보여 줍니다. TUI를 지원하는 제품에서는 같은 Skill과 작업 지시를 사용할 수 있습니다.

시작하기 전에: ego (lite) 설치

Codex 앱을 열기 전에 ego (lite)를 설치하고 초기 설정을 완료하세요.

1. DMG 파일을 다운로드하여 엽니다
2. 안내에 따라 ego (lite) 아이콘을 더블 클릭해 설치합니다
3. ego (lite)를 열고 초기 설정을 완료합니다
4. Codex에서 프로젝트 또는 작업 공간을 엽니다

초기 설정을 완료하면 ego-browser가 ~/.agents/skills/에 설치됩니다. Codex 앱이 이미 실행 중이었다면 완전히 종료한 뒤 다시 여세요.

데스크톱 앱 또는 TUI 선택

데스크톱 앱에서는 프로젝트를 열고 새 세션을 시작합니다. TUI에서는 터미널에서 프로젝트 디렉터리로 이동한 뒤 다음 명령을 실행하세요.

codex --dangerously-bypass-approvals-and-sandbox

이 명령은 권한 확인을 건너뛰는 상태로 TUI를 시작합니다.

1단계: Codex 모드 선택

ChatGPT 데스크톱 앱(이전 Codex 데스크톱 앱)을 사용 중이라면, 시작하기 전에 왼쪽 위 모드를 Codex로 바꾸세요. Codex TUI를 사용 중이라면 이 단계는 건너뛰면 됩니다.

2단계: Full access 활성화

데스크톱 앱

입력창 왼쪽 아래의 권한 메뉴을 열고 Full access을 선택하세요. 그러면 Codex에서 단계마다 승인을 기다리지 않고 ego (lite)를 실행하고 로컬 브라우저 명령을 보낼 수 있습니다.

ego-browser는 Mac에 설치된 ego (lite)를 실행하고 브라우저 명령을 보내야 합니다. Full access가 꺼져 있으면 샌드박스가 앱 실행을 차단하거나 승인 대기 상태에서 작업이 멈출 수 있습니다.

TUI

codex --dangerously-bypass-approvals-and-sandbox로 새 세션을 시작하세요. TUI가 권한 확인을 건너뛰는 상태로 실행됩니다.

3단계: ego-browser Skill 불러오기

데스크톱 앱

Codex 입력창에 /ego를 입력한 뒤 Skill 목록에서 ego-browser를 선택하세요. /ego-browser를 직접 입력한 다음 Tab 키를 눌러 Skill을 활성화할 수도 있습니다.

이 Skill을 불러오면 Codex는 /ego-browser를 통해 ego (lite)에서 Space를 자유롭게 만들거나 기존 Space를 제어하고, 그 안에서 웹페이지를 열어 조작해 해당 작업을 완료할 수 있습니다. 개인 탭에는 영향을 주지 않습니다. 목록에 ego-browser가 없다면 ego (lite)의 초기 설정을 완료한 뒤 Codex를 다시 시작하세요.

TUI

TUI에서 ego-browser를 불러온 다음 브라우저 작업을 입력하세요. Skill은 데스크톱 앱과 같은 방식으로 작동합니다.

4단계: 에이전트에게 작업 맡기기

Codex에 작업을 전달하세요. 에이전트는 ego-browser를 사용해 ego (lite)에서 Anthropic의 X 프로필을 열고 요청한 게시물을 읽은 뒤 대화에 결과를 정리합니다.

5단계: 작업 완료

실행이 끝나면 Codex에서 게시물 5개의 화면에 표시된 정보, 직접 링크, 짧은 요약을 반환합니다. Anthropic의 X 프로필은 ego (lite)에 열린 상태로 유지되며 브라우저 작업이 완료됩니다.

문제 해결

ego-browser가 표시되지 않음

ego (lite) 초기 설정이 완료되었고 Skill이 ~/.agents/skills/에 있는지 확인한 다음 Codex을 다시 시작하세요.

Skill을 불러왔지만 ego (lite)가 열리지 않음

Full access이 활성화되어 있는지 확인하세요. TUI에서는 현재 세션을 종료한 뒤 codex --dangerously-bypass-approvals-and-sandbox로 다시 시작하세요.

X에서 로그인 또는 확인을 요청함

ego (lite)의 에이전트 Space에서 직접 로그인 또는 확인을 완료한 다음 Codex에 계속 진행하도록 요청하세요.

관련 문서

• 빠른 시작: ego (lite)를 설치하고 첫 번째 브라우저 작업을 완료하는 방법
• Claude Code: Cowork에서 Code로 전환하고 Bypass permissions를 활성화한 뒤 ego-browser를 사용하는 방법
• Cursor: ego-browser를 불러오고 Full access를 활성화한 뒤 Cursor에서 브라우저 작업을 완료하는 방법
• ego-browser Skill: 브라우저 명령과 사용 방법 확인
• Space 작동 방식: 에이전트 Space와 개인 탭이 분리되는 방식 확인
• Codex 샌드박스 및 승인: OpenAI의 현재 보안 안내 확인