Kimi WebBridge 설정과 연결 오류 해결

Kimi WebBridge의 새 이름은 Kimi Browser Extension입니다. 사이드바가 열리는데 로컬 에이전트에서 브라우저가 오프라인이라고 표시하면 확장 프로그램, 서비스, 에이전트를 각각 점검하세요. 도구가 반환한 원본 오류부터 읽으세요. 상태 표시만으로 연결이 끊긴 지점을 알기는 어렵습니다.

Kimi Browser Extension

r/kimi의 한 사용자는 확장 프로그램에 활성 상태가 표시됐지만 Claw가 WebBridge가 오프라인이라고 응답했다고 전했습니다. 이런 경우 연결을 구간별로 확인하면 됩니다. r/kimi

핵심 정리

• Kimi가 안내하는 환경은 macOS 또는 Windows의 Chrome과 Edge입니다. 작업에 사용할 프로필에 확장 프로그램을 설치하세요.

• 사이드바와 로컬 에이전트 제어는 따로 설정합니다. 사이드바가 열리면 로컬 연결 상태도 확인하세요.

• Connection refused는 로컬 서비스를, extension_not_connected는 서비스와 확장 프로그램 사이의 연결을 먼저 확인하세요.

• 작업을 허용하기 전에 페이지 제목과 전체 URL, 화면에 표시된 문구를 확인하세요.

에이전트가 사용할 브라우저 확인하기

Kimi Code Desktop 오른쪽 패널에는 내장 브라우저가 있습니다. 그 안의 탭은 현재 세션에 속합니다. 승인된 작업에서 사이트가 이미 열린 브라우저 프로필을 써야 한다면 확장 프로그램을 선택하세요. Kimi 문서에는 Chrome과 Edge가 나옵니다. 에이전트와 브라우저의 호환 여부는 따로 확인합니다.

내장 브라우저 기존 브라우저 세션

내장 브라우저와 확장 프로그램은 세션이 서로 다릅니다. 사용할 방식을 정하려면 Kimi Code 내장 브라우저와 WebBridge를 선택하는 기준을, 로그인 상태가 다른 이유를 알아보려면 브라우저 프로필 vs 워크스페이스 vs 탭 그룹: 업무와 개인 브라우징을 완벽하게 분리하는 방법을 참고하세요.

페이지까지 연결 경로 따라가기

로컬 에이전트는 루프백 주소의 서비스에 요청합니다. 확장 프로그램은 WebSocket으로 같은 서비스에 연결하고 자신의 브라우저 프로필에서 작동합니다. Kimi FAQ에 나온 확장 프로그램 기본 주소는 ws://127.0.0.1:10086/ws입니다. 에이전트의 HTTP 엔드포인트와 확장 프로그램의 WebSocket URL은 용도가 다릅니다. 에이전트가 컨테이너나 다른 컴퓨터에서 실행되면 그 루프백은 해당 환경을 가리킵니다.

Local Agent  ── HTTP ──►  Loopback service
Kimi extension ── WebSocket ──► Loopback service
Kimi extension ──► Browser profile ──► Test page

에이전트가 브라우저와 다른 환경에서 실행된다면 Codex Cloud가 내 컴퓨터의 localhost를 열 수 없는 이유에서 주소가 어떻게 달라지는지 확인할 수 있습니다.

설치 후 구성 요소 확인하기

1. Kimi의 공식 링크를 통해 Chrome 웹 스토어 또는 Edge 추가 기능에서 설치하세요. 수동 설치는 공식 패키지의 압축을 풀고 확장 프로그램 관리 페이지에서 개발자 모드를 켠 뒤 압축을 푼 폴더를 불러오는 방식입니다.

2. Kimi Work는 플러그인 마켓에서 플러그인을 설치한 뒤 설정의 자동 제어 메뉴에서 외부 브라우저에 연결하세요. Kimi Code CLI는 가이드에 따라 클라이언트 플러그인과 브라우저 확장 프로그램을 각각 설치하세요.

