자주 묻는 질문

제품 버전

Kimi WebBridge와 Kimi 브라우저 확장 프로그램은 어떤 관계인가요?

Kimi WebBridge가 Kimi 브라우저 확장 프로그램으로 이름이 변경되었고, 브라우저 사이드바 진입점, 웹 작업 녹화, 웹페이지를 분해해 지시문을 생성하는 기능이 새로 추가되었습니다. Local Agent에서 확장 프로그램을 호출하는 방식은 그대로 유지되므로 계속 사용할 수 있으며, 새로 추가된 사이드바 진입점은 Kimi 계정으로 로그인한 후 사용할 수 있습니다.

사이드바 사용하기

대화 기록은 kimi.com, Kimi Desktop과 동기화되나요?

동기화되지 않습니다. 사이드바의 대화 기록은 현재 브라우저에만 저장되며, 계정별로 기본적으로 최근 대화 10개를 보관합니다. 오래 보관하려면 답변 아래의 “Export”를 클릭해 내용을 Markdown(.md) 파일로 저장하세요.

설치 및 설정

어떤 브라우저를 지원하나요?

현재 Chrome과 Edge를 지원합니다. 최상의 환경을 위해 최신 버전을 사용하시길 권장합니다.

확장 프로그램을 설치할 때 “이 웹사이트에서 앱을 추가할 수 없습니다”라는 메시지가 표시됩니다.

반드시 공식 웹 스토어(Chrome 웹 스토어 또는 Edge 부가 기능)에서 설치하세요. 웹 스토어에 접속할 수 없다면 공식 웹사이트에서 제공하는 수동 설치 방법을 이용하세요.

Windows에서 Kimi 브라우저 확장 프로그램을 설치할 때 “설치 실패” 오류가 발생합니다.

Kimi 브라우저 확장 프로그램은 Windows 운영 체제를 지원하며, 설치 명령은 PowerShell에서 실행할 수 있습니다.

Powershell

설치 후 Kimi 브라우저 확장 프로그램에 Chrome 호환성 경고가 표시됩니다. 무슨 의미인가요?

Kimi 브라우저 확장 프로그램이 페이지는 정상적으로 열지만 snapshot, evaluate, screenshot, click 같은 동작이 계속 실패한다면, 가장 흔한 원인은 다른 브라우저 확장 프로그램과의 충돌입니다.

특히 스크래핑 도구, 웹사이트 도우미 확장 프로그램, 화면 녹화 확장 프로그램, AI 비서 확장 프로그램에서 자주 발생합니다.

다음 단계로 문제를 해결해 보시기를 권장합니다.

1. 브라우저의 확장 프로그램 관리 페이지를 엽니다.
2. 다른 확장 프로그램을 일시적으로 비활성화합니다.
3. Kimi 브라우저 확장 프로그램만 활성화 상태로 둡니다.
4. 브라우저를 다시 시작한 후 다시 시도합니다.
5. Kimi 브라우저 확장 프로그램이 정상적으로 작동하면 다른 확장 프로그램을 하나씩 다시 활성화하여 충돌을 일으키는 확장 프로그램을 찾아냅니다.

연결 명령을 실행해도 아무 일도 일어나지 않습니다.

인터넷 연결 상태를 확인하세요. 문제가 계속되면 Kimi Claw Desktop을 다시 시작한 후 명령을 다시 실행해 보세요.

여러 대의 컴퓨터에서 사용할 수 있나요?

가능합니다. 다만 각 컴퓨터마다 별도로 설치하고 설정해야 합니다.

Kimi Claw Desktop을 찾을 수 없습니다.

Kimi Claw Desktop은 로컬 컴퓨터에 배포된 Kimi Claw입니다. Kimi Desktop을 열고 왼쪽 사이드바에서 Kimi Claw를 찾아 새 Claw를 만든 다음 “내 컴퓨터에 배포”를 선택하세요.

연결 및 사용

로컬 Agent가 브라우저를 사용할 수 없다면 연결 상태는 어떻게 확인하나요?

