# Breakpoint

> Proxyman Breakpoint로 HTTP 요청과 응답을 일시 중지하고, 계속 진행되기 전에 URL, 헤더, 상태 코드 또는 본문을 실시간으로 편집할 수 있습니다.

## 1. 기능 소개 {#1-whats-it}

Breakpoint는 개발자가 요청과 응답의 내용을 **실시간으로** 편집할 수 있도록 도와주는 편리한 도구입니다.

**Request**, **Response**, 또는 둘 다에 Breakpoint를 설정할 수 있습니다.

![일치 규칙과 Request, Response 체크박스가 있는 Proxyman Breakpoint 규칙 편집기](https://proxyman.com/docs/assets/Screenshot%202026-06-28%20at%2019.24.05.jpg)

_Breakpoint 규칙 만들기_

> **노트:** [Atlantis Framework](https://proxyman.com/docs/ko/atlantis/atlantis-for-ios)를 사용 중이라면 Breakpoint를 사용할 수 없습니다. 대신 일반 프록시를 사용해야 합니다.

## 동영상 {#video}

[Video: Breakpoint로 요청과 응답 수정하기](https://proxyman.com/videos/breakpoint-tool) (30 seconds)

## 2. 주요 기능 {#2-main-features}

Breakpoint 도구는 나가는 요청이나 들어오는 응답을 멈춰서 데이터를 수정할 수 있게 합니다.

* 요청 URL 수정: Scheme, Host, Path, Port, HTTP Method 포함
* 요청/응답의 HTTP 헤더 수정
* 요청의 Query 또는 Form 항목 수정
* Authorization/Cookie/Set-Cookie 헤더 수정
* 요청/응답의 HTTP 본문 수정
* 응답 HTTP 상태 코드 변경

![편집 가능한 헤더와 Apply & Execute 버튼이 있는 POST 요청에서 일시 중지된 Proxyman Breakpoint 창](https://proxyman.com/docs/assets/proxyman-breakpoint-window-edit-request.jpg)

_헤더, URL, 상태 코드, 본문 수정_

### Raw HTTP 메시지 {#raw-http-message}

Proxyman macOS 6.12.0 이상에서는 Raw 탭으로 전환해 요청/응답 HTTP 메시지를 수정할 수 있습니다. 모든 데이터를 한 곳에서 편집할 수 있습니다.

![유효한 POST 요청 메시지, 헤더, JSON 본문이 표시된 Proxyman Breakpoint Raw 탭](https://proxyman.com/docs/assets/proxyman-breakpoint-raw-tab.jpg)

_Raw HTTP 메시지 편집_

### Breakpoint 동작 {#breakpoint-actions}

| 동작 | 설명 |
| --- | --- |
| Continue Original (⌘.) | 수정 내용을 무시하고 원본 데이터로 요청/응답을 계속 진행합니다 |
| Drop Connection (⌘\\) | Breakpoint를 중단하고 연결을 끊습니다. 옆의 화살표 -> **Abort Mode**를 사용하면 대신 429 또는 503 상태 코드를 반환할 수 있습니다 |
| Apply & Execute (⌘⏎) | 수정 내용을 적용해 요청/응답을 전송합니다 |

> **노트:** Breakpoint 튜토리얼을 확인할 수 있습니다: [Breakpoint로 iOS 앱의 요청과 응답 가로채기 및 편집](https://proxyman.com/posts/2019-09-15-Use-Breakpoint-to-intercept-and-edit-request-response-on-iOS-app)

## 3. Scripting 도구로 Breakpoint 구현 ✅ {#3-breakpoint-by-the-scripting-tool-}

요청을 자동으로 수정하려면 [Scripting](https://proxyman.com/docs/ko/scripting/script#1-whats-it) 도구를 사용합니다. JavaScript 코드를 작성해 Breakpoint와 같은 결과를 더 유연한 방식으로 얻을 수 있습니다.

Breakpoint에 Scripting을 사용하는 방법은 [Scripting 스니펫 코드](https://proxyman.com/docs/ko/scripting/snippet-code#2-common-on-request-and-response)에서 확인할 수 있습니다.

## 4. GraphQL 요청과 Breakpoint {#4-breakpoint-with-graphql-requests}

Proxyman 2.27.0+에서는 특정 QueryName으로 GraphQL 요청에 Breakpoint를 적용할 수 있습니다. 아래 GraphQL 문서에서 자세한 내용을 확인할 수 있습니다.

- [GraphQL 요청 디버깅](https://proxyman.com/docs/ko/advanced-features/graphql)

## 5. 사용 방법 {#5-how-to-use}

다음 방법으로 Breakpoint 규칙을 만들 수 있습니다:

1. 먼저 Proxyman이 HTTPS 요청을 캡처할 수 있는지 확인합니다.
2. 요청을 마우스 오른쪽 버튼으로 클릭 -> **Tools** -> **Breakpoint…**를 선택합니다.
3. Proxyman이 Breakpoint 규칙 창을 열고 Matching Rule을 자동으로 채웁니다.
4. Request, Response 또는 둘 다에 Breakpoint를 선택합니다.
5. **Add**를 클릭해 규칙을 만듭니다.
6. 요청을 다시 보냅니다. Proxyman이 Breakpoint 창을 열면 데이터를 수정할 수 있습니다.
7. **Apply & Execute**를 클릭해 요청/응답을 전송합니다.

## 더 알아보기 {#learn-more}

* [Proxyman Breakpoint 도구로 HTTP 요청/응답 수정하기](https://proxyman.com/posts/2021-12-31-Modify-URL-Request-With-Breakpoint)
* [테스트를 위해 HTTP 응답 상태 코드, 헤더, 본문을 변경하는 방법](https://proxyman.com/posts/change-response-status-code-header-for-testing)
* [Breakpoint 도구로 GraphQL 요청 조작하기](https://proxyman.com/posts/2023-03-16-GraphQL-Request-With-Breakpoint)