Codex 세션에 도구가 있고 대상 페이지에 접근할 수 있을 때 브라우저를 제어할 수 있습니다. 먼저 브라우저가 실행될 위치를 정하세요. 데스크톱 내장 브라우저는 로컬 미리보기에 적합합니다. 승인된 외부 브라우저는 기존 프로필을 쓸 수 있습니다. CLI와 클라우드는 각각 도구와 접근 경로가 필요합니다.
r/codex의 한 사용자는 내장 브라우저로 localhost 미리보기에 주석을 달았다고 설명했습니다. 사이트가 이미 내 컴퓨터에서 실행 중이라면 이 방법으로 시작하세요. Tabbit에 로그인해 둔 사이트는 아래 예시처럼 다른 경로를 선택할 수 있습니다.
먼저 확인할 사항
로컬 미리보기에는 @Browser를 쓰고, 다른 브라우저의 로그인 상태가 필요하면 호환 확장 프로그램을 쓰세요.
터미널 세션에는 별도의 브라우저 도구가 필요합니다. 클라우드에서는 그 환경에서 URL에 접속할 수 있는지 확인하세요.
Codex에 화면 조작을 맡기기 전에 최종 URL과 화면에 보이는 문구를 비교하세요.
내장 브라우저는 별도 프로필을 씁니다. 기존 로그인이 필요하면 데이터를 읽기 전에 프로필과 계정을 확인하세요.
실행 환경에 맞는 진입점 고르기
ChatGPT 데스크톱에서 로그인하지 않은 공개 페이지나 로컬 미리보기에는 내장 브라우저를 사용하세요. 새 탭에서 페이지를 열고 Codex 작업에 @Browser를 사용합니다. 내장 브라우저에는 별도 프로필이 있습니다. 평소 쓰는 브라우저에 이미 열린 사이트가 필요하면 호환 확장 프로그램이나 승인된 외부 도구를 선택합니다. OpenAI는 Chrome, Edge, Brave, Opera, Vivaldi를 안내합니다. 버전, 배포 상태와 워크스페이스 정책에 따라 달라질 수 있습니다.
@Browser의 새 탭에서 정확한 URL을 열고 프롬프트에서 그 탭을 지정하세요. 기존 로그인이 필요하면 확장 프로그램이 어느 브라우저와 프로필에 연결되는지 확인하세요. 원격 작업이라면 승인된 테스트 주소나 클라우드 환경 안에서 시작한 서버부터 확인하세요.
| 실행 환경 | 브라우저 도구 | 쓰는 경우와 확인 사항 |
|---|---|---|
| ChatGPT 데스크톱 | @Browser | 로컬 미리보기나 공개 페이지에 적합합니다. 내장 프로필의 로그인 상태는 별개입니다. |
| 확장 프로그램이 있는 데스크톱 | 호환 외부 브라우저 | 로그인된 페이지에 적합합니다. 프로필과 사이트 권한을 확인하세요. |
| 로컬 Codex CLI | Tabbit CLI 또는 브라우저 MCP | 터미널 작업에 적합합니다. 현재 프로세스가 도구를 호출할 수 있는지 확인하세요. |
| 클라우드 Codex | 원격 환경의 브라우저 도구 | 접근 가능한 테스트 URL을 쓰세요. 노트북의 localhost에는 별도 승인된 연결이 필요합니다. |
자세한 내용은 다음 가이드를 참고하세요. Tabbit / Codex.
로컬 CLI와 클라우드 따로 확인하기
로컬 터미널은 프로세스가 접근할 수 있고 실행 정책이 허용하는 도구를 사용할 수 있습니다. Tabbit은 실행 파일과 현재 에이전트의 스킬을 확인하세요. MCP라면 클라이언트가 도구를 제공하고 서버에 실제 브라우저가 있어야 합니다. 클라우드 localhost는 클라우드 환경을 가리킵니다. 노트북 개발 서버나 로그인 프로필에는 승인된 별도 경로가 필요합니다.
자세한 내용은 다음 가이드를 참고하세요. Codex Cloud가 내 컴퓨터의 localhost를 열 수 없는 이유.
자세한 내용은 다음 가이드를 참고하세요. agent-browser CLI 입문: 스냅샷, ref, 세션.
워크플로 전에 브라우저 확인하기
도구 이름, 대상 URL, 별도 프로필인지 기존 로그인 프로필인지 확인하세요. 도구가 없으면 버전, 설정, 권한과 로드 상태를 점검합니다. 브라우저가 열리지만 페이지가 실패하면 URL과 서비스가 실행되는 장치를 확인합니다. 로그인 화면이 나오면 같은 요청을 반복하기 전에 프로필을 확인합니다.
| 증상 | 다음 확인 사항 |
|---|---|
| 브라우저 도구가 없음 | 현재 세션의 도구 목록, 설정, 워크스페이스 정책을 확인하세요. |
| 연결이 거부됨 | 브라우저가 실행되는 컴퓨터와 서버의 수신 주소 및 포트를 확인하세요. |
| URL 또는 제목 불일치 | 최종 URL의 호스트와 포트가 예상 페이지와 같은지 확인하세요. 다르면 중단하세요. |
| 로그인 화면 표시 | 비공개 데이터를 읽기 전에 프로필과 승인된 계정을 확인하세요. |
자세한 내용은 다음 가이드를 참고하세요. GPT-6.1 Terra 브라우저 사용: 빠르고 강력한 저비용 모델.
읽기 전용 작업으로 시작하기
정확한 URL을 열고 최종 URL, 페이지 제목, 첫 번째 제목 요소, 고유한 화면 표식을 반환하게 하세요. 클릭, 입력, 양식 제출, 다운로드, 로그인은 제외합니다. 내용이 다르면 중단하고 차이를 보고하게 합니다. 답변과 브라우저 도구 결과를 대조하세요.
예시의 URL과 표식을 실제 페이지에서 확인할 수 있는 값으로 바꾸세요.
지정한 탭에서 http://localhost:3000/ 을 열어 주세요. 읽기 전용입니다. 최종 URL, 페이지 제목, 화면의 첫 제목과 B01-FIXTURE가 보이면 해당 표식을 반환하세요. 클릭, 입력, 제출, 로그인, 다운로드는 하지 마세요. 예상과 다른 주소나 로그인 화면이 나오면 중단하고 화면을 설명하세요.자세한 내용은 다음 가이드를 참고하세요. 브라우저 에이전트 설정이 제대로 됐는지 확인하는 법.
예시: Tabbit에서 열어 둔 페이지 읽기
Tabbit Browser에서 대시보드에 로그인해 두었고 Codex도 같은 컴퓨터에서 실행 중이라고 가정해 보세요. Tabbit CLI는 별도의 브라우저 도구입니다. 공식 가이드대로 설정한 뒤, 사용할 Tabbit 탭을 확인하고 알고 있는 제목 하나를 읽으라고 요청하세요. 도구나 탭을 찾지 못하면 먼저 연결을 점검하세요.
이 방법은 선택한 Tabbit 프로필을 사용합니다. 원격 세션에서 내 컴퓨터로 연결해 주지는 않습니다. 로그인할 필요가 없고 @Browser에서 열리는 페이지라면 내장 브라우저부터 쓰세요.
자세한 내용은 다음 가이드를 참고하세요. Codex 브라우저와 Tabbit CLI 비교 및 선택 기준.
작업 범위만큼 권한 주기
공개 테스트에는 깨끗한 프로필을 사용하세요. 로그인이 필요하면 승인 전에 브라우저와 오리진을 확인합니다. 브라우저 권한, 터미널 샌드박스, 클라우드 네트워크는 적용 범위가 다릅니다. 쓰기 전에 대상과 예상 결과를 확인하세요. r/codex에는 데스크톱 브라우저로 미리보기와 주석을 사용한 사례, 설정이 켜져도 비활성 오류가 난 사례가 있었습니다. 모두 개인 사례입니다.
OpenAI r/codex · @Browser r/codex · Local browser use
자세한 내용은 다음 가이드를 참고하세요. Codex가 이미 로그인한 대시보드를 읽을 수 있나요?.
자세한 내용은 다음 가이드를 참고하세요. AI 에이전트를 이미 열어 둔 브라우저에 연결하는 방법.
페이지 하나로 시작하기
로컬 미리보기는 @Browser 탭 하나에서 시작하세요. 로그인이 필요하면 해당 세션이 열린 승인된 브라우저를 선택하세요. 그 브라우저가 Tabbit이라면 Tabbit CLI를 쓸 수 있습니다. 클라우드에서 URL에 접속할 수 없다면 프롬프트를 바꾸기 전에 네트워크 경로를 확인하세요.
자주 묻는 질문
모든 Codex CLI에서 내장 브라우저를 쓸 수 있나요?
해당 세션에 도구가 제공될 때만 가능합니다. CLI에 설정된 브라우저 연동을 먼저 확인하세요.
클라우드 Codex가 노트북의 localhost에 접근할 수 있나요?
클라우드에서 localhost는 원격 환경을 뜻합니다. 앱을 그 환경에서 실행하거나 접근 가능한 승인된 테스트 URL을 쓰세요.
도구가 사용 가능한지 어떻게 확인하나요?
도구와 브라우저 프로필을 밝히고 알려진 공개 페이지를 열어 달라고 하세요. 도구 결과나 실제 탭을 확인하세요.
첫 작업에서 무엇을 반환해야 하나요?
최종 URL, 페이지 제목, 첫 제목, 알려진 표식을 요청하세요. 예상과 다르면 클릭하기 전에 중단하세요.
어떤 프로필을 써야 하나요?
공개 페이지나 미리보기에는 내장 프로필을 쓰세요. 기존 로그인이 필요하면 해당 세션이 있는 승인된 브라우저 프로필을 선택하세요.