# 폴더 (/ko/docs/workspaces/folders)

폴더는 사이드바의 요청 트리에서 요청을 묶으며, 설정도 가지고 있습니다. 폴더에 설정한 인증, 변수, 스크립트는 그 안의 모든 요청에 적용됩니다. 디스크에서
폴더는 `requests/` 아래의 디렉터리이며 `_folder.toml`이 들어 있습니다.

## 폴더 만들기 [#create-a-folder]

- 사이드바에 **요청**이 표시된 상태에서 **파일 › 새로운 폴더**(<kbd>⇧</kbd><kbd>⌘</kbd><kbd>N</kbd>).
- 사이드바에서 <strong>요청</strong> 옆의 <strong>+</strong>를 누른 다음 <strong>새로운 폴더</strong>.
- 폴더를 Control 키를 누른 채 클릭하고 **새로운 폴더**를 선택하면 그 안에 만들어지고, 트리의 빈 공간을 Control 키를 누른 채 클릭하면 최상위에
  만들어집니다.

새 폴더의 이름은 바로 편집할 수 있는 상태가 됩니다. 이름을 입력하고 <kbd>↩</kbd>를 누르세요.

폴더의 컨텍스트 메뉴에서 **새로운 요청**을 선택하면 요청이 그 안에 만들어집니다. **파일 › 새로운 요청**(<kbd>⌘</kbd><kbd>N</kbd>)과 다른
**새로운 … 요청** 명령은 트리에서 현재 위치한 곳에 만듭니다.

## 이름 변경, 복제, 순서 변경 [#rename-duplicate-and-reorder]

요청이나 폴더를 Control 키를 누른 채 클릭하면 메뉴가 나옵니다.

| 명령 | 하는 일 |
| --- | --- |
| **요청 실행** / **폴더 실행** | 검사와 함께 [실행](/docs/requests/runner)에서 실행합니다. |
| **이름 변경** | 이름을 그 자리에서 편집합니다. 선택한 행에서 <kbd>↩</kbd>를 눌러도 같고, <kbd>Esc</kbd>는 중단합니다. |
| **복제** | 요청을 복사합니다(<kbd>⌘</kbd><kbd>D</kbd>). |
| **위로 이동**, **아래로 이동** | 항목을 폴더 안에서 한 칸 옮깁니다. |
| **Finder에서 보기** | 항목의 파일이나 폴더를 보여 줍니다. |
| **휴지통으로 이동…** | 먼저 묻고 휴지통으로 이동합니다. |

폴더에는 **새로운 요청**, **새로운 폴더**, **폴더 설정…**, **OpenAPI 명세에 연결…**(연결한 뒤에는 **OpenAPI 명세에서 변경 사항 확인…**,
[명세](/docs/specs) 참조), **OpenAPI 명세에 문서화…**([트래픽으로 만드는 명세](/docs/specs/specs-from-traffic) 참조), **폴더 내보내기…**
([내보내기](/docs/workspaces/exporting) 참조)도 있습니다.

항목에 지정한 순서는 폴더의 `_folder.toml`에 저장되므로 작업 공간을 여는 모든 사람에게 똑같습니다.

## 키보드와 마우스로 항목 이동 [#move-items-with-the-keyboard-and-the-mouse]

요청 트리에서 <kbd>↑</kbd>와 <kbd>↓</kbd>는 선택을 옮기고, <kbd>→</kbd>는 폴더를 열고, <kbd>←</kbd>는 폴더를 닫거나 위의 폴더로 이동합니다.

요청과 폴더를 끌어서 이동합니다.

- 항목이 놓일 자리에 틈이 열리고 아래 행들이 자리를 내줍니다.
- 열린 폴더의 아래에서는 포인터를 왼쪽이나 오른쪽으로 옮겨 깊이를 정합니다. 폴더 안인지 폴더 뒤인지를 고릅니다.
- 닫힌 폴더 위에 잠시 두면 폴더가 열리므로 그 안의 항목 사이에 놓을 수 있습니다. 이렇게 열린 폴더는 다른 곳에서 끌기가 끝나면 다시 닫힙니다.
- 선택한 여러 항목 중 하나를 끌면 모두 함께 이동합니다.

