본문으로 건너뛰기
Codex DesignBETA

Codex 앱 내 브라우저

Codex 데스크톱 앱에는 사이트나 앱을 미리 보고, 페이지 위에 바로 시각적 피드백을 남기고, Codex가 직접 눌러 보며 변경을 확인하게 할 수 있는 브라우저가 들어 있습니다. 여는 법, 주석 사용법, 중요한 설정, 그리고 브라우저가 안 보이거나 Codex가 쓰지 못할 때 확인할 것을 정리했습니다.

2026년 11월 8일 업데이트 · 6분 분량

짧게 답하자면

  • 어디에 있나요? Codex 데스크톱 앱(ChatGPT 데스크톱 앱의 일부)에 있고, 앱과 함께 설치됩니다. Codex CLI와 IDE 확장에는 없습니다.
  • 열 수 있는 것: http://localhost:3000 같은 로컬 앱, 파일 기반 페이지, 공개 웹사이트.
  • 여는 법: New tab을 골라 URL을 입력하거나, 채팅의 링크를 열거나, Cmd+T(Windows와 Linux는 Ctrl+T)를 누르세요.
  • Codex가 쓰게 하기: 메시지에서 @Browser를 언급하면 Codex가 페이지를 열고, 눌러 보고, 확인합니다.
  • 피드백 주는 법: Annotate를 고르고, 요소를 클릭하거나 영역을 드래그해 댓글을 쓴 뒤, 댓글을 반영해 달라고 Codex에 요청하세요.

이 가이드는 OpenAI의 Browser 문서를 기준으로 합니다(2026년 11월 8일 기준).

페이지 열기

  • 새 탭: New tab을 골라 URL을 입력하세요. 주소창에 입력하면 방문 기록이 추천되고, 그 밖의 내용은 Google로 검색됩니다.
  • 채팅에서: Codex가 알려 준 URL, 예를 들어 방금 띄운 개발 서버 주소를 고르세요.
  • 키보드: Mac은 Cmd+T, Windows와 Linux는 Ctrl+T.
  • 레이아웃: Enter full view 또는 Enter split view를 고르세요. Cmd+Shift+B(Ctrl+Shift+B)로 전체 화면에서 분할 화면으로 돌아가거나 채팅 옆 탭을 켜고 끌 수 있습니다.

로컬 앱이라면 먼저 Codex에게 개발 서버를 띄우고 주소를 알려 달라고 한 뒤 여세요. Codex가 바꾼 뒤에는 넘어가기 전에 페이지를 다시 확인하세요.

Codex가 브라우저를 쓰게 하기

페이지 열기, 흐름 따라가기, 버그 재현, 수정 확인처럼 Codex가 직접 페이지에서 일하게 하려면 @Browser를 언급하세요.

브라우저에서 변경 확인
@Browser http://localhost:3000/settings를 열고, 폼의 이메일 주소를 바꿔 저장한 뒤 성공 메시지가 뜨는지 확인해 주세요. 그다음 같은 페이지를 390px 너비에서 확인하고 깨지는 곳을 알려 주세요.

@Chrome은 다릅니다. OpenAI 확장 프로그램으로 내 Chrome을 제어하며 따로 설정이 필요합니다. 앱 내 브라우저는 평소 브라우저와 별도의 프로필을 써서 탭이나 로그인 상태를 공유하지 않습니다. 계정이 필요한 작업이면 그 안에서 바로 로그인할 수 있습니다.

주석으로 피드백하기

주석은 페이지에서 정확히 무엇을 바꿀지 Codex에 알리는 가장 빠른 방법입니다.

  1. 브라우저 도구 막대에서 Annotate를 골라 Annotation mode로 들어가세요.
  2. 요소를 클릭하거나 영역을 드래그해 고르세요.
  3. 댓글을 쓰고 저장하세요. 필요한 만큼 추가할 수 있습니다.
  4. 댓글을 반영해 달라고 Codex에 메시지를 보내세요.

스타일 변경에는 댓글 입력란 옆의 Adjust를 쓰세요. 폰트, 텍스트, 간격, 색상을 조정하고 보내기 전에 미리 볼 수 있습니다. "제목 위를 조금 더 띄워 주세요"라고 말로 설명하는 것보다 빠릅니다.

주석 반영
이 페이지에 남긴 제 댓글을 모두 반영해 주세요. 댓글이 없는 부분은 그대로 두고, 스타일 변경에는 기존 간격과 색상 토큰을 쓰세요.

