phi-browser 스킬
phi-browser 스킬은 브라우저 밖에 사는 AI 코딩 에이전트, 즉 Claude Code, Codex, Cursor, OpenClaw, Pi, Hermes를 Phi에 연결해요. 에이전트에 이 스킬을 설치하면 에이전트가 Phi를 직접 조종할 수 있어요. 페이지 열기, 폼 작성, 스크린샷 촬영, 데이터 추출, 웹 앱 테스트까지, 진짜 브라우저가 필요한 일이라면 무엇이든요.
브라우저 스킬과는 달라요
이건 단 하나의 스킬이고, 내 코딩 에이전트의 것이에요. 브라우저 스킬은 방향이 반대예요. 브라우저 안에서 Phi의 어시스턴트에게 가르치는 지침이거든요. phi-browser 스킬은 에이전트가 Phi를 자신의 브라우저로 쓸 수 있도록 Phi가 내 에이전트에게 건네주는 거예요.
이 스킬이 특별한 건 에이전트가 일하는 장소예요. 내 창을 빼앗지도 않고, 기능을 덜어낸 별도의 브라우저를 돌리지도 않아요. 에이전트는 실제 로그인 상태를 가진 숨겨진 브라우저 창, 즉 자신만의 에이전트 스페이스에서 일하고, 그동안 나는 하던 브라우징을 계속하면 돼요. 실시간으로 지켜볼 수 있고, 언제든 제어권을 가져올 수 있고, 끝나면 다시 돌려줄 수 있어요.
에이전트 스페이스
Phi는 스페이스를 중심으로 만들어졌어요. 스페이스는 각각 자체 로그인 정보를 가진 프로필에 묶인 독립된 작업 공간이에요. 코딩 에이전트가 작업을 시작하면 Phi는 전용 에이전트 스페이스를 내어줘요. 숨겨진 채 생성되는 진짜 브라우저 창인데, 스페이스 전환기에는 상태 배지가 달린 작은 로봇(🤖) 핍으로 나타나요. 에이전트가 여러 개면 번호가 붙은 핍(R1, R2 등)으로 서로 구분할 수 있어요.
핍을 클릭하면 에이전트가 일하는 모습을 실시간으로 볼 수 있어요. Phi가 에이전트의 동작을 네이티브로 렌더링하기 때문에 커서가 목표 지점으로 미끄러지듯 움직이고, 클릭에는 물결이 번지고, 입력 중인 입력란은 깜박여서 에이전트가 무엇을 하는지 정확히 따라갈 수 있어요. 지켜보는 동안에는 페이지가 내 클릭과 키 입력을 무시하므로, 실수로 에이전트를 방해할 일이 없어요. 개입하는 유일한 방법은 명시적인 제어권 가져오기 버튼뿐이에요.
여기에 메뉴 항목 두 개가 더해져요. 보기 → 에이전트 트랜스크립트는 에이전트의 설명, 동작, 대화를 보여주는 콘솔을 열고, 여기에서 에이전트에게 명령을 입력할 수도 있어요. 보기 → 에이전트 자동 보기는 지금 동작 중인 에이전트를 자동으로 따라가요.
에이전트 스페이스는 기본적으로 깔끔하게 정리돼요. 임시 스페이스는 작업이 잠잠해지고 얼마 지나지 않아 스스로 닫히기 때문에, 끝난 작업이 전환기에 쌓이지 않아요. 에이전트가 계속 남는 작업 공간을 만드는 건 사용자가 명시적으로 요청했을 때뿐이에요.
언제든 직접 운전대를 잡을 수 있어요
에이전트 스페이스는 한 번에 한쪽만 제어할 수 있고, 언제나 사용자가 이겨요. 에이전트 스페이스 상단의 오버레이 알약 표시는 지금 조종 중인 에이전트의 이름을 보여주고, 운전대를 잡은 쪽을 위한 컨트롤을 제공해요:
- 에이전트가 조종하는 동안에는 제어권 가져오기로 즉시 멈출 수 있어요. 제어권을 돌려주기 전까지 에이전트가 시도하는 모든 동작은 거부돼요.
- 내가 조종하는 동안에는 제어권 돌려주기로 에이전트에게 제어권을 되돌려 주면 에이전트가 멈췄던 곳부터 이어가고, 완료를 누르면 작업이 끝나요.
제어권 넘기기는 반대 방향으로도 동작해요. 로그인, 보안문자(CAPTCHA), 2단계 인증 코드, 중요한 결정처럼 사용자의 몫인 단계에 이르면 에이전트가 제어권을 돌려주고, Phi가 "에이전트가 도움을 요청해요" 프롬프트를 에이전트 스페이스로 바로 이동하는 버튼과 함께 보여줘요. 사람이 해야 할 단계를 마치고 제어권 돌려주기를 클릭하면 에이전트가 다시 이어가요.
내 로그인 상태를 의도적으로 재사용해요
에이전트 스페이스는 기존 프로필 중 하나에 묶이기 때문에, 에이전트는 내가 이미 로그인해 둔 사이트 상태 그대로 브라우징해요. 그게 핵심이에요. 빈 브라우저에서 시작하는 대신 지금 내가 있는 지점부터 이어갈 수 있거든요.
어디까지 허용할지는 사용자가 정해요. 개발자 탭의 에이전트가 사용할 수 있는 프로필에서 에이전트가 일할 수 있는 프로필을 제한할 수 있어요. 전부 허용하지 않으면 Phi가 전용 "Agent" 프로필을 만들어서, 에이전트가 주 로그인 정보를 건드리지 않고도 일할 수 있게 해요. 그리고 작업 중에 어딘가에 로그인해야 할 때도 에이전트는 비밀번호를 붙여넣어 달라고 하지 않아요. 모든 요청에 사용자의 승인이 필요한 에이전트 비밀번호 관리자를 거쳐요.
에이전트가 한 일은 내 책임이에요
이 부분은 두 번 읽을 가치가 있어요. 무언가가 알아서 일하는 걸 지켜보다 보면 놓치기 쉽거든요.
Phi를 조종하는 에이전트는 내 브라우저에서, 내 세션으로, 나로서 행동해요. 내 지시에 따라 에이전트가 한 일은 우리 서비스에서든 다른 모든 서비스에서든 내 책임이고, 에이전트가 방문한 사이트의 약관은 내가 직접 하나하나 클릭했을 때와 똑같이 나에게 적용돼요.
에이전트를 원치 않는 사이트가 있고, 그런 사이트는 실제로 조치를 취해요. 많은 사이트가 자동화된 접근을 사업에 대한 위협으로 여겨요. 콘텐츠가 곧 그들의 사업이니까요. 그래서 자동화를 공격적으로 탐지해요. 잘 알려진 예가 Reddit이에요. 자동화로 판정된 계정은 제한되거나 차단되는데, 그 판단은 우리가 아니라 그들의 권한이에요. 에이전트를 환영하지 않는 사이트에 에이전트를 보내면 그곳의 계정, 기록, 그 안에 보관하던 모든 것을 잃을 수 있어요. 그 위험은 사용자의 몫이고, 우리가 대신 이의를 제기하거나 되돌릴 수 있는 일이 아니에요.
중요한 행동의 승인은 사용자의 몫이에요. 에이전트는 로그인된 서비스에서 물건을 사고, 메시지를 보내고, 폼을 제출하고, 설정을 바꿀 수 있어요. 허락하기 전에 에이전트가 무엇을 하려는지 확인하세요. Phi가 확인을 요청하는 곳에서는 그 확인이 실제로 중요한 역할을 해요.
자세한 내용은 이용약관에 전부 정리돼 있어요.
설정 방법
모든 기능은 개발자 모드 뒤에 있고, 기본값은 꺼짐이에요. 세 단계면 돼요:
- 설정 → 일반에서 개발자 모드를 켜요. 그러면 에이전트 접근, 권한, 비밀번호 관리자가 있는 개발자 탭이 나타나요.
- 설정 → 개발자 → phi-browser 스킬 설치에서 스킬을 설치해요. 스킬 추가 대상… 버튼에는 지원되는 에이전트가 하나씩, 그리고 모든 에이전트 항목이 나열되는데, 선택하면 Phi 안에 번들된 스킬이 해당 에이전트의 스킬 폴더에 링크돼서 Phi가 업데이트될 때마다 항상 최신으로 유지돼요. Node 22 이상이 필요하고, 새로 설정한 에이전트는 이후에 다시 시작하는 게 좋아요. Pi에서는
/reload면 충분해요. - 설정 → 개발자 → 에이전트 제어 → "에이전트가 Phi를 제어하도록 허용 (CDP)"으로 에이전트 연결을 허용해요. 재시작 없이 즉시 적용돼요.
특정 에이전트가 처음으로 실제 연결을 시도하면 Phi가 연결하는 프로세스를 코드 서명까지 포함해 식별한 다음 물어봐요: 한 번만 허용, 항상 허용, 거부 중에서 선택해요. 승인하기 전에는 아무것도 브라우저에 닿지 않아요. 승인한 에이전트는 같은 탭의 허용된 에이전트 아래에 "항상" 또는 "이번 세션"으로 표시돼요. 목록에서 제거하면 다음번에 다시 물어봐요.
접근은 이렇게 통제돼요
이 연결은 승인하지 않은 무엇도 닿을 수 없도록 설계됐어요:
- Phi는 네트워크 포트가 아니라 이 Mac의 프로세스만 접근할 수 있는 프라이빗 소켓에서 연결을 기다려요. 네트워크에 있는 무엇도, Mac의 다른 사용자도 여기에 연결할 수 없어요.
- 모든 연결은 연결하는 프로세스의 신원으로 검증되어 에이전트별로 동의를 받아요.
- "에이전트가 Phi를 제어하도록 허용 (CDP)"을 끄면 새 연결이 차단되고 살아 있는 연결도 즉시 끊겨요.
- 기본적으로 에이전트는 자신의 에이전트 스페이스 안에서만 일할 수 있어요. 실제 브라우징 데이터, 그러니까 내 스페이스, 북마크, 고정된 탭, URL 규칙, 창 배치를 건드리는 건 별도 권한인 "에이전트가 내 스페이스를 조작하도록 허용"이 필요하고, 이 권한 역시 기본값은 꺼짐이에요.
- 개발자 모드를 끄는 게 킬 스위치예요. 에이전트 접근과 에이전트 비밀번호 관리자가 함께 비활성화되고, 다시 켜도 자동으로 다시 활성화되는 건 없어요.
다음 읽을거리
- Phi CLI, 같은 자동화를 터미널의
phi명령으로 쓰는 방법이에요. 스크립트나 빠른 일회성 조작에 좋아요. - 에이전트 비밀번호 관리자, 에이전트가 비밀번호를 보지 않고 내 보관함으로 로그인하는 방법이에요.
- 브라우저 스킬, 또 다른 종류의 스킬로, Phi의 어시스턴트에게 가르치는 것이에요.
- 스페이스와 프로필, 에이전트 스페이스의 바탕이 되는 작업 공간과 로그인 신원이에요.
- 자동화와 Phi Link, Phi의 어시스턴트가 나를 대신해 할 수 있는 일이에요.