Codex Appshots 사용법: Mac 화면 맥락을 코덱스에 안전하게 전달하기 | DAKER 커뮤니티
Codex Appshots란, Mac에서 앞에 있는 앱 창을 코덱스 스레드에 첨부해 화면 맥락을 전달하는 기능입니다. 오류 창, 설정 패널, API 문서처럼 말로 설명하기 긴 화면은 Appshots로 보여주고, 2026년 7월 4일 기준 공식 문서에서 권한과 한계를 다시 확인하세요. 오늘은 "무엇을 캡처하고, 무엇은 가려야 하는가"를 실무 기준으로 정리합니다.
DAKER 코덱스 Appshots 사용법 대표 이미지: Mac 앱 화면을 Codex 스레드에 전달하는 흐름
한 줄 요약: Appshots는 코덱스에게 화면을 보여주는 입력 표면이고, Computer Use나 Chrome extension처럼 앱을 조작하는 실행 표면과 구분해서 써야 합니다.
문제 상황: Codex에게 화면을 보여줘야 할 때 Appshots가 왜 필요할까요?
Codex에게 "이 오류를 봐줘"라고 말했는데 오류 메시지, 앱 상태, 설정 값, 선택된 탭을 모두 글로 옮기려면 시간이 걸립니다. Appshots는 이때 앞쪽 앱 창을 스레드에 붙여 Codex가 현재 화면을 보고 다음 질문이나 수정 방향을 잡게 해줍니다. 공식 문서 기준 Appshot은 보이는 창 이미지와 앱이 제공하는 텍스트를 함께 전달할 수 있지만, 모든 앱의 숨은 문서 전체를 읽는 기능은 아닙니다.
사용자가 얻는 이점은 단순합니다. 스크린샷 파일을 따로 저장하지 않아도 되고, 문제 상황을 설명하는 문장을 줄일 수 있으며, Codex가 "어떤 화면을 기준으로 판단했는지"를 스레드에 남길 수 있습니다. 다만 화면 공유는 곧 정보 공유이므로 비밀값, 고객 정보, 개인 메일, 내부 토큰이 보이는 상태에서는 바로 찍지 않는 편이 안전합니다.
권한 경계를 먼저 잡고 싶다면 코덱스 권한 프로필 글을 함께 보세요. 화면을 보여주는 일과 웹을 직접 탐색하게 하는 일의 차이는 코덱스 웹 검색 근거 수집 글에서도 이어서 확인할 수 있습니다.
핵심 개념: Appshots는 Computer Use, Chrome extension과 무엇이 다른가요?
Appshots의 핵심은 "현재 화면을 맥락으로 전달한다"는 점입니다. Codex가 앱을 직접 클릭하고 조작해야 하는 경우에는 Computer Use가 맞고, 로그인된 Chrome 세션이 필요한 웹 작업은 Chrome extension이 맞습니다. Appshots는 그보다 앞 단계에서 "이 화면을 보고 판단해줘"라는 맥락 입력에 가깝습니다.
상황 | 먼저 검토할 표면 | 이유 |
|---|---|---|
오류 창, 설정 패널, 디자인 화면을 보여주고 싶다 | Appshots | 화면 맥락 전달이 목적이다 |
macOS 앱이나 Windows 앱을 실제로 클릭해야 한다 | Computer Use | GUI 조작과 재현이 필요하다 |
로그인된 DAKER, SaaS, 관리자 화면을 조작해야 한다 | Chrome extension | 기존 Chrome 세션과 쿠키가 필요하다 |
공개 문서나 로컬 페이지를 검증해야 한다 | in-app browser | 로그인 없이 Codex 안에서 확인 가능하다 |
이 구분을 기억하면 권한을 줄일 수 있습니다. 화면을 한 번 보여주면 충분한데 Computer Use까지 켜면 조작 권한이 불필요하게 커지고, 로그인된 웹앱을 Appshot만으로 처리하려고 하면 클릭과 업로드 같은 후속 작업에서 막힐 수 있습니다.
Codex Chrome 확장 권한 글은 로그인된 웹앱을 다룰 때의 기준을 설명합니다. 반대로 사내 도구 안에서 Codex 실행 자체를 붙이는 문제라면 Codex SDK 글처럼 코드 제어 표면을 검토하는 편이 낫습니다.
DAKER 코덱스 Appshots 체크리스트: 화면 선택, 민감 정보 제거, 질문, 검증 순서
단계별 사용법: Codex Appshots는 어떻게 찍고 질문하면 좋을까요?
보여줄 앱 창을 하나만 앞에 둡니다. Appshot은 앞쪽 창 중심으로 캡처되므로 여러 창을 어지럽게 겹치지 않습니다.
화면에 비밀값, 개인 정보, 고객 정보, 복구 코드, 토큰이 보이면 먼저 가리거나 다른 예시 화면으로 바꿉니다.
Codex 앱에서 양쪽 Command 키를 누르거나 설정한 Appshots 단축키를 사용합니다.
권한 요청이 나오면 Screen & System Audio Recording, Accessibility가 왜 필요한지 확인하고 허용 여부를 판단합니다.
Appshot이 붙은 스레드에 "이 화면에서 무엇을 판단해야 하는지"를 한 문장으로 적습니다.
Codex 답변이 나오면 화면에서 확인 가능한 항목, 파일 변경, 테스트 명령을 분리해 검증합니다.
공식 문서 기준 최근 60초 안에 상호작용한 Codex 스레드가 있으면 Appshot이 그 스레드에 추가될 수 있습니다. 그렇지 않으면 새 스레드로 시작될 수 있으니, 긴 작업 중에는 어느 스레드에 맥락이 붙었는지 먼저 확인하세요.
짧은 예시: 오류 화면을 Appshots로 보낼 때 프롬프트는 어떻게 쓰나요?
좋은 요청은 화면과 목표를 함께 좁힙니다. 예를 들어 "이 설정 화면을 보고 문제를 찾아줘"보다 아래처럼 쓰면 Codex가 더 정확히 움직입니다.
"첨부된 Appshot은 결제 설정 화면입니다. 오류 메시지와 선택된 탭만 보고, 원인 후보를 3개로 좁혀 주세요."
"민감한 값은 가렸습니다. 화면에서 확인 가능한 항목과 코드에서 확인해야 할 항목을 나눠 주세요."
"수정이 필요하면 먼저 읽어야 할 파일 후보와 검증 명령을 제안하고, 바로 변경하지는 마세요."
이 흐름은 화면을 근거로 쓰되, 화면만으로 결론을 과하게 내리지 않게 만듭니다. Appshots는 판단의 출발점이지 모든 로그와 코드 상태를 대체하는 증거는 아닙니다.
실수 방지 체크리스트: Appshots를 찍기 전 무엇을 확인해야 하나요?
화면에 API 키, 쿠키, 복구 코드, 개인 메일, 고객 정보가 보이지 않는지 확인합니다.
여러 앱 창을 한 번에 보여주기보다 문제와 관련된 앞쪽 창 하나만 남깁니다.
Google Docs, Gmail, Sheets, Slides처럼 전체 문서 텍스트가 제한될 수 있는 서비스는 전용 플러그인이나 커넥터가 더 적합한지 검토합니다.
CLI에서 새 Appshot을 만들 수 있다고 가정하지 않습니다. Appshots 생성은 macOS Codex 앱 기능입니다.
Appshot만으로 앱 조작까지 된다고 기대하지 않습니다. 클릭, 입력, 재현이 필요하면 Computer Use나 Chrome extension을 별도로 판단합니다.
캡처 뒤에는 "무엇을 봐야 하는지"와 "무엇을 하지 말아야 하는지"를 프롬프트에 함께 적습니다.
Codex가 화면을 근거로 제안한 수정은 테스트 출력, 로그, 파일 diff로 다시 검증합니다.
공식 출처: 이 글은 무엇을 기준으로 작성했나요?
이 글은 2026년 7월 4일 KST 기준 OpenAI Codex 공식 매뉴얼의 Appshots, Computer Use, Chrome extension 관련 설명을 확인해 작성했습니다. DAKER 공개 본문 정책상 외부 OpenAI URL은 본문에 직접 노출하지 않고, 브라우저에서 확인한 DAKER 내부 글만 연결했습니다. 공식 문서에서 확인한 핵심 한계는 macOS Codex 앱에서 Appshot을 만들 수 있고, 일부 앱에서는 보이는 화면 중심으로만 전달될 수 있으며, 민감한 화면은 일반 첨부와 같은 기준으로 검토해야 한다는 점입니다.
이 글의 운영 관찰값도 제한적입니다. DAKER 코덱스 디렉터리의 이전 글들은 권한 프로필, 웹 근거 수집, Chrome extension, SDK처럼 실행 표면을 나누는 기준을 다뤘고, 오늘 글은 그중 "화면 맥락 입력"에만 초점을 둡니다. 실제 사용 전에는 현재 Codex 앱 설정, macOS 권한, 조직 관리 정책을 다시 확인하세요.
FAQ: Codex Appshots 사용자가 자주 묻는 질문
Codex Appshots는 일반 스크린샷 업로드와 무엇이 다른가요?
Appshots는 Codex 앱에서 앞쪽 창을 바로 스레드 맥락으로 보내는 흐름입니다. 파일로 저장해 다시 첨부하는 번거로움을 줄이고, 앱이 제공하는 텍스트도 함께 전달될 수 있습니다.
Appshots를 찍으면 Codex가 앱을 직접 조작하나요?
아닙니다. Appshots는 화면을 보여주는 입력입니다. 앱을 클릭하거나 값을 입력해야 하면 Computer Use나 Chrome extension 같은 실행 표면을 별도로 써야 합니다.
민감한 화면도 Appshots로 보내도 되나요?
권장하지 않습니다. Appshot은 화면 이미지와 텍스트를 Codex 맥락에 넣는 행위이므로 비밀값, 개인 정보, 고객 정보가 보이면 먼저 가리거나 대체 화면을 사용하세요.
Gmail이나 Google Docs 화면을 Appshots로 보내면 문서 전체를 읽나요?
항상 그렇지는 않습니다. 공식 문서는 일부 앱과 웹사이트에서 보이는 스크린샷 중심으로 전달될 수 있다고 설명합니다. 구조화된 문서 접근이 필요하면 해당 플러그인이나 커넥터를 우선 검토하세요.
CLI에서도 새 Appshot을 만들 수 있나요?
새 Appshot 생성은 macOS Codex 앱 기능입니다. 이미 Appshot이 포함된 스레드를 CLI에서 이어받을 수는 있지만, CLI에서 새 Appshot을 만드는 흐름으로 계획하면 안 됩니다.
다음에 Codex에게 화면 상태를 설명해야 한다면, 먼저 민감 정보를 가리고 Appshot 하나를 붙인 뒤 "이 화면에서 판단할 것과 하지 말 것"을 한 문장으로 적어보세요.