• 브라우저 사이드바의 “Settings” → “Local agent remote control”에서 “Connection”을 확인하세요. “Not connected”로 표시되면 “Connect”를 눌러 다시 시도하세요.
• Kimi Work에서는 “설정” → “자동 제어” → “Browser use”에서 “서비스 연결” 상태를 확인하고 “연결”을 눌러 다시 시도할 수 있습니다.

주의: 사이드바가 열린다고 해서 로컬 Agent의 연결 설정이 끝난 것은 아닙니다.

Kimi Work나 다른 로컬 Agent가 브라우저를 사용하지 못하면 먼저 도구가 반환한 원본 오류를 확인하세요. 자주 나타나는 필드나 메시지에 따라 확인할 항목이 다릅니다.

다음 순서대로 확인하세요.

1. 브라우저가 열려 있고 확장 프로그램이 활성화되어 있나요?

Kimi 브라우저 확장 프로그램이 설치된 Chrome 또는 Edge를 열고 확장 프로그램 관리 페이지에서 활성화 여부를 확인하세요. 그런 다음 Kimi Work에서 “연결”을 클릭하거나 확장 프로그램 설정에서 “Connect”를 클릭하세요.

2. 브라우저 확장 프로그램만 설치하고 로컬 Agent는 설정하지 않았나요?

브라우저 확장 프로그램과 로컬 Agent 연결 구성 요소가 모두 필요합니다. Kimi Work에서는 플러그인 마켓에서 Kimi Browser Extension을 설치하고 설치 및 연결 안내를 따르세요.

다른 로컬 Agent를 사용하거나 아직 로컬 서비스를 설정하지 않았다면 확장 프로그램의 “Connect”를 누르고 대화 상자의 설치 지침을 Agent에게 보내세요. 운영체제에 맞는 아래 요청문을 복사해도 됩니다.

macOS 또는 Linux

Text

Windows

Text

설치와 서비스 실행이 성공했는지 확인한 뒤 “Connection”을 다시 확인하세요.

3. 설치한 로컬 서비스가 실행 중인가요?

설치가 완료되어도 서비스가 계속 실행되는 것은 아닙니다. Kimi Work에서는 위 설정 페이지의 “연결”을 먼저 클릭하세요. 다른 로컬 Agent에는 Kimi 브라우저 확장 프로그램의 로컬 서비스 상태를 확인하고 필요하면 실행해 달라고 요청하세요. 이후 확장 프로그램에서 “Connect”를 누르세요. 실행에 실패하면 포트 충돌을 확인하세요.

4. 확장 프로그램 주소와 로컬 서비스 주소가 일치하나요?

확장 프로그램의 “Settings” → “Local agent remote control” → “Connection address”를 확인하세요. 기본 주소는 ws://127.0.0.1:10086/ws입니다. 서비스 포트를 바꿨다면 확장 프로그램도 같은 포트를 사용해야 합니다. 한쪽만 바꾸면 연결되지 않습니다.

5. 오류에 포트 충돌 가능성이 표시되나요?

Port … is most likely held by another program이 표시되면 로컬 Agent에게 해당 포트, 사용 중인 프로그램, 함께 제공된 로그를 확인해 달라고 하세요. 이 메시지는 가능성을 나타낼 뿐 원인을 확정하지 않습니다. 충돌이 확인되면 아래 포트 안내를 따르세요.

여전히 연결되지 않으면 확장 프로그램의 “Settings” → “Feedback”으로 Kimi Work 또는 로컬 Agent 버전, 브라우저와 확장 프로그램 버전, 연결 상태 스크린샷, 전체 오류, 시도한 단계를 보내세요.

포트가 사용 중이면 어떻게 하나요? 연결 포트는 어떻게 바꾸나요?

로컬 연결 서비스의 기본 포트는 10086입니다. 먼저 포트를 점유한 프로그램을 확인하세요. 종료할 수 있으면 종료 후 연결을 다시 시도하세요. 계속 실행해야 한다면 아래 단계로 포트를 변경하세요.