3. 다른 로컬 에이전트는 Kimi가 안내하는 클라이언트별 설정을 따르고 로컬 서비스가 실행 중인지 확인하세요. 확장 프로그램 설정에서 로컬 에이전트 원격 제어 메뉴를 열어 연결한 뒤 상태를 확인하세요.

공식 설정 방법 Kimi Code CLI

다른 로컬 클라이언트에서 프로필을 고르는 방법은 OpenClaw 브라우저 설정과 프로필 선택하기을 참고하세요. 클라이언트와 브라우저를 나누어 설정하는 예는 DeepSeek Harness로 브라우저를 제어하는 방법에서 볼 수 있습니다.

원본 오류로 장애 구간 찾기

Connection refused 또는 Failed to connect는 그 주소에서 대기 중인 서비스에 도달하지 못했다는 뜻입니다. 실행 환경, 포트와 서비스 상태를 확인하세요. 서비스가 extension_not_connected를 반환하면 서비스와 확장 프로그램 사이를 확인합니다. 대상 프로필에서 확장 프로그램이 활성화됐는지, 양쪽 포트가 같은지 점검하세요. 포트 충돌 가능성이 나오면 설정 변경 전에 대기 중인 프로세스를 확인합니다.

서비스가 시작되지 않으면 오류와 함께 표시된 로그를 읽고 포트를 사용 중인 프로그램을 확인하세요. Kimi의 기본 포트는 10086입니다. 충돌이 확인되면 비어 있는 로컬 포트를 골라 새 주소로 서비스를 다시 시작하세요. 확장 프로그램에서 해당 WebSocket 주소를 테스트하고 저장한 뒤 에이전트를 다시 연결하세요. 서비스 상태에서 실제 포트와 확장 프로그램의 연결 여부를 확인하세요. 설정 파일과 재시작 명령은 공식 문서를 따르세요.

페이지가 열리지만 스냅샷, 스크린샷 또는 클릭이 반복해서 실패한다면 Kimi FAQ는 확장 프로그램 충돌을 확인하라고 안내합니다. Kimi 확장 프로그램만 켠 별도 프로필에서 같은 안전한 동작을 반복하세요. 성공하면 그 프로필에서 다른 확장 프로그램을 하나씩 확인하세요.

공식 FAQ

읽기 전용 테스트로 대상 창 확인하기

대상 프로필에서 민감한 정보가 없는 테스트 페이지를 엽니다. 제목, 정확한 URL, WEBBRIDGE-CHECK 같은 화면의 표식을 보고하도록 요청합니다. 클릭, 입력, 양식 제출은 제외합니다. 표식이 다르면 중단하고 URL과 프로필을 대조하세요. 기록에는 비공개 페이지 내용이나 인증 정보를 남기지 않습니다.

첫 브라우저 에이전트 작업

이미 로그인한 대시보드도 프로필에 따라 달라집니다. 테스트 페이지로 쓰기 전에 Codex가 이미 로그인한 대시보드를 읽을 수 있나요?을 확인하세요.

연결 후에는 허용된 탭 하나부터 확인하기

r/codex의 한 사용자는 확장 프로그램과 호환 스킬을 설치한 뒤 이미 열린 탭을 제어했다고 전했습니다. 개별 사용 사례이며, 클라이언트별 지원 여부와 설정은 해당 클라이언트 문서에서 확인하세요. r/codex

연결을 확인한 뒤 작업 다시 시도하기

원래 오류가 서비스를 가리키면 그 연결부터 복구하세요. 확장 프로그램이 연결되면 대상 프로필을 확인하고 읽기 전용 요청으로 페이지를 확인하세요. 페이지 정보가 일치한 뒤 원래 작업을 다시 시도하세요.

Secholar.L

Tabbit 그로스 & 콘텐츠

Secholar.L은 AI 브라우저와 에이전트 워크플로우에 대한 실용적인 가이드를 작성하며, 실제 조사와 검증 가능한 출처를 바탕으로 도구를 비교합니다.