Finder에서 파일을 트리에 끌어다 놓으면 그 폴더로 [가져옵니다](/docs/get-started/importing). Postman, Insomnia, OpenAPI, HAR와 Echolot이 읽는 다른
형식이 해당됩니다. cURL 명령을 붙여넣거나 끌어다 놓으면 그 명령으로 요청이 만들어집니다.

## 여러 항목 선택 [#select-several-items]

<kbd>⌘</kbd> 키를 누른 채 클릭하면 항목이 추가되거나 빠집니다. <kbd>⇧</kbd> 키를 누른 채 클릭하면 마지막 항목과 이 항목 사이의 모든 것이 선택됩니다.
선택한 항목 중 아무거나 Control 키를 누른 채 클릭하면 모든 항목에 할 수 있는 작업이 나옵니다.

| 명령 | 하는 일 |
| --- | --- |
| **항목 N개 실행** | 실행에서 실행합니다. |
| **요청 N개 편집…** | 선택한 모든 요청의 헤더, 매개변수, 인증을 한꺼번에 변경합니다. |
| **항목 N개를 포함한 새로운 폴더** | 폴더를 만들고 항목을 그 안으로 옮깁니다. |
| **항목 N개를 다음으로 이동** | **작업 공간(최상위)** 또는 아무 폴더로 옮깁니다. |
| **항목 N개를 휴지통으로 이동…** | 먼저 묻고 모두 휴지통으로 이동합니다. |

폴더와 그 안의 항목이 함께 선택되어 있으면 명령은 폴더에 적용됩니다.

<Shot id="workspaces-multi-select-menu" alt="Orders 폴더에서 요청 두 개를 선택한 상태의 컨텍스트 메뉴: 항목 2개 실행, 요청 2개 편집, 항목 2개를 포함한 새로운 폴더, 항목 2개를 다음으로 이동, 항목 2개를 휴지통으로 이동" />

## 여러 요청을 한꺼번에 편집 [#edit-several-requests-at-once]

<strong>요청 N개 편집…</strong>은 <strong>헤더</strong>, <strong>매개변수</strong>, <strong>인증</strong>의 세 탭이 있는 시트를 엽니다. 여기서 한 모든 변경은 <strong>요청 N개에 적용</strong>을 클릭할 때 선택한
각 요청에 적용됩니다.

- **헤더**와 **매개변수**에는 요청 중 하나라도 가지고 있는 모든 헤더나 매개변수가 나열됩니다. 요청마다 값이 다른 항목은 혼합으로 표시되며, 새 값을
  입력하지 않는 한 각 요청에서 그대로 유지됩니다. 일부 요청에 없는 행은 몇 개의 요청이 가지고 있는지 알려 주며, **모두에 추가**로 모든 요청에 넣을 수
  있습니다. 행을 제거하면 모든 요청에서 빠집니다.
- **인증**에는 **각 요청의 설정 유지**, **폴더에서 상속**, **인증 없음**, 또는 선택한 요청 중 하나와 같은 인증(**“List orders”과(와) 동일(Bearer
  토큰)**)이 있습니다. 모두에 새 자격 증명을 주려면 그 폴더에 자격 증명을 설정하고 **폴더에서 상속**을 선택하세요.

변경 전체가 한 단계이므로 **편집 › 실행 취소**가 모든 요청에서 되돌립니다.

<Shot id="workspaces-bulk-edit" alt="헤더 탭이 열린 요청 3개 편집 시트: 세 요청 모두에 있는 헤더와 일부에만 있는 헤더" />

## 폴더 설정 [#folder-settings]

폴더를 Control 키를 누른 채 클릭하고 <strong>폴더 설정…</strong>을 선택합니다. 시트에는 다음 탭이 있습니다.

| 탭 | 설정하는 것 |
| --- | --- |
| **인증** | 자체 인증을 설정하지 않은 안의 모든 요청의 인증. **상속**(기본값)은 위의 폴더 또는 작업 공간의 인증을 아래로 전달합니다. |
| **변수** | 이 폴더의 모든 요청에 대한 변수. 작업 공간과 환경의 변수보다 우선합니다. |
| **스크립트** | 이 폴더의 각 요청 앞뒤에 실행되는 요청 전 스크립트와 테스트 스크립트. |
| **문서** | 폴더에 대한 메모로, `_folder.toml`에 보관됩니다. **이 요청을 에이전트에게 도구로 제공**도 있습니다. [에이전트](/docs/ai/agents)를 참조하세요. |