중요한 설정

  • Settings > Browser > Agent permissions: 탐색, 다운로드, 업로드의 기본 권한과 사이트별 예외를 정합니다. 사이트의 사용자 지정 권한을 지우면 기본값으로 돌아갑니다. 조직이 이 설정을 제한할 수 있습니다.
  • 민감한 작업: 정보를 제출하거나 구매하기 전에 Codex가 확인을 요청합니다.
  • 다운로드: 기본적으로 다운로드 폴더에 저장됩니다. 위치를 바꾸거나 Ask where to save downloads를 켤 수 있습니다.
  • 방문 기록 삭제: Settings > Browser에서 기간과 데이터 종류를 골라 지웁니다.
  • 개발자 모드: Enable full CDP access를 켜면 Codex가 Chrome DevTools Protocol을 통제된 방식으로 써서 더 깊이 디버깅할 수 있습니다. 사이트에서 쓰기 전에 묻고, 관리자가 끌 수 있습니다.

앱 내 브라우저에서 Codex는 파일 업로드를 자동화할 수 없습니다. 업로드가 필요하면 직접 하세요.

앱 내 브라우저가 안 될 때

CLI나 IDE 확장에는 없음. 앱 내 브라우저는 그곳에서 쓸 수 없습니다. 터미널이나 에디터에서는 Playwright 같은 도구를 쓰도록 Codex에 요청하거나, 데스크톱 앱에서 페이지를 여세요.

페이지가 열리지 않음. 로컬 앱이라면 개발 서버가 실행 중인지, 주소의 포트가 출력된 포트와 같은지 확인하세요. Codex에게 시작이나 재시작을 요청하세요.

Codex가 페이지를 클릭하거나 입력하지 못함. @Browser를 언급했는지, Agent permissions가 그 사이트 탐색을 허용하는지 확인한 뒤 새 스레드에서 다시 해 보세요.

브라우저가 사용할 수 없다고 나옴(특히 Windows). openai/codex GitHub에는 Windows 사용자들이 설정에서 Browser 플러그인이 사용할 수 없다고 나오거나, "Browser is not available: iab" 오류가 나거나, 브라우저는 열리지만 Codex가 조작하지 못한다고 보고한 사례가 있습니다. 거기서 보고된 방법은 Microsoft Store에서 앱을 업데이트하거나 다시 설치한 뒤, Windows에서 앱 복구(Repair) 또는 **초기화(Reset)**를 실행하고 다시 시작하는 것입니다. 효과는 사람마다 다르니, 쓰는 버전에 대해서는 GitHub issues를 확인하세요.

주석이 반영되지 않음. 각 댓글을 저장한 뒤, 반영해 달라는 메시지를 보냈는지 확인하세요. 메시지를 보내기 전에는 댓글이 전달되지 않습니다.

조직에서 기능을 막음. 관리자는 브라우저 권한과 전체 CDP 접근을 제한할 수 있습니다. 설정이 회색이면 워크스페이스 관리자에게 문의하세요.

Codex Design은 어디에 쓰나요

앱 내 브라우저는 한 번에 한 페이지를 보여 주므로, 만들고 있는 화면을 확인하고 고치는 데 알맞습니다. 정하기 전에 한 화면의 여러 방향을 나란히 비교하고 싶다면, Codex Design이 Codex에 캔버스를 더해 각 방향을 고르고 편집할 수 있는 라이브 HTML 페이지로 놓아 줍니다. 둘을 함께 쓰는 법은 Codex 캔버스를 보세요.

자주 묻는 질문

Codex 앱 내 브라우저는 Windows에서 되나요?

브라우저는 데스크톱 앱의 일부이고, 데스크톱 앱은 Mac, Windows, Linux에서 실행됩니다. 일부 Windows 사용자가 사용할 수 없다고 나온다고 보고했고, 위의 방법으로 해결된 경우도 있습니다.

앱 내 브라우저에서 Chrome 로그인을 쓸 수 있나요?

아니요. 별도의 프로필이라 평소 브라우저와 세션을 공유하지 않습니다. 그 안에서 로그인하거나, OpenAI의 Chrome 확장 프로그램과 @Chrome으로 내 Chrome에서 작업하세요.

Annotate와 Adjust는 무엇이 다른가요?

Annotate는 요소나 영역에 댓글을 답니다. Adjust는 요소의 폰트, 텍스트, 간격, 색상을 실시간 미리보기로 바꿔, Codex가 원하는 정확한 값을 받게 합니다.

더 읽어 보기

Codex용 독립 플러그인입니다. OpenAI와 제휴하거나 OpenAI의 보증을 받은 제품이 아닙니다.