---
title: "terminal-browser"
url: "https://claudemods.dev/ko/builds/terminal-browser-432408"
source: "https://github.com/zenbu-labs/terminal-browser/tree/main/claude-code-plugin"
source_type: "github"
repo: "https://github.com/zenbu-labs/terminal-browser/tree/main/claude-code-plugin"
author: "zenbu-labs"
author_handle: "zenbu-labs"
stars: 4717
category: "도구 및 연동"
categories: ["tools"]
tags: ["Claude Code", "mod"]
permission_level: 3
scan_complete: false
install: "claude plugin marketplace add zenbu-labs/terminal-browser\nclaude plugin install terminal-browser@terminal-browser"
added: "2026-10-04T10:40:34.110Z"
updated: "2026-11-19T00:59:30Z"
locale: "ko"
content_locale: "ko"
---

# terminal-browser

터미널 브라우저: Claude Code 내에서 직접 실행되는 브라우저입니다. 웹사이트 미리보기, HTML 문서 보기, 에이전트의 제어 허용

## Description

# 터미널 브라우저 Claude Code 플러그인

> 이 플러그인은 실험적이며 몇 가지 [알려진 제한 사항](#caveats)이 있습니다.




https://github.com/user-attachments/assets/a79e7667-6fcb-49a4-9967-44d0f942102c



## 설치

터미널 브라우저 설치
```
curl -fsSL https://terminal-browser.sh/install | bash # or brew install terminal-browser
```
최신 버전의 clude 코드를 사용하고 있는지 확인하세요.
```
claude update
`
```
~/.claude/settings.json`에 다음을 추가하여 Claude Code UI 플러그인을 활성화합니다.
```jso
n
{
  "env": { "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1" }
}
```
터미널 브라우저 플러그인 설치
```
# set the marketplace
claude plugin marketplace add zenbu-labs/terminal-browser

# install the plugin
claude plugin install terminal-browser@terminal-browser
```
이제 Claude Code 내에서 "/browser"를 실행하여 브라우저를 열 수 있습니다.

### 업데이트 중

Claude Code 플러그인 업데이트
```
claude plugin update terminal-browser@terminal-browser
```
터미널 브라우저 업데이트
```
terminal-browser upgrade
```
### 구성

Claude가 브라우저를 여는 데 사용할 수 있는 도구를 포함하도록 터미널 브라우저 플러그인을 구성할 수 있습니다. Claude는 이미 `terminal-browser` CLI를 사용하여 분할 창을 통해 터미널 내부에서 브라우저를 열 수 있으므로 기본적으로 꺼져 있습니다. ` ~/.claude/settings.json`에 다음을 추가하여 도구를 활성화할 수 있습니다.
```jso
n
{
  "pluginConfigs": {
    "terminal-browser@terminal-browser": {
      "options": {
        "agentTool": true
      }
    }
  }
}
```
## 터미널 브라우저 플러그인 API

터미널 브라우저 플러그인에는 프로그래밍 방식으로 브라우저를 열고 URL을 로드하기 위해 다른 Claude Code 플러그인 내에서 사용할 수 있는 API가 함께 제공됩니다. 이를 사용하여 구축할 수 있는 유용한 플러그인의 몇 가지 예는 다음과 같습니다.
- Claude Code 분할 창에서 tldraw를 여는 `/tldraw` 슬래시 명령
- 작업 중인 분기와 관련된 PR을 여는 `/open-pr` 슬래시 명령
```typescrip
t
export type BrowserOpenInput = { url?: string }

export type BrowserOpenResult =
  | { ok: true; url: string }
  | { ok: false; error: string }

export type Browser = {
  open: (input: BrowserOpenInput) => Promise<BrowserOpenResult>
  close: (input?: Record<string, never>) => Promise<boolean>
}

// usage: in your plugin's hooks module
on('command.run', { command: 'tldraw' }, async ($) => {
  const result = await $.browser.open({ url: 'https://www.tldraw.com/' })
  return { text: result.ok ? 'Opened tldraw' : result.error }
})
```
## 어떻게 작동하나요?

터미널 브라우저는 t를 사용합니다.

## Install

```
claude plugin marketplace add zenbu-labs/terminal-browser
claude plugin install terminal-browser@terminal-browser
```

## Original README

# terminal-browser claude code plugin

> This plugin is experimental and does have some [known limitations](#caveats)




https://github.com/user-attachments/assets/a79e7667-6fcb-49a4-9967-44d0f942102c



## Installation

Install terminal-browser
```
curl -fsSL https://terminal-browser.sh/install | bash # or brew install terminal-browser
```

Ensure you are on the latest version of claude code
```
claude update
```

Enable claude code UI plugins by adding this to `~/.claude/settings.json`:
```json
{
  "env": { "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1" }
}
```




Install the terminal-browser plugin
```
# set the marketplace
claude plugin marketplace add zenbu-labs/terminal-browser

# install the plugin
claude plugin install terminal-browser@terminal-browser
```

Now you can run "/browser" inside claude code to open the browser

### Updating

Update the claude code plugin
```
claude plugin update terminal-browser@terminal-browser
```

Update terminal-browser
```
terminal-browser upgrade
```

### Configuration

You can configure the terminal-browser plugin to include a tool that claude can use to open the browser. This is by default off, since claude can already use the `terminal-browser` CLI to open the browser inside the terminal through a split pane. You can enable the tool by adding the following to your ` ~/.claude/settings.json`:

```json
{
  "pluginConfigs": {
    "terminal-browser@terminal-browser": {
      "options": {
        "agentTool": true
      }
    }
  }
}
```


## terminal-browser plugin API

The terminal-browser plugin comes with an API you can use within another claude code plugin to programatically open the browser and load a URL. Some examples of useful plugins you can build with this are:
- `/tldraw` slash command that opens tldraw in the claude code split pane
- `/open-pr` slash command that opens the PR associated with the branch you are working on

```typescript
export type BrowserOpenInput = { url?: string }

export type BrowserOpenResult =
  | { ok: true; url: string }
  | { ok: false; error: string }

export type Browser = {
  open: (input: BrowserOpenInput) => Promise<BrowserOpenResult>
  close: (input?: Record<string, never>) => Promise<boolean>
}

// usage: in your plugin's hooks module
on('command.run', { command: 'tldraw' }, async ($) => {
  const result = await $.browser.open({ url: 'https://www.tldraw.com/' })
  return { text: result.ok ? 'Opened tldraw' : result.error }
})
```

## How does it work?

terminal-browser uses the [kitty graphics protocol] to display pixels generated by a real browser inside the terminal. To display the browser inside claude code, we use claude codes new [function hooks API](https://github.com/anthropics/claude-code/issues/91870).

terminal-browser's internals have been extracted to a javascript library - https://github.com/zenbu-labs/terminal-browser/tree/main/pixel - if you would like to build your own graphical application inside claude code/the terminal


## Supported terminals

The terminal-browser claude code plugin will only work in terminals that support the [kitty graphics protocol], and implement [kitty unicode placeholders](https://sw.kovidgoyal.net/kitty/graphics-protocol/#unicode-placeholders). The most popular terminals that support this feature are:
- [ghostty](https://ghostty.org)
- [kitty](https://sw.kovidgoyal.net/kitty/)

If your terminal does not support the required features, trying to open the browser inside claude code may garble the TUI

In addition any terminals that are built on libghostty will support this feature, some examples are:
- [cmux](https://cmux.com/)
- [supacode](https://supacode.sh/)

You can find more libghostty based terminals here: [awesome-libghostty](https://github.com/Uzaaft/awesome-libghostty)

Even if your terminal supports the required graphics feature, if you are running a multiplexer, the plugin may not work. This is because multiplexers rewrite the output of terminal programs and breaks terminal graphics commands. tmux support will be arriving soon (terminal-browser currently works in tmux, just not through the claude code plugin yet), and within herdr performance is very bad when running through the claude code plugin, but will likely improve soon. Other multiplexers I have not tested, so if it does not work please file an issue and I will see if we can support this.




## Caveats:
- depends on your terminal supporting the [kitty graphics protocol]
- the mouse position will sometimes be slightly off, since claude code does not enable pixel coordinate mouse reporting
- the plugin needs to make fetch requests to a local http server to communicate with the terminal-browser CLI, which may cause a prompt to show in your OS that your terminal wants to access the local network
- claude code sets a very high min width for the chat area, so its sometimes not possible to resize the browser to the size you want
- the plugin depends on the experimental function hooks claude code API, which is unstable, so the plugin may break between releases

[kitty graphics protocol]: https://sw.kovidgoyal.net/kitty/graphics-protocol/