**완료**를 클릭하면 저장됩니다. 시트를 다른 방식으로 닫거나 윈도우를 닫아도 편집 내용은 유지됩니다.

<Shot id="workspaces-folder-settings" alt="인증 탭이 열린 Orders의 폴더 설정: 토큰 {{token}}을 사용하는 Bearer 토큰 인증" />

Alpenglow에서는 **Orders** 폴더가 `{{token}}`으로 Bearer 인증을 설정하므로, 그 안의 모든 요청은 **Auth › Sign in**이 캡처한 토큰을 보냅니다. 자체
인증을 설정한 요청은 그 인증을 사용합니다.

## 작업 공간 설정 [#workspace-settings]

작업 공간 설정은 상속 사슬의 맨 위로, 작업 공간의 모든 요청이 상속하는 내용입니다. 작업 공간 전환기의 <strong>작업 공간 설정…</strong>으로 열거나, 요청 트리의
빈 공간을 Control 키를 누른 채 클릭하세요.

| 탭 | 설정하는 것 |
| --- | --- |
| **인증** | 모든 요청의 기본 인증. |
| **변수** | 작업 공간 변수로, 환경, 폴더, 요청이 재정의하는 기본값입니다. [환경](/docs/workspaces/environments) 페이지의 **작업 공간**과 같은 목록입니다. |
| **스크립트** | 모든 요청 앞뒤에 실행되는 스크립트. |
| **에이전트** | 이 작업 공간에서 AI 에이전트에게 적용되는 규칙. [에이전트](/docs/ai/agents)를 참조하세요. |
| **프록시** | **앱의 프록시 설정 사용**, 또는 팀원과 명령줄 도구에도 함께 전달되는 이 작업 공간의 프록시. [요청 설정](/docs/requests/settings)을 참조하세요. |
| **인증서** | 신뢰할 CA 인증서와 호스트별로 제시할 클라이언트 인증서. [요청 설정](/docs/requests/settings)을 참조하세요. |

## 요청이 상속하는 방식 [#how-requests-inherit]

인증은 요청이 다음 중 무언가를 설정한 첫 번째 것을 사용합니다. 요청 자체, 요청의 폴더, 그 위의 폴더(가까운 쪽부터 바깥으로), 그다음 작업 공간입니다.

변수는 대신 누적됩니다. 요청은 모든 수준의 변수를 보며, 두 수준이 같은 이름을 정의하면 더 가까운 쪽이 우선합니다. 순서는
[환경](/docs/workspaces/environments#which-value-wins)에 있습니다.

스크립트는 요청 앞뒤에 순서대로 실행됩니다. 작업 공간의 스크립트가 먼저, 그다음 바깥에서 안쪽으로 각 폴더의 스크립트, 마지막으로 요청 자체의
스크립트입니다. [스크립트와 테스트](/docs/requests/scripts-and-tests)를 참조하세요.

헤더는 폴더에서 상속되지 않습니다. 공통 헤더는 <strong>요청 N개 편집…</strong>이나 요청 전 스크립트로 설정하세요.

## 요청을 옮기면 상속하는 내용이 바뀝니다 [#moving-a-request-changes-what-it-inherits]

요청은 자신이 들어 있는 폴더의 인증, 변수, 스크립트를 따릅니다. 다른 폴더로 옮기면 그 폴더의 것을 따릅니다. 이전 폴더의 인증에 의존하던 요청이라면
옮긴 뒤 **인증** 탭을 확인하세요.

## 폴더 삭제 [#deleting-folders]

폴더의 <strong>휴지통으로 이동…</strong>은 먼저 묻고 폴더에 요청이 몇 개 있는지 알려 줍니다. 폴더, 폴더의 설정, 안의 모든 요청이 Finder의 휴지통으로 이동합니다.
**편집 › 실행 취소**로 되돌릴 수 있습니다.