Documentation 2026-09-22 23:59 UTC to 2026-09-23 23:57 UTC

1713`terminal_slash_commands`는 `exit`와 같은 로컬 터미널에 바인드된 인터페이스를 가진 `slash_commands`의 항목을 명명합니다. 다른 `slash_commands` 항목처럼 보낼 수 있습니다. 필드는 원격 또는 모바일 클라이언트가 명령 메뉴에서 이를 숨길 수 있도록 존재합니다. 필드는 비어 있지 않을 때만 있으며 Agent SDK v0.3.229 이상이 필요합니다.1713`terminal_slash_commands`는 `exit`와 같은 로컬 터미널에 바인드된 인터페이스를 가진 `slash_commands`의 항목을 명명합니다. 다른 `slash_commands` 항목처럼 보낼 수 있습니다. 필드는 원격 또는 모바일 클라이언트가 명령 메뉴에서 이를 숨길 수 있도록 존재합니다. 필드는 비어 있지 않을 때만 있으며 Agent SDK v0.3.229 이상이 필요합니다.

1714 1714 

1715* 각 `mcp_servers` 항목의 `source`: 서버 정의가 어디에서 나왔는지로, [`McpServerStatus`](#mcpserverstatus)의 `source`와 동일한 값입니다. Agent SDK v0.3.274 이상이 필요합니다.1715* 각 `mcp_servers` 항목의 `source`: 서버 정의가 어디에서 나왔는지로, [`McpServerStatus`](#mcpserverstatus)의 `source`와 동일한 값입니다. Agent SDK v0.3.274 이상이 필요합니다.

1716* `effort`: [노력 수준](/docs/ko/model-config#adjust-effort-level) Claude Code가 세션의 다음 요청에서 보내거나 보내지 않을 때 `null`입니다. Claude Code는 [Remote Control](/docs/ko/remote-control) 클라이언트로 보내는 초기화 메시지에만 필드를 설정하고 애플리케이션이 읽는 초기화 메시지에서 생략합니다. Agent SDK v0.3.234 이상이 필요합니다.1716*

1717 

1718`effort`: [노력 수준](/docs/ko/model-config#adjust-effort-level) Claude Code가 세션의 다음 요청에서 보내거나 보내지 않을 때 `null`입니다. Claude Code는 [Remote Control](/docs/ko/remote-control) 클라이언트로 보내는 초기화 메시지에만 필드를 설정하고 애플리케이션이 읽는 초기화 메시지에서 생략합니다. Agent SDK v0.3.234 이상이 필요합니다.

1717 1719 

1718`capabilities` 배열은 이 CLI가 구현하는 프로토콜 동작의 이름을 지정하므로 `claude_code_version` 문자열을 비교하는 대신 기능을 감지할 수 있습니다. 이는 열린 집합입니다: 인식하지 못하는 값을 무시하고 동작이 의존하는 특정 기능을 확인합니다. 필드는 Claude Code v2.1.205 이상이 필요하며 이전 CLI에는 없습니다.1720`capabilities` 배열은 이 CLI가 구현하는 프로토콜 동작의 이름을 지정하므로 `claude_code_version` 문자열을 비교하는 대신 기능을 감지할 수 있습니다. 이는 열린 집합입니다: 인식하지 못하는 값을 무시하고 동작이 의존하는 특정 기능을 확인합니다. 필드는 Claude Code v2.1.205 이상이 필요하며 이전 CLI에는 없습니다.

1719 1721 

1720| 기능 | 의미 |1722| 기능 | 의미 |

1721| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1723| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |

1722| `interrupt_receipt_v1` | [`interrupt()`](#query-object)는 인터럽트가 도착했을 때 보류 중인 메시지를 나열하는 [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) 영수증으로 해결됩니다 |1724| `interrupt_receipt_v1` | [`interrupt()`](#query-object)는 인터럽트가 도착했을 때 보류 중인 메시지를 나열하는 [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) 영수증으로 해결됩니다 |

1723| `interrupt_cancel_queued_v1` | `interrupt` 제어 요청이 `cancel_queued: true`를 준수하여 영수증이 `still_queued` 아래에 나열할 메시지를 취소하고 대신 `cancelled` 아래에 나열합니다. [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse)를 참조하세요. Claude Code v2.1.219 이상이 필요합니다 |1725| `interrupt_cancel_queued_v1` | |

1726| `interrupt` 제어 요청이 `cancel_queued: true`를 준수하여 영수증이 `still_queued` 아래에 나열할 메시지를 취소하고 대신 `cancelled` 아래에 나열합니다. [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse)를 참조하세요. Claude Code v2.1.219 이상이 필요합니다 | |

1724 1727 

1725<h3 id="sdkpartialassistantmessage">1728<h3 id="sdkpartialassistantmessage">

1726 `SDKPartialAssistantMessage`1729 `SDKPartialAssistantMessage`

2005Claude Code가 작업 알림을 세션에 전달할 때, Anthropic 서버가 해당 알림이 어디에서 나왔는지 확인했으면 알림의 `origin`에 `subkind`를 설정합니다. 또한 애플리케이션이 [메시지를 예약된 실행으로 선언](#declare-a-scheduled-run)할 때 `subkind`를 설정하며, TypeScript Agent SDK v0.3.280 이상이 필요합니다. `subkind`는 Claude Code v2.1.213 이상이 필요하며 두 가지 값 중 하나를 취합니다:2008Claude Code가 작업 알림을 세션에 전달할 때, Anthropic 서버가 해당 알림이 어디에서 나왔는지 확인했으면 알림의 `origin`에 `subkind`를 설정합니다. 또한 애플리케이션이 [메시지를 예약된 실행으로 선언](#declare-a-scheduled-run)할 때 `subkind`를 설정하며, TypeScript Agent SDK v0.3.280 이상이 필요합니다. `subkind`는 Claude Code v2.1.213 이상이 필요하며 두 가지 값 중 하나를 취합니다:

2006 2009 

2007* `scheduled-trigger`: 알림은 [루틴](/docs/ko/routines)의 저장된 프롬프트로, 루틴의 트리거 중 하나가 발생했기 때문에 전달됩니다: 일정, [API 트리거](/docs/ko/routines#add-an-api-trigger), [GitHub 트리거](/docs/ko/routines#add-a-github-trigger), 또는 **지금 실행**. 애플리케이션이 [예약된 실행으로 선언](#declare-a-scheduled-run)하는 프롬프트도 이 값을 전달합니다. Claude Code는 이를 세션의 할당된 작업으로 모델에 프레임하며, [다른 작업 알림이 전달하는 알림](#sdktasknotificationmessage)과 다른 알림입니다.2010* `scheduled-trigger`: 알림은 [루틴](/docs/ko/routines)의 저장된 프롬프트로, 루틴의 트리거 중 하나가 발생했기 때문에 전달됩니다: 일정, [API 트리거](/docs/ko/routines#add-an-api-trigger), [GitHub 트리거](/docs/ko/routines#add-a-github-trigger), 또는 **지금 실행**. 애플리케이션이 [예약된 실행으로 선언](#declare-a-scheduled-run)하는 프롬프트도 이 값을 전달합니다. Claude Code는 이를 세션의 할당된 작업으로 모델에 프레임하며, [다른 작업 알림이 전달하는 알림](#sdktasknotificationmessage)과 다른 알림입니다.

2008* `peer-send-message`: 알림은 [교차 세션 `SendMessage` 도구](/docs/ko/cross-session-messaging)가 아니라 [클라우드 세션](/docs/ko/claude-code-on-the-web)이 서로 메시지를 보내는 데 사용하는 서버 측 `send_message` 도구로 다른 세션이 보낸 메시지이며, Anthropic 서버가 두 세션이 동일한 비공개 세션 그룹에 속한다고 확인했습니다. Claude Code v2.1.224 이상이 필요합니다. 서버가 그런 식으로 확인하지 않은 `send_message` 전달은 `subkind`를 얻지 못합니다.2011*

2012 

2013`peer-send-message`: 알림은 [교차 세션 `SendMessage` 도구](/docs/ko/cross-session-messaging)가 아니라 [클라우드 세션](/docs/ko/claude-code-on-the-web)이 서로 메시지를 보내는 데 사용하는 서버 측 `send_message` 도구로 다른 세션이 보낸 메시지이며, Anthropic 서버가 두 세션이 동일한 비공개 세션 그룹에 속한다고 확인했습니다. Claude Code v2.1.224 이상이 필요합니다. 서버가 그런 식으로 확인하지 않은 `send_message` 전달은 `subkind`를 얻지 못합니다.

2009 2014 

2010다른 모든 작업 알림에는 `subkind`가 없습니다. 여기에는 [PR 활동](/docs/ko/claude-code-on-the-web#how-claude-responds-to-pr-activity)이 세션에 전달되고 완료된 작업과 같은 백그라운드 이벤트가 포함됩니다. [교차 세션 `SendMessage` 도구](/docs/ko/cross-session-messaging)의 메시지는 작업 알림이 아닙니다: 동일한 머신의 세션에서 오든 다른 머신의 Anthropic 서버를 통해 오든 Claude Code는 `kind: "peer"`를 제공하고 [피어 원점 필드](#peer-origin-fields)를 제공합니다.2015다른 모든 작업 알림에는 `subkind`가 없습니다. 여기에는 [PR 활동](/docs/ko/claude-code-on-the-web#how-claude-responds-to-pr-activity)이 세션에 전달되고 완료된 작업과 같은 백그라운드 이벤트가 포함됩니다. [교차 세션 `SendMessage` 도구](/docs/ko/cross-session-messaging)의 메시지는 작업 알림이 아닙니다: 동일한 머신의 세션에서 오든 다른 머신의 Anthropic 서버를 통해 오든 Claude Code는 `kind: "peer"`를 제공하고 [피어 원점 필드](#peer-origin-fields)를 제공합니다.

2011 2016 

2024`peer` 원점은 메시지를 보낸 에이전트를 식별합니다: `SendMessage`로 `main`에 보내는 프로세스 내 [팀원](/docs/ko/agent-teams) 또는 [교차 세션 피어](/docs/ko/cross-session-messaging), 다른 Claude Code 세션입니다. 교차 세션 피어는 macOS 및 Linux에서 Claude Code v2.1.224 이상이 필요합니다. [교차 세션 메시징 가용성](/docs/ko/cross-session-messaging#availability)에서 네이티브 Windows 요구 사항을 참조하세요. 교차 세션 피어는 동일한 머신에서 실행되거나 [다른 머신](/docs/ko/cross-session-messaging#message-sessions-on-other-machines)에서 또는 [클라우드](/docs/ko/claude-code-on-the-web)에서 Remote Control을 통해 메시지가 도착할 때 실행될 수 있습니다. 두 종류의 발신자는 필드를 다르게 채웁니다:2029`peer` 원점은 메시지를 보낸 에이전트를 식별합니다: `SendMessage`로 `main`에 보내는 프로세스 내 [팀원](/docs/ko/agent-teams) 또는 [교차 세션 피어](/docs/ko/cross-session-messaging), 다른 Claude Code 세션입니다. 교차 세션 피어는 macOS 및 Linux에서 Claude Code v2.1.224 이상이 필요합니다. [교차 세션 메시징 가용성](/docs/ko/cross-session-messaging#availability)에서 네이티브 Windows 요구 사항을 참조하세요. 교차 세션 피어는 동일한 머신에서 실행되거나 [다른 머신](/docs/ko/cross-session-messaging#message-sessions-on-other-machines)에서 또는 [클라우드](/docs/ko/claude-code-on-the-web)에서 Remote Control을 통해 메시지가 도착할 때 실행될 수 있습니다. 두 종류의 발신자는 필드를 다르게 채웁니다:

2025 2030 

2026* `from`: 팀원의 이름 또는 교차 세션 피어의 발신자 주소입니다. [일방향 교차 머신 메시지](/docs/ko/cross-session-messaging#message-sessions-on-other-machines)의 경우 발신자는 회신 주소가 없고 `from`은 `"unknown"`입니다. 값은 발신자가 작성한 것입니다. `verifiedPeerPid`는 확인된 신원입니다.2031* `from`: 팀원의 이름 또는 교차 세션 피어의 발신자 주소입니다. [일방향 교차 머신 메시지](/docs/ko/cross-session-messaging#message-sessions-on-other-machines)의 경우 발신자는 회신 주소가 없고 `from`은 `"unknown"`입니다. 값은 발신자가 작성한 것입니다. `verifiedPeerPid`는 확인된 신원입니다.

2027* `fromMode`: 발신 세션의 권한 클래스로, `bypass` 또는 `prompting`이며, [데스크톱 앱](/docs/ko/desktop#work-across-sessions)과 같이 세션 간에 피어 메시지를 중계하는 호스트에서 선언합니다. Claude Code는 [인바운드 제어](/docs/ko/cross-session-messaging#control-inbound-messages)를 적용할 때 수신 세션에서 읽습니다. Agent SDK v0.3.234 이상이 필요합니다.2032*

2033 

2034`fromMode`: 발신 세션의 권한 클래스로, `bypass` 또는 `prompting`이며, [데스크톱 앱](/docs/ko/desktop#work-across-sessions)과 같이 세션 간에 피어 메시지를 중계하는 호스트에서 선언합니다. Claude Code는 [인바운드 제어](/docs/ko/cross-session-messaging#control-inbound-messages)를 적용할 때 수신 세션에서 읽습니다. Agent SDK v0.3.234 이상이 필요합니다.

2035 

2028* `senderTaskId`: 팀원의 작업 ID입니다. 교차 세션 피어의 경우 없습니다.2036* `senderTaskId`: 팀원의 작업 ID입니다. 교차 세션 피어의 경우 없습니다.

2029* `name`: 발신자의 표시 이름으로, Claude Code에서 정규화됩니다: Unicode 제어, 형식, 대리, 줄 또는 단락 구분 기호 코드 포인트를 제거한 다음 결과를 자르고 64개 코드 포인트로 제한하고 줄임표를 추가합니다. Claude Code v2.1.205 이상이 필요합니다.2037*

2030* `body`: 피어 봉투가 제거된 디코딩된 메시지 본문로, 모델이 보는 것과 바이트 정확합니다. 팀원 메시지의 경우 항상 있습니다. 교차 세션 피어의 경우 턴이 정확히 Claude Code에서 형성한 하나의 피어 봉투일 때만 있습니다. 메시지 텍스트를 다시 구문 분석하는 대신 `name`과 `body`를 렌더링합니다. Claude Code v2.1.205 이상이 필요합니다.2038 

2031* `fromSession`: 발신자의 호스트 열기 가능 세션 ID로, 발신자의 호스트에서 설정하여 UI가 발신 세션으로 다시 링크할 수 있습니다. `from`과 마찬가지로 발신자가 주장한 것입니다: 네비게이션 대상으로만 사용하고 발신자의 신원 증명으로 취급하지 마세요. Claude Code v2.1.216 이상이 필요합니다.2039`name`: 발신자의 표시 이름으로, Claude Code에서 정규화됩니다: Unicode 제어, 형식, 대리, 줄 또는 단락 구분 기호 코드 포인트를 제거한 다음 결과를 자르고 64개 코드 포인트로 제한하고 줄임표를 추가합니다. Claude Code v2.1.205 이상이 필요합니다.

2032* `verifiedPeerPid`: 이 세션의 교차 세션 메시징 소켓에 연결된 프로세스의 프로세스 ID로, 커널에서 확인하고 페이로드가 아닌 연결 자체에서 읽습니다. 발신자를 식별하려면 `from`이 아니라 이를 사용합니다: `from`은 동일한 사용자 프로세스에서 위조 가능합니다. 필드는 Claude Code가 확인할 수 없을 때 없으며, 예를 들어 Windows 또는 비소켓 수신에서 없으므로 없는 값은 발신자가 확인되지 않음을 의미합니다. 중계된 트래픽의 경우 메시지의 작성자가 아니라 중계를 식별하고 프로세스 ID는 재활용 가능하므로 인증 토큰이 아니라 출처로 취급합니다. Claude Code v2.1.216 이상이 필요합니다.2040 

2041*

2042 

2043`body`: 피어 봉투가 제거된 디코딩된 메시지 본문로, 모델이 보는 것과 바이트 정확합니다. 팀원 메시지의 경우 항상 있습니다. 교차 세션 피어의 경우 턴이 정확히 Claude Code에서 형성한 하나의 피어 봉투일 때만 있습니다. 메시지 텍스트를 다시 구문 분석하는 대신 `name`과 `body`를 렌더링합니다. Claude Code v2.1.205 이상이 필요합니다.

2044 

2045*

2046 

2047`fromSession`: 발신자의 호스트 열기 가능 세션 ID로, 발신자의 호스트에서 설정하여 UI가 발신 세션으로 다시 링크할 수 있습니다. `from`과 마찬가지로 발신자가 주장한 것입니다: 네비게이션 대상으로만 사용하고 발신자의 신원 증명으로 취급하지 마세요. Claude Code v2.1.216 이상이 필요합니다.

2048 

2049*

2050 

2051`verifiedPeerPid`: 이 세션의 교차 세션 메시징 소켓에 연결된 프로세스의 프로세스 ID로, 커널에서 확인하고 페이로드가 아닌 연결 자체에서 읽습니다. 발신자를 식별하려면 `from`이 아니라 이를 사용합니다: `from`은 동일한 사용자 프로세스에서 위조 가능합니다. 필드는 Claude Code가 확인할 수 없을 때 없으며, 예를 들어 Windows 또는 비소켓 수신에서 없으므로 없는 값은 발신자가 확인되지 않음을 의미합니다. 중계된 트래픽의 경우 메시지의 작성자가 아니라 중계를 식별하고 프로세스 ID는 재활용 가능하므로 인증 토큰이 아니라 출처로 취급합니다. Claude Code v2.1.216 이상이 필요합니다.

2033 2052 

2034<h2 id="hook-types">2053<h2 id="hook-types">

2035 훅 타입2054 훅 타입

354| 조직 정책 | 고객 관리 암호화 키(CMEK), HIPAA 및 [Zero Data Retention](/docs/ko/zero-data-retention)이 조직에 대해 활성화되지 않았습니다. |354| 조직 정책 | 고객 관리 암호화 키(CMEK), HIPAA 및 [Zero Data Retention](/docs/ko/zero-data-retention)이 조직에 대해 활성화되지 않았습니다. |

355| 표면 | Claude Code CLI 또는 Claude 데스크톱 앱 버전 1.13576.0 이상. [Claude Tag](https://claude.com/docs/claude-tag/overview) 세션도 Claude Tag와 artifacts가 조직에 대해 활성화된 경우 artifacts를 게시할 수 있습니다. [Agent SDK](/docs/ko/agent-sdk/overview), GitHub Action 및 MCP-server 컨텍스트에서는 기본적으로 비활성화되며, [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ko/env-vars)이 설정된 경우에도 비활성화됩니다. |355| 표면 | Claude Code CLI 또는 Claude 데스크톱 앱 버전 1.13576.0 이상. [Claude Tag](https://claude.com/docs/claude-tag/overview) 세션도 Claude Tag와 artifacts가 조직에 대해 활성화된 경우 artifacts를 게시할 수 있습니다. [Agent SDK](/docs/ko/agent-sdk/overview), GitHub Action 및 MCP-server 컨텍스트에서는 기본적으로 비활성화되며, [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ko/env-vars)이 설정된 경우에도 비활성화됩니다. |

356 356 

357조직에서 artifacts가 허용되는지 여부는 Claude Code가 `api.anthropic.com`에서 로드하는 조직의 정책에서 나옵니다. Claude Code가 정책을 로드할 수 없으면 artifacts를 사용할 수 없습니다. 사용자가 요청하면 Claude가 그 이유를 설명합니다.

358 

359프록시, VPN 또는 웹 필터가 관련된 경우 IT 관리자에게 `api.anthropic.com`을 허용하도록 요청하십시오. Claude Code는 백그라운드에서 계속 재시도하며, 정책이 로드되고 이를 허용하면 artifacts를 사용할 수 있게 됩니다.

360 

357<h2 id="disable-artifacts">361<h2 id="disable-artifacts">

358 아티팩트 비활성화362 아티팩트 비활성화

359</h2>363</h2>

7> 브라우저, 휴대폰, 데스크톱 앱 또는 터미널에서 클라우드의 Claude Code 세션을 실행하고, --cloud 및 --teleport로 이동하며, pull request를 자동 수정합니다.7> 브라우저, 휴대폰, 데스크톱 앱 또는 터미널에서 클라우드의 Claude Code 세션을 실행하고, --cloud 및 --teleport로 이동하며, pull request를 자동 수정합니다.

8 8 

9<Note>9<Note>

10 클라우드 세션은 Pro, Max 및 Team 사용자, 그리고 프리미엄 시트 또는 Chat + Claude Code 시트가 있는 Enterprise 사용자를 위한 연구 미리보기 상태입니다.10 클라우드 세션은 Pro, Max 및 Team 사용자, 그리고 프리미엄 시트 또는 Chat + Claude Code 시트가 있는 Enterprise 사용자를 위해 제공됩니다.

11</Note>11</Note>

12 12 

13클라우드 세션은 사용자의 머신 대신 클라우드 인프라에서 실행되는 Claude Code 세션입니다. 기본적으로 Anthropic이 관리하는 인프라에서 실행되거나, 라우팅될 때 조직의 [자체 호스팅 환경](/docs/ko/self-hosted-environments)에서 실행됩니다. 세션은 노트북을 닫은 후에도 계속 실행되며, 모든 기기에서 확인하거나 조종할 수 있습니다.13클라우드 세션은 사용자의 머신 대신 클라우드 인프라에서 실행되는 Claude Code 세션입니다. 기본적으로 Anthropic이 관리하는 인프라에서 실행되거나, 라우팅될 때 조직의 [자체 호스팅 환경](/docs/ko/self-hosted-environments)에서 실행됩니다. 세션은 노트북을 닫은 후에도 계속 실행되며, 모든 기기에서 확인하거나 조종할 수 있습니다.

7> Claude Code 클라우드 세션을 위한 클라우드 환경 구성: 네트워크 액세스 수준, 환경 변수, 설정 스크립트 및 환경 캐싱.7> Claude Code 클라우드 세션을 위한 클라우드 환경 구성: 네트워크 액세스 수준, 환경 변수, 설정 스크립트 및 환경 캐싱.

8 8 

9<Note>9<Note>

10 클라우드 환경은 [클라우드 세션](/docs/ko/claude-code-on-the-web)에 적용되며, 이는 Pro, Max, Team 사용자를 위한 연구 미리보기이고, [프리미엄 시트 또는 Chat + Claude Code 시트](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan)가 있는 Enterprise 사용자를 위한 것입니다.10 클라우드 환경은 [클라우드 세션](/docs/ko/claude-code-on-the-web)에 적용되며, 이는 Pro, Max, Team 플랜에서 사용 가능하고, [프리미엄 시트 또는 Chat + Claude Code 시트](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan)가 있는 Enterprise 사용자를 위한 것입니다.

11</Note>11</Note>

12 12 

13각 [클라우드 세션](/docs/ko/claude-code-on-the-web)은 클라우드 환경에서 실행됩니다. 환경을 구성하여 [네트워크 액세스](#access-levels)를 허용하거나 거부하고, 세션에 대한 [환경 변수](#set-environment-variables)를 설정하며, Pro 및 Max 플랜에서 세션이 사용하는 [API 자격 증명](#add-api-credentials)을 저장하고, Claude가 작업을 시작하기 전에 [설정 스크립트](#setup-scripts)를 실행할 수 있습니다.13각 [클라우드 세션](/docs/ko/claude-code-on-the-web)은 클라우드 환경에서 실행됩니다. 환경을 구성하여 [네트워크 액세스](#access-levels)를 허용하거나 거부하고, 세션에 대한 [환경 변수](#set-environment-variables)를 설정하며, Pro 및 Max 플랜에서 세션이 사용하는 [API 자격 증명](#add-api-credentials)을 저장하고, Claude가 작업을 시작하기 전에 [설정 스크립트](#setup-scripts)를 실행할 수 있습니다.

311| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 연결 중 IDE 잠금 파일 항목의 유효성 검사를 건너뛰려면 `1`로 설정하세요. 자동 연결이 실행 중인 IDE를 찾지 못할 때 사용합니다 |311| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 연결 중 IDE 잠금 파일 항목의 유효성 검사를 건너뛰려면 `1`로 설정하세요. 자동 연결이 실행 중인 IDE를 찾지 못할 때 사용합니다 |

312| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent 도구가 다른 것을 생성하기를 거부하기 전에 한 세션에서 실행할 수 있는 [서브에이전트](/docs/ko/sub-agents#concurrent-subagent-limit) 수입니다(기본값: 20). 일반 숫자로 양의 정수를 허용합니다. 다른 것은 무시되므로 변수는 상한을 조정할 수 있지만 비활성화할 수 없습니다. Claude Code v2.1.217 이상이 필요합니다 |312| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent 도구가 다른 것을 생성하기를 거부하기 전에 한 세션에서 실행할 수 있는 [서브에이전트](/docs/ko/sub-agents#concurrent-subagent-limit) 수입니다(기본값: 20). 일반 숫자로 양의 정수를 허용합니다. 다른 것은 무시되므로 변수는 상한을 조정할 수 있지만 비활성화할 수 없습니다. Claude Code v2.1.217 이상이 필요합니다 |

313| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code가 활성 모델에 대해 가정하는 컨텍스트 창 크기를 재정의합니다. v2.1.193부터 적용 방식은 Claude Code가 모델 ID를 확인하는 방식에 따라 다릅니다. [게이트웨이 또는 사용자 정의 모델 ID의 창 수정](/docs/ko/model-config#correct-the-window-for-a-gateway-or-custom-model-id)을 참조하세요. `ANTHROPIC_BASE_URL`을 통해 컨텍스트 창이 이름의 기본 제공 크기와 일치하지 않는 모델로 라우팅할 때 사용합니다 |313| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code가 활성 모델에 대해 가정하는 컨텍스트 창 크기를 재정의합니다. v2.1.193부터 적용 방식은 Claude Code가 모델 ID를 확인하는 방식에 따라 다릅니다. [게이트웨이 또는 사용자 정의 모델 ID의 창 수정](/docs/ko/model-config#correct-the-window-for-a-gateway-or-custom-model-id)을 참조하세요. `ANTHROPIC_BASE_URL`을 통해 컨텍스트 창이 이름의 기본 제공 크기와 일치하지 않는 모델로 라우팅할 때 사용합니다 |

314| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code가 모델로 전송하는 각 MCP 도구 설명 및 각 MCP 서버의 지침의 최대 길이(문자)(기본값: 2048). Claude Code는 [더 긴 텍스트를 잘라냅니다](/docs/ko/mcp#for-mcp-server-authors). 일반 숫자로 양의 정수를 허용합니다. 다른 것은 무시되고 기본값이 적용됩니다. Claude Code v2.1.280 이상이 필요합니다 |

314| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 대부분의 요청에 대한 최대 출력 토큰 수를 설정합니다. 기본값 및 상한은 모델에 따라 다릅니다. [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)을 참조하세요. Claude Code는 인식하지 못하는 모델 ID(예: 게이트웨이 특정 이름)에 대해 기본값 32000을 사용하고 모델의 상한 이상의 값을 상한으로 낮춥니다. 이 값을 증가시키면 [자동 압축](/docs/ko/costs#reduce-token-usage)이 트리거되기 전에 사용 가능한 유효 컨텍스트 창이 감소합니다 |315| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 대부분의 요청에 대한 최대 출력 토큰 수를 설정합니다. 기본값 및 상한은 모델에 따라 다릅니다. [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)을 참조하세요. Claude Code는 인식하지 못하는 모델 ID(예: 게이트웨이 특정 이름)에 대해 기본값 32000을 사용하고 모델의 상한 이상의 값을 상한으로 낮춥니다. 이 값을 증가시키면 [자동 압축](/docs/ko/costs#reduce-token-usage)이 트리거되기 전에 사용 가능한 유효 컨텍스트 창이 감소합니다 |

315| `CLAUDE_CODE_MAX_RETRIES` | 실패한 API 요청을 재시도할 횟수를 재정의합니다(기본값: 10). v2.1.186부터 15로 제한됩니다. v2.1.199부터 `CLAUDE_CODE_RETRY_WATCHDOG`이 기본값을 올리고 상한을 제거합니다. 더 오래 중단되지 않은 세션이 더 긴 중단을 기다려야 할 때 `CLAUDE_CODE_RETRY_WATCHDOG`을 대신 설정하세요 |316| `CLAUDE_CODE_MAX_RETRIES` | 실패한 API 요청을 재시도할 횟수를 재정의합니다(기본값: 10). v2.1.186부터 15로 제한됩니다. v2.1.199부터 `CLAUDE_CODE_RETRY_WATCHDOG`이 기본값을 올리고 상한을 제거합니다. 더 오래 중단되지 않은 세션이 더 긴 중단을 기다려야 할 때 `CLAUDE_CODE_RETRY_WATCHDOG`을 대신 설정하세요 |

316| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224에서 제거되었으며 이제 작동하지 않습니다. 이전에는 한 세션에서 Agent 도구로 Claude가 생성할 수 있는 [서브에이전트](/docs/ko/sub-agents)의 총 수를 제한했습니다(기본값: 200). 상한을 초과하여 생성하면 `Subagent spawn limit reached`로 실패했습니다. [동시 서브에이전트 제한](/docs/ko/sub-agents#concurrent-subagent-limit) 및 [깊이 제한](/docs/ko/sub-agents#let-subagents-spawn-their-own-subagents)은 여전히 적용됩니다 |317| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224에서 제거되었으며 이제 작동하지 않습니다. 이전에는 한 세션에서 Agent 도구로 Claude가 생성할 수 있는 [서브에이전트](/docs/ko/sub-agents)의 총 수를 제한했습니다(기본값: 200). 상한을 초과하여 생성하면 `Subagent spawn limit reached`로 실패했습니다. [동시 서브에이전트 제한](/docs/ko/sub-agents#concurrent-subagent-limit) 및 [깊이 제한](/docs/ko/sub-agents#let-subagents-spawn-their-own-subagents)은 여전히 적용됩니다 |

340| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 새 버전을 사용할 수 있을 때 Claude Code가 백그라운드에서 패키지 관리자의 업그레이드 명령을 실행하도록 하려면 `1`로 설정하세요. Homebrew 및 WinGet 설치에 적용됩니다. 다른 패키지 관리자는 업그레이드 명령을 실행하지 않고 계속 표시합니다. [자동 업데이트](/docs/ko/setup#auto-updates)를 참조하세요 |341| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 새 버전을 사용할 수 있을 때 Claude Code가 백그라운드에서 패키지 관리자의 업그레이드 명령을 실행하도록 하려면 `1`로 설정하세요. Homebrew 및 WinGet 설치에 적용됩니다. 다른 패키지 관리자는 업그레이드 명령을 실행하지 않고 계속 표시합니다. [자동 업데이트](/docs/ko/setup#auto-updates)를 참조하세요 |

341| `CLAUDE_CODE_PERFORCE_MODE` | Perforce 인식 쓰기 보호를 활성화하려면 `1`로 설정하세요. 설정하면 Edit, Write 및 NotebookEdit이 대상 파일에 소유자 쓰기 비트가 없으면 `p4 edit <file>` 힌트로 실패합니다. Perforce는 `p4 edit`이 파일을 열 때까지 동기화된 파일에서 이를 지웁니다. 이는 Claude Code가 Perforce 변경 추적을 우회하는 것을 방지합니다 |342| `CLAUDE_CODE_PERFORCE_MODE` | Perforce 인식 쓰기 보호를 활성화하려면 `1`로 설정하세요. 설정하면 Edit, Write 및 NotebookEdit이 대상 파일에 소유자 쓰기 비트가 없으면 `p4 edit <file>` 힌트로 실패합니다. Perforce는 `p4 edit`이 파일을 열 때까지 동기화된 파일에서 이를 지웁니다. 이는 Claude Code가 Perforce 변경 추적을 우회하는 것을 방지합니다 |

342| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | 플러그인 루트 디렉토리를 재정의합니다. 이름에도 불구하고 이는 캐시 자체가 아니라 부모 디렉토리를 설정합니다: 마켓플레이스 및 플러그인 캐시는 이 경로 아래의 하위 디렉토리에 있습니다. 기본값은 `~/.claude/plugins`입니다 |343| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | 플러그인 루트 디렉토리를 재정의합니다. 이름에도 불구하고 이는 캐시 자체가 아니라 부모 디렉토리를 설정합니다: 마켓플레이스 및 플러그인 캐시는 이 경로 아래의 하위 디렉토리에 있습니다. 기본값은 `~/.claude/plugins`입니다 |

344| `CLAUDE_CODE_PLUGIN_DIRS` | 세션에 로드할 플러그인 디렉토리입니다. [`--plugin-dir`](/docs/ko/plugins#test-your-plugins-locally) 플래그가 로드하는 방식으로 각각 로드됩니다. Unix에서는 `:`로 구분되고 Windows에서는 `;`로 구분됩니다. 각 경로를 절대 경로로 제공하거나 `~`로 시작하세요. Claude Code는 상대 경로를 건너뜁니다. Claude Code v2.1.280 이상이 필요합니다 |

343| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | 플러그인을 설치하거나 업데이트할 때 git 작업의 타임아웃(밀리초)(기본값: 120000). 큰 리포지토리나 느린 네트워크 연결의 경우 이 값을 증가시키세요. [Git 작업 타임아웃](/docs/ko/plugin-marketplaces#git-operations-time-out)을 참조하세요 |345| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | 플러그인을 설치하거나 업데이트할 때 git 작업의 타임아웃(밀리초)(기본값: 120000). 큰 리포지토리나 느린 네트워크 연결의 경우 이 값을 증가시키세요. [Git 작업 타임아웃](/docs/ko/plugin-marketplaces#git-operations-time-out)을 참조하세요 |

344| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | 마켓플레이스 새로 고침이 원격에 도달하거나 인증할 수 없을 때 다시 복제 시도를 건너뛰고 기존 마켓플레이스 체크아웃을 계속 사용하려면 `1`로 설정하세요. 다시 복제가 동일한 방식으로 실패하는 오프라인 또는 에어갭 환경에 유용합니다. [오프라인 환경에서 마켓플레이스 업데이트 실패](/docs/ko/plugin-marketplaces#marketplace-updates-fail-in-offline-environments)를 참조하세요 |346| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | 마켓플레이스 새로 고침이 원격에 도달하거나 인증할 수 없을 때 다시 복제 시도를 건너뛰고 기존 마켓플레이스 체크아웃을 계속 사용하려면 `1`로 설정하세요. 다시 복제가 동일한 방식으로 실패하는 오프라인 또는 에어갭 환경에 유용합니다. [오프라인 환경에서 마켓플레이스 업데이트 실패](/docs/ko/plugin-marketplaces#marketplace-updates-fail-in-offline-environments)를 참조하세요 |

345| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` 단축 소스를 SSH 대신 HTTPS를 통해 복제하려면 `1`로 설정하세요. 플러그인 설치 및 업데이트, `/plugin marketplace add` 및 `update`에 적용됩니다. CI 러너, 컨테이너 또는 `github.com`에 대해 구성된 SSH 키가 없는 모든 환경에 유용합니다 |347| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` 단축 소스를 SSH 대신 HTTPS를 통해 복제하려면 `1`로 설정하세요. 플러그인 설치 및 업데이트, `/plugin marketplace add` 및 `update`에 적용됩니다. CI 러너, 컨테이너 또는 `github.com`에 대해 구성된 SSH 키가 없는 모든 환경에 유용합니다 |

524 526 

525가져오기가 비활성화되면 다음을 수행할 수 없습니다:527가져오기가 비활성화되면 다음을 수행할 수 없습니다:

526 528 

527* Claude Code가 [프로젝트 지침으로 `AGENTS.md` 파일을 읽을 수 없습니다](/docs/ko/memory#agents-md). `CLAUDE.md` 파일만 로드합니다

528* [Pro, Max 및 Team 플랜에서 기본적으로 자동 모드로 세션을 시작할 수 없습니다](/docs/ko/permission-modes#which-mode-a-session-starts-in)529* [Pro, Max 및 Team 플랜에서 기본적으로 자동 모드로 세션을 시작할 수 없습니다](/docs/ko/permission-modes#which-mode-a-session-starts-in)

529* VS Code 확장이 [시작 권한 모드에 대한 설정 파일을 읽을 수 없습니다](/docs/ko/permission-modes#switch-permission-modes)530* VS Code 확장이 [시작 권한 모드에 대한 설정 파일을 읽을 수 없습니다](/docs/ko/permission-modes#switch-permission-modes)

530* [`/auto-mode-setup`](/docs/ko/auto-mode-config#generate-environment-entries)을 실행하여 `autoMode.environment` 항목을 작성할 수 없습니다531* [`/auto-mode-setup`](/docs/ko/auto-mode-config#generate-environment-entries)을 실행하여 `autoMode.environment` 항목을 작성할 수 없습니다

38 38 

39이 중 일부는 제공자별 차이가 있습니다:39이 중 일부는 제공자별 차이가 있습니다:

40 40 

41* **CLAUDE.md memory**: `CLAUDE.md` 파일은 모든 제공자에서 로드됩니다. [`AGENTS.md` 파일](/docs/ko/memory#agents-md)을 프로젝트 지침으로 읽으려면 [기능 플래그를 가져오는](/docs/ko/env-vars#features-that-need-feature-flag-fetching) 세션도 필요합니다.

42* **MCP servers**: [claude.ai의 커넥터](/docs/ko/mcp#use-mcp-servers-from-claude-ai)는 claude.ai 구독이 활성 인증 방법일 때만 로드됩니다. [도구 검색](/docs/ko/mcp#configure-tool-search)은 `ANTHROPIC_BASE_URL`이 비자사 호스트를 가리킬 때 기본적으로 꺼져 있으며, Google Cloud의 Agent Platform의 Claude 4.5 세대보다 이전 모델이나 Microsoft Foundry [Azure에서 호스팅되는 배포](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)에서는 지원되지 않습니다.41* **MCP servers**: [claude.ai의 커넥터](/docs/ko/mcp#use-mcp-servers-from-claude-ai)는 claude.ai 구독이 활성 인증 방법일 때만 로드됩니다. [도구 검색](/docs/ko/mcp#configure-tool-search)은 `ANTHROPIC_BASE_URL`이 비자사 호스트를 가리킬 때 기본적으로 꺼져 있으며, Google Cloud의 Agent Platform의 Claude 4.5 세대보다 이전 모델이나 Microsoft Foundry [Azure에서 호스팅되는 배포](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)에서는 지원되지 않습니다.

43* **Subagents**: 기본 제공 [Explore subagent](/docs/ko/sub-agents#built-in-subagents)는 Claude API에서 상속된 모델을 Opus로 제한하며, AWS의 Claude Platform을 포함한 다른 모든 제공자에서는 주 대화의 모델을 직접 상속합니다.42* **Subagents**: 기본 제공 [Explore subagent](/docs/ko/sub-agents#built-in-subagents)는 Claude API에서 상속된 모델을 Opus로 제한하며, AWS의 Claude Platform을 포함한 다른 모든 제공자에서는 주 대화의 모델을 직접 상속합니다.

44* **[Commands](/docs/ko/commands#all-commands)**:43* **[Commands](/docs/ko/commands#all-commands)**:

16 AGENTS.md16 AGENTS.md

17</h3>17</h3>

18 18 

19AI 코딩 에이전트를 위해 작성하는 프로젝트 지침의 마크다운 파일입니다. 저장소에 이 파일이 있고 [CLAUDE.md](#claude-md)가 없으면, Claude는 두 번째 파일을 추가하지 않고도 이를 프로젝트 지침으로 읽습니다. `/config`의 **프로젝트 지침** 설정을 변경하여 Claude가 두 파일을 모두 읽거나 `CLAUDE.md`만 읽도록 할 수 있습니다. `AGENTS.md`를 직접 읽으려면 Claude Code v2.1.277 이상이 필요하며, 기능 플래그를 가져오는 세션에서만 가능합니다. 다른 버전에서는 `CLAUDE.md`에서 가져옵니다.19AI 코딩 에이전트를 위해 작성하는 프로젝트 지침의 마크다운 파일입니다. 저장소에 이 파일이 있고 [CLAUDE.md](#claude-md)가 없으면, Claude는 두 번째 파일을 추가하지 않고도 이를 프로젝트 지침으로 읽습니다. `/config`의 **프로젝트 지침** 설정을 변경하여 Claude가 두 파일을 모두 읽거나 `CLAUDE.md`만 읽도록 할 수 있습니다. `AGENTS.md`를 직접 읽으려면 Claude Code v2.1.277 이상이 필요합니다. 일부 세션에서는 Claude가 [`AGENTS.md`를 읽을 수 없으므로](/docs/ko/memory#when-agents-md-support-is-unavailable), 대신 [`CLAUDE.md`에서 가져오세요](/docs/ko/memory#share-one-file-with-other-coding-tools).

20 20 

21자세히 알아보기: [AGENTS.md](/docs/ko/memory#agents-md)21자세히 알아보기: [AGENTS.md](/docs/ko/memory#agents-md)

22 22 

1562* Claude가 도구를 검색해야 할 시기1562* Claude가 도구를 검색해야 할 시기

1563* 서버가 제공하는 주요 기능1563* 서버가 제공하는 주요 기능

1564 1564 

1565Claude Code는 도구 설명과 서버 지침을 각각 2KB에서 자릅니다. 자르기를 피하려면 간결하게 유지하고 중요한 세부 정보를 시작 부분에 배치하세요.1565Claude Code는 각 도구 설명과 각 서버의 지침을 기본적으로 2,048자에서 자릅니다. 간결하게 유지하고 중요한 세부 정보를 시작 부분에 배치하세요.

1566 

1567세션의 모든 MCP 서버에 대한 제한을 변경하려면 [`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](/docs/ko/env-vars#variables)를 문자 수로 설정하세요. 이 변수는 Claude Code v2.1.280 이상이 필요합니다.

1566 1568 

1567<h3 id="configure-tool-search">1569<h3 id="configure-tool-search">

1568 도구 검색 구성1570 도구 검색 구성

379기본값을 변경하려면, 예를 들어 Claude가 항상 두 파일을 모두 읽도록 하거나, `CLAUDE.md`만 읽도록 하거나, 조직의 관리되는 지침만 읽도록 하려면 [**프로젝트 지침** 설정을 변경](#choose-which-instruction-files-load)하십시오.379기본값을 변경하려면, 예를 들어 Claude가 항상 두 파일을 모두 읽도록 하거나, `CLAUDE.md`만 읽도록 하거나, 조직의 관리되는 지침만 읽도록 하려면 [**프로젝트 지침** 설정을 변경](#choose-which-instruction-files-load)하십시오.

380 380 

381<Note>381<Note>

382 `AGENTS.md`를 직접 읽으려면 Claude Code v2.1.277 이상이 필요합니다. Amazon Bedrock의 세션이나 원격 측정이 비활성화된 세션과 같은 일부 세션에서는 Claude가 [`AGENTS.md`를 읽을 수 없으므로](#when-agents-md-support-is-unavailable), 대신 [`CLAUDE.md`에서 가져오십시오](#share-one-file-with-other-coding-tools).382 `AGENTS.md`를 직접 읽으려면 Claude Code v2.1.277 이상이 필요합니다. 일부 세션에서는 Claude가 [`AGENTS.md`를 읽을 수 없으므로](#when-agents-md-support-is-unavailable), 대신 [`CLAUDE.md`에서 가져오십시오](#share-one-file-with-other-coding-tools).

383</Note>383</Note>

384 384 

385<h3 id="when-claude-code-reads-agents-md">385<h3 id="when-claude-code-reads-agents-md">

436이러한 세션에서 Claude는 `CLAUDE.md` 파일만 읽으며, `/config` 설정 패널에서 **프로젝트 지침**이 나타나지 않습니다:436이러한 세션에서 Claude는 `CLAUDE.md` 파일만 읽으며, `/config` 설정 패널에서 **프로젝트 지침**이 나타나지 않습니다:

437 437 

438* v2.1.277 이전의 Claude Code 버전을 사용 중입니다438* v2.1.277 이전의 Claude Code 버전을 사용 중입니다

439* 세션이 Anthropic에서 [기능 플래그를 가져오지 않습니다](/docs/ko/env-vars#features-that-need-feature-flag-fetching). 예를 들어 Amazon Bedrock 또는 다른 타사 제공자를 사용하거나 원격 측정을 비활성화했습니다. 연결된 섹션에 전체 목록이 있습니다

440* `AGENTS.md` 지원이 있는 버전으로 [설치 또는 업그레이드한 후 첫 번째 세션](/docs/ko/env-vars#first-session-after-an-install-or-upgrade)입니다. Claude는 다음 세션부터 `AGENTS.md`를 읽습니다

441* 내장 `agents-md` 플러그인을 `/plugin`에서 비활성화했습니다439* 내장 `agents-md` 플러그인을 `/plugin`에서 비활성화했습니다

440* 일부 경우, v2.1.276 이상에서 [업그레이드한 후 첫 번째 세션](/docs/ko/env-vars#first-session-after-an-install-or-upgrade)입니다. Claude는 다음 세션부터 `AGENTS.md`를 읽습니다

442 441 

443이러한 세션에서 Claude에 `AGENTS.md`를 제공하려면, [`CLAUDE.md`에서 가져오십시오](#share-one-file-with-other-coding-tools).442v2.1.281 이전에는 Amazon Bedrock의 세션이나 원격 측정이 비활성화된 세션과 같은 일부 세션에서 `CLAUDE.md` 파일만 읽었습니다. 이러한 버전에서는 Claude Code를 업데이트하십시오. 이러한 세션에서 Claude에 `AGENTS.md`를 제공하려면 [`CLAUDE.md`에서 가져오십시오](#share-one-file-with-other-coding-tools).

444 443 

445<h3 id="where-agents-md-differs-from-claude-md">444<h3 id="where-agents-md-differs-from-claude-md">

446 AGENTS.md가 CLAUDE.md와 다른 점445 AGENTS.md가 CLAUDE.md와 다른 점

637저장소에 `AGENTS.md`가 있고 Claude가 그 내용을 알지 못하는 경우, 일반적인 원인은 프로젝트 경로의 어딘가에 있는 `CLAUDE.md`입니다. 기본적으로 Claude는 작업 디렉토리 또는 그 위의 `CLAUDE.md` 또는 `CLAUDE.local.md`가 없을 때만 `AGENTS.md`를 읽습니다. 다음 순서대로 확인합니다:636저장소에 `AGENTS.md`가 있고 Claude가 그 내용을 알지 못하는 경우, 일반적인 원인은 프로젝트 경로의 어딘가에 있는 `CLAUDE.md`입니다. 기본적으로 Claude는 작업 디렉토리 또는 그 위의 `CLAUDE.md` 또는 `CLAUDE.local.md`가 없을 때만 `AGENTS.md`를 읽습니다. 다음 순서대로 확인합니다:

638 637 

6391. 작업 디렉토리 또는 그 위의 디렉토리에서 `CLAUDE.md`, `.claude/CLAUDE.md`, 또는 `CLAUDE.local.md`를 찾습니다. `~/.claude/CLAUDE.md`는 제외합니다. 찾은 경우, Claude는 **Project instructions**를 `claude-md-and-agents-md`로 설정하지 않는 한 `AGENTS.md` 대신 이를 읽습니다.6381. 작업 디렉토리 또는 그 위의 디렉토리에서 `CLAUDE.md`, `.claude/CLAUDE.md`, 또는 `CLAUDE.local.md`를 찾습니다. `~/.claude/CLAUDE.md`는 제외합니다. 찾은 경우, Claude는 **Project instructions**를 `claude-md-and-agents-md`로 설정하지 않는 한 `AGENTS.md` 대신 이를 읽습니다.

6402. `claude --version`을 실행하고 v2.1.277 이상인지 확인합니다.6392. `claude --version`을 실행하고 v2.1.277 이상인지 확인합니다. v2.1.281 이전에는 Amazon Bedrock의 세션이나 원격 분석이 비활성화된 세션과 같은 일부 세션이 [`AGENTS.md`를 로드할 수 없었으므로](#when-agents-md-support-is-unavailable), 해당 버전에서는 v2.1.281 이상으로 업데이트합니다.

6413. 세션이 [AGENTS.md를 로드할 수 없는](#when-agents-md-support-is-unavailable) 세션인지 확인합니다. 예를 들어 타사 제공자의 세션이거나 원격 분석이 비활성화된 세션입니다.6403. 세션에서 `/config`를 입력하여 설정 패널을 열고 **Project instructions**가 `claude-md` 또는 `managed-only`로 설정되지 않았는지 확인합니다. 설정이 전혀 표시되지 않으면 세션이 [AGENTS.md를 로드할 수 없는](#when-agents-md-support-is-unavailable) 세션입니다.

6424. 세션에서 `/config`를 입력하여 설정 패널을 열고 **Project instructions**가 `claude-md` 또는 `managed-only`로 설정되지 않았는지 확인합니다. 설정이 전혀 표시되지 않으면 세션이 [AGENTS.md를 로드할 수 없는](#when-agents-md-support-is-unavailable) 세션입니다.

643 641 

644Claude가 `AGENTS.md`를 읽었는지 확인하려면 `/memory`를 실행하고 목록에서 해당 경로를 찾습니다.642Claude가 `AGENTS.md`를 읽었는지 확인하려면 `/memory`를 실행하고 목록에서 해당 경로를 찾습니다.

645 643 

1226* `num_non_blocking_error`: 차단 없이 실패한 수1226* `num_non_blocking_error`: 차단 없이 실패한 수

1227* `num_cancelled`: 완료 전에 취소된 수1227* `num_cancelled`: 완료 전에 취소된 수

1228* `total_duration_ms`: 모든 일치하는 훅의 벽시계 기간1228* `total_duration_ms`: 모든 일치하는 훅의 벽시계 기간

1229* `stdout_chars`: 성공한 일치하는 훅 전체의 stdout 총 문자 수. Claude Code v2.1.280 이상 필요

1230* `additional_context_chars`: 일치하는 훅이 반환한 `additionalContext`의 총 문자 수. Claude Code v2.1.280 이상 필요

1231* `system_message_chars`: 일치하는 훅이 반환한 `systemMessage`의 총 문자 수. Claude Code v2.1.280 이상 필요

1232* `initial_user_message_chars`: 일치하는 훅이 반환한 `initialUserMessage`의 총 문자 수. Claude Code v2.1.280 이상 필요

1233* `num_outputs_persisted`: [10,000자 상한](/docs/ko/hooks#json-output)을 초과한 훅 출력 수(Claude Code가 파일에 저장함). Claude Code v2.1.280 이상 필요

1229* `managed_only`: 관리 정책 훅만 허용될 때 `"true"`1234* `managed_only`: 관리 정책 훅만 허용될 때 `"true"`

1230* `hook_source`: `"policySettings"` 또는 `"merged"`1235* `hook_source`: `"policySettings"` 또는 `"merged"`

1231* `safe_mode`: 세션이 [`--safe-mode`](/docs/ko/cli-reference)로 시작되었을 때 `"true"`, 그 외에는 `"false"`. Claude Code v2.1.169 이상 필요1236* `safe_mode`: 세션이 [`--safe-mode`](/docs/ko/cli-reference)로 시작되었을 때 `"true"`, 그 외에는 `"false"`. Claude Code v2.1.169 이상 필요

859 백그라운드 자동 업데이트859 백그라운드 자동 업데이트

860</h4>860</h4>

861 861 

862기본적으로 백그라운드 새로고침은 마켓플레이스의 원격에서 새 커밋을 확인할 때 git 자격 증명 도우미를 비활성화하므로 도우미가 구성되어 있어도 HTTPS를 통해 개인 저장소에 인증할 수 없습니다. SSH 원격은 영향을 받지 않습니다. `ssh-agent`에 로드된 키는 실행하는 명령어와 동일한 방식으로 백그라운드 확인을 인증합니다. 확인이 새 커밋을 찾거나 원격에 도달하거나 인증할 수 없어서 실패하면 Claude Code는 마켓플레이스를 다시 복제하고 새 복제본으로 교체합니다. 해당 복제가 실패하면 기존 체크아웃이 제자리에 유지됩니다. 다시 복제는 저장된 git 자격 증명을 사용하지만 [대규모 저장소에서 시간 초과](#git-operations-time-out)될 수 있으므로 개인 마켓플레이스 자동 업데이트가 간헐적으로 실패할 수 있습니다.862백그라운드 새로고침은 마켓플레이스의 원격에서 새 커밋을 확인할 때 구성된 git 자격 증명 도우미를 사용합니다. 실행하는 명령어와 동일합니다. SSH 원격의 경우 `ssh-agent`에 로드된 키가 확인을 인증합니다. Claude Code는 확인을 비대화형으로 실행합니다. git의 터미널 프롬프트 및 askpass 프로그램을 끄고 자격 증명 도우미에 프롬프트하지 않도록 지시합니다. 확인이 HTTPS를 통해 개인 저장소에 인증할 수 있는지 여부는 도우미에 따라 다릅니다:

863 

864* 프롬프트 없이 저장된 자격 증명을 제공할 수 있는 도우미는 확인을 인증합니다. Git Credential Manager, macOS Keychain 도우미 및 `git-credential-store`는 호스트에 대한 자격 증명을 보유하면 이런 식으로 작동합니다.

865* 프롬프트가 필요한 도우미는 백그라운드에서 응답할 수 없습니다. 업데이트가 조용히 실패하고 기존 체크아웃이 제자리에 유지되므로 플러그인은 마지막 동기화된 상태에서 계속 작동합니다. `/plugin marketplace update <name>`을 실행하여 자격 증명으로 마켓플레이스를 새로고칩니다.

866 

867확인이 체크아웃이 최신 상태임을 발견하면 Claude Code는 그대로 둡니다. 확인이 새 커밋을 발견하거나 원격에 도달하거나 인증할 수 없어서 실패하면 Claude Code는 마켓플레이스를 다시 복제하고 새 복제본으로 교체합니다. 해당 복제가 실패하면 기존 체크아웃이 제자리에 유지됩니다. 다시 복제는 [대규모 저장소에서 시간 초과](#git-operations-time-out)될 수 있습니다.

863 868 

864두 가지 설정이 개인 마켓플레이스를 예측 가능하게 작동하게 합니다:869두 가지 설정이 개인 마켓플레이스를 예측 가능하게 작동하게 합니다:

865 870 

866* `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`을 설정하여 백그라운드 확인이 원격에 도달하거나 인증할 수 없을 때 다시 복제를 시도하지 않고 기존 체크아웃을 유지합니다. 플러그인은 마지막 동기화된 상태에서 계속 작동하며 `/plugin marketplace update`를 사용한 수동 업데이트는 여전히 자격 증명으로 인증합니다.871* `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`을 설정하여 백그라운드 확인이 원격에 도달하거나 인증할 수 없을 때 다시 복제를 시도하지 않고 기존 체크아웃을 유지합니다. 플러그인은 마지막 동기화된 상태에서 계속 작동하며 `/plugin marketplace update`를 사용한 수동 업데이트는 여전히 자격 증명으로 인증합니다.

867* git 자격 증명 도우미를 구성합니다. 예를 들어 GitHub의 경우 `gh auth setup-git`을 사용하여 다시 복제가 프롬프트 없이 인증할 수 있습니다.872* git 자격 증명 도우미를 구성합니다. 예를 들어 GitHub의 경우 `gh auth setup-git`을 사용하여 백그라운드 확인과 다시 복제가 프롬프트 없이 인증할 수 있습니다.

868 873 

869`GITHUB_TOKEN`과 같은 공급자 토큰을 환경에서 설정하는 것만으로는 백그라운드 인증을 활성화하지 않습니다. 토큰은 구성된 자격 증명 도우미(예: `GH_TOKEN` 및 `GITHUB_TOKEN`을 읽는 `gh` CLI의 도우미)를 통해서만 적용됩니다.874`GITHUB_TOKEN`과 같은 공급자 토큰을 환경에서 설정하는 것만으로는 백그라운드 인증을 활성화하지 않습니다. 토큰은 구성된 자격 증명 도우미(예: `GH_TOKEN` 및 `GITHUB_TOKEN`을 읽는 `gh` CLI의 도우미)를 통해서만 적용됩니다.

870 875 

871백그라운드 확인 자체가 HTTPS를 통해 인증하도록 하려면 전역 git URL 다시 쓰기를 구성합니다. 다시 쓰기는 원격 URL에 토큰을 포함하므로 백그라운드 확인이 자격 증명 도우미를 비활성화하더라도 적용됩니다. 확인이 체크아웃이 최신 상태임을 발견하면 Claude Code는 다시 복제를 건너뜁니다. 다음 예제는 마켓플레이스 저장소의 URL을 다시 쓰어 액세스 토큰을 포함합니다:

872 

873```bash theme={null}

874git config --global url."https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins".insteadOf "https://github.com/acme-corp/plugins"

875```

876 

877다시 쓰기를 마켓플레이스 저장소 또는 조직 경로로 범위를 지정합니다. 기본이 호스트만인 다시 쓰기는 해당 호스트에 대한 모든 가져오기 및 푸시에 적용되며 자신의 저장소에 대한 푸시를 포함한 일반 자격 증명을 재정의합니다.

878 

879각 공급자는 다시 쓴 URL에서 다른 사용자 이름을 예상하며 동일한 경로 범위 지정이 모든 공급자에 적용됩니다. 자체 호스팅 서버의 경우 호스트 이름을 서버의 호스트 이름으로 바꿉니다:

880 

881| 공급자 | 다시 쓴 URL 형식 |

882| :-------- | :---------------------------------------------------------------- |

883| GitHub | `https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins` |

884| GitLab | `https://oauth2:YOUR_TOKEN@gitlab.com/acme-corp/plugins` |

885| Bitbucket | `https://x-token-auth:YOUR_TOKEN@bitbucket.org/acme-corp/plugins` |

886 

887다시 쓰기는 gitconfig에 평문으로 토큰을 저장하므로 마켓플레이스 저장소에 대한 읽기 전용 액세스 권한이 있는 토큰을 사용합니다.

888 

889<Note>876<Note>

890 CI/CD 환경에서는 개인 저장소에서 플러그인을 설치하기 전에 git 자격 증명 도우미를 구성합니다. GitHub Actions에서 마켓플레이스 저장소에 대한 읽기 액세스 권한이 있는 토큰을 `GH_TOKEN`으로 내보낸 다음 `gh auth setup-git`을 실행합니다. 기본 워크플로우 토큰은 워크플로우 자신의 저장소에만 액세스할 수 있으므로 다른 저장소의 개인 마켓플레이스는 개인 액세스 토큰 또는 앱 토큰이 필요합니다.877 CI/CD 환경에서는 개인 저장소에서 플러그인을 설치하기 전에 git 자격 증명 도우미를 구성합니다. GitHub Actions에서 마켓플레이스 저장소에 대한 읽기 액세스 권한이 있는 토큰을 `GH_TOKEN`으로 내보낸 다음 `gh auth setup-git`을 실행합니다. 기본 워크플로우 토큰은 워크플로우 자신의 저장소에만 액세스할 수 있으므로 다른 저장소의 개인 마켓플레이스는 개인 액세스 토큰 또는 앱 토큰이 필요합니다.

891 

892 파이프라인에서 구성된 전역 URL 다시 쓰기도 백그라운드 확인을 직접 인증합니다.

893</Note>878</Note>

894 879 

895<h3 id="distribute-through-organization-settings">880<h3 id="distribute-through-organization-settings">

1618 1603 

1619백그라운드 자동 업데이트의 경우:1604백그라운드 자동 업데이트의 경우:

1620 1605 

1621* 기본적으로 백그라운드 새로 고침은 원격에 대한 확인 시 git 자격 증명 도우미를 비활성화하므로 확인이 HTTPS를 통해 인증할 수 없습니다. `ssh-agent`에 로드된 키가 있는 SSH 원격은 여전히 인증합니다1606* 백그라운드 새로 고침은 구성된 git 자격 증명 도우미를 사용하지만 절대 프롬프트하지 않으므로 도우미는 저장된 자격 증명으로 응답할 수 있어야 합니다. `ssh-agent`에 로드된 키가 있는 SSH 원격도 인증합니다

1622* 확인이 인증할 수 없으면 Claude Code는 저장된 자격 증명을 사용하여 마켓플레이스를 다시 복제하지만 다시 복제는 대규모 저장소에서 시간 초과될 수 있습니다1607* 도우미가 프롬프트해야 하면 백그라운드 업데이트가 조용히 실패하고 기존 체크아웃이 제자리에 유지됩니다. 먼저 도우미에 로그인하여 호스트에 대한 자격 증명을 보유하도록 합니다. GitHub의 경우 `gh auth login`을 실행한 다음 `gh auth setup-git`을 실행합니다

1608* 확인이 새 커밋을 찾거나 원격에 도달하거나 인증할 수 없으면 Claude Code는 동일한 자격 증명으로 마켓플레이스를 다시 복제합니다. 다시 복제는 대규모 저장소에서 시간 초과될 수 있습니다

1623* `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`을 설정하여 백그라운드 확인이 원격에 도달하거나 인증할 수 없을 때 기존 체크아웃을 유지합니다1609* `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`을 설정하여 백그라운드 확인이 원격에 도달하거나 인증할 수 없을 때 기존 체크아웃을 유지합니다

1624* git 자격 증명 도우미(예: `gh auth setup-git`)를 구성하여 다시 복제가 인증할 수 있도록 합니다

1625* 대규모 저장소에서 다시 복제 시간이 초과되면 [`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`](#git-operations-time-out)를 사용하여 제한을 늘립니다1610* 대규모 저장소에서 다시 복제 시간이 초과되면 [`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`](#git-operations-time-out)를 사용하여 제한을 늘립니다

1626* 백그라운드 확인이 마켓플레이스 저장소로 범위가 지정된 [git URL 재작성](#private-repositories)을 직접 인증하도록 구성합니다

1627* 또는 자격 증명을 사용하는 `/plugin marketplace update <name>`으로 개인 마켓플레이스를 수동으로 업데이트합니다1611* 또는 자격 증명을 사용하는 `/plugin marketplace update <name>`으로 개인 마켓플레이스를 수동으로 업데이트합니다

1628 1612 

1613v2.1.280 이전에는 백그라운드 확인이 자격 증명 도우미 없이 실행되었고 HTTPS를 통해 개인 저장소에 인증할 수 없었습니다.

1614 

1629<h3 id="marketplace-updates-fail-in-offline-environments">1615<h3 id="marketplace-updates-fail-in-offline-environments">

1630 마켓플레이스 업데이트가 오프라인 환경에서 실패합니다1616 마켓플레이스 업데이트가 오프라인 환경에서 실패합니다

1631</h3>1617</h3>

340 플러그인과 그것이 의존하는 플러그인을 함께 테스트하려면 [플러그인과 그 종속성을 로컬에서 테스트](/docs/ko/plugin-dependencies#test-a-plugin-and-its-dependency-locally)를 참조하세요.340 플러그인과 그것이 의존하는 플러그인을 함께 테스트하려면 [플러그인과 그 종속성을 로컬에서 테스트](/docs/ko/plugin-dependencies#test-a-plugin-and-its-dependency-locally)를 참조하세요.

341</Tip>341</Tip>

342 342 

343플래그를 추가할 수 없는 세션에서 플러그인을 로드하려면 대신 [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ko/env-vars#variables) 환경 변수에 절대 경로를 나열하세요. Claude Code는 각 경로를 `--plugin-dir` 경로로 로드합니다. 이러한 플러그인은 `--plugin-dir`로 전달하는 플러그인에 추가로 로드됩니다. [프로젝트 및 로컬 설정은 이 변수를 설정할 수 없습니다](/docs/ko/settings-reference#variables-claude-code-ignores-in-env). `CLAUDE_CODE_PLUGIN_DIRS`는 Claude Code v2.1.280 이상이 필요합니다.

344 

343`--plugin-dir`로 플러그인을 시도하면 작동할 수 있음을 알 수 있습니다. Claude가 실제로 얼마나 자주 도달하고 올바른 결과를 얻는지 알아보려면 [`claude plugin eval`](/docs/ko/plugin-evals)을 사용하여 테스트 프롬프트 세트에 대해 실행하세요. 각 프롬프트는 플러그인이 로드된 상태와 로드되지 않은 상태에서 여러 번 실행되므로 플러그인이 기여하는 바를 확인하고 변경하거나 새 모델이 출시될 때 회귀를 포착할 수 있습니다.345`--plugin-dir`로 플러그인을 시도하면 작동할 수 있음을 알 수 있습니다. Claude가 실제로 얼마나 자주 도달하고 올바른 결과를 얻는지 알아보려면 [`claude plugin eval`](/docs/ko/plugin-evals)을 사용하여 테스트 프롬프트 세트에 대해 실행하세요. 각 프롬프트는 플러그인이 로드된 상태와 로드되지 않은 상태에서 여러 번 실행되므로 플러그인이 기여하는 바를 확인하고 변경하거나 새 모델이 출시될 때 회귀를 포착할 수 있습니다.

344 346 

345한 곳에서 여러 플러그인을 로드하려면 플러그인을 보유한 폴더를 전달합니다(예: `--plugin-dir ./plugins`). 플러그인 폴더를 로드하려면 Claude Code v2.1.265 이상이 필요합니다. Claude Code는 폴더의 최상위 수준을 읽어 어떤 플러그인을 로드할지 결정하며, 대화형 세션에서는 나중에 변경 사항을 위해 폴더를 감시합니다:347한 곳에서 여러 플러그인을 로드하려면 플러그인을 보유한 폴더를 전달합니다(예: `--plugin-dir ./plugins`). 플러그인 폴더를 로드하려면 Claude Code v2.1.265 이상이 필요합니다. Claude Code는 폴더의 최상위 수준을 읽어 어떤 플러그인을 로드할지 결정하며, 대화형 세션에서는 나중에 변경 사항을 위해 폴더를 감시합니다:

37두 가지 설정은 계층 표에 나타나지 않지만 여전히 캐시된 상태에 영향을 미칩니다:37두 가지 설정은 계층 표에 나타나지 않지만 여전히 캐시된 상태에 영향을 미칩니다:

38 38 

39* **모델**: 각 모델은 자체 캐시를 가집니다. 모델을 전환하면 콘텐츠가 동일한 경우에도 전체 요청이 다시 계산됩니다. 아래의 [모델 전환](#switching-models)을 참조하세요.39* **모델**: 각 모델은 자체 캐시를 가집니다. 모델을 전환하면 콘텐츠가 동일한 경우에도 전체 요청이 다시 계산됩니다. 아래의 [모델 전환](#switching-models)을 참조하세요.

40* **노력 수준**: 대부분의 모델에서 각 노력 수준은 자체 캐시를 가지므로 세션 중에 노력을 변경하면 전체 요청이 다시 계산됩니다. API 키 또는 Claude 구독이 있는 Fable 5.1에서는 기본적으로 캐시가 그대로 유지됩니다. 아래의 [노력 수준 변경](#changing-effort-level)을 참조하세요.40* **노력 수준**: 대부분의 모델에서 각 노력 수준은 자체 캐시를 가지므로 세션 중에 노력을 변경하면 전체 요청이 다시 계산됩니다. API 키 또는 Claude 구독이 있는 Opus 5.5 및 Fable 5.1에서는 기본적으로 캐시가 그대로 유지됩니다. 아래의 [노력 수준 변경](#changing-effort-level)을 참조하세요.

41 41 

42<Tip>42<Tip>

43 세션 시작 시 모델과 노력 수준을 선택한 다음 작업 간의 자연스러운 중단점을 위해 `/compact`를 저장하세요. 작업 중에 변경을 적게 할수록 캐시 히트율이 높아집니다.43 세션 시작 시 모델과 노력 수준을 선택한 다음 작업 간의 자연스러운 중단점을 위해 `/compact`를 저장하세요. 작업 중에 변경을 적게 할수록 캐시 히트율이 높아집니다.

106 106 

107대부분의 모델에서 세션 중에 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 변경하면 다음 요청이 캐시 히트 없이 전체 대화 기록을 읽습니다. 캐시가 여전히 따뜻한 동안 Claude Code는 먼저 변경을 확인하도록 요청합니다.107대부분의 모델에서 세션 중에 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 변경하면 다음 요청이 캐시 히트 없이 전체 대화 기록을 읽습니다. 캐시가 여전히 따뜻한 동안 Claude Code는 먼저 변경을 확인하도록 요청합니다.

108 108 

109API 키 또는 Claude 구독이 있는 Fable 5.1에서 노력을 변경하면 캐시가 유지되고 Claude Code는 묻지 않고 새 수준을 적용합니다. 이는 Amazon Bedrock, Google Cloud의 Agent Platform, [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway)에는 적용되지 않으며, [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ko/llm-gateway-protocol#disable-pre-release-capabilities)를 설정하거나 조직에 HIPAA 구성이 있을 때도 적용되지 않습니다.109API 키 또는 Claude 구독이 있는 Opus 5.5 및 Fable 5.1에서 노력을 변경하면 캐시가 유지되고 Claude Code는 묻지 않고 새 수준을 적용합니다. 이는 Amazon Bedrock, Google Cloud의 Agent Platform, [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway)에는 적용되지 않으며, [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ko/llm-gateway-protocol#disable-pre-release-capabilities)를 설정하거나 조직에 HIPAA 구성이 있을 때도 적용되지 않습니다.

110 110 

111v2.1.260 이전에는 API 키 또는 Claude 구독이 있는 Fable 5.1에서 노력을 변경해도 캐시가 무효화되었습니다.111v2.1.260 이전에는 API 키 또는 Claude 구독이 있는 Fable 5.1에서 노력을 변경해도 캐시가 무효화되었습니다.

112 112 

202[캐시 수명](#cache-lifetime)보다 긴 휴식 후에는 읽을 캐시가 남아 있지 않으므로 요약 요청이 캐시되지 않은 입력으로 전체 기록을 다시 처리합니다. 이것이 [이전 세션을 재개](/docs/ko/sessions#resume-from-a-summary)할 때 `/compact`의 비용이 가장 많은 이유입니다. 따뜻한 경우와 차가운 경우 모두에서 압축 후 턴이 훨씬 더 짧은 요약에 대해서만 대화 캐시를 다시 빌드하므로 해당 턴이 느린 부분이 아닙니다.202[캐시 수명](#cache-lifetime)보다 긴 휴식 후에는 읽을 캐시가 남아 있지 않으므로 요약 요청이 캐시되지 않은 입력으로 전체 기록을 다시 처리합니다. 이것이 [이전 세션을 재개](/docs/ko/sessions#resume-from-a-summary)할 때 `/compact`의 비용이 가장 많은 이유입니다. 따뜻한 경우와 차가운 경우 모두에서 압축 후 턴이 훨씬 더 짧은 요약에 대해서만 대화 캐시를 다시 빌드하므로 해당 턴이 느린 부분이 아닙니다.

203 203 

204<Tip>204<Tip>

205 압축은 더 이상 필요하지 않은 컨텍스트를 버릴 때 유리합니다. 오버헤드가 발생하는 시기를 선택하려면 작업 간 또는 작업 간과 같은 자연스러운 휴식 시간에 `/compact`를 실행하고 자동 압축이 작업 중에 트리거될 때까지 기다리지 마세요. 완전히 포기하고 싶은 경로를 따라가면 대신 [이전 턴으로 `rewinding`](#rewinding-the-conversation)하세요. 되감기는 압축이 수행하는 새로운 것을 빌드하는 대신 이미 캐시된 접두사로 다시 자릅니다.205 압축은 더 이상 필요하지 않은 컨텍스트를 버릴 때 유리합니다. 오버헤드가 발생하는 시기를 선택하려면 작업 간 또는 작업 간과 같은 자연스러운 휴식 시간에 `/compact`를 실행하고 자동 압축이 작업 중에 트리거될 때까지 기다리지 마세요. 완전히 포기하고 싶은 경로를 따라가면 대신 [이전 턴으로 되감기](#rewinding-the-conversation)하세요. 되감기는 압축이 수행하는 새로운 것을 빌드하는 대신 이미 캐시된 접두사로 다시 자릅니다.

206</Tip>206</Tip>

207 207 

208<h3 id="accumulating-many-images">208<h3 id="accumulating-many-images">

367캐시 성능은 API가 모든 응답에서 보고하는 두 개의 토큰 수로 표시됩니다. 이를 실시간으로 확인하는 가장 직접적인 방법은 `current_usage` 객체를 읽는 [상태 표시줄 스크립트](/docs/ko/statusline)입니다:367캐시 성능은 API가 모든 응답에서 보고하는 두 개의 토큰 수로 표시됩니다. 이를 실시간으로 확인하는 가장 직접적인 방법은 `current_usage` 객체를 읽는 [상태 표시줄 스크립트](/docs/ko/statusline)입니다:

368 368 

369| 필드 | 의미 |369| 필드 | 의미 |

370| ----------------------------- | --------------------------------------- |370| ----------------------------- | ------------------------------------------------------------------------------------------------------------------ |

371| `cache_creation_input_tokens` | 이번 턴에 캐시에 기록된 토큰, 캐시 쓰기 요금으로 청구됨 |371| `cache_creation_input_tokens` | 이번 턴에 캐시에 기록된 토큰, 캐시 쓰기 요금으로 청구됨 |

372| `cache_read_input_tokens` | 이번 턴에 캐시에서 제공된 토큰, 표준 입력 요금의 약 10%로 청구됨 |372| `cache_read_input_tokens` | 이번 턴에 캐시에서 제공된 토큰, 모델의 [캐시된 토큰 요금](https://platform.claude.com/docs/en/about-claude/pricing)으로 청구되며, 표준 입력 요금보다 낮음 |

373 373 

374높은 읽기 대 생성 비율은 캐싱이 잘 작동하고 있음을 의미합니다. 생성이 턴마다 높게 유지되면 접두사에서 뭔가 변경되고 있다는 뜻입니다. [캐시를 무효화하는 작업](#actions-that-invalidate-the-cache) 섹션에서 일반적인 원인을 나열합니다.374높은 읽기 대 생성 비율은 캐싱이 잘 작동하고 있음을 의미합니다. 생성이 턴마다 높게 유지되면 접두사에서 뭔가 변경되고 있다는 뜻입니다. [캐시를 무효화하는 작업](#actions-that-invalidate-the-cache) 섹션에서 일반적인 원인을 나열합니다.

375 375 

299 프론트매터 참조299 프론트매터 참조

300</h3>300</h3>

301 301 

302YAML [프론트매터](/docs/ko/glossary#frontmatter)를 사용하여 파일 상단의 `---` 마커 사이에 서브에이전트를 구성하고, 닫는 `---` 뒤에 마크다운으로 시스템 프롬프트를 작성하세요. `name`과 `description`만 필수입니다.302서브에이전트를 YAML [프론트매터](/docs/ko/glossary#frontmatter)로 구성합니다. 파일 상단의 `---` 마커 사이에 프론트매터를 배치하고, 닫는 `---` 뒤에 마크다운으로 시스템 프롬프트를 작성하세요. `name`과 `description`만 필수입니다.

303 303 

304다중 단어 필드 이름은 `maxTurns`와 `disallowedTools`와 같이 camelCase를 사용하며, 표와 정확히 일치해야 합니다. Claude Code는 인식하지 못하는 필드를 오류 보고 없이 무시합니다. 서브에이전트 파일이 로드되지 않은 이유를 알아보려면 [Claude Code가 건너뛰는 서브에이전트 파일](#subagent-files-claude-code-skips)을 참조하세요.304다중 단어 필드 이름은 `maxTurns`와 `disallowedTools`와 같이 camelCase를 사용하며, 표와 정확히 일치해야 합니다. Claude Code는 인식하지 못하는 필드를 오류 보고 없이 무시합니다. 서브에이전트 파일이 로드되지 않은 이유를 알아보려면 [Claude Code가 건너뛰는 서브에이전트 파일](#subagent-files-claude-code-skips)을 참조하세요.

305 305 

71 71 

72처음 몇 개의 키 반복 문자는 워밍업 중에 입력으로 입력되며 녹음이 활성화될 때 자동으로 제거됩니다. 단일 `Space` 탭은 여전히 공백을 입력합니다. 누르고 있기 감지는 빠른 반복에서만 트리거되기 때문입니다.72처음 몇 개의 키 반복 문자는 워밍업 중에 입력으로 입력되며 녹음이 활성화될 때 자동으로 제거됩니다. 단일 `Space` 탭은 여전히 공백을 입력합니다. 누르고 있기 감지는 빠른 반복에서만 트리거되기 때문입니다.

73 73 

74`Space`를 누르고 있거나 탭하면 키 누름이 프롬프트에 입력되는 곳에서만 받아쓰기가 시작됩니다. [전사 뷰어](/docs/ko/interactive-mode#transcript-viewer)에서 `Space`는 대화를 페이징하고, [vim 모드](/docs/ko/interactive-mode#vim-editor-mode)에서 INSERT 외부에서는 명령입니다. [받아쓰기 키를 다시 바인딩](#rebind-the-dictation-key)한 `meta+k`와 같은 수정자 조합은 텍스트를 입력하지 않으므로 이러한 곳에서도 받아쓰기를 시작합니다.

75 

74<Tip>76<Tip>

75 워밍업을 건너뛰려면 `/voice tap`으로 [탭 모드](#tap-to-record-and-send)로 전환하거나 [받아쓰기 키를 다시 바인딩](#rebind-the-dictation-key)하여 `meta+k`와 같은 수정자 조합을 사용하세요. 수정자 조합은 첫 번째 키 누름에서 녹음을 시작합니다.77 워밍업을 건너뛰려면 `/voice tap`으로 [탭 모드](#tap-to-record-and-send)로 전환하거나 [받아쓰기 키를 다시 바인딩](#rebind-the-dictation-key)하여 `meta+k`와 같은 수정자 조합을 사용하세요. 수정자 조합은 첫 번째 키 누름에서 녹음을 시작합니다.

76</Tip>78</Tip>

79 81 

80```82```

81> refactor the auth middleware to ▮83> refactor the auth middleware to ▮

82 # hold Space, speak "use the new token validation helper"84 # hold space, speak "use the new token validation helper"

83> refactor the auth middleware to use the new token validation helper▮85> refactor the auth middleware to use the new token validation helper▮

84```86```

85 87 

99 101 

100첫 번째 탭은 프롬프트 입력이 비어 있을 때만 녹음을 시작하므로 메시지를 작성하는 동안 여전히 공백을 정상적으로 입력할 수 있습니다. 두 번째 탭은 입력 내용에 관계없이 녹음을 중지합니다. 녹음은 또한 15초의 침묵 또는 2분 총 시간 후 자동으로 중지됩니다.102첫 번째 탭은 프롬프트 입력이 비어 있을 때만 녹음을 시작하므로 메시지를 작성하는 동안 여전히 공백을 정상적으로 입력할 수 있습니다. 두 번째 탭은 입력 내용에 관계없이 녹음을 중지합니다. 녹음은 또한 15초의 침묵 또는 2분 총 시간 후 자동으로 중지됩니다.

101 103 

104<h2 id="cancel-a-recording">

105 녹음 취소하기

106</h2>

107 

108`Esc` 또는 `Ctrl+C`를 눌러 녹음을 완료하지 않고 받아쓰기를 취소합니다. Claude Code는 마이크를 중지하고 녹음 내용을 버린 후 녹음을 시작하기 전의 프롬프트 상태로 복원합니다.

109 

110두 키 모두 완료된 녹음의 녹음 내용이 여전히 처리 중일 때도 취소합니다. 처리 중에 편집하거나 제출한 프롬프트는 그대로 유지됩니다.

111 

112취소하는 키 입력에서는 다른 작업을 수행하지 않습니다. `Esc`는 Claude의 응답을 중단하지 않으며, `Ctrl+C`는 프롬프트를 지우거나 [Claude Code를 종료하는 두 번의 키 입력 중 첫 번째](/docs/ko/interactive-mode#general-controls)로 계산되지 않습니다.

113 

102<h2 id="change-the-dictation-language">114<h2 id="change-the-dictation-language">

103 받아쓰기 언어 변경115 받아쓰기 언어 변경

104</h2>116</h2>

113 * **Auto**: 분류기가 사용자에게 묻는 대신 대부분의 작업을 검토합니다. [자동 모드](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)에서 검토하고 차단하는 항목을 참조하세요.113 * **Auto**: 분류기가 사용자에게 묻는 대신 대부분의 작업을 검토합니다. [자동 모드](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)에서 검토하고 차단하는 항목을 참조하세요.

114 * **Manual**: Claude가 파일 편집 및 대부분의 셸 명령 전에 권한을 요청합니다.114 * **Manual**: Claude가 파일 편집 및 대부분의 셸 명령 전에 권한을 요청합니다.

115 * **Plan**: Claude가 수행할 작업을 설명하고 변경 작업을 시작하기 전에 승인을 기다립니다. VS Code는 자동으로 계획을 전체 Markdown 문서로 열어서 Claude가 시작하기 전에 피드백을 제공하기 위해 인라인 주석을 추가할 수 있습니다.115 * **Plan**: Claude가 수행할 작업을 설명하고 변경 작업을 시작하기 전에 승인을 기다립니다. VS Code는 자동으로 계획을 전체 Markdown 문서로 열어서 Claude가 시작하기 전에 피드백을 제공하기 위해 인라인 주석을 추가할 수 있습니다.

116 

117 프롬프트 상자에 `/plan`을 입력할 수도 있습니다. Claude Code v2.1.280 이상이 필요합니다.

118 

119 * `/plan`: 계획 모드로 전환합니다. 이미 계획 모드에 있으면 현재 계획을 대신 표시합니다.

120 * `/plan`과 함께 작업(예: `/plan fix the auth bug`)을 입력합니다: 계획 모드로 전환하고 해당 작업 계획을 시작합니다.

121 * `/plan open`: 이미 계획 모드에 있을 때 편집기에서 계획 파일을 엽니다.

116 * **Edit automatically**: Claude가 묻지 않고 편집합니다.122 * **Edit automatically**: Claude가 묻지 않고 편집합니다.

117* **모델**: 명령 메뉴에서 \*\*Switch model…\*\*을 선택하여 세션 중간에 모델을 변경합니다. 프롬프트 상자 하단의 모델 이름을 클릭하여 동일한 선택기를 열 수도 있습니다.123* **모델**: 명령 메뉴에서 \*\*Switch model…\*\*을 선택하여 세션 중간에 모델을 변경합니다. 프롬프트 상자 하단의 모델 이름을 클릭하여 동일한 선택기를 열 수도 있습니다.

118 124 

119 현재 모델이 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 지원하는 경우 선택기에 **Effort** 행도 표시되며 모델 이름 버튼은 선택된 수준을 표시합니다. `max` 이외의 수준을 선택하면 Claude Code는 사용자 설정의 [`modelSettings`](/docs/ko/settings-reference#modelsettings) 아래에서 현재 모델에 대한 기본값으로 저장합니다. `max`는 현재 세션에만 적용됩니다. 모델 이름 버튼과 **Effort** 행에는 Claude Code v2.1.257 이상이 필요합니다.125 현재 모델이 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 지원하는 경우 선택기에 **Effort** 행도 표시되며 모델 이름 버튼은 선택된 수준을 표시합니다. `max` 이외의 수준을 선택하면 Claude Code는 사용자 설정의 [`modelSettings`](/docs/ko/settings-reference#modelsettings) 아래에서 현재 모델에 대한 기본값으로 저장합니다. `max`는 현재 세션에만 적용됩니다. 모델 이름 버튼과 **Effort** 행에는 Claude Code v2.1.257 이상이 필요합니다.

120* **명령 메뉴**: `/`를 클릭하거나 `/`를 입력하여 명령 메뉴를 엽니다. 옵션에는 파일 첨부, 모델 전환, 확장 사고 토글이 포함됩니다.126* **명령 메뉴**: `/`를 클릭하거나 `/`를 입력하여 명령 메뉴를 엽니다. 옵션에는 파일 첨부, 모델 전환, 확장 사고 토글이 포함됩니다.

121 127 

122 Customize 섹션은 MCP 서버, 명령, 출력 스타일, hooks, 메모리, 권한 및 플러그인에 대한 액세스를 제공합니다. 터미널 아이콘이 있는 항목은 통합 터미널에서 열립니다.128 Customize 섹션은 MCP 서버, 명령, 출력 스타일, hooks, 메모리, 지시사항, 권한 및 플러그인과 같은 항목을 포함합니다. 터미널 아이콘이 있는 항목은 통합 터미널에서 열립니다.

123 129 

124 * slash 명령 `/usage` 또는 [`/remote-control`](/docs/ko/remote-control)과 같은 명령을 찾아보려면 Customize 섹션에서 **Slash commands**를 선택합니다. 대화 상자에 필터 상자가 있는 목록이 표시됩니다. 하나를 선택하여 실행합니다. 프롬프트 상자에서 `/`를 입력하면 여전히 명령을 인라인으로 제안합니다. Claude Code v2.1.257 이상이 필요합니다.130 * slash 명령 `/usage` 또는 [`/remote-control`](/docs/ko/remote-control)과 같은 명령을 찾아보려면 Customize 섹션에서 **Slash commands**를 선택합니다. 대화 상자에 필터 상자가 있는 목록이 표시됩니다. 하나를 선택하여 실행합니다. 프롬프트 상자에서 `/`를 입력하면 여전히 명령을 인라인으로 제안합니다. Claude Code v2.1.257 이상이 필요합니다.

131 

132 또한 `/skills`를 입력하면 이 대화 상자가 열립니다. 각 [skill](/docs/ko/skills) 행은 **On** 또는 **Name only**와 같은 [가시성](/docs/ko/skills#override-skill-visibility-from-settings)을 표시합니다. 플러그인 skills와 같이 **locked**로 표시된 행을 제외하고 가시성을 클릭하여 변경합니다. `/skills` 바로가기 및 가시성 컨트롤에는 Claude Code v2.1.280 이상이 필요합니다.

125 * Customize 섹션에서 **Output styles**를 선택하여 사용자 정의 스타일을 포함한 [출력 스타일](/docs/ko/output-styles)을 선택합니다. Claude Code v2.1.257 이상이 필요합니다.133 * Customize 섹션에서 **Output styles**를 선택하여 사용자 정의 스타일을 포함한 [출력 스타일](/docs/ko/output-styles)을 선택합니다. Claude Code v2.1.257 이상이 필요합니다.

126 134 

127 대신 사용자 정의 스타일을 만들려면 **Output styles** 메뉴에서 **Build a custom style**을 선택합니다. Claude Code는 프로젝트 또는 사용자 수준에서 [스타일 파일](/docs/ko/output-styles#create-a-custom-output-style)을 작성합니다. Claude Code v2.1.261 이상이 필요합니다.135 대신 사용자 정의 스타일을 만들려면 **Output styles** 메뉴에서 **Build a custom style**을 선택합니다. Claude Code는 프로젝트 또는 사용자 수준에서 [스타일 파일](/docs/ko/output-styles#create-a-custom-output-style)을 작성합니다. Claude Code v2.1.261 이상이 필요합니다.

131 139 

132 저장된 메모리를 클릭하여 대화 상자에서 읽고, 텍스트를 편집하거나, 메모리를 삭제하거나, 편집기에서 파일을 열 수 있습니다. 대화 상자에서 메모리를 보거나, 편집하거나, 삭제하려면 Claude Code v2.1.275 이상이 필요합니다.140 저장된 메모리를 클릭하여 대화 상자에서 읽고, 텍스트를 편집하거나, 메모리를 삭제하거나, 편집기에서 파일을 열 수 있습니다. 대화 상자에서 메모리를 보거나, 편집하거나, 삭제하려면 Claude Code v2.1.275 이상이 필요합니다.

133 * Customize 섹션에서 **Instructions**를 선택하여 Claude가 읽는 [CLAUDE.md 파일](/docs/ko/memory#claude-md-files)을 편집합니다. 파일을 선택하여 편집기에서 엽니다. 파일이 아직 없으면 Claude Code가 먼저 생성합니다. Claude Code v2.1.274 이상이 필요합니다.141 * Customize 섹션에서 **Instructions**를 선택하여 Claude가 읽는 [CLAUDE.md 파일](/docs/ko/memory#claude-md-files)을 편집합니다. 파일을 선택하여 편집기에서 엽니다. 파일이 아직 없으면 Claude Code가 먼저 생성합니다. Claude Code v2.1.274 이상이 필요합니다.

142 * Customize 섹션에서 **Status**를 선택하거나 `/status`를 입력하여 세션의 Claude Code 버전, 계정, 모델 및 MCP 서버 세부 정보를 확인합니다. Claude Code v2.1.280 이상이 필요합니다.

143 * Customize 섹션에서 **Sandbox**를 선택하거나 `/sandbox`를 입력하여 Claude의 Bash 명령이 [샌드박스](/docs/ko/sandboxing)에서 실행되는지 확인합니다. 샌드박스 모드를 전환하고 [제외된 명령](/docs/ko/settings-reference#sandbox-excludedcommands)을 추가할 수 있습니다. Claude Code v2.1.280 이상이 필요합니다.

144 * Customize 섹션에서 **Claude in Chrome**을 선택하거나 `/chrome`을 입력하여 [Claude in Chrome](/docs/ko/chrome) 연결을 확인하고 관리합니다. 둘 다 claude.ai 계정으로 로그인해야 합니다. Claude Code v2.1.280 이상이 필요합니다.

145 * Context 섹션에서 **Export conversation**을 선택하거나 `/export`를 입력하여 대화를 일반 텍스트로 복사하거나 파일에 저장합니다. `/export notes.txt`와 같은 파일 이름을 추가하여 대화 상자를 건너뛰고 파일을 저장할 위치를 선택합니다. Claude Code v2.1.280 이상이 필요합니다.

134 * Settings 섹션에는 **Enable Remote Control for all sessions**이 포함되어 있으며, 이는 [`remoteControlAtStartup`](/docs/ko/settings-reference#remotecontrolatstartup)을 설정하여 [새 대화형 세션이 Remote Control에 자동으로 연결되는지](/docs/ko/remote-control#enable-remote-control-for-all-sessions) 제어합니다. Claude Code v2.1.203 이상이 필요합니다.146 * Settings 섹션에는 **Enable Remote Control for all sessions**이 포함되어 있으며, 이는 [`remoteControlAtStartup`](/docs/ko/settings-reference#remotecontrolatstartup)을 설정하여 [새 대화형 세션이 Remote Control에 자동으로 연결되는지](/docs/ko/remote-control#enable-remote-control-for-all-sessions) 제어합니다. Claude Code v2.1.203 이상이 필요합니다.

135 147 

136 VS Code 창에서 토글을 켜거나 끌 때 변경 사항은 그 이후에 시작하는 세션뿐만 아니라 해당 VS Code 창에서 이미 열려 있는 세션에 적용됩니다. 토글을 끄면 열려 있는 세션이 연결 해제됩니다. Claude Code v2.1.261 이상에서는 변경 사항이 다른 VS Code 창에서 열려 있는 세션에도 도달합니다.148 VS Code 창에서 토글을 켜거나 끌 때 변경 사항은 그 이후에 시작하는 세션뿐만 아니라 해당 VS Code 창에서 이미 열려 있는 세션에 적용됩니다. 토글을 끄면 열려 있는 세션이 연결 해제됩니다. Claude Code v2.1.261 이상에서는 변경 사항이 다른 VS Code 창에서 열려 있는 세션에도 도달합니다.

183* 파일을 첨부하려면 프롬프트 상자로 드래그할 때 `Shift`를 누르고 있습니다.195* 파일을 첨부하려면 프롬프트 상자로 드래그할 때 `Shift`를 누르고 있습니다.

184* 컨텍스트에서 첨부 파일을 제거하려면 X를 클릭합니다.196* 컨텍스트에서 첨부 파일을 제거하려면 X를 클릭합니다.

185 197 

198<h3 id="paste-text">

199 텍스트 붙여넣기

200</h3>

201 

202붙여넣은 텍스트는 프롬프트 상자에 표시된 상태로 유지되며, [터미널](/docs/ko/terminal-config#paste-large-content)에서처럼 자리 표시자로 축소되지 않습니다. Claude Code가 [붙여넣은 텍스트를 표시](/docs/ko/terminal-config#how-claude-treats-pasted-text)하는 세션에서 Claude는 여전히 큰 붙여넣기를 입력한 텍스트가 아닌 붙여넣은 텍스트로 봅니다.

203 

204Claude Code는 또한 프롬프트 상자에 붙여넣은 텍스트 및 보내는 다른 모든 항목에서 [보이지 않는 Unicode 문자](/docs/ko/interactive-mode#invisible-characters-in-prompts)를 제거합니다:

205 

206* 붙여넣을 때 `Removed 3 invisible characters from the pasted text`와 같은 공지가 나타나면 텍스트가 해당 문자 없이 들어갔습니다.

207* 보낼 때 제거된 문자에 대한 공지가 나타나면 아무것도 전송되지 않았습니다. 정리된 텍스트가 프롬프트 상자에 다시 있습니다. 다시 보내서 표시된 대로 텍스트를 보냅니다.

208 

186<h3 id="resume-past-conversations">209<h3 id="resume-past-conversations">

187 과거 대화 재개210 과거 대화 재개

188</h3>211</h3>

7> 브라우저나 휴대폰에서 클라우드에서 Claude Code를 실행합니다. GitHub 저장소를 연결하고, 작업을 제출하고, 로컬 설정 없이 PR을 검토합니다.7> 브라우저나 휴대폰에서 클라우드에서 Claude Code를 실행합니다. GitHub 저장소를 연결하고, 작업을 제출하고, 로컬 설정 없이 PR을 검토합니다.

8 8 

9<Note>9<Note>

10 클라우드 세션은 Pro, Max, Team 사용자와 프리미엄 시트 또는 Chat + Claude Code 시트가 있는 Enterprise 사용자를 위한 연구 미리보기 상태입니다.10 클라우드 세션은 Pro, Max, Team 플랜과 프리미엄 시트 또는 Chat + Claude Code 시트가 있는 Enterprise 사용자를 위해 제공됩니다.

11</Note>11</Note>

12 12 

13클라우드 세션은 사용자의 머신 대신 기본적으로 Anthropic 관리 클라우드 인프라에서 Claude Code를 실행합니다. 이 빠른 시작은 브라우저에서 [claude.ai/code](https://claude.ai/code)에서 시작합니다. Claude 모바일 앱, Desktop 앱, 또는 터미널에서 `claude --cloud`를 사용하여 시작할 수도 있습니다.13클라우드 세션은 사용자의 머신 대신 기본적으로 Anthropic 관리 클라우드 인프라에서 Claude Code를 실행합니다. 이 빠른 시작은 브라우저에서 [claude.ai/code](https://claude.ai/code)에서 시작합니다. Claude 모바일 앱, Desktop 앱, 또는 터미널에서 `claude --cloud`를 사용하여 시작할 수도 있습니다.