> Bingsu 설치, 화면 녹화, 편집, 공유 페이지, 그리고 Claude, ChatGPT, Codex 등 AI 에이전트 연결 방법. 한 페이지에 모든 작업을 담았어요.

Source: https://docs.bingsustudio.com/ko/

# 문서

1. [Bingsu 설치](https://docs.bingsustudio.com/ko/#install-bingsu)
2. [화면 녹화 허용하기](https://docs.bingsustudio.com/ko/#allow-screen-recording)
3. [화면 녹화하기](https://docs.bingsustudio.com/ko/#record-your-screen)
4. [창, 앱 또는 영역 고르기](https://docs.bingsustudio.com/ko/#pick-a-window-an-app-or-an-area)
5. [소리와 마이크](https://docs.bingsustudio.com/ko/#sound-and-microphones)
6. [내 카메라와 통화 게스트](https://docs.bingsustudio.com/ko/#your-camera-and-call-guests)
7. [일시 정지, 정지, 잠금 화면](https://docs.bingsustudio.com/ko/#pause-stop-and-the-lock-screen)
8. [앞뒤 자르기, 구간 잘라 내기, 크롭](https://docs.bingsustudio.com/ko/#trim-cut-and-crop)
9. [확대와 배경](https://docs.bingsustudio.com/ko/#zoom-and-backgrounds)
10. [녹취록, 자막, 챕터](https://docs.bingsustudio.com/ko/#transcript-captions-and-chapters)
11. [페이지 공유하기](https://docs.bingsustudio.com/ko/#share-a-page)
12. [AI 에이전트 연결하기](https://docs.bingsustudio.com/ko/#connect-an-ai-agent)
13. [에이전트에게 녹화 맡기기](https://docs.bingsustudio.com/ko/#ask-an-agent-to-record)
14. [에이전트가 할 수 있는 일](https://docs.bingsustudio.com/ko/#what-an-agent-can-do)
15. [여러 에이전트가 동시에 녹화하게 하기](https://docs.bingsustudio.com/ko/#let-several-agents-record-at-once)
16. [에이전트용 카메라와 마이크](https://docs.bingsustudio.com/ko/#camera-and-microphones-for-agents)
17. [명령줄 사용하기](https://docs.bingsustudio.com/ko/#use-the-command-line)
18. [업데이트](https://docs.bingsustudio.com/ko/#updates)
19. [개인정보 처리방침](https://docs.bingsustudio.com/ko/#privacy)
20. [문제 해결](https://docs.bingsustudio.com/ko/#fix-a-problem)
21. [제거](https://docs.bingsustudio.com/ko/#uninstall)

[Markdown](https://docs.bingsustudio.com/ko/index.md) [llms.txt](https://docs.bingsustudio.com/docs/llms.txt)

Bingsu는 내 컴퓨터에서 화면, 카메라, 통화를 녹화해요. AI 에이전트도 자기가 하는 작업을 직접 녹화할 수 있어요. 아래 작업은 모두 프롬프트로 복사할 수 있어서 에이전트에게 대신 맡길 수 있어요.

## Bingsu 설치

1. [Mac용 Bingsu 다운로드](https://bingsustudio.com/download/). macOS 26 Tahoe 이상이 필요해요.
2. 다운로드 폴더에서 `Bingsu.dmg`을 열고 Bingsu를 응용 프로그램 폴더로 끌어다 놓으세요.
3. Bingsu를 여세요. Dock이 아니라 메뉴 막대에 있어요.

Homebrew로 설치하려면:

```
brew install --cask bingsu
```

열기 전에 파일을 확인하려면 SHA-256 값을 [다운로드 페이지](https://bingsustudio.com/download/#verify)의 값과 비교하세요.

```
shasum -a 256 ~/Downloads/Bingsu.dmg
```

Windows에서:

1. [Windows용 Bingsu를 다운로드](https://bingsustudio.com/download/#windows)하세요. Windows 10(버전 2004) 이상이 필요해요.
2. 다운로드 폴더에서 `Bingsu.msix`을 열고 설치를 누르세요.
3. 시작 메뉴에서 Bingsu를 여세요.

Linux에서:

1. [Linux용 Bingsu를 다운로드](https://bingsustudio.com/download/#linux)하세요. PipeWire가 있는 Wayland 환경의 GNOME이나 KDE가 필요해요. X11에서도 쓸 수 있어요.
2. 파일에 실행 권한을 주고 여세요:

```
chmod +x ~/Downloads/Bingsu.AppImage && ~/Downloads/Bingsu.AppImage
```

## 화면 녹화 허용하기

처음 녹화할 때 macOS가 한 번 물어봐요. 시스템 설정 > 개인정보 보호 및 보안 > 화면 및 시스템 오디오 녹음에서 Bingsu를 켠 다음 Bingsu를 다시 여세요.

카메라와 마이크는 따로 물어봐요. macOS는 각각 처음 쓸 때만 물어봐요. Bingsu는 둘 중 어느 것도 스스로 켜지 않아요.

## 화면 녹화하기

1. 메뉴 막대의 Bingsu 아이콘을 클릭하거나, 어디서든 ⌥⇧⌘R을 누르세요.
2. 녹화할 대상을 고르세요: 화면, 창, 앱 또는 영역.
3. 'Record'를 누르세요. 다 끝나면 'Stop'과 'Save'를 누르세요.

모든 파일은 저장 후 검사해요: 길이, 화면, 소리 트랙, 무음 구간, 창이 닫혔는지 여부. 문제가 있으면 녹화에 경고로 표시돼요.

파일은 `~/Movies/Bingsu`에 저장돼요. 폴더는 'Settings'에서 바꿀 수 있어요.

## 창, 앱 또는 영역 고르기

- **창**은 다른 창에 가려져도 계속 녹화되고, 그 앱의 소리만 담겨요.
- **앱**은 그 앱의 모든 창을 녹화해요.
- **영역**은 화면의 정해진 부분을 녹화해요. 드래그해서 그리세요.
- **화면**은 그 디스플레이의 모든 것을 녹화해요.

최소화한 창은 화면을 보내지 않아요. 창을 다시 띄울 때까지 녹화에는 마지막 프레임이 반복돼요.

## 소리와 마이크

창이나 앱 녹화에는 그 앱의 소리만 담겨요. 화면 녹화에는 Mac의 소리가 담겨요.

마이크는 몇 개든 추가할 수 있어요. 마이크마다 실시간 음량이 표시되고, 파일에 별도 트랙이 생기며, 어떤 플레이어에서나 재생되는 믹스 트랙 하나에도 들어가요. 마이크 연결이 끊기면 다시 꽂을 때까지 그 트랙은 무음으로 남고, 녹화는 계속돼요.

## 내 카메라와 통화 게스트

패널의 'Camera' 줄에서 카메라를 고르세요. 녹화 위에 버블로 표시되고, 별도 비디오 트랙으로도 저장돼요.

- 버블은 어디로든 끌어서 옮길 수 있어요. 모서리를 끌면 크기가 바뀌어요.
- 도구 막대에서 원형, 둥근 사각형, 와이드로 바꾸고 좌우 반전할 수 있어요.
- 오른쪽 클릭으로 카메라를 끄거나 숨길 수 있어요.

Zoom, Meet, Teams, FaceTime, Slack, Discord, Webex, WhatsApp에서 Bingsu가 통화 창 속 사람들을 찾아 각각 버블로 추가해요. 얼굴은 최대 다섯 개예요. 말하는 사람을 따라가거나 한 사람만 따라갈 수 있어요. 게스트의 목소리는 통화 앱에서 가져와 각자 별도 트랙에 담겨요. 얼굴 찾기는 Mac에서 실행되고, 얼굴에 관한 어떤 정보도 Mac 밖으로 나가거나 보관되지 않아요.

## 일시 정지, 정지, 잠금 화면

- 일시 정지하고 다시 시작해도 파일에 빈틈이 생기지 않아요.
- 녹화 길이를 정하면 정확히 그 초에 멈춰요.
- 화면이 잠기면 Bingsu는 일시 정지했다가 다시 로그인하면 이어서 녹화해요. 'Settings'에서 바꿀 수 있어요.
- Mac이 멈추는 경우에 대비해 Bingsu는 파일을 2초 단위 조각으로 쓰고, 다음에 열 때 쓰다 만 파일을 복구해요.

## 앞뒤 자르기, 구간 잘라 내기, 크롭

편집기에서 녹화를 여세요.

1. 핸들을 끌어 앞뒤를 자르세요.
2. 구간을 잘라 내려면 I와 O로 표시한 다음 X를 누르세요. ⌘Z로 실행 취소해요.
3. 16:9, 9:16, 1:1, 4:3으로 크롭하세요.
4. 사본을 HEVC, H.264, ProRes, GIF 또는 소리만으로 저장하세요.

원본은 절대 바뀌지 않아요. 편집할 때마다 “(edited)”, “(1080p)” 같은 이름의 새 파일이 원본 옆에 저장돼요.

## 확대와 배경

포커스와 프레임은 사본을 저장할 때 더해지고, 원본에는 절대 입혀지지 않아요.

- **포커스**는 클릭하고 입력하는 곳을 부드럽게 확대하고 포인터 움직임을 매끄럽게 해요. 모든 확대는 타임라인에 표시되고, 거기서 옮기거나 바꾸거나 지울 수 있어요.
- **프레임**은 창이나 영역을 여백, 둥근 모서리, 그림자와 함께 배경 위에 올려요.

## 녹취록, 자막, 챕터

Bingsu는 Apple의 온디바이스 음성 모델로 시간이 표시된 녹취록을 만들어요. 아무것도 업로드되지 않고 크레딧도 들지 않아요. Apple Intelligence가 있는 Mac에서는 제목, 짧은 요약, 챕터도 만들어요.

- 자막을 공유 페이지에 표시하거나, 영상 사본에 입혀 넣으세요.
- 녹취록에서 단어를 지워 영상을 잘라 내세요.
- Mac이 지원하는 모든 언어를 쓸 수 있어요. 언어 모델은 처음 쓸 때 macOS가 내려받아요.

'Settings' > 'General' > 'Understand recordings'에서 끌 수 있어요.

## 페이지 공유하기

Bingsu는 녹화를 완전한 웹사이트 폴더로 만들어요: 플레이어, 제목, 챕터, 녹취록, 자막. 이미 사이트를 호스팅하는 곳에 게시하면 돼요. 저희는 페이지도, 링크도, 시청자도 보지 않아요.

| 호스트 | 폴더를 게시할 곳 |
| --- | --- |
| Cloudflare Pages | `npx wrangler pages deploy <folder> --project-name <name>` |
| Vercel | `npx vercel deploy <folder> --prod --yes` |
| Netlify | `npx netlify-cli deploy --dir <folder> --prod` |
| GitHub Pages | `npx gh-pages --add -d <folder> -e <name>` |
| ChatGPT Sites | ChatGPT 앱의 Codex에게 폴더 게시를 요청하세요 |

게시하기 전에 Mac에서 페이지를 미리 보세요. 직접 켜지 않는 한 페이지에서 영상을 내려받을 수 없어요. 주소를 아는 사람은 누구나 볼 수 있으니, 주소는 보여 줄 사람에게만 알려 주세요.

## AI 에이전트 연결하기

[bingsustudio.com/agents](https://bingsustudio.com/agents/#connect)의 연결 프롬프트를 에이전트 앱에 붙여 넣으세요. Mac용 ChatGPT, Claude, Codex, Cursor, Grok Build 등에서 쓸 수 있어요. Bingsu를 로컬 MCP 서버로 추가하고, 잘 작동하는지 확인하고, 무엇을 할 수 있는지 알려 줘요. 같은 페이지에 앱별 직접 설정 방법도 있어요.

에이전트가 처음 녹화를 요청하면 Bingsu가 자체 창에서 물어봐요. 'Settings' > 'Agents'에 허용한 모든 에이전트가 표시되고, 거기서 'Revoke'로 권한을 취소할 수 있어요.

## 에이전트에게 녹화 맡기기

평소 말투로 요청하세요. 예를 들면:

- “테스트를 돌리는 동안 이 창을 소리 없이 녹화해 줘. 다 끝나면 멈추고, 파일을 검사하고, 어디 있는지 알려 줘.”
- “설정 창을 20초 동안 녹화하고, 그걸로 공유 페이지를 만들어서 폴더를 줘.”
- “내 브라우저를 60fps로 30초 동안 녹화하고, 10MB 이하 GIF 사본으로 저장해 줘.”

에이전트는 먼저 `bingsu_screenshot`로 화면을 확인하고, `bingsu_start`로 녹화하며, 검사 결과가 `ok`일 때만 파일을 믿어요. 에이전트의 녹화는 이름과 함께 메뉴 막대에 표시되고, 언제든 멈출 수 있어요.

## 에이전트가 할 수 있는 일

| 도구 | 하는 일 |
| --- | --- |
| `bingsu_sources` | 디스플레이, 창, 앱, 마이크, 카메라를 ID와 함께 나열해요 |
| `bingsu_screenshot` | 소스를 녹화하면 보일 화면 그대로 |
| `bingsu_start` | 소스를 녹화해요. `seconds`와 `wait`를 주면 저장하고 검사한 파일을 돌려줘요 |
| `bingsu_wait`, `bingsu_stop`, `bingsu_pause` | 에이전트 자신의 녹화를 기다리거나, 멈추거나, 일시 정지해요 |
| `bingsu_status` | 녹화 중인 항목, 추가 녹화 여유, 남은 디스크 공간 |
| `bingsu_recordings`, `bingsu_verify` | 최근 녹화와 검사 결과. 파일을 다시 검사해요 |
| `bingsu_export` | 앞뒤를 자르거나, 구간을 잘라 내거나, 크롭하거나, 변환한 사본. 원본을 덮어쓰지 않아요 |
| `bingsu_understand` | Mac에서 만드는 녹취록, 제목, 요약, 챕터 |
| `bingsu_share_page` | 바로 게시할 수 있는 녹화용 웹사이트 폴더 |
| `bingsu_mark`, `bingsu_script`, `bingsu_presenter` | 이름 붙인 단계, 내레이션 대본, 음성 또는 발표자 클립 |

모든 오류에는 고정된 `error` 코드, `message`, `fix`가 있어요.

## 여러 에이전트가 동시에 녹화하게 하기

- 각 에이전트는 자기 녹화만 시작하고, 멈추고, 일시 정지해요. 나는 메뉴 막대에서 모든 녹화를 보고 무엇이든 멈출 수 있어요.
- 에이전트의 창과 앱 녹화는 그 앱의 소리를 스피커로 내보내지 않고 담아요.
- 에이전트는 자기 도구로 브라우저를 조작하고, 내 포인터나 키보드는 절대 쓰지 않아요.
- Bingsu는 녹화를 하나 더 끼워 넣으려고 화질을 낮추지 않아요. 인코더가 꽉 차면 에이전트는 시작 전에 `busy`을 받거나, `queue: true`로 차례를 기다려요.
- 화면 전체가 필요한 에이전트는 `bingsu display add`로 자기 가상 디스플레이를 만들 수 있어요.

## 에이전트용 카메라와 마이크

'Settings' > 'Agents'에서 'Can use the camera and microphones'을 켜기 전까지 에이전트는 카메라나 마이크를 쓸 수 없어요. 처음에는 꺼져 있어요. 꺼져 있을 때 요청한 에이전트는 `devices_off`을 받고, 녹화가 스스로 켜는 일도 없어요.

## 명령줄 사용하기

`bingsu` 명령어는 MCP 도구와 같은 일을 하고, 같은 JSON 응답을 줘요.

```
bingsu record "Safari" --for 30s --json
bingsu edit <id> --start 3.5 --end 1:20 --format gif --max-mb 10
bingsu share-page <id> --title "Design review, new onboarding"
```

종료 코드 3은 파일은 저장됐지만 검사에서 문제가 발견됐다는 뜻이에요. `BINGSU_SESSION`를 스크립트마다 고유한 값으로 설정하면 그 스크립트의 녹화가 따로 관리돼요.

## 업데이트

Bingsu는 하루에 한 번 최신 버전이 적힌 작은 파일을 내려받아 업데이트를 확인해요. 이 요청은 서버에 내 버전만 알리고 다른 정보는 보내지 않아요. 업데이트는 모두 서명되어 있고, Bingsu는 서명이 일치하는 업데이트만 설치해요. 확인 기능은 'Settings'에서 끌 수 있어요. Homebrew를 쓴다면 `brew upgrade`를 실행하세요.

## 개인정보 처리방침

녹화, 녹취록, 설정은 Mac에 남아요. 계정도, 분석도, 충돌 보고도, 원격 측정도 없어요. 연결한 에이전트는 파일 경로, 스크린샷, 녹취록처럼 Bingsu가 돌려준 내용을 보고, 그 앱은 자체 약관에 따라 이를 자기 서버로 보낼 수 있어요. [개인정보 처리방침](https://bingsustudio.com/privacy/)을 읽어 보세요.

## 문제 해결

| 오류 | 해결 방법 |
| --- | --- |
| `permission` | 시스템 설정 > 개인정보 보호 및 보안 > 화면 및 시스템 오디오 녹음에서 Bingsu를 허용하세요 |
| `sound_permission` | macOS가 물으면 허용하거나, 소리 없이 녹화하세요 |
| `device_permission` | 시스템 설정 > 개인정보 보호 및 보안에서 카메라나 마이크를 허용하세요 |
| `devices_off` | 'Settings' > 'Agents'에서 'Can use the camera and microphones'을 켜세요 |
| `agents_off` | 'Settings' > 'Agents'에서 스크립트와 에이전트를 다시 켜세요 |
| `not_found` | 창, 앱 또는 녹화가 없어졌어요. `fix`에 지금 있는 항목이 나와요 |
| `disk_full` | 공간을 확보하세요. Bingsu에는 1GB가 필요해요 |
| `busy` | 녹화 하나를 멈추거나, `queue: true`로 시작하세요 |
| `not_yours` | 자기 녹화를 대상으로 하려면 id를 빼세요 |

그래도 안 되나요? [GitHub에 이슈를 열어 주세요](https://github.com/bingsustudio/bingsu/issues).

## 제거

1. 메뉴에서 Bingsu를 종료하세요.
2. 응용 프로그램 폴더에서 Bingsu를 휴지통으로 끌어다 놓으세요.
3. 명령어 제거: `rm ~/.local/bin/bingsu`
4. 에이전트에서도 제거하세요. 예: `claude mcp remove bingsu`.

녹화는 직접 지우기 전까지 `~/Movies/Bingsu`에 남아 있어요.

## 다음엔 *보여 주세요*.

한 번 녹화하고 링크를 보내세요. 녹화는 에이전트에게 맡겨도 돼요.

[용 다운로드](https://docs.bingsustudio.com/ko/download/#all) [에이전트 연결하기](https://docs.bingsustudio.com/ko/agents/#connect)