시작 전 준비 — 설치·첫 실행 설정·에이전트 권한
실습에 들어가기 전에 한 번만 해 두는 준비입니다. ego(lite)를 설치하고, 내가 쓰는 AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램 — Claude Code, Codex 등)가 ego(lite)를 열 수 있도록 권한을 맞춘 뒤, 대화창에서 /ego-browser가 보이는지 확인합니다.
- ego(lite)를 설치하고 첫 실행 설정(onboarding)을 끝까지 마칩니다.
- 쓰던 브라우저의 로그인 상태를 가져올지 스스로 정합니다.
- 에이전트의 권한을 넓히는 것이 무슨 뜻인지 알고 켭니다.
- 에이전트 대화창에서 ego-browser 스킬(Skill — 에이전트에게 주는 사용 설명서 묶음)을 불러옵니다.
예상 소요 시간: 5~10분 (원문은 설치부터 첫 작업까지 약 2분이라고 안내합니다)
준비물을 확인한 뒤 따라 하기 다섯 단계를 순서대로 진행하세요. 중간에 걸리면 막히면에서 같은 증상을 찾습니다. 이미 설치와 첫 실행 설정을 마쳤다면 3단계부터 시작합니다.
준비물과 완료 기준
- macOS 컴퓨터. 이 활용편은 macOS를 기준으로 씁니다. Windows용은 베타이고 화면·경로가 다를 수 있습니다 — 가이드 1장 Windows를 함께 보세요.
- 내가 쓰는 에이전트 하나. 여기서는 Claude Code(데스크톱 앱 또는 터미널(글자로 명령을 입력하는 창))와 Codex(데스크톱 앱 또는 터미널)를 다룹니다. 다른 에이전트는 가이드 5장의 에이전트별 표에서 찾습니다.
- (선택) 평소 쓰던 브라우저와 macOS 키체인(Keychain — macOS가 비밀번호 같은 민감한 정보를 보관하는 금고) 암호. 로그인 상태를 옮겨 올 때만 필요합니다.
에이전트 입력 칸 옆의 권한 표시가 Bypass permissions(Claude Code) 또는 Full access(Codex)이고, 입력 칸에 /ego-browser를 쳤을 때 ego-browser 스킬이 목록에 보이면 완료입니다.
따라 하기
1단계 · ego(lite) 내려받아 설치하기
- 설치 파일 내려받기ego(lite) 문서 사이트(lite.ego.app)의 Download for Mac(Mac용 내려받기) 단추로 DMG(macOS 앱 설치 파일)를 받아 엽니다.
- 설치하기화면 안내에 따라 ego(lite) 아이콘을 더블클릭해 설치합니다.
- ego(lite) 열기설치된 ego(lite)를 찾아 엽니다.
확인: ego(lite)가 열리고 첫 실행 설정이 시작됩니다. 더 자세한 설명은 가이드 1장 설치에 있습니다.
2단계 · 첫 실행 설정 마치기
처음 열면 ego(lite)가 두 가지 일을 합니다. 하나는 스킬 설치입니다. 내 컴퓨터에 설치된 에이전트를 찾아 ego-browser 스킬을 그 에이전트의 스킬 폴더(~/.agents/skills, ~/.claude/skills/)에 써 넣습니다. 그래서 널리 쓰이는 에이전트 대부분은 따로 설치할 것이 없습니다. 다른 하나는 데이터 가져오기를 할지 묻는 것입니다.
- 가져올지 정하기다른 브라우저의 데이터를 가져오겠냐고 물으면, 가져올 브라우저를 고르고 확인합니다. 로그인 상태·북마크·비밀번호·확장 프로그램이 함께 넘어와 나와 에이전트가 그대로 씁니다. 이 데이터는 내 컴퓨터에 남고 내가 관리합니다.
- 키체인 암호 입력하기가져오는 동안 macOS가 키체인 암호를 물을 수 있고, 같은 창이 여러 번 뜰 수 있습니다. 뜰 때마다 입력합니다. 이 암호가 있어야 로그인 상태·쿠키·확장 프로그램·Chrome 프로필을 옮겨 올 수 있습니다.
- 끝까지 진행하기남은 안내를 따라 첫 실행 설정을 마칩니다.
확인: 첫 실행 설정이 끝까지 진행되었습니다. 데이터를 가져왔다면 평소 쓰던 사이트 하나를 ego(lite)에서 열어 로그인된 채인지 봅니다. 가져오기의 자세한 내용은 가이드 1장 데이터 가져오기를 보세요.
3단계 · 에이전트를 완전히 종료했다 다시 열기
첫 실행 설정을 하는 동안 에이전트가 이미 켜져 있었다면, 방금 설치된 스킬이 에이전트의 스킬 목록에 아직 나타나지 않을 수 있습니다. 종료했다 다시 열어야 스킬 목록이 새로 고쳐집니다.
- 에이전트 종료하기Claude 또는 Codex를 완전히 종료(quit)합니다.
- 다시 열기같은 에이전트를 다시 엽니다.
Codex 문서는 처음부터 ego(lite) 설치와 첫 실행 설정을 마친 뒤에 Codex를 열라고 안내합니다.
확인: 에이전트가 새로 열려 대화를 시작할 수 있습니다.
4단계 · 에이전트 권한 넓히기
ego-browser 명령은 내 컴퓨터에 설치된 ego(lite) 앱을 열어야 합니다. 이것은 샌드박스(격리된 실행 칸) 밖의 앱을 실행하는 일이라, 권한이 좁은 상태에서는 샌드박스에 막히거나 승인 요청에서 멈출 수 있습니다. 그래서 에이전트 쪽 권한 설정을 넓혀 줍니다. 이름은 에이전트마다 다릅니다.
- Cowork가 아니라 Code로 바꾸기Claude 데스크톱 앱의 왼쪽 위 모드 전환기에서 Cowork를 Code로 바꾸고, 프로젝트나 폴더를 하나 엽니다. ego-browser 스킬은 Claude Code용이라 Cowork의 스킬 메뉴에는 나타나지 않습니다.
- Bypass permissions 고르기Code 대화의 입력 칸 옆 권한 선택기를 열어 Bypass permissions(승인 건너뛰기)를 고릅니다. 켜면 Claude Code가 단계마다 확인을 기다리지 않고 내 컴퓨터에서 명령을 실행해 ego(lite)를 열고 브라우저 작업을 합니다.
터미널에서 Claude Code를 쓰는 경우
터미널 화면(TUI(터미널 안에서 글자로 쓰는 화면))에서는 아래 명령으로 시작합니다. 열리면 상태 줄에 bypass permissions on이 보입니다.
claude --dangerously-skip-permissions- Codex 모드인지 보기ChatGPT 데스크톱 앱(예전 Codex 데스크톱 앱)을 쓴다면 왼쪽 위에서 모드를 Codex로 바꿉니다. 그다음 프로젝트를 열고 새 작업을 시작합니다.
- Full access 고르기입력 칸 왼쪽 아래의 권한 선택기를 열어 Full access(전체 권한)를 고르고, 이어서 뜨는 경고를 확인합니다. 이 설정이 없으면 ego(lite) 실행이 샌드박스에 막히거나 승인 요청에서 멈출 수 있습니다.
터미널에서 Codex를 쓰는 경우
프로젝트 폴더에서 터미널을 열고 아래 명령으로 새로 시작합니다. 승인 요청과 샌드박스를 건너뛴 상태로 Codex가 열립니다. Codex 모드 전환 단계는 건너뜁니다.
codex --dangerously-bypass-approvals-and-sandboxCursor, OpenCode, WorkBuddy, Hermes Agent, OpenClaw, DeepSeek Harness도 같은 원리이고 설정 이름만 다릅니다. 가이드 5장의 에이전트별 표에서 내 에이전트의 설정 이름을 찾으세요. 어느 에이전트든 공통인 부분은 5장 첫머리에 있습니다.
이 설정을 켜면 에이전트는 단계마다 묻지 않고 내 컴퓨터에서 명령을 실행합니다. Codex는 Full access를 고를 때 경고를 보여 주고 확인을 받습니다. 그러니 믿는 에이전트에게, 내용을 아는 작업을 맡길 때만 켜고, 해도 되는 일과 하면 안 되는 일은 프롬프트(에이전트에게 보내는 요청 글)에 적어 줍니다. 권한 방식 자체는 각 에이전트를 만든 회사의 안내를 함께 확인하세요. 더 자세한 설명은 가이드 1장 권한에 있습니다.
확인: 입력 칸 옆 권한 표시가 Bypass permissions(Claude Code) 또는 Full access(Codex)로 보입니다. 터미널에서 쓴다면 Claude Code는 상태 줄의 bypass permissions on으로 확인하고, Codex는 위 명령으로 새로 시작했는지로 확인합니다.
5단계 · /ego-browser 가 보이는지 확인하기
이제 스킬이 실제로 잡히는지 봅니다. 작업 문장은 아직 보내지 않습니다.
- 입력 칸에
/ego-browser입력하기Claude Code에서는/ego-browser를 입력하고 목록에서 그 스킬을 고릅니다. Codex에서는/ego까지만 입력해 스킬 선택 목록에서 ego-browser를 고르거나,/ego-browser를 입력하고 Tab을 누릅니다. - 목록 확인하기ego-browser가 목록에 나타나는지 봅니다.
/ego-browser▌
스킬 목록 ▸ ego-browser
확인: ego-browser 스킬이 목록에 보이고 선택됩니다. 여기까지 되면 준비가 끝났습니다. 보내지 않고 입력 칸을 비워 두어도 됩니다 — 스킬은 실습 1에서 다시 부릅니다. 연결의 전체 설명은 가이드 1장 에이전트 연결에 있습니다.
준비 점검표
| ☐ | 확인할 것 | 어디서 했나 |
|---|---|---|
| ☐ | ego(lite)를 설치했고 첫 실행 설정을 끝까지 마쳤다 | 1·2단계 |
| ☐ | (선택) 쓰던 브라우저의 데이터를 가져왔고, 키체인 암호 창에 매번 입력했다 | 2단계 |
| ☐ | 에이전트를 완전히 종료했다가 다시 열었다 | 3단계 |
| ☐ | 권한 표시가 Bypass permissions 또는 Full access다 | 4단계 |
| ☐ | /ego-browser를 치면 ego-browser 스킬이 보인다 | 5단계 |
막히면
| 증상 | 해 볼 것과 확인 기준 |
|---|---|
Claude에서 /ego-browser가 안 보임 | 지금 화면이 Cowork가 아니라 Code인지 봅니다. Cowork에 안 보인다고 설치가 실패한 것은 아닙니다. Code인데도 없으면 Claude를 종료했다 다시 열고 /ego를 다시 입력합니다. |
| Codex에서 ego-browser가 안 보임 | ego(lite) 첫 실행 설정을 마쳤는지 확인하고, Codex를 종료했다 다시 연 뒤 /ego를 입력해 ego-browser를 고릅니다. 설치된 스킬은 ~/.agents/skills/에 있어야 합니다. |
| 권한 선택기에 Bypass permissions가 없음 | Claude의 Settings > Claude Code(설정 > Claude Code)에서 Allow bypass permissions mode(승인 건너뛰기 모드 허용)를 켭니다. Team·Enterprise 정책이 이 항목을 숨길 수 있으니, 잠겨 있으면 관리자에게 문의합니다. |
| 키체인 암호 창이 계속 뜸 | 가져오기 중에는 여러 번 뜨는 것이 정상입니다. 뜰 때마다 입력합니다. |
| (실습 1에서 작업을 보냈을 때) 스킬은 보이는데 ego(lite)가 열리지 않음 | 권한 표시부터 다시 봅니다. 터미널에서 쓰는 중이면 지금 열어 둔 에이전트 화면(세션)을 닫고 4단계의 명령으로 새로 시작합니다. 그래도 안 되면 실습 9 — 연결 문제 해결과 가이드 5장 문제 해결로 갑니다. |
다음에 할 것
준비가 끝났으면 실습 1 — 블로그 두 곳을 읽고 요약 받기로 첫 작업을 맡겨 봅니다. 이어서 실습 2에서 에이전트가 일하는 모습을 들여다보고, 실습 3에서 결과를 원문과 대조하는 법을 익힙니다.
- ego(lite)를 설치하고 처음 열면 스킬 설치와 데이터 가져오기(선택)가 함께 진행됩니다.
- 키체인 암호 창은 여러 번 뜰 수 있고, 뜰 때마다 입력합니다.
- 첫 실행 설정 때 켜져 있던 에이전트는 종료했다 다시 열어야 스킬이 보입니다.
- Claude Code는 Code 모드에서 Bypass permissions, Codex는 Full access를 고릅니다. 믿는 에이전트와 아는 작업에만 켭니다.
/ego-browser를 쳐서 스킬이 보이면 준비 끝입니다.
출처: lite.ego.app/document/en/docs/quick-start · claude-code · codex (수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준). 가이드 1장 설치·1장 에이전트 연결·5장 에이전트별 표.
첫 작업 — 블로그 두 곳을 읽고 요약 받기
준비를 마쳤다면 첫 일을 맡겨 봅니다. 원문 빠른 시작에 실린 프롬프트(에이전트에게 보내는 요청 글) 한 줄을 그대로 보내면, AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)가 ego(lite) 안에 새 Space(스페이스 — 에이전트 전용 작업 공간)를 만들어 OpenAI와 Anthropic의 블로그를 읽고, 요점을 대화창으로 돌려줍니다.
- 스킬을 불러오고 프롬프트를 보내는 기본 순서를 손에 익힙니다.
- 에이전트가 일하는 동안 ego(lite) 안에서 무슨 일이 일어나는지 압니다.
- 돌아온 답이 부탁한 내용을 채웠는지 스스로 확인합니다.
예상 소요 시간: 5분 안팎
준비물과 완료 기준
- 시작 전 준비를 마친 상태 — ego(lite) 설치와 첫 실행 설정이 끝났고, 에이전트 권한이 Full access(Codex) 또는 Bypass permissions(Claude Code)입니다.
- 에이전트의 새 대화 하나. 원문 빠른 시작은 Codex를 예로 듭니다. 에이전트마다 다른 점은 가이드 5장에서 다룹니다.
- ego(lite)를 미리 열어 둘 필요는 없습니다. ego-browser 스킬(Skill — 에이전트에게 주는 사용 설명서 묶음)이 ego(lite)를 열고 Space를 만듭니다.
에이전트 대화창에 OpenAI와 Anthropic 두 회사의 최신 글 요점이 정리되어 돌아오면 완료입니다.
따라 하기
1단계 · 스킬을 불러오고 권한 확인하기
- 새 대화 열기에이전트에서 새 대화(Codex 데스크톱이라면 프로젝트를 열고 새 작업, Claude라면 Code 모드의 대화)를 엽니다.
/ego-browser입력하기대화창 입력 칸에/ego-browser를 입력해 스킬을 켭니다. 목록이 뜨면 ego-browser를 고릅니다(에이전트별 고르는 법은 준비 5단계와 같습니다).- 권한 표시 보기입력 칸 옆의 권한 표시가 Full access 또는 Bypass permissions인지 봅니다.
/ego-browser▌
스킬 목록 ▸ ego-browser · 권한 ▸ Full access
확인: ego-browser 스킬이 선택되었고 권한이 넓혀져 있습니다. 둘 중 하나라도 아니면 준비 4단계·5단계로 돌아갑니다.
2단계 · 프롬프트를 붙여 넣고 보내기
아래 한 줄을 대화창에 붙여 넣고 Enter를 누릅니다. 원문 빠른 시작의 프롬프트 그대로입니다.
Use ego-browser. Please open the blog pages of OpenAI and Anthropic, check if there is any noteworthy information, and quickly summarize the main points of the latest articles for me.
뜻: ego-browser를 써 줘. OpenAI와 Anthropic의 블로그 페이지를 열어 눈여겨볼 소식이 있는지 확인하고, 최신 글들의 요점을 빠르게 요약해 줘.
| 문장 조각 | 에이전트에게 알려 주는 것 |
|---|---|
Use ego-browser. | 어떤 도구로 할지 — ego(lite)를 조종하는 ego-browser |
open the blog pages of OpenAI and Anthropic | 대상 — 두 회사의 블로그 페이지 |
check if there is any noteworthy information | 읽을 것 — 눈여겨볼 소식 |
quickly summarize the main points of the latest articles | 결과 형태 — 최신 글 요점의 짧은 요약 |
터미널 화면(TUI)에서 보내는 경우
Claude Code의 TUI(터미널 안에서 글자로 쓰는 화면)에서는 /ego-browser 뒤에 한 칸을 띄우고 같은 메시지 안에 작업 문장을 이어 적어 보냅니다. Codex의 TUI에서는 /ego를 입력해 ego-browser를 고른 뒤 작업 문장을 덧붙입니다.
확인: 메시지가 전송되고 에이전트가 일을 시작합니다.
3단계 · 에이전트가 일하는 동안 기다리기
이제 에이전트 차례입니다. 에이전트는 ego(lite)에 새 Space를 만들고, 거기서 OpenAI와 Anthropic의 블로그 페이지를 열어 최신 글을 읽은 뒤, 두 회사의 최근 소식과 요점을 정리합니다. 이 일은 모두 에이전트 Space 안에서 일어나므로 엉뚱한 창이 튀어나오거나 내가 쓰던 탭을 빼앗기지 않습니다. 기다리는 동안 내 탭에서 하던 일을 계속해도 됩니다.
무엇을 하고 있는지 궁금하면 ego(lite) 오른쪽 위의 Space 단추를 눌러 들여다볼 수 있습니다. 방법은 실습 2에서 따라 합니다.
확인: 대화창에서 에이전트가 작업을 이어 가고, ego(lite)에서 내가 보던 탭은 바뀌지 않았습니다. 에이전트 Space가 생긴 것은 오른쪽 위 Space 단추로 볼 수 있지만, 지금은 건너뛰어도 됩니다.
4단계 · 요약을 받고 확인하기
작업이 끝나면 에이전트가 요약을 대화창으로 돌려줍니다. 받은 답을 아래 세 가지로 읽어 봅니다.
- 두 회사가 모두 있는가OpenAI 쪽과 Anthropic 쪽 내용이 각각 들어 있는지 봅니다.
- 최신 글의 요점인가부탁한 것은 최신 글들의 요점입니다. 글 제목이나 주제가 함께 적혀 있으면 나중에 원문과 대조하기 쉽습니다.
- 읽지 못한 곳을 밝혔는가열지 못한 페이지가 있었다면 빈틈을 지어내 채우지 말고 무엇이 빠졌는지 말하게 합니다.
확인: 대화창에 OpenAI와 Anthropic 두 회사의 최신 글 요점이 있습니다. 첫 작업을 마쳤습니다.
막히면
| 증상 | 해 볼 것과 확인 기준 |
|---|---|
/ego-browser가 목록에 없음 | ego(lite) 첫 실행 설정을 마쳤는지 보고, 에이전트를 종료했다 다시 엽니다. Claude라면 Cowork가 아니라 Code인지 확인합니다. → 준비의 막히면 |
| 스킬은 불러왔는데 ego(lite)가 열리지 않음 | 권한 표시를 확인합니다. ego-browser는 내 컴퓨터의 ego(lite) 앱을 열어야 하므로 샌드박스(격리된 실행 칸) 밖의 앱을 실행할 권한이 필요합니다. Full access 또는 Bypass permissions로 바꾼 뒤 다시 보냅니다. |
| 에이전트가 단계마다 승인을 물으며 멈춤 | 권한이 넓혀지지 않은 상태입니다. 준비 4단계를 다시 합니다. |
| 요약에 한 회사만 있음 | 빠진 쪽 블로그를 왜 읽지 못했는지, 무엇이 빠졌는지 말해 달라고 합니다. 에이전트 Space에 남은 탭을 열어 실제로 어떤 페이지가 열렸는지도 봅니다(실습 2). |
| 사이트가 로그인이나 확인을 요구함 | 에이전트 Space에 들어가 내가 직접 처리하고 이어 하라고 말합니다(실습 2의 넘겨받기 — 사람만 할 수 있는 단계를 내가 직접 처리하는 것). 비밀번호나 인증 코드는 프롬프트에 붙여 넣지 않습니다. |
원문은 로그인이 필요 없는 공개 자료만 찾거나 요약할 때는 일반 웹 검색이 더 가벼운 도구라고 말합니다. Space가 제값을 하는 것은 진짜 브라우저·진짜 로그인·파일 주고받기가 필요한 일입니다. 여기서는 “스킬 → 프롬프트 → 결과”의 기본 순서를 몸에 익히는 것이 목적입니다.
다음에 할 것
- 같은 작업을 한 번 더 돌리면서 실습 2 — 에이전트 Space 들여다보고, 넘겨받고, 돌려주기를 따라 합니다.
- 표로 결과를 받고 원문과 대조하는 연습은 실습 3에 있습니다.
- 이 순서의 배경 설명은 가이드 1장 첫 작업, 에이전트에게 일을 잘 맡기는 글쓰기는 가이드 3장에서 볼 수 있습니다.
- 순서는
/ego-browser로 스킬 부르기 → 프롬프트 보내기 → 기다리기 → 요약 확인입니다. - 에이전트는 새 Space를 만들어 그 안에서 블로그를 읽으므로 내 탭은 그대로입니다.
- 완료 기준은 두 회사의 최신 글 요점이 대화창에 돌아오는 것입니다.
- 빠진 것이 있으면 지어내지 말고 무엇이 빠졌는지 말하게 합니다.
출처: lite.ego.app/document/en/docs/quick-start · space · claude-code · codex · snapshot(검증할 수 있는 결과) · windows/quick-start(빠진 내용을 말하게 하라는 안내) (수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준). 가이드 1장 첫 작업·2장 Space.
에이전트 Space 들여다보고, 넘겨받고, 돌려주기
AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)가 일하는 동안 그 Space(스페이스 — 에이전트 전용 작업 공간)를 직접 들여다봅니다. 로그인이나 인증처럼 사람만 할 수 있는 단계가 나오면 내가 넘겨받아(에이전트가 못 하는 단계를 내가 직접 처리하는 것) 끝내고, 다시 에이전트에게 돌려줍니다.
- 오른쪽 위 Space 단추로 Space 관리 패널을 열고, 에이전트가 일하는 Space를 찾습니다.
- 에이전트 Space를 보고 와도 내 탭이 그대로라는 것을 눈으로 확인합니다.
- 로그인·인증 화면이 나오면 직접 처리하고, 에이전트에게 이어 하라고 말합니다.
- 작업이 끝난 뒤 남은 탭으로 에이전트가 본 페이지를 확인합니다.
예상 소요 시간: 10분 안팎
준비물을 확인한 뒤 따라 하기를 진행하세요. 파란 빛이 안 보이거나 에이전트가 이어 하지 않으면 막히면을 봅니다. 5단계(넘겨받기)는 그런 화면이 실제로 나왔을 때만 합니다.
준비물과 완료 기준
- 실습 1을 마친 상태 — ego-browser 스킬(Skill — 에이전트에게 주는 사용 설명서 묶음)을 불러오고 프롬프트(에이전트에게 보내는 요청 글)를 보낼 수 있습니다.
- ego(lite)에서 내가 보던 탭 하나. 읽던 기사나 쓰던 글이면 됩니다. 돌아왔을 때 그대로인지 보기 위해서입니다.
- 돌릴 작업 하나. 여기서는 실습 1의 프롬프트를 다시 씁니다.
작업이 도는 동안 파란 빛이 나는 Space에 들어가 에이전트가 연 페이지를 보고, 내 탭으로 돌아와 그대로인지 확인하고, 작업이 끝난 뒤에도 그 Space에 탭이 남아 있는 것을 보면 완료입니다. 이번 작업에서 로그인·인증 화면이 나오지 않으면 5단계는 읽어만 둡니다.
따라 하기
1단계 · 작업 하나 시작하기
먼저 ego(lite)에서 내가 볼 탭 하나를 열어 둡니다. 그다음 에이전트 대화창에서 /ego-browser로 스킬을 부르고, 실습 1의 프롬프트를 다시 보냅니다(원문 빠른 시작의 문장 그대로).
Use ego-browser. Please open the blog pages of OpenAI and Anthropic, check if there is any noteworthy information, and quickly summarize the main points of the latest articles for me.
뜻: ego-browser를 써 줘. OpenAI와 Anthropic의 블로그 페이지를 열어 눈여겨볼 소식이 있는지 확인하고, 최신 글들의 요점을 빠르게 요약해 줘.
확인: 에이전트가 일을 시작했습니다. 끝나기 전에 바로 2단계로 넘어갑니다.
2단계 · 오른쪽 위 Space 단추로 Space 관리 패널 열기
작업이 도는 동안 ego(lite) 창의 오른쪽 위 Space 단추를 누릅니다. Space management panel(Space 관리 패널)이 열립니다. 이 가운데 파란 빛이 나는 것이 지금 에이전트가 일하고 있는 Space입니다.
확인: 패널이 열렸고, 파란 빛이 나는 Space가 하나 보입니다.
3단계 · 파란 빛 Space로 들어가 보기
파란 빛이 나는 Space를 눌러 들어갑니다. 에이전트가 연 페이지들이 보입니다. Space는 화면 없이 숨어서 도는 브라우저가 아니라, 내 컴퓨터의 ego(lite) 안에서 눈으로 볼 수 있는 작업 공간입니다. 이번에는 구경만 합니다 — 에이전트가 어떤 페이지를 열어 두었는지 살펴봅니다.
확인: 에이전트 Space 안에 OpenAI나 Anthropic의 블로그 페이지가 열려 있습니다.
4단계 · 내 탭으로 돌아오기
이제 내가 쓰던 쪽으로 돌아옵니다. 원문은 들어가는 길(Space 단추 → Space 관리 패널 → 파란 빛 Space)을 안내하므로, 돌아올 때도 같은 Space 단추에서 내가 쓰던 쪽을 고릅니다. 화면에 보이는 모양이 다르면 화면을 따르세요.
돌아와서 볼 것은 하나입니다. 1단계에서 열어 둔 내 탭이 두고 간 그대로인지입니다. 에이전트는 자기 Space 안에서만 일하므로 내가 보던 페이지·마우스·초점을 가져가지 않습니다. 그래서 에이전트가 일하는 동안 나는 기사를 읽거나 글을 쓰던 일을 계속할 수 있고, 궁금할 때만 Space에 들렀다 오면 됩니다.
확인: 내 탭이 그대로이고, 에이전트의 작업은 멈추지 않고 계속됩니다. 배경 설명은 가이드 2장 함께 일하는 흐름에 있습니다.
5단계 · 필요할 때 넘겨받고 돌려주기
사이트가 로그인이나 인증을 요구하면 에이전트는 멈추고 나를 부릅니다. 이때는 2·3단계와 같은 길로 에이전트 Space에 들어가, 그 페이지에서 내가 직접 로그인하거나 인증을 끝냅니다. 그런 다음 대화창으로 돌아와 이어 하라고 말합니다.
I finished the login in the agent Space. Please continue the task in the same Space.
뜻: 에이전트 Space에서 로그인을 마쳤어. 같은 Space에서 작업을 이어서 해 줘. — 예시입니다. 원문에는 “직접 끝낸 뒤 에이전트에게 같은 Space에서 계속하라고 말한다”는 안내만 있고 정해진 문장은 없습니다.
로그인과 인증은 반드시 에이전트 Space의 그 페이지에서 내 손으로 합니다. 대화창에 적어 보내지 않습니다.
| 에이전트가 멈추고 나를 불러야 하는 상황 (원문 Space 문서) |
|---|
| 문자·이메일 인증 코드, QR 코드 로그인, 하드웨어 보안 키, CAPTCHA(사람인지 확인하는 검사) |
| 결제·주문·송금·환불 |
| 게시·삭제·보관, 그 밖에 되돌리기 어려운 일괄 수정 |
| 다른 앱에 내 계정 접근 권한을 주는 일 |
확인: 내가 처리한 뒤 에이전트가 같은 Space에서 작업을 이어 갑니다. 자세한 설명은 가이드 2장 로그인과 멈춰야 하는 순간에 있습니다.
6단계 · 끝난 뒤 남은 탭 확인하기
에이전트가 요약을 돌려주면 다시 Space 단추로 그 Space에 들어가 봅니다. 작업이 끝나도 Space의 탭은 바로 닫히지 않고 남습니다. 에이전트가 어떤 페이지를 방문했고 무엇을 했는지 내가 확인할 수 있게 하기 위해서입니다. 다만 명령 없이 30분이 지나면 에이전트 작업 Space는 자동으로 닫히므로, 이 단계는 작업이 끝난 직후에 합니다(가이드 2장 작업이 끝난 뒤).
- 남은 탭 보기블로그 페이지 탭이 그대로 열려 있는지 봅니다.
- 답과 맞춰 보기대화창의 요약에 나온 글 하나를 골라, 남은 탭의 페이지에 실제로 있는 글인지 봅니다.
확인: 작업이 끝난 뒤에도 에이전트 Space에 탭이 남아 있고, 요약의 내용을 그 페이지에서 찾을 수 있습니다.
막히면
| 증상 | 해 볼 것과 확인 기준 |
|---|---|
| 파란 빛이 나는 Space가 없음 | 파란 빛은 에이전트가 지금 일하고 있는 Space의 표시입니다. 대화창에서 작업이 아직 도는 중인지 먼저 봅니다. 작업을 새로 보내고 도는 동안 다시 Space 단추를 누릅니다. |
| 에이전트가 로그인 화면에서 멈춰 있음 | 5단계대로 에이전트 Space에 들어가 직접 로그인·인증을 끝낸 뒤 이어 하라고 말합니다. |
| 내가 처리했는데 에이전트가 이어 하지 않음 | 대화창에 “끝냈으니 같은 Space에서 계속하라”고 분명히 말합니다. 원문의 안내도 처리를 끝낸 뒤 에이전트에게 계속하라고 말하는 것입니다. |
| 이어 하던 에이전트가 번호가 맞지 않는다고 함 | 내가 로그인하면서 페이지가 바뀌어, 에이전트가 전에 읽어 둔 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전)의 번호표(@N)가 더는 맞지 않는 것입니다. 스냅샷을 새로 찍으라고 말합니다. → 실습 10 |
| 작업이 끝나고 한참 뒤에 들어가 보니 그 Space가 없음 | 끝난 직후에는 탭이 남아 있지만, 명령 없이 30분이 지나면 에이전트 작업 Space는 자동으로 닫힙니다. 작업을 다시 보내고 끝난 직후에 6단계를 합니다. → 가이드 2장 작업이 끝난 뒤 |
| 비밀번호를 대화창에 적어야 할 것 같음 | 적지 않습니다. 에이전트 Space의 로그인 페이지에서 직접 입력합니다. |
다음에 할 것
- 멈출 곳은 미리 정해 줄 수도 있습니다. 원문이 드는 예는
read-only, don't modify(읽기만, 수정 금지)와stop and confirm before submitting(제출 전에 멈추고 확인받기)입니다. 프롬프트에 이런 문장을 넣는 연습은 실습 4·실습 6에서 합니다. - 남은 탭으로 결과를 꼼꼼히 대조하는 방법은 실습 3에서 이어집니다.
- Space가 무엇이고 왜 내 탭을 방해하지 않는지는 가이드 2장, 작업 뒤 남는 것은 2장 작업이 끝난 뒤에서 설명합니다.
- 오른쪽 위 Space 단추 → Space 관리 패널 → 파란 빛이 나는 Space가 에이전트의 작업 공간입니다.
- 에이전트는 자기 Space에서만 일하므로 내 탭·마우스·초점은 그대로입니다.
- 로그인·인증은 에이전트 Space에서 내가 직접 하고, 끝나면 이어 하라고 말합니다.
- 비밀번호와 인증 코드는 프롬프트에 붙여 넣지 않습니다.
- 작업이 끝나도 탭은 바로 닫히지 않고 남아 있어 에이전트가 본 페이지를 확인할 수 있습니다.
출처: lite.ego.app/document/en/docs/quick-start(Watch and take over) · space · claude-code · codex(넘겨받은 뒤 이어 하라고 말하기, 비밀번호 경고) · snapshot(번호표가 맞지 않을 때) (수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준). 가이드 2장 함께 일하는 흐름·2장 로그인. “이어 하라”는 문장은 연습용 예시입니다.
읽기만 하는 조사 — 인기 글을 표로 받고 원문과 대조
아무것도 고치지 않고 읽기만 하는 조사를 맡깁니다. AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)가 Reddit에서 인기 글 하나를 찾아 표로 정리해 오면, 표의 칸을 원문 페이지와 하나씩 맞춰 봅니다. 화면에 없는 숫자를 지어내지 않고 not shown(표시 안 됨)으로 적었는지가 핵심입니다.
- 읽을 것·하지 말 것·결과 형태를 담은 프롬프트(에이전트에게 보내는 요청 글)를 보냅니다.
- 표의 각 칸을 원문 페이지와 대조합니다.
- 지어낸 숫자와
not shown을 구별하고, 빠진 것을 에이전트가 말하게 합니다. - 결과를 믿어도 되는지 다섯 가지 신호로 점검합니다.
예상 소요 시간: 10~15분
준비물과 완료 기준
- 실습 1을 마친 상태. 실습 2까지 했다면 Space(스페이스 — 에이전트 전용 작업 공간)에 들어가는 법도 알고 있습니다.
- 에이전트의 새 대화 하나와 ego-browser 스킬(Skill — 에이전트에게 주는 사용 설명서 묶음).
- 이번 프롬프트는 Windows용 빠른 시작 문서에 실린 것입니다. 문장 자체에는 운영체제에 따라 달라지는 내용이 없어 그대로 씁니다.
제목·서브레딧(Reddit 안의 주제별 게시판)·링크·게시 날짜·추천 수·댓글 수·조회 수가 든 표를 받고, 링크를 열어 표와 글을 대조했으며, 화면에 보이지 않는 숫자가 not shown으로 적혀 있으면 완료입니다.
따라 하기
1단계 · 조사 프롬프트 보내기
새 대화에서 /ego-browser로 스킬을 부른 뒤, 아래 문장을 붙여 넣고 보냅니다. 원문에 실린 문장 그대로입니다.
Use ego-browser. Open Reddit and find a popular post from the past week. Open the post and return its title, subreddit, link, posting date, upvote count, comment count, and view count if Reddit shows one. Present the results in a small table. If a figure is not visible, mark it as "not shown" rather than guessing. Do not vote or comment.
뜻: ego-browser를 써 줘. Reddit을 열어 지난 한 주의 인기 글 하나를 찾아 줘. 그 글을 열고 제목, 서브레딧(Reddit 안의 주제별 게시판), 링크, 게시 날짜, 추천 수, 댓글 수, 그리고 Reddit이 보여 준다면 조회 수를 알려 줘. 결과는 작은 표로 정리해 줘. 숫자가 보이지 않으면 추측하지 말고 “not shown”이라고 적어 줘. 투표하거나 댓글을 달지 마.
이 문장이 좋은 본보기인 이유는, 원문 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전) 문서가 “좋은 작업 설명에 들어갈 것”으로 꼽는 항목이 거의 다 들어 있기 때문입니다.
확인: 메시지가 전송되고 에이전트가 일을 시작합니다. 에이전트는 ego(lite)에 Space를 만들어 Reddit을 열고 글 하나를 읽습니다.
2단계 · 표 받기
에이전트가 출처 링크가 달린 표를 돌려줍니다. 모양은 대략 아래와 같습니다(값은 자리 표시입니다 — 실제 글에 따라 달라집니다).
| 칸 | 들어 있어야 할 것 |
|---|---|
| Title (제목) | 글 제목 그대로 |
| Subreddit (서브레딧) | 글이 올라온 게시판 이름 |
| Link (링크) | 그 글로 바로 가는 주소 |
| Posting date (게시 날짜) | 글이 올라온 날짜 |
| Upvote count (추천 수) | 페이지에 보이는 숫자 |
| Comment count (댓글 수) | 페이지에 보이는 숫자 |
| View count (조회 수) | 보이면 숫자, 안 보이면 not shown |
확인: 일곱 칸이 모두 있고 링크가 들어 있습니다. 칸이 빠졌으면 빠진 칸을 채워 달라고, 그 값이 페이지에 없으면 없다고 말해 달라고 합니다.
3단계 · 링크를 열어 표와 원문 대조하기
원문은 작업이 끝나면 링크를 열어 표와 글을 비교하라고 안내합니다. 표의 링크를 눌러 열어도 되고, 에이전트 Space에 남아 있는 탭을 봐도 됩니다(들어가는 법은 실습 2). 작업이 끝나도 탭은 바로 닫히지 않고 남으므로, 끝난 직후라면 에이전트가 실제로 본 페이지를 그대로 볼 수 있습니다.
not shown이어야 맞습니다.확인: 제목·서브레딧·날짜·숫자가 페이지에 보이는 것과 같습니다. 페이지와 어긋나는 칸이 있으면 4단계까지 본 뒤 5단계에서 다시 읽게 합니다.
4단계 · 안 보이는 숫자가 not shown 인지 보기
프롬프트에 “보이지 않으면 추측하지 말고 not shown이라고 적어라”를 넣은 이유를 확인하는 단계입니다. 원문의 시연 녹화에서는 Reddit이 조회 수를 보여 주지 않았고, 에이전트(Codex)는 그 칸을 not shown으로 적었습니다.
- 표에서 not shown 찾기어느 칸이 not shown인지 봅니다.
- 페이지에서 그 값 찾아보기정말 화면에 없는지 봅니다. 없으면 에이전트가 제대로 한 것입니다.
- 반대 방향도 보기표에는 숫자가 있는데 페이지에서 찾을 수 없는 칸이 있는지 봅니다. 있다면 지어낸 값일 수 있습니다.
확인: not shown인 칸은 페이지에도 없고, 숫자가 적힌 칸은 모두 페이지에서 찾을 수 있습니다.
5단계 · 빠진 것이 있으면 무엇이 빠졌는지 말하게 하기
에이전트가 어떤 페이지에 닿지 못했거나 숫자를 읽지 못했다면, 원문의 안내는 빈틈을 채워 넣게 하지 말고 무엇이 빠졌는지 말하게 하라는 것입니다. 아래는 그 안내를 따라 만든 예시 문장입니다(원문에 정해진 문장은 없습니다).
If you could not reach a page or read a figure, tell me exactly what is missing instead of filling in the gap.
뜻: 닿지 못한 페이지나 읽지 못한 숫자가 있으면, 빈틈을 채우지 말고 무엇이 빠졌는지 정확히 말해 줘.
표와 페이지가 어긋나 보일 때는 이전 답에서 계속 추론하게 두지 말고, 지금 페이지의 스냅샷을 다시 찍게 합니다. 이것도 예시입니다.
Take a fresh snapshot of the current page and check the table against it again.
뜻: 지금 페이지의 스냅샷을 새로 찍고, 표를 그것과 다시 대조해 줘.
확인: 에이전트가 빠진 것을 구체적으로 밝혔거나, 다시 읽은 뒤 표를 고쳤습니다.
결과 점검표 — 다섯 가지 신호
원문 스냅샷 문서는 작업이 끝났을 때 볼 신호를 다섯 가지로 듭니다. 이번 작업에 맞춰 보면 이렇습니다.
| ☐ | 신호 | 이번 실습에서 볼 것 |
|---|---|---|
| ☐ | 방문한 페이지와 핵심 동작을 밝혔는가 | Reddit의 어느 글을 열었는지 답에 적혀 있습니다. |
| ☐ | 내가 검증할 수 있는 것(제목·ID·주소·금액·시각)이 들어 있는가 | 제목·링크·게시 날짜가 있어 직접 열어 볼 수 있습니다. |
| ☐ | 내려받기였다면 파일이 저장된 경로를 알려 줬는가 | 이번에는 해당 없음 — 실습 5에서 봅니다. |
| ☐ | 고치거나 제출하는 일이었다면 마지막 단계 전에 멈췄는가 | 이번에는 읽기만 했습니다. 투표·댓글을 하지 않았는지 봅니다 — 멈추기 연습은 실습 6. |
| ☐ | 관련 페이지가 Space에 아직 열려 있는가 | 에이전트 Space에 그 Reddit 글 탭이 남아 있습니다. |
막히면
| 증상 | 해 볼 것과 확인 기준 |
|---|---|
| 표의 숫자를 페이지에서 찾을 수 없음 | 5단계의 두 번째 문장처럼 스냅샷을 다시 찍어 대조하게 합니다. 이전 답을 바탕으로 계속 추론하게 두지 않습니다. |
| 조회 수가 not shown으로 나옴 | 정상일 수 있습니다. 페이지에 조회 수가 실제로 없는지만 확인합니다. |
| 표에 링크가 없음 | 글로 바로 가는 링크를 달라고 합니다. 링크가 있어야 대조할 수 있습니다. |
| 에이전트가 페이지 일부를 읽지 못했다고 함 | 스냅샷이 모든 것을 읽지는 못합니다. 화면 밖 내용, 이미지 속 글자, 복잡한 캔버스, 샌드박스된 교차 출처 iframe(페이지 안에 끼워 넣은 다른 사이트의 페이지)은 다 보이지 않을 수 있습니다. 읽지 못한 부분을 밝히게 하고 내가 직접 봅니다. → 가이드 3장 한계 |
| Reddit이 로그인이나 확인을 요구함 | 에이전트 Space에서 내가 직접 처리하고 이어 하라고 말합니다(실습 2의 넘겨받기 — 사람만 할 수 있는 단계를 내가 직접 처리하는 것). 비밀번호나 인증 코드는 프롬프트에 붙여 넣지 않습니다. |
다음에 할 것
- 로그인된 사이트에서 같은 방식으로 목록을 뽑는 연습은 실습 4입니다. “하지 말 것”을 더 분명히 적습니다.
- 일 맡기는 글에 들어갈 다섯 가지는 가이드 3장 작업 설명 쓰기, 결과 확인은 3장 결과 확인에서 자세히 설명합니다.
- 프롬프트에 대상·읽을 것·하지 말 것·결과 형태를 적고, “모르면 not shown”을 넣습니다.
- 표를 받으면 링크를 열어 한 줄씩 원문과 대조합니다. Space에 남은 탭으로도 볼 수 있습니다.
- 화면에 없는 값이 not shown이면 제대로 된 것이고, 페이지에 없는 숫자가 적혀 있으면 의심합니다.
- 빠진 것은 채워 넣게 하지 말고 무엇이 빠졌는지 말하게 합니다.
- 마지막에 다섯 가지 신호로 점검합니다.
출처: lite.ego.app/document/en/docs/windows/quick-start(Reddit 조사 프롬프트와 결과 확인 안내) · snapshot(Writing a task for the agent · Reviewing what the agent did · Common questions) · space (수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준). 가이드 3장 작업 설명 쓰기·3장 결과 확인. 5단계의 두 문장은 원문 안내를 따라 만든 예시입니다.
로그인된 사이트에서 목록 뽑기 — 하지 말 것 정해 주기
내가 ego(lite)에 로그인해 둔 사이트의 알림 목록을 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)에게 읽어 오게 합니다. 이번에는 “읽기만 하고 아무것도 바꾸지 말라”는 경계를 문장으로 못박는 연습입니다.
- ego(lite)에 로그인해 둔 사이트가 에이전트 Space(스페이스 — 에이전트 전용 작업 공간)에서도 로그인된 화면으로 열리는 것을 확인합니다.
- 작업 문장에 “하지 말 것”을 적어 읽기만 시킵니다.
- 돌아온 목록의 제목과 URL(웹 주소)을 내 눈으로 대조합니다.
예상 소요 시간: 10~15분
준비물과 완료 기준
- 시작 전 준비와 실습 1을 마친 상태. 에이전트 대화창에서
/ego-browser스킬(에이전트에게 주는 사용 설명서 묶음)을 부를 수 있어야 합니다. - ego(lite)에서 내가 이미 로그인해 둔 사이트 하나. 원문 예시는 GitHub의 Notifications(알림) 페이지입니다. GitHub를 쓰지 않는다면 알림이나 받은편지함 목록이 있는, 내가 로그인해 둔 다른 사이트로 바꿔도 됩니다.
- 비밀번호와 인증 코드는 필요 없습니다. 에이전트에게 보내는 문장에 절대 붙여 넣지 않습니다.
에이전트가 목록(이름·제목·URL)을 돌려주고, 알림이 읽음 처리되거나 보관되지 않은 것을 확인한 뒤, 그중 두 건 이상을 내가 직접 열어 제목이 같은지 확인하면 완료입니다.
따라 하기
1단계 · 내 탭에서 로그인 상태 확인하기
ego(lite)의 내 탭에서 연습할 사이트의 알림(또는 받은편지함) 페이지를 직접 엽니다. 로그인 화면이 나오면 지금 내가 직접 로그인해 둡니다.
원문은 “ego(lite)에 이미 로그인해 둔 사이트라면, 에이전트는 보통 로그인을 마친 뒤의 화면으로 바로 들어간다”고 설명합니다. 쿠키(로그인했다는 것을 브라우저가 기억해 두는 정보)를 따로 옮겨 줄 필요가 없습니다.
확인: 내 탭에 로그인 화면이 아니라 내 알림 목록이 보입니다. 목록의 맨 위 두세 건 제목과, 읽지 않음으로 표시된 건이 어느 것인지 눈여겨봐 둡니다(5단계에서 바뀐 것이 없는지 볼 때 씁니다).
Space마다 쿠키가 따로라는데 왜 로그인되어 있나요
Space 문서에는 두 문장이 함께 있습니다. “Space는 작업마다 쿠키와 저장소가 따로인 격리된 BrowserContext(브라우저 안의 독립된 칸)다.” 그리고 “ego(lite)에 로그인해 둔 사이트는 보통 로그인된 화면으로 바로 열린다.” 원문은 둘 사이의 내부 동작을 더 설명하지 않으므로, 이 실습에서는 “보통 로그인된 채로 열린다”는 결과만 확인합니다. 완전 가이드 2장 · 로그인.
2단계 · 작업 문장을 다섯 가지로 뜯어 보기
공식 문서의 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전) 쪽은 좋은 작업 설명에 다섯 가지가 들어간다고 말합니다. ① 대상 페이지 ② 읽고·채우고·누르고·내려받을 것 ③ 하면 안 되는 것 ④ 멈출 곳 ⑤ 원하는 결과의 모양입니다. 원문 예시 문장을 여기에 맞춰 보면 이렇습니다.
PR(Pull Request — 코드 변경을 검토해 달라는 요청)이 낯설어도 괜찮습니다. “내가 처리해야 할 알림의 목록”이라고 읽으면 됩니다.
확인: 내 사이트에서 ①~⑤에 해당하는 말을 각각 한 줄로 말할 수 있습니다. 특히 ③ “바뀌면 곤란한 것”을 두 가지 이상 떠올렸습니다.
3단계 · 문장을 보내기
에이전트 대화창에서 /ego-browser로 스킬을 부른 뒤, 아래에서 내 상황에 맞는 문장을 붙여 넣고 Enter를 누릅니다.
Use ego-browser. Open my GitHub Notifications and list the PRs that need my review — repo name, title, URL.
Don't archive, don't mark anything as read.뜻: ego-browser를 써서 내 GitHub 알림을 열고, 내 검토가 필요한 PR을 저장소 이름·제목·URL과 함께 목록으로 뽑아 줘. 보관하지 말고, 아무것도 읽음으로 표시하지 마.
첫머리 Use ego-browser.는 빠른 시작 문서의 첫 작업 문장을 따라 붙인 것이고, 나머지는 스냅샷 문서의 예시 그대로입니다.
Use ego-browser. Open my [site name] inbox and list the unread items — sender, title, URL.
Read-only, don't modify: don't open, reply to, archive, delete, or mark anything as read.
Pause if you hit a login or verification screen.뜻: ego-browser를 써서 내 [사이트 이름] 받은편지함을 열고, 읽지 않은 항목을 보낸 사람·제목·URL과 함께 목록으로 뽑아 줘. 읽기만 하고 바꾸지 마 — 열지도, 답장하지도, 보관·삭제하지도, 읽음으로 표시하지도 마. 로그인이나 인증 화면이 나오면 멈춰.
원문에 없는 문장입니다. 다섯 가지 요소에 맞춰 만든 예시이고, [site name]과 항목 이름은 내 사이트에 맞게 바꿉니다. “read-only, don't modify”는 Space 문서가 경계 문장의 예로 든 표현입니다.
확인: 에이전트가 작업을 시작하고, 내가 보고 있던 탭은 바뀌지 않습니다. 에이전트는 ego(lite) 안에 자기 Space를 만들어 그 안에서 페이지를 엽니다.
4단계 · Space에서 로그인된 화면인지 보기
- ego(lite) 오른쪽 위의 Space 단추 누르기3단계의 작업이 도는 동안 바로 누릅니다. Space 관리 패널이 열립니다.
- 파란 빛이 나는 Space 찾기그곳이 지금 에이전트가 일하고 있는 Space입니다.
- 눌러서 들어가 보기에이전트가 연 페이지가 보입니다. 보기만 하고 아무것도 누르지 않습니다.
확인: Space 안에 로그인 화면이 아니라 내 계정의 알림 목록이 열려 있습니다. 로그인이나 인증 화면이 보이면 막히면의 첫 줄로 갑니다.
5단계 · 돌아온 목록을 직접 대조하기
에이전트의 답을 그대로 믿지 않고, 스냅샷 문서의 점검 항목으로 확인합니다.
- 어느 페이지를 열고 무엇을 했는지 적혀 있는가방문한 페이지와 주요 동작이 답에 있어야 합니다.
- 바뀐 것이 없는가작업이 끝나도 Space의 탭은 바로 닫히지 않고 남습니다. 그 화면에서 알림이 읽음 처리되거나 보관되지 않았는지, 1단계에서 봐 둔 것과 견주어 봅니다. 이 확인을 아래의 “직접 열어 보기”보다 먼저 합니다 — 사이트에 따라서는 내가 알림을 여는 것만으로 읽음으로 바뀔 수 있어, 순서가 뒤바뀌면 누가 바꿨는지 가릴 수 없습니다.
- 확인할 수 있는 항목이 있는가제목과 URL이 건마다 있어야 합니다. 두 건을 골라 URL을 내 탭에서 열고 제목이 같은지 봅니다.
빠진 건이 있거나 목록이 화면과 다르면, 앞선 답을 근거로 계속 추측하게 두지 말고 지금 페이지를 다시 읽게 합니다. 아래는 그렇게 요청하는 예시 문장입니다.
Re-snapshot the current page and check your list against what is on the page now. Don't modify anything.뜻: 지금 페이지의 스냅샷을 다시 찍고, 네 목록을 지금 화면과 맞춰 봐. 아무것도 바꾸지 마.
확인: 내가 열어 보기 전의 알림 상태가 1단계에서 본 그대로이고, 고른 두 건의 제목·URL이 실제 페이지와 같습니다.
막히면
| 증상 | 할 일 |
|---|---|
| Space에 로그인·인증 화면이 뜸 | 문자·이메일 코드, QR 로그인, 보안 키 같은 단계는 에이전트가 멈추고 나에게 돌려줘야 하는 일입니다. 그 Space에 들어가 내가 직접 처리한 뒤 대화창에서 이어 하라고 말합니다(실습 2의 5단계). 비밀번호나 인증 코드를 대화창에 붙여 넣지 않습니다. |
| 4단계에서 파란 빛이 나는 Space가 안 보임 | 파란 빛은 에이전트가 지금 일하고 있는 Space의 표시입니다. 대화창에서 작업이 아직 도는 중인지 먼저 봅니다. 이미 끝났다면 문장을 다시 보내고, 도는 동안 Space 단추를 누릅니다(실습 2의 막히면). |
| 목록이 비었거나 엉뚱한 페이지를 읽음 | Space에 열린 페이지가 맞는지 먼저 봅니다. 다르면 대상 페이지를 더 분명히 적어 다시 맡기고, 맞으면 5단계의 다시 읽기 문장을 보냅니다. |
| 알림을 읽음 처리하려 하거나 이미 바꿈 | 대화창에서 에이전트에게 그만하라고 말하고, 그 Space에 들어가 무엇이 바뀌었는지 내가 직접 봅니다. 다시 맡길 때는 “read-only, don't modify”를 문장에 넣고, 하지 말 것을 하나씩 적습니다. |
| “번호표(@N)(스냅샷 속 단추·입력 칸에 붙는 임시 번호)가 유효하지 않다”고 함 | 앞선 스냅샷 뒤에 페이지가 바뀐 것입니다. 스냅샷을 새로 찍게 합니다. 자세한 것은 실습 10. |
| 스킬이 안 보이거나 ego(lite)가 안 열림 | 실습 9에서 연결부터 확인합니다. |
다음에 할 것
- 읽기만 하던 것에서 한 걸음 나아가 파일을 받아 봅니다 — 실습 5 · 파일 내려받기.
- 되돌리기 어려운 단추 앞에서 멈추게 하는 연습 — 실습 6.
- 더 읽기: 작업 문장 쓰는 법 · 결과 점검하기 · 로그인과 넘겨받기.
- ego(lite)에 로그인해 둔 사이트는 에이전트 Space에서도 보통 로그인된 화면으로 바로 열립니다.
- 작업 문장에는 대상·읽을 것·하지 말 것·멈출 곳·결과 형태를 적습니다.
- Space 단추 → Space 관리 패널 → 파란 빛이 나는 Space에서 에이전트의 화면을 봅니다.
- 돌아온 목록은 제목과 URL로 직접 대조하고, 이상하면 스냅샷을 다시 찍게 합니다.
출처: lite.ego.app/document/en/docs/snapshot (Writing a task for the agent · Reviewing what the agent did · Common questions), /docs/space (Logged-in state · How you and the agent collaborate · FAQ), /docs/quick-start (Run your first task · Watch and take over), /docs/product-introduce (Space), /docs/claude-code (비밀번호·인증 코드 경고). 2026-11-09 수집. “다른 사이트” 틀과 다시 읽기 문장은 연습용 예시입니다.
파일 내려받기 — 멈출 곳과 저장 위치 보고받기
로그인해야 들어갈 수 있는 관리 화면에서 조건을 걸고 파일을 내려받는 일을 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)에게 맡깁니다. 어디서 멈출지 미리 정하고, 파일이 내 컴퓨터 어디에 저장됐는지 보고받는 연습입니다.
- 작업 문장에 “이런 화면이 나오면 멈춰라”를 미리 적습니다.
- 내려받은 파일의 로컬 경로(내 컴퓨터 안에서 파일이 있는 위치)를 보고받습니다.
- 파일을 직접 열어 날짜와 행 수가 맞는지 확인합니다.
예상 소요 시간: 15~20분
준비물과 완료 기준
- 실습 4까지 해 본 상태. 로그인된 사이트를 에이전트 Space(스페이스 — 에이전트 전용 작업 공간)에서 여는 것을 확인했어야 합니다.
- ego(lite)에 로그인해 둔, 내려받기 단추가 있는 내 업무 화면 하나. 원문 예시는 주문 현황 화면(orders dashboard)에서 어제 주문을 CSV(쉼표로 칸을 나눈 표 파일)로 받는 일입니다. 내가 쓰는 관리 화면의 보고서·목록 내보내기로 바꿔서 합니다.
- 연습은 여러 번 내려받아도 문제가 없는 자료로 합니다.
에이전트가 파일의 로컬 경로를 알려 주고, 내가 그 파일을 열어 날짜 범위와 행 수가 화면과 맞는 것을 확인하면 완료입니다.
이런 일이 Space에 어울리는 이유는 원문에 있습니다. 로그인이 필요한 현황 화면·주문 페이지, 그리고 누르기·걸러 내기·내려받기가 들어가는 작업은 진짜 브라우저와 진짜 로그인이 있어야 하기 때문입니다.
따라 하기
1단계 · 원문 문장을 내 화면에 맞게 바꾸기
공식 문서 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전) 쪽의 예시 문장은 두 줄입니다. 첫 줄은 할 일, 둘째 줄은 멈출 곳과 보고받을 것입니다.
Use ego-browser. Open the orders dashboard, filter yesterday's orders, and download the CSV.
Pause if you hit a login challenge or an export confirmation, and tell me where the file landed.뜻: ego-browser를 써서 주문 현황 화면을 열고, 어제 주문만 걸러서 CSV를 내려받아 줘. 로그인 확인이나 내보내기 확인이 나오면 멈추고, 파일이 어디에 저장됐는지 알려 줘.
첫머리 Use ego-browser.는 빠른 시작 문서의 첫 작업 문장을 따라 붙인 것이고, 나머지는 스냅샷 문서의 예시 그대로입니다.
Use ego-browser. Open [page name or URL], filter [what, which period], and download the [CSV].
Don't change, delete, or send anything on the site.
Pause if you hit a login challenge or an export confirmation, and tell me where the file landed.뜻: ego-browser를 써서 [화면 이름이나 주소]를 열고, [무엇을 어느 기간으로] 걸러서 [CSV]를 내려받아 줘. 사이트에서 아무것도 바꾸거나 지우거나 보내지 마. 로그인 확인이나 내보내기 확인이 나오면 멈추고, 파일이 어디에 저장됐는지 알려 줘.
원문 문장의 빈칸만 바꾸고 “하지 말 것” 한 줄을 더한 예시입니다. 대괄호 안을 내 화면에 맞게 채웁니다.
| 원문의 말 | 내 화면에서 바꿔 넣을 것 |
|---|---|
| the orders dashboard | 내가 쓰는 관리 화면의 이름이나 주소 |
| yesterday's orders | 걸러 낼 대상과 기간(어제, 지난주 등) |
| the CSV | 그 화면이 내보내 주는 파일 |
| a login challenge | 로그인이나 본인 확인을 다시 요구하는 화면 — 그대로 둡니다 |
| an export confirmation | 내려받기 전에 확인을 요구하는 화면 — 그대로 둡니다 |
확인: 내 문장에 대상 화면, 걸러 낼 조건, 멈출 곳, “파일이 어디에 저장됐는지 알려 달라”는 말이 모두 들어 있습니다.
2단계 · 내 탭에서 미리 한 번 보기
ego(lite)의 내 탭에서 그 화면을 직접 열어 봅니다. 로그인되어 있는지, 내려받기 단추가 실제로 있는지 봅니다. 같은 조건을 걸었을 때 화면에 건수가 보이면 적어 둡니다. 나중에 파일의 행 수와 맞춰 볼 숫자입니다.
로그인이 풀려 있으면 지금 내가 직접 로그인합니다. 비밀번호나 인증 코드를 에이전트에게 보내는 문장에 붙여 넣지 않습니다.
확인: 로그인된 화면이 보이고, 조건을 걸었을 때의 건수(또는 첫 줄과 마지막 줄)를 메모했습니다.
3단계 · 보내고, 멈춘 곳에서 직접 처리하기
에이전트 대화창에서 /ego-browser 스킬(에이전트에게 주는 사용 설명서 묶음)을 부르고 1단계의 문장을 보냅니다. 그다음 ego(lite) 오른쪽 위의 Space 단추를 눌러 Space 관리 패널을 열고, 파란 빛이 나는 Space에 들어가 진행을 봅니다.
에이전트가 로그인 확인이나 내보내기 확인에서 멈추고 나를 부르면, 그 Space 안에서 화면을 읽고 내가 직접 처리합니다. 마친 뒤에는 대화창으로 돌아와 이어 하라고 말합니다 — Claude Code 연결 문서가 “직접 처리한 뒤 에이전트에게 계속하라고 말하라”고 안내합니다(문장 예시는 실습 2의 5단계). 그러면 에이전트가 이어서 합니다. 순서가 낯설면 실습 2를 다시 봅니다.
확인: 내가 보던 탭은 그대로이고, 멈춤이 있었다면 내가 처리한 뒤 작업이 이어졌습니다. 확인 화면이 아예 없는 사이트라면 멈춤 없이 끝나도 정상입니다.
4단계 · 저장 위치를 보고받기
작업이 끝나면 에이전트의 답에서 세 가지를 찾습니다. 스냅샷 문서의 점검 항목 가운데 내려받기에 해당하는 것들입니다.
- 어느 페이지를 열고 무엇을 했는가방문한 화면과 건 조건이 답에 적혀 있어야 합니다.
- 로컬 파일 경로가 있는가내려받기 작업이라면 파일이 내 컴퓨터 어디에 있는지 알려 줘야 합니다.
- 대조할 값이 있는가건수·날짜처럼 내가 확인할 수 있는 값이 있으면 더 좋습니다.
경로가 빠졌다면 아래 예시 문장으로 다시 묻습니다.
Tell me the local file path of the file you downloaded, and the filter you applied.뜻: 내려받은 파일의 로컬 경로와, 네가 건 조건을 알려 줘.
저장 위치:
(내 컴퓨터의 폴더 경로)/orders.csv행 수: 42
확인: 답에 파일 경로가 한 줄로 적혀 있고, 그 위치에서 파일을 찾았습니다.
5단계 · 파일을 열어 날짜와 행 수 확인하기
알려 준 경로의 파일을 표 계산 프로그램이나 글 편집기로 엽니다. 그리고 작업이 끝난 뒤에도 바로 닫히지 않고 남아 있는 Space의 화면과 나란히 놓고 봅니다. 이 대조는 작업이 끝난 직후에 합니다.
맞지 않으면 에이전트에게 지금 페이지를 다시 읽게 합니다. 앞선 답을 근거로 계속 추측하게 두지 않는다는 것이 원문의 조언입니다. 예시 문장:
Re-snapshot the current page and tell me the filter that is applied now and how many rows are shown.뜻: 지금 페이지의 스냅샷을 다시 찍고, 지금 걸려 있는 조건과 보이는 행 수를 알려 줘.
확인: 파일의 날짜가 요청한 기간 안에만 있고, 행 수가 화면의 건수와 같습니다.
막히면
| 증상 | 할 일 |
|---|---|
| 에이전트가 멈춘 채 기다림 | 약속대로 멈춘 것입니다. Space 단추 → Space 관리 패널 → 파란 빛이 나는 Space에 들어가 화면을 보고 내가 직접 처리한 뒤, 대화창에서 이어 하라고 말합니다. 비밀번호나 인증 코드를 대화창에 붙여 넣지 않습니다. |
| 답에 파일 경로가 없음 | 4단계의 예시 문장으로 다시 묻습니다. 다음부터는 문장 끝의 “tell me where the file landed”를 빼지 않습니다. |
| 경로는 받았는데 그 위치에서 파일을 못 찾음 | 경로의 마지막 부분이 파일 이름이고 그 앞이 폴더입니다. 폴더 이름과 파일 이름을 따로 다시 알려 달라고 한 뒤 그 폴더를 직접 열어 봅니다. 그래도 없으면 내려받기가 실제로 끝났는지 Space에 남은 화면에서 확인하고 다시 맡깁니다. |
| 파일이 비었거나 기간이 다름 | Space에 남은 화면에서 조건이 어떻게 걸려 있는지 먼저 봅니다. 그다음 5단계의 다시 읽기 문장을 보내고, 조건을 더 분명히 적어 다시 맡깁니다. |
| 내려받기 단추를 못 찾겠다고 함 | 스냅샷이 모든 것을 읽지는 못합니다. 화면 밖 내용, 그림 속 글자, 복잡한 캔버스, 다른 사이트에서 끼워 넣은 일부 페이지(iframe)는 다 보이지 않을 수 있습니다. 그 단계만 내가 Space에서 직접 누르고 이어 가게 합니다. 실습 10. |
| 확인 화면에서 멈추지 않고 진행함 | 결과를 5단계대로 더 꼼꼼히 대조합니다. 다음에는 멈출 화면을 그 사이트의 말로 구체적으로 적습니다. |
다음에 할 것
- 내려받기보다 조심스러운 일, 제출 단추 앞에서 멈추게 하는 연습 — 실습 6.
- 보고서 여러 개를 한꺼번에 받고 싶다면 — 실습 7 · 여러 작업을 동시에.
- 더 읽기: 작업 문장 쓰는 법 · 결과 점검하기 · 작업이 끝난 뒤의 Space.
- 문장 첫 줄에는 할 일을, 둘째 줄에는 멈출 곳과 보고받을 것을 적습니다.
- 에이전트가 멈추면 그 Space에 들어가 내가 직접 처리하고, 끝나면 이어 하라고 말합니다.
- 내려받기 작업은 파일의 로컬 경로를 반드시 보고받습니다.
- 파일을 열어 날짜와 행 수를 Space에 남은 화면과 맞춰 봅니다.
출처: lite.ego.app/document/en/docs/snapshot (Writing a task for the agent · Reviewing what the agent did · Common questions), /docs/space (What belongs in a Space · How you and the agent collaborate · FAQ), /docs/quick-start (Run your first task · Watch and take over), /docs/claude-code (넘겨받은 뒤 계속하라고 말하기 · 비밀번호 경고). 2026-11-09 수집. 바꿔 쓰는 틀, 다시 묻는 문장, 답의 모양은 연습용 예시입니다.
양식 채우고 제출 직전에 멈추기
칸을 채우는 지루한 일은 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)에게 맡기고, 되돌리기 어려운 마지막 단추는 내가 누릅니다. 에이전트가 제출 바로 앞에서 멈추게 문장을 쓰고, 채워진 내용을 확인하는 연습입니다.
- 제출·결제·게시·삭제처럼 되돌리기 어려운 일 앞에 “멈춤선”을 긋습니다.
- 에이전트가 채운 칸을 Space(스페이스 — 에이전트 전용 작업 공간)에서 하나씩 대조합니다.
- 마지막 단추는 내가 직접 누르거나, 누르지 않고 끝냅니다.
예상 소요 시간: 15~20분
준비물과 완료 기준
- 실습 2(Space 들여다보기·넘겨받기)와 실습 4(하지 말 것 정해 주기)를 해 본 상태.
- 잘못 제출돼도 실제 피해가 없는 양식 하나. 예: 내가 쓰는 서비스의 문의 양식, 설문, 예약 신청 양식. 결제나 계약이 걸린 양식은 연습 대상으로 고르지 않습니다.
- 양식에 채울 내용을 적은 메모(이름, 연락처, 문의 내용 등). 비밀번호나 인증 코드는 메모에도, 에이전트에게 보내는 문장에도 넣지 않습니다.
에이전트가 칸을 채운 뒤 제출 단추를 누르지 않고 멈췄고, 내가 Space에서 칸마다 내용을 확인했으면 완료입니다. 제출은 해도 되고 안 해도 됩니다.
공식 활용 사례도 같은 방식을 씁니다. 채용 지원서를 이력서 PDF로 끝까지 채우되 제출 한 번 전에서 멈춰 내가 검토하게 하고, 항공편 예약은 탑승객 정보를 미리 채운 뒤 결제 페이지에서 멈춥니다.
따라 하기
1단계 · 어디에 멈춤선을 그을지 알기
Space 문서는 에이전트가 멈추고 나에게 돌려줘야 하는 상황을 네 가지로 듭니다. 내가 고른 양식의 마지막 단추가 이 가운데 어디에 해당하는지 봅니다.
원문은 여기에 한 줄을 덧붙입니다. 경계는 미리 그어 둘 수도 있다는 것입니다. 예로 든 문장이 “read-only, don't modify”(읽기만, 바꾸지 말 것)와 “stop and confirm before submitting”(제출하기 전에 멈추고 확인받을 것)입니다. 이번에는 뒤의 문장을 씁니다.
확인: 내 양식에서 “에이전트가 누르면 안 되는 단추”가 무엇인지 한 가지로 말할 수 있습니다.
2단계 · 멈출 곳을 넣어 문장 만들기
아래는 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전) 문서의 다섯 가지 요소(대상 페이지 · 채울 것 · 하지 말 것 · 멈출 곳 · 결과 형태)에 맞춰 만든 예시입니다. 원문에 이 문장이 그대로 있는 것은 아닙니다. 대괄호 안을 내 양식에 맞게 바꿉니다.
Use ego-browser. Open [form page URL] and fill in the form with the details below.
Name: [my name]
Email: [my email]
Message: [what I want to say]
Don't click the final submit button. Stop and confirm before submitting, and list what you entered in each field.
Pause if you hit a login, captcha, or payment screen.
뜻: ego-browser를 써서 [양식 페이지 주소]를 열고 아래 내용으로 양식을 채워 줘. 이름: … / 이메일: … / 내용: … 마지막 제출 단추는 누르지 마. 제출하기 전에 멈추고 확인받고, 칸마다 무엇을 넣었는지 적어 줘. 로그인, 사람 확인(captcha), 결제 화면이 나오면 멈춰.
| 요소 | 이 문장에서 |
|---|---|
| 대상 페이지 | [form page URL] — 양식이 있는 주소 |
| 채울 것 | 칸 이름과 값을 한 줄에 하나씩 |
| 하지 말 것 | Don't click the final submit button. |
| 멈출 곳 | Stop and confirm before submitting · 로그인·사람 확인·결제 화면 |
| 결과 형태 | 칸마다 넣은 값의 목록 |
확인: 문장에 “누르지 말 것”과 “멈출 곳”이 각각 한 줄씩 있고, 비밀번호나 인증 코드는 들어 있지 않습니다.
3단계 · 보내고, Space에서 채워지는 모습 보기
- 대화창에서
/ego-browser를 부르고 문장 보내기에이전트가 ego(lite) 안에 Space를 만들고 양식 페이지를 엽니다. - ego(lite) 오른쪽 위의 Space 단추 누르기Space 관리 패널이 열립니다. 파란 빛이 나는 Space가 에이전트가 일하는 곳입니다.
- 그 Space에 들어가 보기칸이 채워지는 것을 봅니다. 지금은 보기만 하고 아무것도 누르지 않습니다.
스냅샷을 찍는 것만으로는 페이지에서 아무것도 바뀌지 않습니다. 상태를 실제로 바꾸는 것은 그 뒤에 일어나는 누르기·채우기·제출·올리기·삭제입니다. 그래서 채우기까지는 맡기되, 제출은 따로 떼어 내가 쥡니다.
확인: 내가 보던 탭은 바뀌지 않았고, Space 안의 양식에 내가 준 값이 들어가고 있습니다.
4단계 · 멈췄는지 확인하고 칸마다 대조하기
에이전트가 “제출 전에 멈췄다”고 답하면, 답에 적힌 값과 Space의 실제 화면을 맞춰 봅니다. 수정하거나 제출하는 작업에서는 마지막 단계 전에 멈춰 확인을 받았는가가 원문이 꼽는 점검 항목입니다.
틀린 칸이 있으면 내가 그 Space에서 직접 고치거나, 아래 예시 문장처럼 고치게 한 뒤 다시 멈추게 합니다.
The email field is wrong. Change it to [correct value], re-snapshot the page, and stop again before submitting.뜻: 이메일 칸이 틀렸어. [맞는 값]으로 바꾸고, 페이지 스냅샷을 다시 찍은 뒤, 제출 전에 다시 멈춰.
확인: Space에 아직 양식 화면이 떠 있고, 모든 칸의 값이 내 메모와 같습니다.
5단계 · 내가 직접 제출하거나, 누르지 않고 끝내기
연습이 목적이면 여기서 끝내도 됩니다. 실제로 보내려면 그 Space 안에서 내가 직접 제출 단추를 누릅니다. 원문 사례에는 내가 확인해 주기를 기다렸다가 마지막 제출로 넘어가는 흐름도 나오지만, 이 실습에서는 에이전트에게 “이제 제출해”라고 시키지 않습니다. 화면을 직접 본 사람이 마지막 단추를 누르는 연습이기 때문입니다.
작업이 끝나도 Space의 탭은 바로 닫히지 않고 남으므로, 제출한 뒤의 결과 화면도 그 자리에서 확인할 수 있습니다. 언제까지 남는지는 완전 가이드 2장 · 작업이 끝난 뒤에 있습니다.
같은 틀이 지원서(마지막 제출 전), 예약(결제 페이지 전), 게시물 작성(게시 전), 관리 화면의 일괄 수정(저장 전)에 그대로 쓰입니다. 멈출 단추의 이름만 그 사이트의 말로 바꿉니다.
확인: 제출했다면 완료 화면을 Space에서 보았고, 하지 않았다면 양식이 채워진 채 남아 있습니다. 어느 쪽이든 마지막 단추는 에이전트가 누르지 않았습니다.
막히면
| 증상 | 할 일 |
|---|---|
| 에이전트가 제출까지 눌러 버림 | Space에 남은 화면에서 무엇이 제출됐는지 먼저 확인합니다. 고치거나 취소할 수 있는지는 그 서비스에서 내가 직접 알아봅니다. 다시 할 때는 “Don't click the final submit button”과 “Stop and confirm before submitting”을 둘 다 넣고, 단추 이름을 그 사이트의 말로 적습니다. |
| 로그인·사람 확인(captcha) 화면에서 멈춤 | 정상입니다. 이런 단계는 에이전트가 멈추고 내가 들어오기를 기다립니다. ego(lite)는 CAPTCHA나 사이트의 보안 확인을 우회하지 않습니다. Space에서 내가 직접 처리하면 에이전트가 이어 갑니다(실습 2). 비밀번호나 인증 코드를 대화창에 붙여 넣지 않습니다. |
| 칸이 비었거나 다른 값이 들어감 | 4단계의 예시 문장으로 고치게 하거나 내가 직접 고칩니다. 값이 헷갈릴 만하면 문장에서 칸 이름을 양식에 보이는 그대로 적습니다. |
| 어떤 칸을 못 찾겠다고 함 | 스냅샷이 모든 것을 읽지는 못합니다. 화면 밖 내용, 그림 속 글자, 복잡한 canvas(그림판처럼 직접 그려 넣은 화면 영역), 다른 사이트의 페이지를 격리해 끼워 넣은 일부 칸(iframe)은 다 보이지 않을 수 있습니다. 그 칸만 내가 채웁니다. 실습 10. |
| 멈췄는지 넘어갔는지 모르겠음 | Space에 들어가 지금 화면이 양식인지 완료 화면인지 봅니다. 에이전트에게는 지금 페이지의 스냅샷을 다시 찍어 알려 달라고 합니다. |
다음에 할 것
- 조사 여러 개를 한꺼번에 맡겨 봅니다 — 실습 7 · 여러 작업을 동시에.
- 로그인·인증에서 자주 막힌다면 — 실습 10.
- 더 읽기: 에이전트가 멈추고 돌려줘야 하는 상황 · 작업 문장 쓰는 법 · 활용 사례.
- 본인 확인, 돈이 오가는 일, 되돌리기 어려운 변경, 권한 내주기 앞에서는 에이전트가 멈추고 나에게 돌려줘야 합니다.
- 문장에 “누르지 말 것”과 “stop and confirm before submitting”을 미리 적습니다.
- 에이전트가 멈추면 Space에서 칸마다 값을 대조합니다.
- 마지막 단추는 그 Space에서 내가 직접 누릅니다.
출처: lite.ego.app/use-cases (Find and apply to jobs automatically · Search and quote flight bookings), /document/en/docs/quick-start (What else can you do with ego(lite) · Watch and take over), /docs/space (Logged-in state · How you and the agent collaborate · FAQ), /docs/snapshot (Writing a task for the agent · Reviewing what the agent did · Common questions), /docs/claude-code (비밀번호·인증 코드 경고). 2026-11-09 수집. 양식 채우기 문장과 고쳐 달라는 문장, 양식 화면은 연습용 예시입니다.
여러 작업을 동시에 맡기기
서로 상관없는 조사 두세 개를 한꺼번에 맡기고, 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)들이 각자의 Space(스페이스 — 에이전트 전용 작업 공간)에서 일하는 모습을 봅니다. 나는 그동안 내 탭에서 하던 일을 계속합니다.
- 작업 두세 개를 동시에 맡기고, 작업마다 Space가 따로 생기는 것을 확인합니다.
- Space 관리 패널에서 어느 Space가 일하는 중인지 보고, 하나를 골라 들어가 봅니다.
- 결과를 작업별로 따로 받아 각각 대조합니다.
예상 소요 시간: 20~30분
준비물과 완료 기준
- 실습 1과 실습 2를 마친 상태. 작업 하나를 맡기고 Space를 들여다본 적이 있어야 합니다.
- 로그인 없이 되는 읽기 작업 두세 개. 아래 1단계에서 공식 활용 사례 가운데 고릅니다.
- ego(lite)가 실행 중이고, 쓰는 에이전트에서
/ego-browser스킬(에이전트에게 주는 사용 설명서 묶음)을 부를 수 있을 것.
작업 두 개 이상이 같은 시간에 서로 다른 Space에서 진행되는 것을 Space 관리 패널에서 보았고, 결과를 작업별로 받아 각각 한 건 이상 원래 페이지와 대조했으면 완료입니다.
몇 개까지 되나요? 원문은 숫자를 정해 두지 않고 “내 컴퓨터의 메모리와 CPU(컴퓨터의 계산 장치)에 달려 있다”고만 말합니다. 그래도 가벼운 편인 이유는, Space가 브라우저를 작업마다 새로 띄우지 않고 ego(lite) 하나를 함께 쓰기 때문입니다. 빈 페이지만 여는 6개 동시 실험의 숫자가 이렇습니다.
따라 하기
1단계 · 맡길 작업 두세 개 고르기
서로 결과가 얽히지 않는, 읽기만 하는 조사를 고릅니다. 아래 셋은 공식 활용 사례에서 가져온 것입니다. 처음에는 A와 B 두 개만 해도 충분합니다.
| 작업 | 활용 사례의 내용 | 돌려받을 것 |
|---|---|---|
| A · 주식 조회 | Yahoo Finance에서 미국 주식 다섯 종목의 가격·일일 등락·시가총액·1개월 수익률을 기록 | 종목별 표, 가장 오른 종목과 가장 내린 종목 |
| B · 중고차 검색 | Cars.com에서 뉴욕 근처 중고 Toyota Camry를 연식·주행거리로 거르고, 선수금 5,000달러·60개월로 월 납입액 계산 | 매물 제목·가격·월 납입액·URL |
| C · 항공편 견적 | 내 노선과 날짜로 항공편을 찾아 직항만 거르고 가장 싼 편 고르기 | 편명·출발 시각·총 운임 |
원문 사례가 미국 사이트라서 그대로 해 봐도 되고, 내가 평소 보는 공개 사이트의 비슷한 조사로 바꿔도 됩니다. 다만 공개 정보를 찾아 읽기만 하는 일이라면 일반 웹 검색이 더 가볍다는 것이 원문의 안내입니다. 여기서는 걸러 내기나 계산기처럼 화면을 직접 다뤄야 하는 조사를 골랐습니다.
확인: 고른 작업이 두 개 이상이고, 모두 로그인·결제·제출 없이 끝나는 일입니다.
2단계 · 작업마다 따로 맡기기
원문은 “작업 여러 개를 이렇게 보내라”고 정해 주지 않습니다. 여러 작업을 맡기는 방법은 에이전트마다 다릅니다. 한 가지 방법(예시)은 에이전트 대화(세션 — 에이전트와 주고받는 한 묶음의 대화)를 작업마다 따로 열어, 각각에서 /ego-browser를 부르고 문장을 하나씩 보내는 것입니다. 앞 작업이 끝나기를 기다리지 않고 이어서 보냅니다.
Use ego-browser. Look up five U.S. stocks on Yahoo Finance — [ticker 1], [ticker 2], [ticker 3], [ticker 4], [ticker 5]. Record price, daily change, market cap, and 1-month return for each, and report the biggest gainer and the biggest loser.
Read-only, don't modify. Return a table with the URL of each page you read.뜻: ego-browser를 써서 Yahoo Finance에서 미국 주식 다섯 종목 [종목 기호 다섯 개]을 찾아봐. 종목마다 가격·일일 등락·시가총액·1개월 수익률을 기록하고, 가장 많이 오른 종목과 가장 많이 내린 종목을 알려 줘. 읽기만 하고 바꾸지 마. 읽은 페이지의 URL을 넣은 표로 돌려줘.
Use ego-browser. Search Cars.com for a used Toyota Camry near NYC, filter by year and mileage ([year range], [max mileage]), then use the payment calculator at $5,000 down over 60 months to surface the monthly payment.
Read-only: don't contact a seller or submit any form. Return the listing title, price, monthly payment, and URL.뜻: ego-browser를 써서 Cars.com에서 뉴욕 근처의 중고 Toyota Camry를 찾고, 연식과 주행거리([연식 범위], [최대 주행거리])로 거른 뒤, 납입 계산기에 선수금 5,000달러·60개월을 넣어 월 납입액을 알려 줘. 읽기만 해 — 판매자에게 연락하거나 어떤 양식도 제출하지 마. 매물 제목·가격·월 납입액·URL을 돌려줘.
Use ego-browser. Search flights for [route] on [date], filter to nonstop, and pick the cheapest option.
Stop before entering any passenger or payment details. Return the flight number, departure time, and total fare.뜻: ego-browser를 써서 [노선]의 [날짜] 항공편을 찾고, 직항만 걸러서 가장 싼 편을 골라 줘. 탑승객 정보나 결제 정보를 넣기 전에 멈춰. 편명·출발 시각·총 운임을 돌려줘.
세 문장 모두 활용 사례 쪽의 설명 문장을 바탕으로 만든 예시입니다. 첫머리 Use ego-browser.와 둘째 줄(하지 말 것·결과 형태)은 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전) 문서의 다섯 가지 요소에 맞춰 더했습니다. 원문의 항공편 사례는 탑승객 정보를 채우고 결제 페이지에서 멈추지만, 여기서는 읽기 연습이라 그 앞에서 멈추게 했습니다.
확인: 작업마다 문장을 하나씩 보냈고, 각 대화에서 에이전트가 작업을 시작했습니다. 내가 보던 탭은 그대로입니다.
3단계 · Space 관리 패널에서 일하는 Space 세어 보기
ego(lite) 오른쪽 위의 Space 단추를 눌러 Space 관리 패널을 엽니다. 파란 빛이 나는 Space가 에이전트가 지금 일하고 있는 곳입니다.
확인: 일하는 중인 Space가 맡긴 작업 수만큼 보입니다. 하나만 보인다면 막히면의 둘째 줄을 봅니다.
4단계 · 하나에 들어가 보고, 내 탭으로 돌아오기
- Space 하나를 골라 들어가기그 작업의 페이지만 열려 있는지 봅니다. Space마다 탭이 따로입니다.
- 보기만 하기어느 Space든 열어서 에이전트를 지켜보거나, 작업을 멈추거나, 넘겨받을 수 있습니다. 이번에는 지켜보기만 합니다.
- 내 탭으로 돌아와 다른 일 하기에이전트는 내 탭을 바꾸지 않고 키보드 초점도 가져가지 않습니다.
확인: 들어가 본 Space에는 그 작업의 사이트만 열려 있었고, 내 탭으로 돌아온 뒤에도 내 화면과 입력은 방해받지 않습니다.
Space는 누가 만들고 이름은 어떻게 붙나요
에이전트가 ego-browser로 실행하는 스크립트 안에서 useOrCreateTaskSpace(name)이 이름으로 Space를 다시 쓰거나 새로 만들고, 스크립트의 나머지가 그 안에서 실행됩니다. Space 문서는 서로 다른 작업이 번호표(@N)(스냅샷 속 단추·입력 칸에 붙는 임시 번호)를 공유하지 않는다고 덧붙입니다. 내가 직접 입력할 일은 없습니다. 완전 가이드 2장 · 여러 작업.
5단계 · 결과를 작업별로 받아 대조하기
결과는 맡긴 대화마다 따로 돌아옵니다. 작업별로 아래를 확인합니다.
- 방문한 페이지와 한 일이 적혀 있는가A의 답에는 A의 사이트만 나와야 합니다.
- 확인할 수 있는 값이 있는가URL·금액·시각 가운데 한 건을 골라 원래 페이지와 맞춰 봅니다. 작업이 끝나도 Space의 탭은 바로 닫히지 않고 남으므로 그 Space에서 볼 수 있습니다(언제까지 남는지).
- 하지 말라고 한 일을 하지 않았는가연락·제출·결제 정보 입력이 없어야 합니다.
값이 화면과 다르면 그 작업의 대화에서 지금 페이지의 스냅샷을 다시 찍어 확인해 달라고 합니다.
확인: 작업마다 결과를 따로 받았고, 각각 한 건 이상 원래 페이지와 값이 같습니다.
막히면
| 증상 | 할 일 |
|---|---|
| 컴퓨터가 눈에 띄게 느려짐 | 동시에 돌릴 수 있는 수는 내 컴퓨터의 메모리와 CPU에 달려 있습니다. 작업 수를 줄여 두 개부터 다시 합니다. 급하면 Space를 열어 작업 하나를 멈춥니다. |
| 일하는 Space가 하나만 보임 | 작업이 한 대화 안에서 차례로 처리되고 있을 수 있습니다. 2단계의 예시처럼 작업마다 대화를 따로 열어 맡겼는지 확인합니다. 에이전트마다 방법이 다르므로 에이전트별 연결 방법도 봅니다. |
| 결과가 서로 섞임 | 한 문장에 여러 작업을 넣지 않았는지 봅니다. 작업 하나에 문장 하나, 결과 형태도 작업마다 따로 적습니다. |
| 한 작업만 멈춰서 기다림 | 그 Space에 사람 확인이나 로그인 화면이 떴을 수 있습니다. 멈춘 Space에 들어가 내가 직접 처리합니다(실습 2). 비밀번호나 인증 코드를 대화창에 붙여 넣지 않습니다. |
| “번호표가 유효하지 않다”고 함 | 페이지가 바뀐 뒤 옛 번호를 쓴 것입니다. 스냅샷을 새로 찍게 합니다. 실습 10. |
다음에 할 것
- 같은 작업을 다른 에이전트로 해 봅니다 — 실습 8.
- 더 읽기: 여러 작업을 동시에 · Space가 가벼운 이유 · 활용 사례.
- 보통 작업 하나에 Space 하나이고, 여러 Space가 같은 ego(lite) 안에서 동시에 돕니다.
- 몇 개까지 되는지는 내 컴퓨터의 메모리와 CPU에 달려 있습니다.
- 여러 작업을 맡기는 방법은 에이전트마다 다릅니다. 대화를 작업마다 따로 여는 것이 한 가지 방법입니다.
- Space 관리 패널에서 파란 빛이 나는 Space를 보고, 결과는 작업별로 따로 대조합니다.
출처: lite.ego.app/document/en/docs/space (Why Space exists · What belongs in a Space · Many tasks at once · FAQ), /docs/product-introduce (Space · Compared with browser extensions), /use-cases (Track your stocks in one pass · Find your dream car · Search and quote flight bookings), /docs/quick-start (Watch and take over), /docs/snapshot (Writing a task for the agent · Reviewing what the agent did). 2026-11-09 수집. 작업 A·B·C 문장과 “대화를 따로 여는” 방법은 연습용 예시입니다.
다른 에이전트로 같은 작업 해 보기
같은 일을 AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램) 둘에게 차례로 맡겨 봅니다. 에이전트를 바꿔도 ego(lite) 브라우저와 로그인, 일하는 방식은 그대로라는 것을 눈으로 확인하는 실습입니다.
- 같은 문장을 두 에이전트에 보내 결과를 나란히 비교합니다.
- 에이전트마다 달라지는 세 가지(스킬을 읽는 폴더 · 권한 설정 이름 · 스킬을 부르는 입력)를 구분합니다.
- 다른 에이전트가 없을 때 같은 에이전트의 데스크톱 앱과 터미널 화면으로 같은 확인을 합니다.
예상 소요 시간: 20~30분 (두 번째 에이전트가 이미 설치·로그인되어 있을 때)
준비물을 확인한 뒤 따라 하기를 진행하세요. 막히면 막히면에서 같은 증상을 찾습니다. 두 번째 에이전트가 없다면 데스크톱 앱 ↔ 터미널 화면으로 대신합니다.
준비물과 완료 기준
- 시작 전 준비를 마친 ego(lite)와, 실습 1에서 쓰던 에이전트 하나. 이 에이전트를 “첫 번째 에이전트”라고 부르겠습니다.
- 두 번째 에이전트 — Claude Code, Codex, Cursor 가운데 내 컴퓨터에 설치되어 있고 로그인된 다른 하나. 이 실습을 위해 새로 설치할 필요는 없습니다.
- 결과를 적어 둘 메모장. 첫 번째 결과의 첫 글과 링크를 적어 두었다가 두 번째 결과와 견줍니다.
맡길 일은 ego(lite) 문서가 에이전트 안내마다 똑같이 쓰는 작은 예시입니다. Anthropic의 X 프로필을 열어 글 다섯 개를 읽어 오는 일입니다.
두 에이전트가 모두 글 다섯 개를 대화창에 돌려주고, 두 번 모두 ego(lite) 안에 Anthropic의 X 프로필이 열린 채 남아 있으면 완료입니다. 그 사이에 ego(lite)를 다시 설치하거나 설정을 바꾸지 않았다는 점을 확인합니다.
따라 하기
1단계 · 첫 번째 에이전트에 공통 작업 맡기기
지금 쓰는 에이전트에서 새 대화를 열고, 실습 1에서 하던 방법으로 ego-browser 스킬(Skill — 에이전트에게 주는 사용 설명서 묶음)을 불러온 뒤 아래 문장을 보냅니다. ego(lite) 문서가 여러 에이전트 안내에서 똑같이 쓰는 작업입니다.
Use the ego-browser Skill to open Anthropic's official X profile and collect the first five posts shown in the Posts feed.
뜻: ego-browser 스킬을 써서 Anthropic의 공식 X 프로필을 열고, Posts(게시물) 목록에 보이는 처음 다섯 개 글을 모아 줘.
에이전트가 ego-browser로 ego(lite)에서 대상 페이지를 열고, 요청한 정보를 모아, 작업이 끝나면 결과를 돌려줍니다. 그동안 내 탭은 건드리지 않습니다.
확인: ego(lite)에 에이전트 Space가 생기고 그 안에 Anthropic의 X 프로필이 열립니다. 대화창에는 글 다섯 개가 돌아옵니다. X가 로그인이나 인증을 요구하면 막히면의 첫 줄을 먼저 봅니다.
2단계 · 결과와 열린 페이지 적어 두기
답이 오면 닫지 말고 두 가지를 적습니다. 돌아오는 내용은 에이전트마다 조금 다릅니다.
| 에이전트 | 문서가 설명하는 결과 |
|---|---|
| Claude Code | 글 다섯 개와 각 글의 링크, 페이지에 보이는 좋아요 수, 주요 주제를 간추린 요약 |
| Codex · Cursor | 글 다섯 개의 보이는 내용, 글로 바로 가는 링크, 글마다 짧은 요약 |
- 첫 글의 링크와 첫 문장을 메모나중에 두 번째 결과와 견줄 기준입니다. 다섯 개를 다 적을 필요는 없습니다.
- ego(lite)에서 에이전트 Space 열어 보기작업이 끝나도 Anthropic의 X 프로필은 ego(lite)에 열린 채 남습니다. 에이전트가 어느 페이지를 보고 답했는지 확인할 수 있게 하기 위해서입니다.
2. 글 내용 한두 줄 — 링크
… (다섯 개)
끝에 요약이 붙습니다. 실제 글과 표현은 실행할 때마다 다릅니다.
확인: 메모에 첫 글의 링크가 있고, ego(lite)의 에이전트 Space에 X 프로필 페이지가 보입니다.
3단계 · 두 번째 에이전트 준비하기
ego(lite)는 그대로 두고 두 번째 에이전트만 준비합니다. 아래에서 두 번째로 쓸 에이전트의 탭을 고르세요. 탭마다 먼저 할 준비 한 가지가 있고, 그 아래 표의 세 줄이 에이전트마다 달라지는 것입니다. 폴더 줄은 알아 두기만 하면 되고, 내가 직접 하는 일은 권한 설정과 스킬 부르기입니다.
먼저: 데스크톱 앱에는 Cowork와 Code 두 모드가 있습니다. ego-browser 스킬은 Code용이라 Cowork의 스킬 메뉴에는 나오지 않습니다. 왼쪽 위 모드 전환 메뉴에서 Cowork를 Code로 바꾸고, 프로젝트나 폴더를 하나 연 뒤 아래 표로 갑니다.
| 스킬을 읽는 폴더 | ~/.claude/skills/ — 첫 실행 설정(onboarding)이 ego-browser 스킬을 여기에 써 둡니다. |
| 권한 설정 | 대화 입력 칸 옆의 권한 선택 메뉴에서 Bypass permissions(승인 없이 실행)를 고릅니다. |
| 스킬을 부르는 입력 | /ego-browser를 입력하고 목록에서 스킬을 고릅니다. |
먼저: ChatGPT 데스크톱 앱(예전 Codex 데스크톱 앱)을 쓴다면 왼쪽 위의 모드를 Codex로 바꿉니다. 그다음 프로젝트를 열고 새 작업을 시작한 뒤 아래 표로 갑니다.
| 스킬을 읽는 폴더 | ~/.agents/skills/ — 첫 실행 설정이 ego-browser 스킬을 여기에 써 둡니다. |
| 권한 설정 | 대화 입력 칸 왼쪽 아래의 권한 선택 메뉴에서 Full access(전체 접근)를 고르고 경고를 확인합니다. |
| 스킬을 부르는 입력 | /ego를 입력하고 스킬 목록에서 ego-browser를 고릅니다. /ego-browser를 입력하고 Tab을 눌러도 됩니다. |
먼저: 믿을 수 있는 프로젝트나 폴더를 Cursor에서 엽니다. Cursor에는 자체 Browser 창이 따로 있지만, 이 실습은 그것이 아니라 ego-browser 스킬로 ego(lite)를 여는 길을 씁니다.
| 스킬을 읽는 폴더 | ~/.agents/skills/ — 첫 실행 설정이 ego-browser 스킬을 여기에 써 둡니다. |
| 권한 설정 | Settings → Agents → Approvals & Execution(설정 → 에이전트 → 승인과 실행)에서 Run Everything(모두 실행)을 고릅니다. |
| 스킬을 부르는 입력 | Agent 패널을 열고 입력 칸에 /ego를 입력한 뒤 ego-browser를 고릅니다. |
첫 실행 설정을 하는 동안 그 에이전트가 열려 있었다면 스킬 목록이 예전 그대로일 수 있습니다. 에이전트를 완전히 종료했다가 다시 열면 목록이 새로 읽힙니다.
확인: 두 번째 에이전트의 입력 칸에서 ego-browser 스킬이 골라지고, 권한 설정이 위 표의 이름(Bypass permissions · Full access · Run Everything 가운데 내 에이전트의 것)으로 골라져 있습니다.
4단계 · 두 번째 에이전트에 같은 문장 보내기
스킬을 고른 상태에서 1단계와 글자 하나 다르지 않은 문장을 보냅니다.
Use the ego-browser Skill to open Anthropic's official X profile and collect the first five posts shown in the Posts feed.
뜻: ego-browser 스킬을 써서 Anthropic의 공식 X 프로필을 열고, Posts 목록에 보이는 처음 다섯 개 글을 모아 줘.
이번에도 에이전트는 ego(lite)의 에이전트 Space에서 페이지를 엽니다. 내 탭을 넘겨받지 않습니다.
확인: 두 번째 에이전트의 대화창에 글 다섯 개가 돌아오고, ego(lite)에 Anthropic의 X 프로필이 열려 있습니다.
5단계 · 달라진 것과 그대로인 것 가려내기
2단계의 메모와 두 번째 결과를 나란히 놓고 아래 그림의 양쪽을 하나씩 짚어 봅니다.
- 달라진 것 — 권한 설정의 이름과 위치, 스킬을 부르는 입력, 결과에 붙는 세부(좋아요 수가 붙는지, 요약이 글마다 붙는지).
- 그대로인 것 — ego(lite)에 로그인해 둔 사이트는 어느 에이전트가 열어도 보통 로그인된 상태로 열립니다. 일은 에이전트 Space에서 이루어지고, 끝난 뒤에도 페이지가 열려 있습니다.
두 결과의 글 목록이 조금 다를 수 있습니다. 두 실행 사이에 새 글이 올라왔을 수도 있고, 에이전트마다 간추리는 방식이 다르기 때문입니다. 어느 쪽이 맞는지는 ego(lite)에 열려 있는 X 프로필과 직접 견주어 확인합니다.
확인: 메모의 첫 글 링크를 두 번째 결과에서 찾았거나, 다르다면 열린 페이지에서 그 이유(새 글)를 확인했습니다. 그 사이에 ego(lite)를 다시 설정한 적이 없습니다.
두 번째 에이전트가 없다면 — 데스크톱 앱 ↔ 터미널 화면
Claude Code와 Codex는 데스크톱 앱과 TUI(터미널 안에서 글자로 쓰는 화면) 두 가지 모습이 있습니다. 한쪽에서 1~2단계를 했다면 다른 쪽에서 4단계를 하면 됩니다. 쓰는 스킬과 보내는 문장은 같고, 권한을 주는 방법만 다릅니다. Cursor 문서에는 터미널 화면 안내가 없으므로 여기서는 다루지 않습니다. 아래 탭은 터미널 화면 쪽 순서입니다(데스크톱 앱 쪽은 3단계의 탭). 터미널 화면을 쓰려면 그 에이전트의 터미널용 프로그램(Codex 문서의 표현으로는 Codex CLI)이 이미 설치되어 있어야 합니다. 없다면 이 대안은 건너뜁니다.
터미널에서 아래 명령으로 Claude Code를 시작합니다.
claude --dangerously-skip-permissions
화면이 열리면 상태 줄에 bypass permissions on이 표시됩니다. 그다음 /ego-browser를 입력하고, 스킬 이름 뒤에 한 칸을 띄운 뒤 같은 메시지 안에 작업 문장을 이어 써서 보냅니다.
프로젝트 폴더에서 터미널을 열고 아래 명령을 실행합니다. 승인 요청과 샌드박스(격리된 실행 칸)를 건너뛴 채로 Codex를 시작하는 명령입니다.
codex --dangerously-bypass-approvals-and-sandbox
화면이 열리면 /ego를 입력해 ego-browser를 고르고 작업 문장을 덧붙입니다. ChatGPT 데스크톱 앱에서 하던 “Codex 모드로 바꾸기”는 TUI에서는 건너뜁니다.
두 명령 모두 에이전트가 명령을 실행할 때마다 묻지 않게 만듭니다. 믿을 수 있는 에이전트·폴더·작업에만 켭니다. 한 에이전트의 명령을 다른 에이전트에 그대로 옮겨 쓰지 않습니다.
막히면
| 증상 | 해 볼 것과 확인 기준 |
|---|---|
| X가 로그인이나 계정 인증을 요구함 | ego(lite)의 에이전트 Space에 들어가 로그인이나 인증을 내가 직접 끝냅니다. 그런 다음 에이전트에게 같은 Space에서 이어 하라고 말합니다. 비밀번호나 인증 코드를 대화창에 붙여 넣지 않습니다. 넘겨받는 방법은 실습 2, 자세한 대처는 실습 10. |
| 두 번째 에이전트에서 스킬이 안 보임 | ego(lite)의 첫 실행 설정을 끝냈는지 확인하고, 에이전트를 완전히 종료했다가 다시 엽니다. Claude Code라면 Cowork가 아니라 Code 모드인지 봅니다. 그래도 없으면 실습 9. |
| 스킬은 불러왔는데 ego(lite)가 열리지 않음 | 3단계 탭의 권한 설정이 켜져 있는지 봅니다. TUI라면 지금 세션을 닫고 위 명령으로 다시 시작합니다. 에이전트별 확인 위치는 가이드 5장 문제 해결. |
| Claude Code에 Bypass permissions가 없음 | Settings → Claude Code에서 Allow bypass permissions mode(승인 없이 실행 모드 허용)를 켭니다. Team·Enterprise 정책이 이 선택지를 숨길 수 있으니, 잠겨 있으면 관리자에게 문의합니다. |
| Cursor에 Run Everything이 다른 이름으로 보임 | Cursor 3.6 이상은 Settings → Agents → Approvals & Execution → Run Everything입니다. 예전 화면에서는 Ask Every Time 대신 Run Everything (Unsandboxed)를 고릅니다. |
로그인을 직접 끝낸 뒤 에이전트에게 보낼 문장의 예시입니다(문서에 있는 문장이 아니라 이 실습용으로 만든 것입니다).
I finished the login in the agent Space. Continue the task in the same Space.
뜻: 에이전트 Space에서 로그인을 끝냈어. 같은 Space에서 작업을 이어서 해 줘.
다음에 할 것
- 스킬이 안 보이거나 ego(lite)가 열리지 않아 실습을 끝내지 못했다면 실습 9 — 막힘 해결 ①로 갑니다.
- 세 에이전트 말고 OpenCode, WorkBuddy, Hermes Agent, OpenClaw, DeepSeek Harness를 쓴다면 가이드 5장 에이전트별 한눈 표에서 같은 세 줄을 찾습니다.
- 에이전트별 전체 순서는 Claude Code · Codex · Cursor 소절에 있습니다.
- 같은 문장을 두 에이전트에 보내면 둘 다 ego(lite)의 에이전트 Space에서 같은 페이지를 열고 결과를 돌려줍니다.
- 에이전트마다 다시 챙길 것은 세 가지 — 스킬을 읽는 폴더, 권한 설정의 이름, 스킬을 부르는 입력입니다.
- ego(lite) 브라우저, 로그인해 둔 사이트, Space에서 일하는 방식은 에이전트를 바꿔도 그대로입니다.
- 두 번째 에이전트가 없으면 Claude Code나 Codex의 데스크톱 앱과 터미널 화면으로 같은 확인을 합니다.
- 사이트가 로그인·인증을 요구하면 에이전트 Space에서 내가 직접 처리합니다. 비밀번호와 인증 코드는 대화창에 넣지 않습니다.
출처: lite.ego.app/document/en/docs/claude-code · codex · cursor · custom-agent-harness(공통 작업 문장) · space(로그인 상태). 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준. 가이드 5장 에이전트별 연결 방법. “로그인을 끝냈어” 문장과 결과 모양 상자는 실습용 예시입니다.
막힘 해결 ① — 스킬이 안 보이거나 ego(lite)가 안 열릴 때
에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)와 ego(lite)가 이어지지 않을 때, 원인을 위에서부터 하나씩 좁혀 가는 순서입니다. 스킬이 목록에 없는 경우와, 스킬은 불러왔는데 브라우저가 열리지 않는 경우는 원인이 다릅니다.
- 증상을 “스킬이 안 보인다 / ego(lite)가 안 열린다 / 승인을 계속 묻는다 / 다른 기기에서 돈다”로 구분합니다.
- 내가 쓰는 에이전트에서 스킬 폴더와 권한 설정을 어디서 확인하는지 찾습니다.
- 연결 시험 문장 하나로 고쳐졌는지 확인합니다.
예상 소요 시간: 10~30분 (원인이 앞 단계에서 잡힐수록 짧습니다)
준비물과 완료 기준
- 설치를 마친 ego(lite)와, 연결이 안 되는 에이전트. 설치 자체를 아직 안 했다면 시작 전 준비가 먼저입니다.
- 증상 메모 한 줄 — 에이전트 이름, 데스크톱 앱인지 TUI(터미널 안에서 글자로 쓰는 화면)인지, 어디서 멈췄는지. 예: “Codex 데스크톱 앱 / 스킬은 골라짐 / ego(lite)가 안 뜸”.
5단계의 연결 시험 문장을 보냈을 때 ego(lite)가 에이전트 Space(스페이스 — 에이전트 전용 작업 공간)를 열고, 페이지가 뜨고, 에이전트가 페이지 제목을 돌려주면 완료입니다.
따라 하기
1단계 · 스킬이 안 보일 때 — 첫 실행 설정과 완전히 다시 열기
ego-browser 스킬(Skill — 에이전트에게 주는 사용 설명서 묶음)은 ego(lite)의 첫 실행 설정(onboarding)이 내 컴퓨터에 써 넣습니다. 그래서 에이전트 문서들이 먼저 확인하라는 것은 둘입니다. 첫 실행 설정을 끝냈는지, 그리고 설정하는 동안 에이전트가 켜져 있어서 목록이 예전 그대로인 것은 아닌지입니다.
- ego(lite)를 열어 첫 실행 설정을 끝까지 마치기중간에 닫았다면 다시 열어 마칩니다.
- 에이전트 앱을 완전히 종료하고 다시 열기지금 대화나 창만 닫아서는 스킬이 다시 읽히지 않을 수 있습니다. 앱 자체를 끝냈다가 다시 실행합니다.
- 입력 칸에
/ego-browser입력하기목록에 ego-browser가 나오는지 봅니다. Claude Code · Codex · Cursor는/ego까지만 입력해도 됩니다. OpenClaw는/ego가 통하지 않으니 2단계 끝의 “목록에 없어도 쓸 수 있는 경우” 상자를 봅니다.
Claude 데스크톱 앱의 Cowork와 Code는 서로 다른 모드입니다. ego-browser 스킬은 Code용이라 Cowork의 스킬 메뉴에는 나오지 않습니다. Cowork에서 안 보인다고 설치가 실패한 것은 아닙니다. 왼쪽 위 모드 전환 메뉴에서 Code로 바꾸고 다시 찾아봅니다.
확인: /ego-browser(Claude Code · Codex · Cursor는 /ego)를 입력하면 ego-browser가 목록에 나옵니다. 나오면 5단계의 연결 시험으로 건너뜁니다.
2단계 · 스킬 폴더에 SKILL.md가 있는지 보기
다시 열어도 없다면, 에이전트가 스킬을 읽는 폴더에 ego-browser 폴더와 그 안의 SKILL.md(스킬의 설명서 파일)가 실제로 들어 있는지 봅니다. 폴더는 에이전트마다 다릅니다. 경로 맨 앞의 ~는 내 홈 폴더(내 계정의 기본 폴더)를 뜻합니다.
| 에이전트 | 스킬이 있어야 하는 곳 | 함께 볼 것 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | Cowork가 아니라 Code 모드인지. |
| Codex · Cursor · OpenCode | ~/.agents/skills/ | 첫 실행 설정을 마치고 에이전트를 종료했다가 다시 엽니다. |
| WorkBuddy | ~/.codebuddy/skills/ego-browser/SKILL.md | WorkBuddy는 이 폴더에서 스킬을 읽습니다. 없으면 아래 접힌 상자의 명령으로 복사한 뒤 완전히 종료하고 다시 엽니다. |
| Hermes Agent | ~/.hermes/skills/ego-browser/SKILL.md | 없으면 복사한 뒤 Hermes를 다시 시작합니다. 열려 있는 TUI에서는 /reload-skills를 실행하고 새 세션을 시작해도 됩니다. |
| OpenClaw | ~/.agents/skills/ego-browser/SKILL.md | 데스크톱 앱의 Settings → Skills(설정 → 스킬)에서 Refresh(새로 고침)를 누르고 ego-browser가 켜져 있는지 본 뒤 새 세션을 시작합니다. |
| DeepSeek Harness | ~/.agents/skills/ego-browser/SKILL.md | 일하려는 프로젝트 폴더에서 시작하고 새 세션을 만듭니다. <project>/.agents/skills/도 함께 읽습니다. |
파일이 있는지 직접 찾기 어렵다면 에이전트에게 읽어 보게 합니다. 아래는 이 실습용으로 만든 예시 문장입니다.
Read ~/.agents/skills/ego-browser/SKILL.md and tell me whether the file exists.
뜻: ~/.agents/skills/ego-browser/SKILL.md 를 읽고, 그 파일이 있는지 알려 줘. (경로는 위 표에서 내 에이전트의 것으로 바꿉니다.)
WorkBuddy · Hermes Agent — 스킬 복사 명령
ego(lite)는 ego-browser를 ~/.agents/skills/ 아래에 설치하는데, 두 에이전트는 자기 폴더에서 스킬을 읽습니다. /ego-browser가 안 나오면 문서가 안내하는 아래 명령을 터미널(명령을 글자로 입력해 실행하는 앱)에 붙여 넣어 실행해 복사하고, 에이전트를 다시 시작합니다.
mkdir -p ~/.codebuddy/skills/ego-browser
cp -R ~/.agents/skills/ego-browser/. ~/.codebuddy/skills/ego-browser/
WorkBuddy(CodeBuddy Code)용입니다.
mkdir -p ~/.hermes/skills/ego-browser
cp -R ~/.agents/skills/ego-browser/. ~/.hermes/skills/ego-browser/
Hermes Agent용입니다.
/ego-browser 같은 슬래시 명령은 에이전트 프로그램의 화면 기능이지 ego(lite)가 요구하는 조건이 아닙니다. OpenClaw에서는 /ego가 명령 목록에 없는 것이 정상입니다 — 데스크톱 앱에서는 /skill ego를 입력해 /ego_browser를 고르고, TUI에서는 /skill ego-browser를 씁니다. 슬래시 명령이 아예 없는 에이전트 프로그램이라면 SKILL.md를 읽으라고 말로 부탁하면 됩니다.
확인: 표의 경로에 SKILL.md가 있고, 에이전트를 다시 연 뒤 스킬이 골라집니다.
3단계 · 스킬은 불러왔는데 ego(lite)가 안 열릴 때 — 권한 확인
스킬은 사용 설명서일 뿐입니다. ego(lite)를 실제로 띄우려면 에이전트가 내 컴퓨터에서 명령을 실행할 수 있어야 합니다. 예를 들어 Codex 문서는 Full access가 없으면 실행이 샌드박스(격리된 실행 칸)에 막히거나 승인 요청에서 멈출 수 있다고 설명합니다. 내 에이전트의 줄을 찾아 지금 상태를 확인합니다.
| 에이전트 | 데스크톱 앱 · 화면 | 터미널 |
|---|---|---|
| Claude Code | 입력 칸 옆 권한 선택 메뉴에서 Bypass permissions | 세션을 닫고 claude --dangerously-skip-permissions |
| Codex | 입력 칸 옆에 Full access가 보이는지 | 세션을 닫고 codex --dangerously-bypass-approvals-and-sandbox |
| Cursor | Settings → Agents → Approvals & Execution → Run Everything (3.6 이상). 예전 화면은 Ask Every Time 대신 Run Everything (Unsandboxed) | 문서에 안내 없음 |
| OpenCode | Settings → General → Auto-accept permissions | 세션을 닫고 opencode --auto |
| WorkBuddy | 권한 메뉴에 Allow full access가 보이는지 | 세션을 닫고 CodeBuddy Code를 --dangerously-skip-permissions로 다시 시작 |
| Hermes Agent | Settings → Safety → Approval Mode가 Smart인지 | 세션을 닫고 hermes --tui --yolo |
| OpenClaw | Exec Approvals의 세 설정 (가이드 5장 OpenClaw) | 세션을 끝내고 openclaw exec-policy preset yolo 실행 후 openclaw tui |
| DeepSeek Harness | Web UI의 현재 세션에 Full access가 보이는지 | 같은 명령 안에서 dsh 앞에 DSH_PERMISSION_MODE=danger-full-access가 있는지 |
위 설정은 에이전트마다 따로입니다. 한 제품의 명령이나 옵션을 다른 제품에 그대로 쓰지 않습니다. 또 이 설정들은 에이전트가 내 컴퓨터에서 할 수 있는 일을 넓히므로, 믿을 수 있는 에이전트·작업 폴더·작업에만 켭니다.
확인: 표에 적힌 이름이 화면에 보입니다. Claude Code TUI라면 상태 줄에 bypass permissions on이 표시됩니다. 그다음 5단계의 연결 시험을 합니다.
4단계 · ego-browser 명령이 보이는지 확인
권한도 맞는데 열리지 않으면, 브라우저 작업을 맡길 바로 그 대화에서 에이전트에게 아래 명령을 실행하게 합니다.
command -v ego-browser
뜻: ego-browser 라는 명령이 어디에 있는지 경로를 보여 줘. 에이전트에게는 “Run command -v ego-browser in this session and show me the output.”(예시 문장)처럼 부탁합니다.
- 경로가 나온다 — 이 대화가 ego-browser를 찾을 수 있다는 뜻입니다. 다만 명령이 내 컴퓨터에서 실행된다는 증명까지는 아닙니다. 그 확인은 5단계가 합니다.
- 아무것도 안 나온다 — 먼저 ego(lite) 첫 실행 설정이 끝났는지 보고, 에이전트를 다시 시작한 뒤 브라우저 작업을 맡길 그 대화에서 한 번 더 실행합니다. 평소 쓰는 터미널에서는 되는데 에이전트에서만 안 된다면, 둘의 PATH(명령을 찾는 폴더 목록)와 실행 환경이 다른지 비교합니다.
이 확인은 매번 할 필요가 없습니다. 문서는 첫 실행이 실제로 오류를 냈을 때만 이런 사전 점검을 하라고 안내합니다.
확인: 명령이 경로 한 줄을 돌려줍니다.
5단계 · 연결 시험 — 공개 페이지 하나 열기
로그인이 필요한 사이트로 가기 전에, 누구나 볼 수 있는 간단한 페이지로 연결만 시험합니다. 문서가 주는 문장 그대로입니다.
Use the ego-browser Skill to open https://example.com in ego (lite), report the page title, and leave the page open.
뜻: ego-browser 스킬을 써서 ego(lite)에서 https://example.com 을 열고, 페이지 제목을 알려 주고, 페이지는 열어 둬.
확인: ego(lite)가 에이전트 Space를 열고, 페이지가 뜨고, 에이전트가 페이지 제목을 돌려줍니다. 여기까지 되면 연결은 정상입니다.
6단계 · 승인만 계속 묻는가, 다른 기기에서 도는가
5단계가 통과하지 못했다면 둘을 구분합니다. 묻는 것과 갇힌 것은 다른 문제입니다.
- 에이전트가 계속 승인을 묻는다 — 승인 정책이 적용되고 있다는 뜻일 뿐, 에이전트가 샌드박스에 갇혔다는 증거는 아닙니다. 승인한 뒤 ego(lite)가 열리면, 계속 직접 승인하거나 믿을 수 있는 세션에 한해 그 제품 문서에 있는 “승인 없이 실행” 설정을 씁니다.
- 승인해도 내 컴퓨터에 닿지 않는다 — 호스트 실행(명령이 ego(lite)가 설치된 바로 그 컴퓨터에서 실행되는 것) 권한이나 호스트로 잇는 다리(host bridge — 격리된 곳의 에이전트가 내 컴퓨터에서 명령을 실행하게 해 주는 연결)를 확인합니다. 거꾸로, 승인 묻기를 꺼 두었다고 호스트 실행이 되는 것도 아닙니다.
- 에이전트가 Docker · SSH · 클라우드에서 돈다 — Docker(프로그램을 격리된 상자에 담아 돌리는 도구), SSH(다른 컴퓨터에 원격으로 접속하는 방법), 클라우드 같은 원격 실행 환경은 호스트로 잇는 다리 없이는 내 컴퓨터의 ego(lite)를 조종할 수 없습니다. 그곳에 스킬을 설치하거나 불러오는 것만으로는 부족합니다.
다른 기기에서 돈다면 길은 셋입니다. 에이전트 프로그램을 내 컴퓨터에서 직접 돌리거나, 그 프로그램이 지원하는 다리를 설정하거나, 에이전트가 도는 그 기기에 맞는 브라우저 환경을 설치해 거기서 돌립니다. 에이전트가 어디서 도는지 모르겠다면 문서의 점검 문장을 첫 메시지로 보냅니다.
First determine whether your command runtime is running directly on this computer or inside a sandbox, container, or remote environment. If it uses a sandbox, confirm that you have an official permission or bridge that lets commands run on this computer. Do not treat disabled approval prompts as proof of host execution.
Then locate and read the ego-browser Skill. First check ~/.agents/skills/ego-browser/SKILL.md. If you cannot execute ego-browser on this computer, stop and explain what host-execution permission or bridge is missing.
뜻: 먼저 네 명령이 이 컴퓨터에서 바로 실행되는지, 샌드박스·컨테이너·원격 환경 안에서 실행되는지 판단해 줘. 샌드박스를 쓴다면 이 컴퓨터에서 명령을 실행하게 해 주는 공식 권한이나 다리가 있는지 확인해 줘. 승인 묻기가 꺼져 있다는 것을 호스트 실행의 증거로 삼지 마. 그다음 ego-browser 스킬을 찾아 읽어 줘(먼저 ~/.agents/skills/ego-browser/SKILL.md). 이 컴퓨터에서 ego-browser를 실행할 수 없다면 멈추고, 어떤 호스트 실행 권한이나 다리가 빠졌는지 설명해 줘.
확인: 에이전트가 자기 실행 위치를 답하고, 조치 뒤 5단계의 연결 시험이 통과합니다.
막히면
에이전트 문서마다 따로 적힌 증상을 모았습니다. 내 에이전트 이름이 붙은 줄만 보면 됩니다.
| 에이전트 | 증상 | 해 볼 것 |
|---|---|---|
| Claude Code | Bypass permissions가 선택지에 없음 | Settings → Claude Code에서 Allow bypass permissions mode를 켭니다. Team·Enterprise 정책이 숨길 수 있으니 잠겨 있으면 관리자에게 문의합니다. |
| Claude Code | 권한도 켰는데 끝내 조종이 안 됨 | 문서는 Discord로 문의해 달라고 안내합니다. |
| OpenCode · WorkBuddy · Hermes Agent | TUI가 엉뚱한 프로젝트에서 열림 | 종료하고 터미널에서 맞는 프로젝트 폴더로 옮긴 뒤 다시 실행합니다(OpenCode opencode --auto, Hermes hermes --tui --yolo). 실행한 폴더가 작업 폴더가 됩니다. |
| WorkBuddy | 터미널이 codebuddy 명령을 못 찾음 | WorkBuddy 앱에 들어 있는 CLI(터미널에서 명령으로 쓰는 프로그램)를 codebuddy 대신 전체 경로 /Applications/WorkBuddy AI.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy로 실행하거나(경로에 빈칸이 있어 문서의 명령은 경로 전체를 큰따옴표로 감쌉니다), 짧은 codebuddy 명령을 쓰려면 CodeBuddy Code를 전역(어느 폴더에서나 쓸 수 있게)으로 먼저 설치합니다. |
| Hermes Agent | /ego-browserUse 같은 모르는 명령이라고 함 | /ego-browser 뒤에 한 칸을 띄우거나, 제안 목록에서 스킬을 먼저 고른 뒤 작업을 씁니다. 띄우지 않으면 스킬 이름과 작업의 첫 단어를 한 명령으로 읽습니다. |
| OpenClaw | TUI가 Gateway에 연결하지 못함 | openclaw gateway status로 상태를 보고, 꺼져 있으면 openclaw gateway start로 켠 뒤 openclaw tui를 다시 실행합니다. |
| DeepSeek Harness | 터미널이 dsh를 못 찾음 | 패키지 실행 형태(npx @deepseek-ai/dsh)로 바꿉니다. 전체 명령은 가이드 5장 DeepSeek Harness. |
| 직접 만든 에이전트 | Bypass permissions 같은 설정이 아예 없음 | 정상일 수 있습니다. 명령이 이미 샌드박스 없이 내 컴퓨터에서 실행된다면 넓힐 권한이 없습니다. 4단계와 5단계로 확인하고, 명령마다 승인만 묻는다면 직접 승인하면 됩니다. 가이드 6장 문제 해결. |
다음에 할 것
- 연결 시험이 통과했다면 하던 실습으로 돌아갑니다. 처음이라면 실습 1.
- 연결은 되는데 작업 도중 로그인 요구나 번호표 오류로 막힌다면 실습 10 — 막힘 해결 ②.
- 더 자세한 설명: 가이드 5장 에이전트별 문제 해결 · 6장 명령이 어디서 실행되나 · 6장 연결 시험.
- 스킬이 안 보이면 — 첫 실행 설정을 마치고, 에이전트를 완전히 종료했다가 다시 열고, 스킬 폴더에 SKILL.md가 있는지 봅니다.
- 스킬은 불러왔는데 ego(lite)가 안 열리면 — 에이전트별 권한 설정을 확인합니다. 이름과 위치는 에이전트마다 다르고, 서로 옮겨 쓰지 않습니다.
- 고쳤는지는 example.com 연결 시험으로 확인합니다. Space가 열리고 제목이 돌아오면 정상입니다.
- 계속 승인을 묻는 것은 승인 정책일 뿐, 갇혔다는 증거가 아닙니다.
- 에이전트가 다른 기기에서 돈다면 내 컴퓨터로 잇는 다리가 있어야 합니다. 스킬을 불러오는 것만으로는 닿지 않습니다.
출처: lite.ego.app/document/en/docs/custom-agent-harness(Step 1 · Step 3 점검 문장 · Step 4 · Troubleshooting) · claude-code · codex · cursor · opencode · workbuddy · hermes-agent · openclaw · deepseek-harness(각 Troubleshooting) · ego-browser(Notes). 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준. SKILL.md를 읽어 보라는 문장과 command -v 를 부탁하는 문장은 실습용 예시입니다.
막힘 해결 ② — 로그인·인증 요구, 번호표 오류, 결과가 이상할 때
에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)와 ego(lite)는 잘 이어졌는데, 작업 도중 페이지 쪽에서 막히는 경우입니다. 다섯 가지 상황마다 내가 할 일과 에이전트에게 보낼 한 문장을 정리했습니다.
- 사이트가 로그인·인증을 요구하면 에이전트 Space에서 직접 처리하고 이어 하게 합니다.
- 번호표 오류나 미심쩍은 결과에는 “지금 페이지를 다시 읽게” 합니다.
- 에이전트가 읽지 못하는 내용과 넘으면 안 되는 선을 분명히 말해 줍니다.
예상 소요 시간: 상황 하나에 3~5분 (전체를 한 번 읽어 두는 데 15분)
준비물과 완료 기준
- 작업을 맡긴 에이전트 대화와, 그 작업이 열려 있는 에이전트 Space(스페이스 — 에이전트 전용 작업 공간). 연습이라면 실습 1이나 실습 4의 작업을 다시 맡겨도 됩니다.
- 에이전트 Space에 들어가 직접 조작하는 방법. 아직 해 보지 않았다면 실습 2가 먼저입니다.
- ego(lite)가 아예 열리지 않거나 스킬이 안 보이는 문제는 여기가 아니라 실습 9에서 다룹니다.
내 상황이 다섯 가지 중 어느 것인지 고르고, 그 단계의 문장을 보낸 뒤, 에이전트가 지금 페이지를 근거로 작업을 이어 가거나 멈춰서 내 확인을 기다리면 완료입니다.
따라 하기
1단계 · 사이트가 로그인·인증·CAPTCHA를 요구할 때
보이는 것: 에이전트가 멈추고 “로그인이 필요하다”고 알리거나, 에이전트 Space에 로그인 화면·인증 번호 입력 칸·CAPTCHA(사람인지 확인하는 검사)가 떠 있습니다.
할 일: ego(lite)의 그 에이전트 Space에 들어가 로그인이나 인증을 내가 직접 끝냅니다. 그런 다음 대화창으로 돌아와 이어 하라고 말합니다. ego(lite)는 CAPTCHA나 사이트의 보안 확인을 우회하지 않으므로, 이 단계는 사람이 합니다.
이어 하라고 말하는 문장의 예시입니다(문서에 있는 문장이 아니라 이 실습용으로 만든 것입니다).
I finished the login in the agent Space. Continue the task in the same Space.
뜻: 에이전트 Space에서 로그인을 끝냈어. 같은 Space에서 작업을 이어서 해 줘.
에이전트에게 대신 입력하라고 비밀번호나 인증 코드를 보내지 마세요. 로그인은 언제나 에이전트 Space의 사이트 화면에서 내가 직접 합니다.
에이전트가 멈추고 나를 불러야 하는 상황 목록
- 문자·이메일 인증 코드, QR 코드 로그인, 하드웨어 보안 키.
- 결제, 주문, 송금, 환불.
- 게시, 삭제, 보관처럼 되돌리기 어려운 수정이나 한꺼번에 여러 건을 바꾸는 일.
- 다른 앱이 내 계정에 접근하도록 허용하는 일.
자세한 설명은 가이드 2장 로그인 상태와 멈춰야 하는 순간.
확인: 에이전트가 로그인 뒤의 페이지에서 작업을 이어 가고, 대화창에는 비밀번호나 코드가 한 글자도 남아 있지 않습니다.
2단계 · 번호표가 유효하지 않다고 할 때 (Unknown ref)
보이는 것: 에이전트가 번호표(@1, @2 … — 누를 수 있는 요소에 붙는 임시 번호)가 유효하지 않다거나 Unknown ref라고 알립니다.
왜 생기나: 번호표는 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전)을 찍은 그 순간에만 맞습니다. 그 뒤에 페이지가 바뀌면 옛 번호가 가리키는 곳이 없어질 수 있습니다. 고장이 아니라 페이지가 달라졌다는 신호입니다.
문서가 꼽는 흔한 원인은 셋입니다.
- 그 요소가 화면 밖으로 스크롤되어 나갔습니다.
- 페이지의 구조가 다시 그려졌습니다.
- 앞에서는 “화면에 보이는 부분만” 스냅샷을 찍었고, 다음 스냅샷이 그 요소를 담지 못했습니다.
할 일: 스냅샷을 새로 찍으라고 합니다. 아래는 예시 문장입니다.
The page changed. Take a fresh snapshot of the current page and continue from there.
뜻: 페이지가 바뀌었어. 지금 페이지의 스냅샷을 새로 찍고 거기서부터 이어서 해 줘.
번호를 내가 외우거나 알려 줄 필요는 없습니다. 번호는 에이전트가 쓰는 것이고, 나는 목표와 경계를 정하면 됩니다. 원리는 가이드 3장 번호표와 4장 번호표가 통하는 범위에 있습니다.
확인: 에이전트가 “다시 스냅샷을 찍었다”고 알리고 다음 동작으로 넘어갑니다.
3단계 · 결과가 이상하거나 지어낸 것 같을 때
보이는 것: 답에 나온 숫자·제목이 내가 아는 것과 다르거나, 어디서 봤는지 근거가 없습니다.
할 일: “아까 답을 고쳐 줘”라고 하지 않습니다. 그러면 에이전트가 앞선 답에서 추측을 이어 갈 수 있습니다. 문서의 안내는 지금 페이지를 다시 스냅샷하게 하라는 것입니다. 스냅샷은 페이지를 읽기만 하고 아무것도 바꾸지 않으므로 몇 번을 다시 찍게 해도 됩니다. 아래는 예시 문장입니다.
Don't extrapolate from your earlier answer. Re-snapshot the current page and check the result again. Include titles, URLs, and timestamps I can verify.
뜻: 앞선 답에서 미루어 짐작하지 마. 지금 페이지를 다시 스냅샷해서 결과를 다시 확인해 줘. 내가 확인할 수 있는 제목, URL, 시각을 함께 적어 줘.
답이 다시 오면 아래 다섯 가지를 봅니다. 문서가 작업이 끝났을 때 확인하라고 꼽는 신호입니다.
- 어느 페이지를 방문했고 어떤 주요 동작을 했는지 말했나요?
- 내가 확인할 수 있는 것 — 제목, ID, URL, 금액, 시각 — 이 들어 있나요?
- 내려받기였다면 파일이 저장된 위치를 알려 주었나요?
- 수정하거나 제출하는 일이었다면 마지막 단계 전에 멈춰 확인을 받았나요?
- 관련 페이지가 Space에 아직 열려 있어 내가 볼 수 있나요?
한 일: 목록 열기 → 어제 날짜로 거르기
결과: (제목) · (ID) · (금액) · (시각)
괄호 자리에 실제 값이 있어야 Space에 열린 페이지와 견줄 수 있습니다.
확인: 답에 든 제목이나 URL 하나를 골라 에이전트 Space에 열려 있는 페이지에서 직접 찾았습니다. 작업이 끝나도 탭은 바로 닫히지 않고 남으므로 그대로 견줄 수 있습니다(언제까지 남는지). 대조하는 연습은 실습 3, 원리는 가이드 3장 결과 확인.
4단계 · 스냅샷이 읽지 못하는 내용일 때
보이는 것: 화면에는 분명히 있는 내용을 에이전트가 “보이지 않는다”고 하거나 빠뜨립니다.
왜 생기나: 스냅샷이 모든 것을 읽지는 못합니다. 문서가 꼽는 것은 넷입니다 — 화면 밖에 있는 내용, 이미지 속 글, 복잡한 canvas(그림판처럼 직접 그려 넣은 화면 영역), 샌드박스된 교차 출처 iframe(다른 사이트의 페이지를 격리해 끼워 넣은 칸). 이런 곳에서 에이전트는 스냅샷에 스크린샷, 글 추출, 사람의 확인을 섞어 씁니다.
할 일: 다른 방법을 쓰게 하고, 못 읽은 부분을 숨기지 말고 밝히게 합니다. 아래는 예시 문장입니다.
If the snapshot doesn't show that part, use a screenshot or text extraction, and tell me which parts you could not read.
뜻: 스냅샷에 그 부분이 안 나오면 스크린샷이나 글 추출을 써 줘. 그리고 읽지 못한 부분이 어디인지 알려 줘.
그래도 안 읽히는 값은 내가 에이전트 Space에서 직접 보고 알려 주면 됩니다. 이것이 “사람의 확인”입니다. 읽지 못하는 범위는 가이드 3장 스냅샷의 한계에 정리되어 있습니다.
확인: 에이전트가 어느 부분을 못 읽었는지 밝히고, 다른 방법으로 얻은 값이나 내게 확인을 부탁하는 질문을 돌려줍니다.
5단계 · 에이전트가 하면 안 되는 일을 하려 할 때
보이는 것: 읽기만 하라고 했는데 무언가를 누르려 하거나, 확인 없이 제출·삭제·보내기로 넘어가려 합니다.
왜 생기나: ego(lite)는 에이전트가 어떤 일을 해도 되는지 정해 주지 않습니다. 스냅샷은 에이전트가 페이지를 또렷이 보게 도울 뿐이고, 작업의 경계는 내가 정합니다. 처음 부탁에 경계가 없었다면 지금 다시 말합니다.
할 일: 먼저 멈추게 하고 경계를 다시 말합니다. 문서가 예로 드는 경계 표현은 read-only, don't modify(읽기만, 고치지 마)와 stop and confirm before submitting(제출하기 전에 멈추고 확인받아)입니다. 아래는 이 둘을 넣어 만든 예시 문장입니다.
Stop. This task is read-only, don't modify anything. Stop and confirm with me before submitting.
뜻: 멈춰. 이 작업은 읽기만 하는 거야, 아무것도 고치지 마. 제출하기 전에는 멈추고 나에게 확인받아.
급하면 말로 기다리지 말고 에이전트 Space에 들어가 내가 넘겨받습니다(실습 2). 다음 작업부터는 처음 부탁에 경계를 넣습니다. 문서의 작업 예시 두 개가 좋은 본보기입니다.
Open my GitHub Notifications and list the PRs that need my review — repo name, title, URL.
Don't archive, don't mark anything as read.
뜻: 내 GitHub 알림을 열어 내가 검토해야 하는 PR을 저장소 이름·제목·URL로 정리해 줘. 보관하지 말고, 읽음으로 표시하지도 마.
Open the orders dashboard, filter yesterday's orders, and download the CSV.
Pause if you hit a login challenge or an export confirmation, and tell me where the file landed.
뜻: 주문 관리 화면을 열어 어제 주문만 걸러 CSV로 내려받아 줘. 로그인 확인이나 내보내기 확인이 나오면 멈추고, 파일이 어디에 저장됐는지 알려 줘.
좋은 작업 설명에 들어가는 다섯 가지
- 대상 페이지나 사이트.
- 무엇을 읽고, 채우고, 누르고, 내려받을지.
- 하면 안 되는 것(삭제, 게시, 결제, 메일 보내기 등).
- CAPTCHA·결제·권한 허용 화면에서 멈출지.
- 받고 싶은 결과의 모양(표, 요약, 스크린샷, 저장된 파일 위치).
확인: 에이전트가 멈추고, 하려던 일을 설명하고, 내 확인을 기다립니다.
막히면
| 증상 | 해 볼 것과 확인 기준 |
|---|---|
| 로그인을 끝냈는데 에이전트가 계속 기다림 | 대화창에서 같은 Space에서 이어 하라고 분명히 말합니다. DeepSeek Harness 문서는 인증을 끝낸 뒤 작업을 다시 실행하라고 안내합니다. |
| 로그인되어 있을 줄 알았는데 로그인 화면이 나옴 | ego(lite)에 로그인해 둔 사이트는 보통 로그인된 채로 열리지만 언제나는 아닙니다. 1단계대로 에이전트 Space에서 직접 로그인합니다. |
| CAPTCHA를 에이전트가 풀어 주지 않음 | 정상입니다. ego(lite)는 CAPTCHA나 보안 확인을 우회하지 않습니다. 내가 직접 풉니다. |
| 에이전트가 “re-snapshot”, “page snapshot”이라고 말함 | 오류가 아닙니다. 페이지가 바뀐 것을 알아차리고 지금 상태를 다시 읽는 중이라는 뜻입니다. |
| 스냅샷을 새로 찍어도 번호표 오류가 되풀이됨 | 2단계의 원인 셋을 차례로 의심합니다. 여러 단계에 걸쳐 같은 요소를 가리켜야 하는 작업이라면, 에이전트가 번호표 대신 스냅샷에 함께 나오는 loc=… 선택자(페이지 안의 요소를 가리키는 주소 같은 표기)나 CSS 선택자를 쓰게 합니다(가이드 4장). 예시 문장: “Use the loc=... selector from the snapshot instead of @N refs for that element.”(뜻: 그 요소는 번호표 대신 스냅샷의 loc=… 선택자로 가리켜 줘.) |
| 다시 확인시켜도 근거가 없음 | 3단계의 다섯 가지 중 빠진 것을 짚어 다시 요구하고, Space에 열린 페이지에서 직접 확인합니다. |
| ego(lite)가 열리지 않거나 스킬이 안 보임 | 페이지 문제가 아니라 연결 문제입니다. 실습 9. |
다음에 할 것
- 결과를 원문과 대조하는 연습은 실습 3, 처음부터 경계를 넣어 맡기는 연습은 실습 4와 실습 6.
- 넘겨받고 돌려주는 흐름이 아직 낯설다면 실습 2를 다시 해 봅니다.
- 원리를 더 알고 싶다면 가이드 2장 로그인 상태 · 3장 결과 확인 · 3장 스냅샷의 한계.
- 로그인·인증·CAPTCHA는 에이전트 Space에서 내가 직접 처리하고, 이어 하라고 말합니다. 비밀번호와 인증 코드는 대화창에 넣지 않습니다.
- 번호표 오류는 페이지가 바뀌었다는 신호입니다. 스냅샷을 새로 찍게 합니다.
- 결과가 미심쩍으면 앞선 답을 고치게 하지 말고, 지금 페이지를 다시 스냅샷해 확인할 수 있는 근거와 함께 답하게 합니다.
- 스냅샷이 못 읽는 내용은 스크린샷·글 추출·사람의 확인으로 메웁니다.
- 작업의 경계는 내가 정합니다. “read-only, don't modify”, “stop and confirm before submitting”을 다시 말합니다.
출처: lite.ego.app/document/en/docs/snapshot(How @N refs work · Writing a task · Reviewing · Common questions) · space(How you and the agent collaborate · Logged-in state · FAQ) · ego-browser(Ref scope) · claude-code · codex · cursor · deepseek-harness(로그인·인증 항목) · product-introduce(우회하지 않는 것). 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준. “예시 문장”이라고 밝힌 여섯 문장과 상자 속 답의 모양은 실습용으로 만든 것입니다.