> For the complete documentation index, see [llms.txt](https://bugshot.gitbook.io/ko/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bugshot.gitbook.io/ko/readme/quick-start.md).

# 빠른 시작

처음이라도 걱정 마세요. 설치부터 첫 이슈 제출까지 5분이면 충분합니다. 아래 흐름을 한 번만 천천히 따라 해 보시면, 그다음부터는 손에 익습니다.

## 1. 설치하기

Chrome 웹스토어에서 BugShot을 설치합니다. 설치하면 툴바에 BugShot 아이콘이 생깁니다.

![Chrome 웹스토어 설치 화면](/files/ozE4r8lYmycB9aQj0QAp)

## 2. 사이드패널 열기

툴바의 BugShot 아이콘을 클릭하거나, 단축키 `Cmd/Ctrl+Shift+E`를 누르면 사이드패널이 열립니다.

> 혹시 단축키가 안 먹는다면, OS나 다른 확장과 겹쳐서 배정이 안 된 걸 수 있습니다. 그럴 땐 툴바 아이콘으로 열면 됩니다.

![사이드패널이 열린 모습](/files/gsglyiZaf8FCddUNBEXT)

## 3. 플랫폼 연결하기

이슈를 보내려면 플랫폼이 하나는 연결되어 있어야 합니다. **연동** 탭에서 Jira·GitHub·Linear·Notion·GitLab·Asana 중 하나만 연결하면 됩니다. 자세한 방법은 [플랫폼 연동](/ko/integrations/platforms.md)에서 차근차근 안내해 드립니다.

![연동 탭에서 플랫폼 연결](/files/DtZBO8sjpx7YpdHeye4G)

## 4. 캡처하기

**디버그** 탭에서 캡처 모드를 고릅니다.

* **요소 스타일 편집** — 요소를 골라 스타일을 고친 뒤 before/after로 리포트.
* **요소 캡처** — 요소를 클릭하면 그 요소만 잘라 스크린샷으로.
* **범위 캡처** — 화면 영역을 드래그해 캡처하고 주석으로 표시.
* **화면 녹화** — 동작을 영상으로 녹화.

뭘 골라야 할지 망설여진다면, 처음에는 **범위 캡처**가 가장 간단합니다.

![캡처 모드 선택](/files/zjjlQRto6YYFHteLxQw2)

## 5. 본문 작성하기

캡처하면 이슈 초안 화면으로 넘어갑니다. 제목과 발생 현상·재현 과정·기대 결과를 적으면 되는데, 재현 환경(OS·브라우저·URL 등)은 알아서 채워지니 신경 쓰지 않으셔도 됩니다.

![이슈 초안 작성](/files/p3M8QsoYsbR7dI0Q355K)

## 6. 제출하기

미리보기로 본문을 한 번 확인하고, 연결한 플랫폼의 필드(프로젝트·담당자 등)를 채운 뒤 **이슈 제출**을 누르면 끝입니다. 등록된 이슈 링크가 바로 표시됩니다.

![이슈 제출 완료](/files/DX7QYfHNNZVWw6Z1Mrvp)

***

각 단계의 자세한 내용이 궁금하시면 [요소 선택 & 스타일링](/ko/element.md), [스크린샷 캡처](/ko/screenshot.md), [녹화](/ko/video.md) 섹션에서 이어집니다.

***

🌐 [English](https://bugshot.gitbook.io/en/readme/quick-start)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bugshot.gitbook.io/ko/readme/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.