빠른 흐름
Appshots 사용 흐름
1. 공유할 Mac 앱 창을 frontmost window로 둔다
2. 양쪽 Command 키나 설정한 Appshots hotkey를 누른다
3. 필요한 macOS 권한 요청을 승인한다
4. appshot이 thread attachment로 들어간 것을 확인한다
5. 캡처된 상태를 근거로 수행할 작업과 제외할 범위를 지시한다캡처 범위
현재 맨 앞 창만 공유된다
Appshots는 Mac에서 현재 맨 앞에 있는 앱 창을 Codex thread로 보내는 기능입니다. 캡처에는 보이는 창 이미지와 앱이 제공하는 사용 가능한 텍스트가 포함될 수 있습니다. 여러 창 전체를 공유하는 기능이 아니므로, 어떤 창이 앞에 있는지 먼저 확인해야 합니다.
Appshots는 thread attachment처럼 동작합니다. 수동으로 붙인 이미지나 파일처럼 thread 맥락에 들어가며, 같은 작업 설명과 함께 쓰면 "이 화면을 보고 어떤 파일을 고칠지 판단해 달라"는 형태의 지시가 가능해집니다.
화면 맥락은 작업 지시와 함께 붙여야 한다
캡처만으로는 Codex가 원하는 행동을 확정할 수 없습니다. 화면이 오류를 보여 주는지, 참고 자료인지, 수정 목표인지, 비교 기준인지 지시문에 적어야 합니다. API 문서, 이메일, 캘린더, 디자인 preview, 설정 화면처럼 텍스트로 설명하기 번거로운 상태를 전달할 때 유용하지만, 캡처 목적을 분리하지 않으면 결과가 넓어집니다.
좋은 appshot 지시
- 이 설정 화면의 오류 메시지를 보고 원인 후보를 정리한다
- 보이는 API reference만 근거로 스크립트 호출 형태를 작성한다
- 민감한 사용자 값은 요약하지 말고 필드명만 사용한다CLI에서는 새 appshot을 만들 수 없다
공식 기준상 Appshots는 Codex app의 macOS 기능입니다. 이미 appshot이 들어 있는 thread를 CLI에서 이어받으면 attachment는 thread history에 남지만, CLI에서 새 appshot을 만들 수는 없습니다. 화면 맥락을 새로 캡처해야 하면 Codex app에서 진행해야 합니다.
어디에 쓸까
| 상황 | 적합한 선택 |
|---|---|
| Mac 앱의 현재 화면을 빠르게 보여 줄 때 | Appshots |
| 실제 클릭과 입력까지 맡길 때 | Computer Use |
| 문서나 설정 화면 일부만 근거로 삼을 때 | Appshots + 좁은 지시 |
| 긴 문서의 전체 내용을 다뤄야 할 때 | 전용 plugin이나 파일 첨부 |
| CLI에서 새 화면을 캡처해야 할 때 | Codex app으로 전환 |
주의할 점
Appshots는 캡처된 이미지와 사용 가능한 텍스트를 Codex에 공유합니다. 민감한 화면은 필요한 경우에만 캡처하고, 캡처된 값 중 사용하지 말아야 할 정보는 지시문에서 분명히 제외해야 합니다.
실패 예시
- 고객 정보가 보이는 CRM 창을 캡처하고 "요약해 줘"라고만 요청함
- 결과: 필요한 필드와 제외할 개인정보의 경계가 모호해짐
- 대응: 사용할 필드, 제외할 값, 출력 범위를 먼저 제한한다참고 링크
1 sources