Kimi Work 3.2.18과 다른 로컬 Agent는 같은 포트 변경 절차를 사용할 수 있습니다. 이전 Work 버전을 사용한다면 먼저 3.2.18 이상으로 업데이트하세요. Kimi 브라우저 확장 프로그램의 로컬 서비스는 v2.0.22 이상이어야 합니다.

로컬 서비스와 확장 프로그램의 포트를 함께 바꿀 수 있습니다. 예시는 12086을 사용하므로 먼저 Agent에게 사용 가능한 포트인지 확인해 달라고 하세요. 재시작하면 현재 연결이 끊기므로 실행 중인 브라우저 작업이 끝날 때까지 기다리세요.

1. 로컬 서비스 설정을 수정하세요.

아래 파일을 열거나 없으면 만드세요. 기존의 다른 필드는 유지하고 addr만 수정하세요. 설정 오류가 표시되면 JSON 구문과 addr가 아래 주소 형식에 맞는지 확인하고 수정한 뒤 다시 시도하세요.

• macOS / Linux: ~/.kimi-webbridge/config.json
• Windows: %USERPROFILE%\.kimi-webbridge\config.json

Json

2. 서비스를 재시작하고 상태를 확인하세요.

운영체제에 맞는 명령을 실행하거나 로컬 Agent에게 실행을 요청하세요.

BashPowershell

결과에서 running: true이고 port가 12086인지 확인하세요. 이전 포트가 표시되거나 시작에 실패하면 서비스 오류를 먼저 해결하세요. Work는 정상 실행 중인 서비스를 재사용하므로 설정을 저장하거나 Work를 다시 여는 것만으로 해당 서비스가 새 포트로 자동 이동하지 않습니다.

3. 확장 프로그램의 연결 주소를 바꾸세요.

사이드바의 “Settings” → “Local agent remote control” → “Connection address”에서 ws://127.0.0.1:12086/ws를 입력하고 “Test”를 누르세요. 성공하면 “Save”를 누르고 설정으로 돌아가 “Connection”이 “Connected”인지 확인하세요.

4. 로컬 Agent가 새 주소를 사용하도록 알려 주세요.

Kimi Work에서는 위 단계를 마친 후 Work를 다시 열고 “설정” → “자동 제어” → “Browser use”에서 “연결”을 클릭하세요. 다른 로컬 Agent에는 서비스가 127.0.0.1:12086으로 바뀌었으며 status가 반환한 실제 포트를 사용하도록 알려 주세요. extension_connected: true는 확장 프로그램이 연결되었다는 뜻입니다. false라면 브라우저가 열려 있고 확장 프로그램이 활성화되어 있으며 주소가 3단계와 일치하는지 확인하세요.

기본값으로 되돌리려면 addr를 127.0.0.1:10086으로 수정하고 서비스를 재시작한 뒤 확장 프로그램의 “Connection address”에서 “Reset to default”를 누르세요. 먼저 다른 프로그램이 10086을 사용하지 않는지 확인하세요.

Kimi 브라우저 확장 프로그램이 제 로그인 정보를 유출하지는 않나요?

그렇지 않습니다. 모든 실행은 사용자 기기에서 로컬로 이루어지며, 로그인 상태와 웹 페이지 콘텐츠는 절대 기기 밖으로 나가지 않습니다. Agent는 사용자가 승인한 작업 결과에만 접근할 수 있습니다.

작업이 실패하는 이유는 무엇인가요?

복잡한 페이지 구조나 동적 로딩으로 인해 작업이 실패할 수 있습니다. 지시를 더 단순하게 작성하거나, 실행하기 전에 Agent에게 먼저 스크린샷을 찍어 페이지 상태를 확인하도록 요청해 보세요.

다른 Agent와 함께 사용하기

어떤 다른 Agent를 지원하나요?

Kimi 브라우저 확장 프로그램은 Claude Code, Codex, Cursor, Kimi Code, Hermes Claw 등을 비롯한 모든 Local Agent를 지원합니다.

Agent마다 설정 방법이 같나요?

설치 명령은 모두 동일합니다. 단일 curl 명령 하나로 설치하면 됩니다. 자세한 내용은 각 Agent의 Skill 설정을 참고하세요.