SpyBara
Go Premium

Documentation 2026-07-10 17:00 UTC to 2026-07-11 19:03 UTC

22 files changed +246 −45. View all changes and history on the product overview
2026
Tue 14 17:58 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01
Details

835 835 

836* **[사용자 정의 도구 가이드](/ko/agent-sdk/custom-tools)**: SDK 애플리케이션과 함께 프로세스 내에서 실행되는 자신의 MCP 서버를 구축합니다836* **[사용자 정의 도구 가이드](/ko/agent-sdk/custom-tools)**: SDK 애플리케이션과 함께 프로세스 내에서 실행되는 자신의 MCP 서버를 구축합니다

837* **[권한](/ko/agent-sdk/permissions)**: `allowedTools` 및 `disallowedTools`로 에이전트가 사용할 수 있는 MCP 도구를 제어합니다837* **[권한](/ko/agent-sdk/permissions)**: `allowedTools` 및 `disallowedTools`로 에이전트가 사용할 수 있는 MCP 도구를 제어합니다

838* **[MCP 출력 제한 및 경고](/ko/mcp#mcp-output-limits-and-warnings)**: SDK가 `MAX_MCP_OUTPUT_TOKENS`을 초과하는 도구 결과를 처리하는 방법으로, 디스크에 지속하는 폴백 및 도구별 `anthropic/maxResultSizeChars` 주석을 포함합니다

838* **[TypeScript SDK 참조](/ko/agent-sdk/typescript)**: MCP 구성 옵션을 포함한 전체 API 참조839* **[TypeScript SDK 참조](/ko/agent-sdk/typescript)**: MCP 구성 옵션을 포함한 전체 API 참조

839* **[Python SDK 참조](/ko/agent-sdk/python)**: MCP 구성 옵션을 포함한 전체 API 참조840* **[Python SDK 참조](/ko/agent-sdk/python)**: MCP 구성 옵션을 포함한 전체 API 참조

840* **[MCP 서버 디렉토리](https://github.com/modelcontextprotocol/servers)**: 데이터베이스, API 등을 위한 사용 가능한 MCP 서버를 찾아봅니다841* **[MCP 서버 디렉토리](https://github.com/modelcontextprotocol/servers)**: 데이터베이스, API 등을 위한 사용 가능한 MCP 서버를 찾아봅니다

Details

267 267 

268이러한 환경 변수를 특정 Amazon Bedrock 모델 ID로 설정하십시오.268이러한 환경 변수를 특정 Amazon Bedrock 모델 ID로 설정하십시오.

269 269 

270`ANTHROPIC_DEFAULT_OPUS_MODEL`이 없으면 Amazon Bedrock의 `opus` 별칭이 Opus 4.6으로 확인됩니다. 최신 모델을 사용하려면 Opus 4.8 ID로 설정하십시오:270이러한 변수가 없으면 Amazon Bedrock의 `opus` 별칭은 Opus 4.8로 확인되고 `sonnet` 별칭은 Sonnet 4.5로 확인됩니다. 변수를 특정 버전으로 고정하려면 다음과 같이 설정하십시오:

271 271 

272```bash theme={null}272```bash theme={null}

273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'


280고정 변수가 설정되지 않은 경우 Claude Code는 이러한 기본 모델을 사용합니다:280고정 변수가 설정되지 않은 경우 Claude Code는 이러한 기본 모델을 사용합니다:

281 281 

282| 모델 유형 | 기본값 |282| 모델 유형 | 기본값 |

283| :------- | :--------------------------------------------- |283| :------- | :----------------------------- |

284| 기본 모델 | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |284| 기본 모델 | `us.anthropic.claude-opus-4-8` |

285| 소형/빠른 모델 | 기본 모델과 동일 |285| 소형/빠른 모델 | 기본 모델과 동일 |

286 286 

287세션 제목 생성과 같은 백그라운드 작업은 소형/빠른 모델(일반적으로 Haiku 클래스 모델)을 사용합니다. Amazon Bedrock에서 Claude Code는 모든 계정 또는 지역에서 Haiku를 사용할 수 없을 수 있으므로 기본적으로 이를 기본 모델로 설정합니다. 백그라운드 작업에 Haiku를 사용하려면 `ANTHROPIC_DEFAULT_HAIKU_MODEL`을 계정에서 사용 가능한 모델 ID로 설정하십시오.287세션 제목 생성과 같은 백그라운드 작업은 소형/빠른 모델(일반적으로 Haiku 클래스 모델)을 사용합니다. Amazon Bedrock에서 Claude Code는 모든 계정 또는 지역에서 Haiku를 사용할 수 없을 수 있으므로 기본적으로 이를 기본 모델로 설정합니다. 백그라운드 작업에 Haiku를 사용하려면 `ANTHROPIC_DEFAULT_HAIKU_MODEL`을 계정에서 사용 가능한 모델 ID로 설정하십시오.

Details

276 3. 모델 버전 고정276 3. 모델 버전 고정

277</h3>277</h3>

278 278 

279Claude Platform on AWS는 직접 Claude API와 동일한 모델 ID를 사용합니다. 기본 별칭 `fable`, `opus`, `sonnet` 및 `haiku`는 Claude Platform on AWS에 대한 Claude Code의 기본 제공 기본값으로 확인되며, 이는 최신 릴리스보다 뒤떨어질 수 있습니다. `ANTHROPIC_DEFAULT_OPUS_MODEL` 없이 `opus` 별칭은 Opus 4.7로 확인됩니다.279Claude Platform on AWS는 직접 Claude API와 동일한 모델 ID를 사용합니다. 기본 별칭 `fable`, `opus`, `sonnet` 및 `haiku`는 Claude Platform on AWS에 대한 Claude Code의 기본 제공 기본값으로 확인되며, 이는 최신 릴리스보다 뒤떨어질 수 있습니다. `ANTHROPIC_DEFAULT_OPUS_MODEL` 없이 `opus` 별칭은 Opus 4.8로 확인됩니다.

280 280 

281Claude Code를 팀에 배포하는 경우 모델 ID를 명시적으로 고정하여 새 릴리스가 모든 사람을 한 번에 이동하지 않도록 하십시오.281Claude Code를 팀에 배포하는 경우 모델 ID를 명시적으로 고정하여 새 릴리스가 모든 사람을 한 번에 이동하지 않도록 하십시오.

282 282 

283```bash theme={null}283```bash theme={null}

284export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5284export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5

285export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7285export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8

286export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5286export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5

287export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5287export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

288```288```

Details

271 271 

272때로는 Claude가 모든 편집 전에 요청하기를 원합니다. 때로는 그냥 배포하기를 원합니다. 영원히 하나를 선택할 필요는 없습니다.272때로는 Claude가 모든 편집 전에 요청하기를 원합니다. 때로는 그냥 배포하기를 원합니다. 영원히 하나를 선택할 필요는 없습니다.

273 273 

274*Shift+Tab*은 Claude가 얻는 자유도를 순환합니다: *Manual*(`default` 설정 값)은 작업 전에 요청하고, *acceptEdits*는 파일 편집과 일반적인 파일 시스템 명령어가 흐르도록 하면서도 다른 셸 명령어 전에 확인하고, *plan*은 무엇이든 건드리기 전에 승인을 위해 변경 사항을 제안합니다. Plan 모드는 신뢰 구축자이므로 여러 파일을 건드리는 모든 것에 대해 거기서 시작하십시오.274*Shift+Tab*은 Claude가 얻는 자유도를 순환합니다: *Manual*(`default` 설정 값)은 파일 편집 및 대부분의 셸 명령어 전에 요청하고, *acceptEdits*는 파일 편집과 일반적인 파일 시스템 명령어가 흐르도록 하면서도 다른 셸 명령어 전에 확인하고, *plan*은 무엇이든 건드리기 전에 승인을 위해 변경 사항을 제안합니다. Plan 모드는 신뢰 구축자이므로 여러 파일을 건드리는 모든 것에 대해 거기서 시작하십시오.

275 275 

276*지금 시도하기:* 다음 리팩토링에서 Shift+Tab을 누르면 "plan"이 표시될 때까지 누른 다음 변경 사항을 설명하십시오. 단일 파일이 움직이기 전에 전체 제안을 받을 것입니다.276*지금 시도하기:* 다음 리팩토링에서 Shift+Tab을 누르면 "plan"이 표시될 때까지 누른 다음 변경 사항을 설명하십시오. 단일 파일이 움직이기 전에 전체 제안을 받을 것입니다.

277 277 


440가장 자주 받을 질문에 대한 한 줄 답변입니다.440가장 자주 받을 질문에 대한 한 줄 답변입니다.

441 441 

442| 질문 | 응답 |442| 질문 | 응답 |

443| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |443| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

444| "VS Code에서 작동하나요?" | 예. VS Code 확장 프로그램과 JetBrains 플러그인이 있으며 같은 기능을 가지고 있고 편집기에 포함되어 있습니다. [VS Code →](/ko/vs-code) |444| "VS Code에서 작동하나요?" | 예. VS Code 확장 프로그램과 JetBrains 플러그인이 있으며 같은 기능을 가지고 있고 편집기에 포함되어 있습니다. [VS Code →](/ko/vs-code) |

445| "먼저 뭔가 구성해야 하나요?" | 아니요. 설치한 다음 모든 리포지토리에서 `claude`를 실행하십시오. `/init`를 한 번 실행하면 설정됩니다. [빠른 시작 →](/ko/quickstart) |445| "먼저 뭔가 구성해야 하나요?" | 아니요. 설치한 다음 모든 리포지토리에서 `claude`를 실행하십시오. `/init`를 한 번 실행하면 설정됩니다. [빠른 시작 →](/ko/quickstart) |

446| "내 코드는 어디로 가나요?" | CLI는 터미널에서 실행되고 컨텍스트를 Anthropic의 API로 보내 추론하며, 제3자 서버가 없습니다. Enterprise 계획에 따라 코드와 프롬프트는 모델 학습에 사용되지 않습니다. [데이터 사용 →](/ko/data-usage) |446| "내 코드는 어디로 가나요?" | CLI는 터미널에서 실행되고 컨텍스트를 Anthropic의 API로 보내 추론하며, 제3자 서버가 없습니다. Enterprise 계획에 따라 코드와 프롬프트는 모델 학습에 사용되지 않습니다. [데이터 사용 →](/ko/data-usage) |

447| "전체 리포지토리를 볼 수 있나요?" | 액세스 권한을 부여한 것을 읽습니다. 작업 디렉토리 내의 파일 읽기는 프롬프트하지 않습니다; 권한 프롬프트는 편집, 셸 명령어, 그 디렉토리 외부의 모든 것을 제어합니다. [권한 →](/ko/permissions) |447| "전체 리포지토리를 볼 수 있나요?" | 액세스 권한을 부여한 것을 읽습니다. 작업 디렉토리 내의 파일 읽기는 프롬프트하지 않습니다; 권한 프롬프트는 편집, 읽기 전용이 아닌 셸 명령어, 그 디렉토리 외부의 파일 도구 읽기를 제어합니다. `ls` 및 `cat`과 같은 기본 제공 읽기 전용 셸 명령어 세트는 프롬프트 없이 실행됩니다; [sandbox `denyRead` 규칙](/ko/sandboxing#filesystem-isolation)으로 제한하십시오. [권한 →](/ko/permissions) |

448| "이것이 Copilot과 어떻게 다른가요?" | Copilot은 줄을 자동 완성합니다. Claude Code는 파일을 읽고, 명령어를 실행하고, 다중 파일 편집을 하는 에이전트입니다. [개요 →](/ko/overview) |448| "이것이 Copilot과 어떻게 다른가요?" | Copilot은 줄을 자동 완성합니다. Claude Code는 파일을 읽고, 명령어를 실행하고, 다중 파일 편집을 하는 에이전트입니다. [개요 →](/ko/overview) |

449| "먼저 뭘 시도해야 하나요?" | 지루해서 미루고 있던 버그. "\[파일]의 테스트가 불안정합니다, 이유를 파악하세요." [빠른 시작 →](/ko/quickstart) |449| "먼저 뭘 시도해야 하나요?" | 지루해서 미루고 있던 버그. "\[파일]의 테스트가 불안정합니다, 이유를 파악하세요." [빠른 시작 →](/ko/quickstart) |

450 450 

desktop.md +1 −1

Details

94 94 

95<span id="auto-mode-availability" />95<span id="auto-mode-availability" />

96 96 

97Auto mode는 Anthropic API의 모든 사용자에게 제공되는 연구 미리보기이며 Claude Opus 4.6 이상 또는 Sonnet 4.6 이상이 필요합니다. Google Cloud의 Agent Platform으로 라우팅하는 엔터프라이즈 배포에서는 [`CLAUDE_CODE_ENABLE_AUTO_MODE`를 설정](/ko/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)할 때까지 auto mode가 꺼져 있으며, 거기서는 Claude Sonnet 5, Opus 4.7, Opus 4.8만 지원됩니다.97Auto mode는 Anthropic API의 모든 사용자에게 제공되며 Claude Opus 4.6 이상 또는 Sonnet 4.6 이상이 필요합니다. Google Cloud의 Agent Platform으로 라우팅하는 엔터프라이즈 배포에서는 [`CLAUDE_CODE_ENABLE_AUTO_MODE`를 설정](/ko/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)할 때까지 auto mode가 꺼져 있으며, 거기서는 Claude Sonnet 5, Opus 4.7, Opus 4.8만 지원됩니다.

98 98 

99<Tip title="모범 사례">99<Tip title="모범 사례">

100 복잡한 작업을 Plan에서 시작하여 Claude가 변경하기 전에 접근 방식을 매핑하도록 합니다. 계획을 승인한 후 Accept edits 또는 Manual로 전환하여 실행합니다. 이 워크플로우에 대한 자세한 내용은 [먼저 탐색, 그 다음 계획, 그 다음 코드](/ko/best-practices#explore-first-then-plan-then-code)를 참조하세요.100 복잡한 작업을 Plan에서 시작하여 Claude가 변경하기 전에 접근 방식을 매핑하도록 합니다. 계획을 승인한 후 Accept edits 또는 Manual로 전환하여 실행합니다. 이 워크플로우에 대한 자세한 내용은 [먼저 탐색, 그 다음 계획, 그 다음 코드](/ko/best-practices#explore-first-then-plan-then-code)를 참조하세요.

desktop-linux.md +10 −2

Details

75 다운로드한 파일에서 설치75 다운로드한 파일에서 설치

76</h3>76</h3>

77 77 

78apt 저장소를 사용할 수 없는 경우 [claude.com/download](https://claude.com/download)에서 아키텍처(x64 또는 arm64)에 맞는 `.deb` 패키지를 다운로드한 소프트웨어 설치 프로그램으로 열거나 다운로드 파일이 포함된 디렉터리에서 apt를 사용하여 설치합니다:78apt 저장소를 통해 설치할 수 없는 경우 저장소의 패키지 풀에서 `.deb` 패키지를 직접 다운로드합니다. 명령은 저장소 인덱스에서 아키텍처에 맞는 최신 패키지를 찾은 현재 디렉터리에 다운로드합니다:

79 

80```bash theme={null}

81curl -fLO "https://downloads.claude.ai/claude-desktop/apt/stable/$(curl -s "https://downloads.claude.ai/claude-desktop/apt/stable/dists/stable/main/binary-$(dpkg --print-architecture)/Packages" | grep '^Filename: pool/main/c/claude-desktop/claude-desktop_' | sort -V | tail -n 1 | cut -d' ' -f2)"

82```

83 

84명령이 `Remote file name has no length` 오류로 실패하면 조회에서 패키지 경로를 반환하지 못한 것입니다. 이는 예를 들어 네트워크가 `downloads.claude.ai`를 차단할 때 저장소 인덱스를 가져올 수 없거나 아키텍처에 대한 패키지가 없음을 의미할 수 있습니다. 네트워크가 `downloads.claude.ai`에 도달할 수 있는지 확인하고 `dpkg --print-architecture`가 `amd64` 또는 `arm64`를 출력하는지 확인합니다. 저장소는 다른 아키텍처에 대한 패키지를 게시하지 않습니다.

85 

86그런 다음 GNOME Software와 같은 소프트웨어 설치 프로그램으로 다운로드한 파일을 열거나 다운로드 파일이 포함된 디렉터리에서 apt를 사용하여 설치합니다:

79 87 

80```bash theme={null}88```bash theme={null}

81sudo apt install ./claude-desktop_*.deb89sudo apt install ./claude-desktop_*.deb


83 91 

84apt가 `E: Unsupported file ./claude-desktop_*.deb given on commandline` 오류를 보고하면 패턴이 현재 디렉터리의 `.deb` 파일과 일치하지 않은 것입니다. 다운로드가 완료되었는지 확인한 후 파일이 포함된 디렉터리에서 명령을 다시 실행하세요.92apt가 `E: Unsupported file ./claude-desktop_*.deb given on commandline` 오류를 보고하면 패턴이 현재 디렉터리의 `.deb` 파일과 일치하지 않은 것입니다. 다운로드가 완료되었는지 확인한 후 파일이 포함된 디렉터리에서 명령을 다시 실행하세요.

85 93 

86이런 방식으로 설치된 `.deb`는 업데이트를 받지 않습니다. apt를 통해 업데이트를 받으려면 위에 표시된 대로 저장소를 추가하거나 패키지가 `/etc/apt/sources.list.d/claude-desktop.list`에 작성하는 자리 표시자 항목의 `deb` 줄을 주석 해제합니다.94이런 방식으로 설치된 `.deb`는 업데이트를 받지 않습니다. apt를 통해 업데이트를 받으려면 [Anthropic의 apt 저장소 추가](#install) 단계에서 저장소를 등록합니다. 패키지는 또한 `/etc/apt/sources.list.d/claude-desktop.list`에 주석 처리된 저장소 항목을 작성합니다. 해당 `deb` 줄의 주석을 제거하는 것과 동일합니다.

87 95 

88<h2 id="update">96<h2 id="update">

89 업데이트97 업데이트

errors.md +13 −13

Details

31| `Auto mode could not evaluate this action and is blocking it for safety` | [서버 오류](#auto-mode-cannot-determine-the-safety-of-an-action) |31| `Auto mode could not evaluate this action and is blocking it for safety` | [서버 오류](#auto-mode-cannot-determine-the-safety-of-an-action) |

32| `Auto mode classifier transcript exceeded context window` | [서버 오류](#auto-mode-cannot-determine-the-safety-of-an-action) |32| `Auto mode classifier transcript exceeded context window` | [서버 오류](#auto-mode-cannot-determine-the-safety-of-an-action) |

33| `Agent terminated early due to an API error` | [서버 오류](#agent-terminated-early-due-to-an-api-error) |33| `Agent terminated early due to an API error` | [서버 오류](#agent-terminated-early-due-to-an-api-error) |

34| `You've hit your session limit` / `You've hit your weekly limit` | [사용 제한](#you%E2%80%99ve-hit-your-session-limit) |34| `You've hit your session limit` / `You've hit your weekly limit` | [사용 제한](#youve-hit-your-session-limit) |

35| `Usage credits required for 1M context` | [사용 제한](#usage-credits-required-for-1m-context) |35| `Usage credits required for 1M context` | [사용 제한](#usage-credits-required-for-1m-context) |

36| `Server is temporarily limiting requests` | [사용 제한](#server-is-temporarily-limiting-requests) |36| `Server is temporarily limiting requests` | [사용 제한](#server-is-temporarily-limiting-requests) |

37| `Request rejected (429)` | [사용 제한](#request-rejected-429) |37| `Request rejected (429)` | [사용 제한](#request-rejected-429) |


42| `This organization has been disabled` | [인증](#this-organization-has-been-disabled) |42| `This organization has been disabled` | [인증](#this-organization-has-been-disabled) |

43| `Your organization has disabled API key authentication` | [인증](#your-organization-has-disabled-api-key-authentication) |43| `Your organization has disabled API key authentication` | [인증](#your-organization-has-disabled-api-key-authentication) |

44| `Your organization has disabled Claude subscription access` | [인증](#your-organization-has-disabled-claude-subscription-access) |44| `Your organization has disabled Claude subscription access` | [인증](#your-organization-has-disabled-claude-subscription-access) |

45| `Routines are disabled by your organization's policy` | [인증](#routines-are-disabled-by-your-organization%E2%80%99s-policy) |45| `Routines are disabled by your organization's policy` | [인증](#routines-are-disabled-by-your-organizations-policy) |

46| `Remote Control is only available when using Claude via api.anthropic.com` | [인증](#remote-control-requires-the-anthropic-api) |46| `Remote Control is only available when using Claude via api.anthropic.com` | [인증](#remote-control-requires-the-anthropic-api) |

47| `OAuth token revoked` / `OAuth token has expired` | [인증](#oauth-token-revoked-or-expired) |47| `OAuth token revoked` / `OAuth token has expired` | [인증](#oauth-token-revoked-or-expired) |

48| `does not meet scope requirement user:profile` | [인증](#oauth-scope-requirement) |48| `does not meet scope requirement user:profile` | [인증](#oauth-scope-requirement) |


53| `SSL certificate verification failed` | [네트워크](#ssl-certificate-errors) |53| `SSL certificate verification failed` | [네트워크](#ssl-certificate-errors) |

54| `SSL certificate error (...)` during login or startup | [네트워크](#ssl-certificate-errors) |54| `SSL certificate error (...)` during login or startup | [네트워크](#ssl-certificate-errors) |

55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [네트워크](#host-not-allowed-in-a-cloud-session) |55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [네트워크](#host-not-allowed-in-a-cloud-session) |

56| `Couldn't reconnect to your Remote Control session` | [네트워크](#couldn%E2%80%99t-reconnect-to-your-remote-control-session) |56| `Couldn't reconnect to your Remote Control session` | [네트워크](#couldnt-reconnect-to-your-remote-control-session) |

57| `Prompt is too long` | [요청 오류](#prompt-is-too-long) |57| `Prompt is too long` | [요청 오류](#prompt-is-too-long) |

58| `Error during compaction: Conversation too long` | [요청 오류](#error-during-compaction-conversation-too-long) |58| `Error during compaction: Conversation too long` | [요청 오류](#error-during-compaction-conversation-too-long) |

59| `Request too large` | [요청 오류](#request-too-large) |59| `Request too large` | [요청 오류](#request-too-large) |


61| `Unable to resize image` | [요청 오류](#unable-to-resize-image) |61| `Unable to resize image` | [요청 오류](#unable-to-resize-image) |

62| `PDF too large` / `PDF is password protected` | [요청 오류](#pdf-errors) |62| `PDF too large` / `PDF is password protected` | [요청 오류](#pdf-errors) |

63| `Extra inputs are not permitted` | [요청 오류](#extra-inputs-are-not-permitted) |63| `Extra inputs are not permitted` | [요청 오류](#extra-inputs-are-not-permitted) |

64| `There's an issue with the selected model` | [요청 오류](#there%E2%80%99s-an-issue-with-the-selected-model) |64| `There's an issue with the selected model` | [요청 오류](#theres-an-issue-with-the-selected-model) |

65| `Model ... is not a recognized model id` | [요청 오류](#model-is-not-a-recognized-model-id) |65| `Model ... is not a recognized model id` | [요청 오류](#model-is-not-a-recognized-model-id) |

66| `Claude Opus is not available with the Claude Pro plan` | [요청 오류](#claude-opus-is-not-available-with-the-claude-pro-plan) |66| `Claude Opus is not available with the Claude Pro plan` | [요청 오류](#claude-opus-is-not-available-with-the-claude-pro-plan) |

67| `Model ... is restricted by your organization's settings` | [요청 오류](#model-is-restricted-by-your-organization%E2%80%99s-settings) |67| `Model ... is restricted by your organization's settings` | [요청 오류](#model-is-restricted-by-your-organizations-settings) |

68| `thinking.type.enabled is not supported for this model` | [요청 오류](#thinking-type-enabled-is-not-supported-for-this-model) |68| `thinking.type.enabled is not supported for this model` | [요청 오류](#thinking-type-enabled-is-not-supported-for-this-model) |

69| `max_tokens must be greater than thinking.budget_tokens` | [요청 오류](#thinking-budget-exceeds-output-limit) |69| `max_tokens must be greater than thinking.budget_tokens` | [요청 오류](#thinking-budget-exceeds-output-limit) |

70| `API Error: 400 due to tool use concurrency issues` | [요청 오류](#tool-use-or-thinking-block-mismatch) |70| `API Error: 400 due to tool use concurrency issues` | [요청 오류](#tool-use-or-thinking-block-mismatch) |


271 271 

272이러한 오류는 계정 또는 플랜에 연결된 할당량에 도달했음을 의미합니다. 이는 모든 사용자에게 영향을 미치는 [서버 오류](#server-errors)와는 다릅니다.272이러한 오류는 계정 또는 플랜에 연결된 할당량에 도달했음을 의미합니다. 이는 모든 사용자에게 영향을 미치는 [서버 오류](#server-errors)와는 다릅니다.

273 273 

274<h3 id="you’ve-hit-your-session-limit">274<h3 id="youve-hit-your-session-limit">

275 세션 한도에 도달했습니다275 세션 한도에 도달했습니다

276</h3>276</h3>

277 277 


312 312 

313* `/model`을 실행하고 `[1m]` 접미사가 없는 변형을 선택하여 표준 컨텍스트 윈도우로 폴백합니다313* `/model`을 실행하고 `[1m]` 접미사가 없는 변형을 선택하여 표준 컨텍스트 윈도우로 폴백합니다

314* `/usage-credits`를 실행하여 Pro 및 Max에서 1M 변형에 대한 종량제 청구를 켜거나, Team 및 Enterprise에서 관리자에게 요청합니다314* `/usage-credits`를 실행하여 Pro 및 Max에서 1M 변형에 대한 종량제 청구를 켜거나, Team 및 Enterprise에서 관리자에게 요청합니다

315* `/model` 후에도 오류가 지속되면 1M 모델 ID가 다른 곳에 설정되어 있을 수 있습니다. 우선순위 순서로 확인할 구성 위치에 대해서는 [선택한 모델에 문제가 있습니다](#there%E2%80%99s-an-issue-with-the-selected-model)를 참조하세요.315* `/model` 후에도 오류가 지속되면 1M 모델 ID가 다른 곳에 설정되어 있을 수 있습니다. 우선순위 순서로 확인할 구성 위치에 대해서는 [선택한 모델에 문제가 있습니다](#theres-an-issue-with-the-selected-model)를 참조하세요.

316* 모델 선택기에서 1M 변형을 완전히 제거하려면 [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ko/env-vars)을 설정합니다.316* 모델 선택기에서 1M 변형을 완전히 제거하려면 [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ko/env-vars)을 설정합니다.

317 317 

318<h3 id="server-is-temporarily-limiting-requests">318<h3 id="server-is-temporarily-limiting-requests">


491* 구독 대신 Console API 키로 인증합니다. 설정은 [Claude Console 인증](/ko/authentication#claude-console-authentication)을 참조합니다.491* 구독 대신 Console API 키로 인증합니다. 설정은 [Claude Console 인증](/ko/authentication#claude-console-authentication)을 참조합니다.

492* 관리자이고 액세스를 활성화하는 옵션이 보이지 않으면 [Anthropic 지원팀](https://support.claude.com)에 문의합니다.492* 관리자이고 액세스를 활성화하는 옵션이 보이지 않으면 [Anthropic 지원팀](https://support.claude.com)에 문의합니다.

493 493 

494<h3 id="routines-are-disabled-by-your-organization’s-policy">494<h3 id="routines-are-disabled-by-your-organizations-policy">

495 루틴이 조직의 정책에 의해 비활성화되었습니다495 루틴이 조직의 정책에 의해 비활성화되었습니다

496</h3>496</h3>

497 497 


687 687 

688액세스 수준 및 기본 허용 목록은 [네트워크 액세스](/ko/claude-code-on-the-web#network-access)를 참조합니다. 로컬 CLI 세션은 이 정책의 영향을 받지 않습니다.688액세스 수준 및 기본 허용 목록은 [네트워크 액세스](/ko/claude-code-on-the-web#network-access)를 참조합니다. 로컬 CLI 세션은 이 정책의 영향을 받지 않습니다.

689 689 

690<h3 id="couldn’t-reconnect-to-your-remote-control-session">690<h3 id="couldnt-reconnect-to-your-remote-control-session">

691 Remote Control 세션에 다시 연결할 수 없음691 Remote Control 세션에 다시 연결할 수 없음

692</h3>692</h3>

693 693 


841* `anthropic-beta` 헤더를 전달하도록 게이트웨이를 구성합니다. 게이트웨이가 전달해야 하는 항목은 [기능 통과](/ko/llm-gateway-protocol#feature-pass-through)를 참조합니다.841* `anthropic-beta` 헤더를 전달하도록 게이트웨이를 구성합니다. 게이트웨이가 전달해야 하는 항목은 [기능 통과](/ko/llm-gateway-protocol#feature-pass-through)를 참조합니다.

842* 대체 방법으로, 시작하기 전에 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ko/env-vars)을 설정합니다. 이렇게 하면 베타 헤더가 필요한 기능이 비활성화되므로 헤더를 전달할 수 없는 게이트웨이를 통해 요청이 성공합니다.842* 대체 방법으로, 시작하기 전에 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ko/env-vars)을 설정합니다. 이렇게 하면 베타 헤더가 필요한 기능이 비활성화되므로 헤더를 전달할 수 없는 게이트웨이를 통해 요청이 성공합니다.

843 843 

844<h3 id="there’s-an-issue-with-the-selected-model">844<h3 id="theres-an-issue-with-the-selected-model">

845 선택한 모델에 문제가 있습니다845 선택한 모델에 문제가 있습니다

846</h3>846</h3>

847 847 


864 모델이 인식된 모델 ID가 아닙니다864 모델이 인식된 모델 ID가 아닙니다

865</h3>865</h3>

866 866 

867모델 스위치에 전달한 모델 문자열이 모델 별칭, 이 Claude Code 버전이 알고 있는 모델 ID 또는 `claude-`로 시작하는 ID가 아닙니다. 일반적인 원인은 ID의 오타, `Sonnet 5`와 같은 표시 이름(ID `claude-sonnet-5` 필요) 또는 최신 Claude Code 버전만 인식하는 별칭입니다. Claude Code는 스위치를 즉시 거부합니다. v2.1.200 이전에는 Claude Code가 문자열을 저장하고 [선택한 모델에 문제가 있습니다](#there%E2%80%99s-an-issue-with-the-selected-model)에서 다음 요청에 실패했습니다.867모델 스위치에 전달한 모델 문자열이 모델 별칭, 이 Claude Code 버전이 알고 있는 모델 ID 또는 `claude-`로 시작하는 ID가 아닙니다. 일반적인 원인은 ID의 오타, `Sonnet 5`와 같은 표시 이름(ID `claude-sonnet-5` 필요) 또는 최신 Claude Code 버전만 인식하는 별칭입니다. Claude Code는 스위치를 즉시 거부합니다. v2.1.200 이전에는 Claude Code가 문자열을 저장하고 [선택한 모델에 문제가 있습니다](#theres-an-issue-with-the-selected-model)에서 다음 요청에 실패했습니다.

868 868 

869```text theme={null}869```text theme={null}

870Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?870Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?


878 878 

879* 인수 없이 `/model`을 실행하여 선택기를 열고 계정에서 사용 가능한 모델 중에서 선택한 다음 거기에 표시된 별칭 또는 ID를 전달합니다.879* 인수 없이 `/model`을 실행하여 선택기를 열고 계정에서 사용 가능한 모델 중에서 선택한 다음 거기에 표시된 별칭 또는 ID를 전달합니다.

880* 최신 Claude Code 버전이 지원하는 별칭을 사용한 경우 `claude update`를 실행합니다. `claude-`로 시작하는 전체 ID는 모델이 Claude Code 버전보다 최신이어도 이 확인을 통과하므로 업그레이드가 필요하지 않습니다.880* 최신 Claude Code 버전이 지원하는 별칭을 사용한 경우 `claude update`를 실행합니다. `claude-`로 시작하는 전체 ID는 모델이 Claude Code 버전보다 최신이어도 이 확인을 통과하므로 업그레이드가 필요하지 않습니다.

881* v2.1.200 이전에 저장된 모델은 이 확인으로 복구되지 않습니다. 오래된 값이 계속 반환되면 [선택한 모델에 문제가 있습니다](#there%E2%80%99s-an-issue-with-the-selected-model)에 나열된 위치에서 제거합니다.881* v2.1.200 이전에 저장된 모델은 이 확인으로 복구되지 않습니다. 오래된 값이 계속 반환되면 [선택한 모델에 문제가 있습니다](#theres-an-issue-with-the-selected-model)에 나열된 위치에서 제거합니다.

882* 확인은 Anthropic API에서만 실행됩니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/ko/claude-platform-on-aws) 및 [LLM 게이트웨이](/ko/llm-gateway) 또는 사용자 정의 `ANTHROPIC_BASE_URL` 뒤에서 공급자 또는 게이트웨이가 모델 이름을 정의하므로 Claude Code는 모든 문자열을 허용하고 통과합니다.882* 확인은 Anthropic API에서만 실행됩니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/ko/claude-platform-on-aws) 및 [LLM 게이트웨이](/ko/llm-gateway) 또는 사용자 정의 `ANTHROPIC_BASE_URL` 뒤에서 공급자 또는 게이트웨이가 모델 이름을 정의하므로 Claude Code는 모든 문자열을 허용하고 통과합니다.

883 883 

884<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">884<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">


897* 최근에 플랜을 업그레이드했는데도 이것이 표시되면 `/logout`을 실행한 다음 `/login`을 실행합니다. 저장된 토큰은 로그인 시점의 플랜을 반영하므로 웹에서 업그레이드해도 기존 세션에서 다시 인증할 때까지 적용되지 않습니다.897* 최근에 플랜을 업그레이드했는데도 이것이 표시되면 `/logout`을 실행한 다음 `/login`을 실행합니다. 저장된 토큰은 로그인 시점의 플랜을 반영하므로 웹에서 업그레이드해도 기존 세션에서 다시 인증할 때까지 적용되지 않습니다.

898* 각 플랜에 포함된 모델은 [claude.com/pricing](https://claude.com/pricing)을 참조합니다.898* 각 플랜에 포함된 모델은 [claude.com/pricing](https://claude.com/pricing)을 참조합니다.

899 899 

900<h3 id="model-is-restricted-by-your-organization’s-settings">900<h3 id="model-is-restricted-by-your-organizations-settings">

901 모델이 조직의 설정으로 제한됩니다901 모델이 조직의 설정으로 제한됩니다

902</h3>902</h3>

903 903 

glossary.md +1 −1

Details

64 Auto mode64 Auto mode

65</h3>65</h3>

66 66 

67백그라운드에서 별도의 분류기 모델이 각 작업을 검토하는 [권한 모드](#permission-mode)이며, 승인 프롬프트를 표시하는 대신입니다. 분류기는 범위 확대, 신뢰할 수 없는 인프라 및 [프롬프트 주입](#prompt-injection)을 차단합니다. 도구 결과를 보지 않으므로 주입된 지침이 결정에 영향을 미칠 수 없습니다. Auto mode는 연구 미리보기입니다.67백그라운드에서 별도의 분류기 모델이 각 작업을 검토하는 [권한 모드](#permission-mode)이며, 대부분은 승인 프롬프트 없이 실행됩니다. 명시적 요청 규칙은 여전히 프롬프트를 표시합니다. 분류기는 범위 확대, 신뢰할 수 없는 인프라 및 [프롬프트 주입](#prompt-injection)을 차단합니다. 도구 결과를 보지 않으므로 주입된 지침이 결정에 영향을 미칠 수 없습니다.

68 68 

69자세히 알아보기: [프롬프트 제거 및 auto mode](/ko/permission-modes#eliminate-prompts-with-auto-mode)69자세히 알아보기: [프롬프트 제거 및 auto mode](/ko/permission-modes#eliminate-prompts-with-auto-mode)

70 70 

Details

232 232 

233이러한 환경 변수를 특정 Google Cloud의 Agent Platform 모델 ID로 설정합니다.233이러한 환경 변수를 특정 Google Cloud의 Agent Platform 모델 ID로 설정합니다.

234 234 

235`ANTHROPIC_DEFAULT_OPUS_MODEL`이 없으면 Google Cloud의 Agent Platform의 `opus` 별칭이 Opus 4.6으로 확인됩니다. 최신 모델을 사용하려면 Opus 4.8 ID로 설정합니다:235이러한 변수가 없으면 Google Cloud의 Agent Platform의 `opus` 별칭이 Opus 4.8로 확인되고 `sonnet` 별칭이 Sonnet 4.5로 확인됩니다. 각 변수를 특정 버전으로 고정하려면 설정합니다:

236 236 

237```bash theme={null}237```bash theme={null}

238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


245Claude Code는 고정 변수가 설정되지 않았을 때 이러한 기본 모델을 사용합니다:245Claude Code는 고정 변수가 설정되지 않았을 때 이러한 기본 모델을 사용합니다:

246 246 

247| 모델 유형 | 기본값 |247| 모델 유형 | 기본값 |

248| :------- | :--------------------------- |248| :------- | :---------------- |

249| 주 모델 | `claude-sonnet-4-5@20250929` |249| 주 모델 | `claude-opus-4-8` |

250| 소형/빠른 모델 | 주 모델과 동일 |250| 소형/빠른 모델 | 주 모델과 동일 |

251 251 

252백그라운드 작업(예: 세션 제목 생성)은 소형/빠른 모델(일반적으로 Haiku 클래스 모델)을 사용합니다. Google Cloud의 Agent Platform에서 Claude Code는 모든 프로젝트 또는 지역에서 Haiku가 활성화되지 않을 수 있으므로 이를 주 모델로 기본 설정합니다. 백그라운드 작업에 Haiku를 사용하려면 `ANTHROPIC_DEFAULT_HAIKU_MODEL`을 프로젝트에서 사용 가능한 모델 ID로 설정합니다.252백그라운드 작업(예: 세션 제목 생성)은 소형/빠른 모델(일반적으로 Haiku 클래스 모델)을 사용합니다. Google Cloud의 Agent Platform에서 Claude Code는 모든 프로젝트 또는 지역에서 Haiku가 활성화되지 않을 수 있으므로 이를 주 모델로 기본 설정합니다. 백그라운드 작업에 Haiku를 사용하려면 `ANTHROPIC_DEFAULT_HAIKU_MODEL`을 프로젝트에서 사용 가능한 모델 ID로 설정합니다.

Details

189* **기본값**: Claude는 파일 편집 및 셸 명령 전에 요청합니다189* **기본값**: Claude는 파일 편집 및 셸 명령 전에 요청합니다

190* **자동 수락 편집**: Claude는 파일을 편집하고 `mkdir` 및 `mv`와 같은 일반적인 파일시스템 명령을 요청 없이 실행하지만 다른 명령은 여전히 요청합니다190* **자동 수락 편집**: Claude는 파일을 편집하고 `mkdir` 및 `mv`와 같은 일반적인 파일시스템 명령을 요청 없이 실행하지만 다른 명령은 여전히 요청합니다

191* **계획 모드**: Claude는 소스 파일을 편집하지 않고 계획을 탐색하고 제안합니다. 기본 모드처럼 권한 프롬프트가 여전히 적용됩니다191* **계획 모드**: Claude는 소스 파일을 편집하지 않고 계획을 탐색하고 제안합니다. 기본 모드처럼 권한 프롬프트가 여전히 적용됩니다

192* **자동 모드**: Claude는 백그라운드 안전 검사로 모든 작업을 평가합니다. 현재 연구 미리보기입니다192* **Auto**: Claude는 백그라운드 안전 검사로 모든 작업을 평가합니다

193 193 

194`.claude/settings.json`에서 특정 명령을 허용하여 Claude가 매번 요청하지 않도록 할 수 있습니다. 이는 `npm test` 또는 `git status`와 같은 신뢰할 수 있는 명령에 유용합니다. 설정은 조직 전체 정책에서 개인 선호도까지 범위를 지정할 수 있습니다. 자세한 내용은 [권한](/ko/permissions)을 참조하세요.194`.claude/settings.json`에서 특정 명령을 허용하여 Claude가 매번 요청하지 않도록 할 수 있습니다. 이는 `npm test` 또는 `git status`와 같은 신뢰할 수 있는 명령에 유용합니다. 설정은 조직 전체 정책에서 개인 선호도까지 범위를 지정할 수 있습니다. 자세한 내용은 [권한](/ko/permissions)을 참조하세요.

195 195 

model-config.md +13 −5

Details

41| **`opus[1m]`** | 긴 세션을 위해 [100만 토큰 컨텍스트 윈도우](https://platform.claude.com/docs/ko/build-with-claude/context-windows#1m-token-context-window)를 사용하는 Opus를 사용합니다 |41| **`opus[1m]`** | 긴 세션을 위해 [100만 토큰 컨텍스트 윈도우](https://platform.claude.com/docs/ko/build-with-claude/context-windows#1m-token-context-window)를 사용하는 Opus를 사용합니다 |

42| **`opusplan`** | Plan Mode 중에 `opus`를 사용한 후 실행을 위해 `sonnet`으로 전환하는 특수 모드입니다 |42| **`opusplan`** | Plan Mode 중에 `opus`를 사용한 후 실행을 위해 `sonnet`으로 전환하는 특수 모드입니다 |

43 43 

44Anthropic API에서 `opus`는 Opus 4.8로, `sonnet`은 Sonnet 5로 확인됩니다. [Claude Platform on AWS](/ko/claude-platform-on-aws)에서 `opus`는 Opus 4.7로, `sonnet`은 Sonnet 4.6으로 확인됩니다. Amazon Bedrock, Google Cloud의 Agent Platform 및 Microsoft Foundry에서 `opus`는 Opus 4.6으로, `sonnet`은 Sonnet 4.5로 확인됩니다. 더 새로운 모델은 전체 모델 이름을 명시적으로 선택하거나 `ANTHROPIC_DEFAULT_OPUS_MODEL` 또는 `ANTHROPIC_DEFAULT_SONNET_MODEL`을 설정하여 해당 제공자에서 사용할 있습니다.44 별칭이 확인되는 방식은 제공자에 따라 다릅니다:

45 

46* **Anthropic API**: `opus`는 Opus 4.8로, `sonnet`은 Sonnet 5로 확인됩니다.

47* **[Claude Platform on AWS](/ko/claude-platform-on-aws)**: `opus`는 Opus 4.8로, `sonnet`은 Sonnet 4.6으로 확인됩니다.

48* **Amazon Bedrock 및 Google Cloud의 Agent Platform**: `opus`는 Opus 4.8로, `sonnet`은 Sonnet 4.5로 확인됩니다.

49* **Microsoft Foundry**: `opus`는 Opus 4.6으로, `sonnet`은 Sonnet 4.5로 확인됩니다.

50 

51별칭이 더 오래된 모델로 확인되는 경우, 전체 모델 이름을 명시적으로 선택하거나 `ANTHROPIC_DEFAULT_OPUS_MODEL` 또는 `ANTHROPIC_DEFAULT_SONNET_MODEL`을 설정하여 더 새로운 모델을 사용할 수 있습니다.

45 52 

46별칭은 제공자에 대한 권장 버전을 가리키며 시간이 지남에 따라 업데이트됩니다. 특정 버전으로 고정하려면 전체 모델 이름(예: `claude-opus-4-8`)을 사용하거나 `ANTHROPIC_DEFAULT_OPUS_MODEL`과 같은 해당 환경 변수를 설정합니다.53별칭은 제공자에 대한 권장 버전을 가리키며 시간이 지남에 따라 업데이트됩니다. 특정 버전으로 고정하려면 전체 모델 이름(예: `claude-opus-4-8`)을 사용하거나 `ANTHROPIC_DEFAULT_OPUS_MODEL`과 같은 해당 환경 변수를 설정합니다.

47 54 


105 112 

106Claude Code는 인식되지 않는 문자열을 `Model "<name>" is not a recognized model id.`로 거부하며 세션은 현재 모델을 유지합니다. 문자열을 저장하고 다음 요청에서 실패하는 대신입니다. 복구 단계는 [오류 참조](/ko/errors#model-is-not-a-recognized-model-id)를 참조하세요.113Claude Code는 인식되지 않는 문자열을 `Model "<name>" is not a recognized model id.`로 거부하며 세션은 현재 모델을 유지합니다. 문자열을 저장하고 다음 요청에서 실패하는 대신입니다. 복구 단계는 [오류 참조](/ko/errors#model-is-not-a-recognized-model-id)를 참조하세요.

107 114 

108확인은 Anthropic API에서만 실행됩니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/ko/claude-platform-on-aws) 및 [LLM 게이트웨이](/ko/llm-gateway) 뒤 또는 사용자 정의 `ANTHROPIC_BASE_URL` 뒤에서는 제공자 또는 게이트웨이가 모델 이름을 정의하므로 Claude Code는 확인 없이 모든 문자열을 통과시킵니다. 확인은 또한 `--model` 플래그, `ANTHROPIC_MODEL` 환경 변수 또는 `model` 설정을 포함하지 않습니다. 잘못된 값은 첫 번째 요청 대신 [선택한 모델에 문제가 있습니다](/ko/errors#there%E2%80%99s-an-issue-with-the-selected-model)를 생성합니다.115확인은 Anthropic API에서만 실행됩니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/ko/claude-platform-on-aws) 및 [LLM 게이트웨이](/ko/llm-gateway) 뒤 또는 사용자 정의 `ANTHROPIC_BASE_URL` 뒤에서는 제공자 또는 게이트웨이가 모델 이름을 정의하므로 Claude Code는 확인 없이 모든 문자열을 통과시킵니다. 확인은 또한 `--model` 플래그, `ANTHROPIC_MODEL` 환경 변수 또는 `model` 설정을 포함하지 않습니다. 잘못된 값은 첫 번째 요청 대신 [선택한 모델에 문제가 있습니다](/ko/errors#theres-an-issue-with-the-selected-model)를 생성합니다.

109 116 

110요청된 모델에 예정된 중단 날짜가 있거나 자동으로 최신 버전으로 재매핑될 때, Claude Code는 요청된 모델의 이름을 지정하는 경고를 표시합니다. 대화형 세션은 이를 시작 알림으로 표시합니다. v2.1.182부터 [비대화형 모드](/ko/headless)에서 기본 텍스트 출력 형식을 사용할 때 동일한 경고가 stderr에 기록됩니다. 확인은 [서브에이전트 프론트매터](/ko/sub-agents)에 설정된 `model`도 포함합니다. stderr 경고는 `--output-format json` 및 `stream-json`에 대해 억제됩니다. [결과 메시지](/ko/headless#get-structured-output)의 `modelUsage` 필드에서 실제 모델을 읽으세요.117요청된 모델에 예정된 중단 날짜가 있거나 자동으로 최신 버전으로 재매핑될 때, Claude Code는 요청된 모델의 이름을 지정하는 경고를 표시합니다. 대화형 세션은 이를 시작 알림으로 표시합니다. v2.1.182부터 [비대화형 모드](/ko/headless)에서 기본 텍스트 출력 형식을 사용할 때 동일한 경고가 stderr에 기록됩니다. 확인은 [서브에이전트 프론트매터](/ko/sub-agents)에 설정된 `model`도 포함합니다. stderr 경고는 `--output-format json` 및 `stream-json`에 대해 억제됩니다. [결과 메시지](/ko/headless#get-structured-output)의 `modelUsage` 필드에서 실제 모델을 읽으세요.

111 118 


338`default`의 동작은 계정 유형에 따라 다릅니다:345`default`의 동작은 계정 유형에 따라 다릅니다:

339 346 

340* **Max, Team Premium, Enterprise 종량제 및 Anthropic API**: Opus 4.8로 기본값 설정347* **Max, Team Premium, Enterprise 종량제 및 Anthropic API**: Opus 4.8로 기본값 설정

341* **AWS의 Claude Platform**: Opus 4.7로 기본값 설정348* **AWS의 Claude Platform**: Opus 4.8로 기본값 설정

342* **Pro, Team Standard 및 Enterprise 구독 시트**: Sonnet 5로 기본값 설정349* **Pro, Team Standard 및 Enterprise 구독 시트**: Sonnet 5로 기본값 설정

343* **Amazon Bedrock, Google Cloud의 Agent Platform 및 Microsoft Foundry**: Sonnet 4.5로 기본값 설정350* **Amazon Bedrock Google Cloud의 Agent Platform**: Opus 4.8로 기본값 설정

351* **Microsoft Foundry**: Sonnet 4.5로 기본값 설정

344 352 

345Enterprise 종량제는 구독 시트가 아닌 사용량으로 청구되는 Enterprise 조직을 의미합니다.353Enterprise 종량제는 구독 시트가 아닌 사용량으로 청구되는 Enterprise 조직을 의미합니다.

346 354 


404 412 

405이 섹션은 Fable 5의 콘텐츠 기반 폴백을 다룹니다. 모델이 과부하 상태이거나 사용할 수 없을 때의 가용성 기반 폴백은 [폴백 모델 체인](#fallback-model-chains)을 참조하세요.413이 섹션은 Fable 5의 콘텐츠 기반 폴백을 다룹니다. 모델이 과부하 상태이거나 사용할 수 없을 때의 가용성 기반 폴백은 [폴백 모델 체인](#fallback-model-chains)을 참조하세요.

406 414 

407Fable 5는 사이버 보안 및 생물학 콘텐츠에 대한 안전 분류기로 실행됩니다. 분류기가 요청에 플래그를 지정하면 Claude Code는 해당 요청을 기본 Opus 모델에서 다시 실행하고 트랜스크립트에 알림을 표시합니다: Anthropic API 및 [LLM gateway](/ko/llm-gateway) 배포의 경우 Opus 4.8, 또는 [Claude Platform on AWS](/ko/claude-platform-on-aws)의 경우 Opus 4.7.415Fable 5는 사이버 보안 및 생물학 콘텐츠에 대한 안전 분류기로 실행됩니다. 분류기가 요청에 플래그를 지정하면 Claude Code는 해당 요청을 기본 Opus 모델에서 다시 실행하고 트랜스크립트에 알림을 표시합니다.

408 416 

409세션은 그 Opus 모델에서 계속됩니다. Fable 5로 돌아가려면 `/model fable`을 실행합니다.417세션은 그 Opus 모델에서 계속됩니다. Fable 5로 돌아가려면 `/model fable`을 실행합니다.

410 418 

Details

187자동 모드는 또한 Claude에게 명확히 하는 질문을 위해 멈추지 않고 계속 작업하도록 권장합니다. 그러나 Claude는 프롬프트나 스킬이 명시적으로 이를 필요로 할 때는 여전히 질문합니다. 권한 프롬프트를 유지하면서 더 강력한 자율적 동작을 원하면 [사전 예방적 출력 스타일](/ko/output-styles)을 대신 설정합니다.187자동 모드는 또한 Claude에게 명확히 하는 질문을 위해 멈추지 않고 계속 작업하도록 권장합니다. 그러나 Claude는 프롬프트나 스킬이 명시적으로 이를 필요로 할 때는 여전히 질문합니다. 권한 프롬프트를 유지하면서 더 강력한 자율적 동작을 원하면 [사전 예방적 출력 스타일](/ko/output-styles)을 대신 설정합니다.

188 188 

189<Warning>189<Warning>

190 자동 모드는 연구 미리보기입니다. 프롬프트를 줄이지만 안전을 보장하지는 않습니다. 일반적인 방향을 신뢰하는 작업에 사용하고, 민감한 작업에 대한 검토 대체로 사용하지 마세요.190 자동 모드는 권한 프롬프트를 줄이지만 안전을 보장하지는 않습니다. 일반적인 방향을 신뢰하는 작업에 사용하고, 민감한 작업에 대한 검토 대체로 사용하지 마세요.

191</Warning>191</Warning>

192 192 

193자동 모드는 계정이 다음의 모든 요구 사항을 충족할 때만 사용 가능합니다:193자동 모드는 계정이 다음의 모든 요구 사항을 충족할 때만 사용 가능합니다:

permissions.md +4 −4

Details

15Claude Code는 강력함과 안전성의 균형을 맞추기 위해 계층화된 권한 시스템을 사용합니다:15Claude Code는 강력함과 안전성의 균형을 맞추기 위해 계층화된 권한 시스템을 사용합니다:

16 16 

17| 도구 유형 | 예시 | 승인 필요 | "예, 다시 묻지 않기" 동작 |17| 도구 유형 | 예시 | 승인 필요 | "예, 다시 묻지 않기" 동작 |

18| :------ | :------------ | :---- | :------------------ |18| :------ | :------------ | :------------------------------------------------- | :------------------ |

19| 읽기 전용 | 파일 읽기, Grep | 아니오 | 해당 없음 |19| 읽기 전용 | 파일 읽기, Grep | 아니오, [작업 디렉토리 및 추가 디렉토리](#working-directories) 내에서 | 해당 없음 |

20| Bash 명령 | 셸 실행 | 예 | 프로젝트 디렉토리 및 명령당 영구적 |20| Bash 명령 | 셸 실행 | 예, [읽기 전용 명령](#read-only-commands)의 기본 제공 집합 제외 | 프로젝트 디렉토리 및 명령당 영구적 |

21| 파일 수정 | Edit/Write 파일 | 예 | 세션 종료까지 |21| 파일 수정 | Edit/Write 파일 | 예 | 세션 종료까지 |

22 22 

23<h2 id="manage-permissions">23<h2 id="manage-permissions">


51| `default` | 표준 동작: 각 도구를 처음 사용할 때 권한을 요청합니다. {/* min-version: 2.1.200 */}CLI 및 VS Code와 JetBrains 확장에서 Manual로 표시되며, Claude Code는 `manual`을 별칭으로 허용합니다. 레이블과 별칭은 Claude Code v2.1.200 이상이 필요합니다 |51| `default` | 표준 동작: 각 도구를 처음 사용할 때 권한을 요청합니다. {/* min-version: 2.1.200 */}CLI 및 VS Code와 JetBrains 확장에서 Manual로 표시되며, Claude Code는 `manual`을 별칭으로 허용합니다. 레이블과 별칭은 Claude Code v2.1.200 이상이 필요합니다 |

52| `acceptEdits` | 작업 디렉토리 또는 `additionalDirectories`의 경로에 대해 파일 편집 및 일반적인 파일 시스템 명령(`mkdir`, `touch`, `mv`, `cp` 등)을 자동으로 수락합니다 |52| `acceptEdits` | 작업 디렉토리 또는 `additionalDirectories`의 경로에 대해 파일 편집 및 일반적인 파일 시스템 명령(`mkdir`, `touch`, `mv`, `cp` 등)을 자동으로 수락합니다 |

53| `plan` | Claude는 파일을 읽고 읽기 전용 셸 명령을 실행하여 탐색하지만 소스 파일을 편집하지 않습니다. CLI 및 VS Code 확장에서 Plan으로 표시됩니다 |53| `plan` | Claude는 파일을 읽고 읽기 전용 셸 명령을 실행하여 탐색하지만 소스 파일을 편집하지 않습니다. CLI 및 VS Code 확장에서 Plan으로 표시됩니다 |

54| `auto` | 배경 안전 검사를 통해 도구 호출을 자동으로 승인하여 작업이 요청과 일치하는지 확인합니다. 현재 연구 미리보기입니다 |54| `auto` | 배경 안전 검사를 통해 도구 호출을 자동으로 승인하여 작업이 요청과 일치하는지 확인합니다 |

55| `dontAsk` | `/permissions` 또는 `permissions.allow` 규칙을 통해 사전 승인되지 않은 한 도구를 자동으로 거부합니다 |55| `dontAsk` | `/permissions` 또는 `permissions.allow` 규칙을 통해 사전 승인되지 않은 한 도구를 자동으로 거부합니다 |

56| `bypassPermissions` | 명시적 `ask` 규칙으로 강제되는 권한 프롬프트를 제외한 모든 권한 프롬프트를 건너뜁니다. 파일 시스템 루트 또는 홈 디렉토리 제거(예: `rm -rf /` 및 `rm -rf ~`)는 모델 오류에 대한 회로 차단기로 여전히 프롬프트합니다 |56| `bypassPermissions` | 명시적 `ask` 규칙으로 강제되는 권한 프롬프트를 제외한 모든 권한 프롬프트를 건너뜁니다. 파일 시스템 루트 또는 홈 디렉토리 제거(예: `rm -rf /` 및 `rm -rf ~`)는 모델 오류에 대한 회로 차단기로 여전히 프롬프트합니다 |

57 57 

security.md +2 −2

Details

22 22 

23Claude Code는 기본적으로 엄격한 읽기 전용 권한을 사용합니다. 추가 작업이 필요한 경우(파일 편집, 테스트 실행, 명령 실행), Claude Code는 명시적 권한을 요청합니다. 사용자는 작업을 한 번만 승인할지 또는 자동으로 허용할지 제어할 수 있습니다.23Claude Code는 기본적으로 엄격한 읽기 전용 권한을 사용합니다. 추가 작업이 필요한 경우(파일 편집, 테스트 실행, 명령 실행), Claude Code는 명시적 권한을 요청합니다. 사용자는 작업을 한 번만 승인할지 또는 자동으로 허용할지 제어할 수 있습니다.

24 24 

25Claude Code는 시스템을 수정할 수 있는 Bash 명령을 실행하기 전에 승인을 요구합니다. `ls`, `cat`, `git status`와 같은 기본 제공 읽기 전용 명령 집합은 프롬프트 없이 실행됩니다. 이 접근 방식을 통해 사용자와 조직은 권한을 직접 구성할 수 있습니다.25Claude Code는 시스템을 수정할 수 있는 Bash 명령을 실행하기 전에 승인을 요구합니다. `ls`, `cat`, `git status`와 같은 기본 제공 [읽기 전용 명령](/ko/permissions#read-only-commands) 집합은 프롬프트 없이 실행됩니다. 이 접근 방식을 통해 사용자와 조직은 권한을 직접 구성할 수 있습니다.

26 26 

27자세한 권한 구성은 [Permissions](/ko/permissions)를 참조하십시오.27자세한 권한 구성은 [Permissions](/ko/permissions)를 참조하십시오.

28 28 


33에이전트 시스템의 위험을 완화하기 위해:33에이전트 시스템의 위험을 완화하기 위해:

34 34 

35* **샌드박스 bash 도구**: [Sandbox](/ko/sandboxing) bash 명령을 파일 시스템 및 네트워크 격리로 실행하여 권한 프롬프트를 줄이면서 보안을 유지합니다. `/sandbox`를 사용하여 Claude Code가 자율적으로 작업할 수 있는 경계를 정의하도록 활성화합니다.35* **샌드박스 bash 도구**: [Sandbox](/ko/sandboxing) bash 명령을 파일 시스템 및 네트워크 격리로 실행하여 권한 프롬프트를 줄이면서 보안을 유지합니다. `/sandbox`를 사용하여 Claude Code가 자율적으로 작업할 수 있는 경계를 정의하도록 활성화합니다.

36* **쓰기 액세스 제한**: Claude Code는 시작된 폴더와 그 하위 폴더에만 쓸 수 있으며, 명시적 권한 없이 상위 디렉토리의 파일을 수정할 수 없습니다. Claude Code는 작업 디렉토리 외부의 파일을 읽을 있지만(시스템 라이브러리 종속성에 액세스하는 유용함), 쓰기 작업은 프로젝트 범위로 엄격히 제한되어 명확한 보안 경계를 만듭니다.36* **작업 디렉토리 경계**: Claude Code는 시작된 폴더와 그 하위 폴더에만 쓸 수 있으며, 명시적 권한 없이 상위 디렉토리의 파일을 수정할 수 없습니다. Read, Grep, Glob 도구를 사용하여 이 경계 외부의 경로를 읽는 것은 승인 프롬프트 후에 가능합니다. [추가 디렉토리](/ko/permissions#working-directories)로 경계를 확장하여 프롬프트를 건너뛰거나, 샌드박싱이 활성화되었을 때만 적용되는 [sandbox `denyRead` 규칙](/ko/sandboxing#filesystem-isolation)으로 읽기 전용 Bash 명령에 사용 가능한 광범위한 읽기 액세스를 제한할 수 있습니다.

37* **프롬프트 피로 완화**: 사용자별, 코드베이스별 또는 조직별로 자주 사용되는 안전한 명령을 허용 목록에 추가하는 지원37* **프롬프트 피로 완화**: 사용자별, 코드베이스별 또는 조직별로 자주 사용되는 안전한 명령을 허용 목록에 추가하는 지원

38* **Accept Edits 모드**: 파일 편집을 자동으로 승인하고 작업 디렉토리의 경로에 대해 `mkdir`, `touch`, `rm`, `mv`, `cp`, `sed`와 같은 고정된 파일 시스템 Bash 명령 집합을 자동으로 승인합니다. 다른 Bash 명령과 범위를 벗어난 경로는 여전히 프롬프트를 표시합니다.38* **Accept Edits 모드**: 파일 편집을 자동으로 승인하고 작업 디렉토리의 경로에 대해 `mkdir`, `touch`, `rm`, `mv`, `cp`, `sed`와 같은 고정된 파일 시스템 Bash 명령 집합을 자동으로 승인합니다. 다른 Bash 명령과 범위를 벗어난 경로는 여전히 프롬프트를 표시합니다.

39 39 

setup.md +1 −1

Details

36</h2>36</h2>

37 37 

38<Tip>38<Tip>

39 그래픽 인터페이스를 선호하시나요? [Desktop 앱](/ko/desktop-quickstart)을 사용하면 터미널 없이 Claude Code를 사용할 수 있습니다. [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 또는 [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs)용으로 다운로드하세요.39 그래픽 인터페이스를 선호하시나요? [Desktop 앱](/ko/desktop-quickstart)을 사용하면 터미널 없이 Claude Code를 사용할 수 있습니다. [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 또는 [Linux](/ko/desktop-linux)용으로 다운로드하세요.

40 40 

41 터미널이 처음이신가요? 단계별 지침은 [터미널 가이드](/ko/terminal-guide)를 참조하세요.41 터미널이 처음이신가요? 단계별 지침은 [터미널 가이드](/ko/terminal-guide)를 참조하세요.

42</Tip>42</Tip>

Details

10 10 

11사용자 정의 도구를 추가하려면 [MCP 서버](/ko/mcp)를 연결합니다. Claude를 재사용 가능한 프롬프트 기반 워크플로우로 확장하려면 [skill](/ko/skills)을 작성합니다. 이는 새로운 도구 항목을 추가하는 대신 기존 `Skill` 도구를 통해 실행됩니다.11사용자 정의 도구를 추가하려면 [MCP 서버](/ko/mcp)를 연결합니다. Claude를 재사용 가능한 프롬프트 기반 워크플로우로 확장하려면 [skill](/ko/skills)을 작성합니다. 이는 새로운 도구 항목을 추가하는 대신 기존 `Skill` 도구를 통해 실행됩니다.

12 12 

13Permission required 열은 작업 디렉토리 내의 경로에 대해 기본 권한 모드에서 도구가 프롬프트를 표시하는지 여부를 나타냅니다. `Read`, `Grep`, `Glob`을 포함한 파일 접근 도구는 아니오로 표시되지만 [작업 디렉토리 및 추가 디렉토리](/ko/permissions#working-directories) 외부의 경로에 대해서는 여전히 프롬프트를 표시합니다. `Bash`는 예로 표시되지만 프롬프트 없이 [읽기 전용 명령](/ko/permissions#read-only-commands)의 기본 제공 세트를 실행합니다.

14 

13| 도구 | 설명 | 필요한 권한 |15| 도구 | 설명 | 필요한 권한 |

14| :--------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----- |16| :--------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----- |

15| `Agent` | 작업을 처리하기 위해 자체 context window를 가진 [subagent](/ko/sub-agents)를 생성합니다. [Agent 도구 동작](#agent-tool-behavior) 참조 | 아니오 |17| `Agent` | 작업을 처리하기 위해 자체 context window를 가진 [subagent](/ko/sub-agents)를 생성합니다. [Agent 도구 동작](#agent-tool-behavior) 참조 | 아니오 |

Details

46문제가 나열되지 않은 경우 아래의 진단 검사를 수행하여 원인을 좁혀보세요.46문제가 나열되지 않은 경우 아래의 진단 검사를 수행하여 원인을 좁혀보세요.

47 47 

48<Tip>48<Tip>

49 터미널을 완전히 건너뛰고 싶다면 [Claude Code Desktop 앱](/ko/desktop-quickstart)을 사용하여 그래픽 인터페이스를 통해 Claude Code를 설치하고 사용할 수 있습니다. [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 또는 [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs)용으로 다운로드하고 명령줄 설정 없이 코딩을 시작하세요.49 터미널을 완전히 건너뛰고 싶다면 [Claude Code Desktop 앱](/ko/desktop-quickstart)을 사용하여 그래픽 인터페이스를 통해 Claude Code를 설치하고 사용할 수 있습니다. [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) 또는 [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs)용으로 다운로드하고 명령줄 설정 없이 코딩을 시작하세요. Linux에서는 [Linux 설치 지침](/ko/desktop-linux)을 따라 apt로 앱을 설치하세요.

50</Tip>50</Tip>

51 51 

52<h2 id="run-diagnostic-checks">52<h2 id="run-diagnostic-checks">

Details

15| 로그인 루프, OAuth 오류, `403 Forbidden`, "organization disabled", Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry 자격 증명 | [설치 및 로그인 문제 해결](/ko/troubleshoot-install#login-and-authentication) |15| 로그인 루프, OAuth 오류, `403 Forbidden`, "organization disabled", Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry 자격 증명 | [설치 및 로그인 문제 해결](/ko/troubleshoot-install#login-and-authentication) |

16| 설정이 적용되지 않음, hooks가 실행되지 않음, MCP 서버가 로드되지 않음 | [구성 디버깅](/ko/debug-your-config) |16| 설정이 적용되지 않음, hooks가 실행되지 않음, MCP 서버가 로드되지 않음 | [구성 디버깅](/ko/debug-your-config) |

17| `API Error: 5xx`, `529 Overloaded`, `429`, 요청 검증 오류 | [오류 참조](/ko/errors) |17| `API Error: 5xx`, `529 Overloaded`, `429`, 요청 검증 오류 | [오류 참조](/ko/errors) |

18| `model not found` 또는 `you may not have access to it` | [오류 참조](/ko/errors#there%E2%80%99s-an-issue-with-the-selected-model) |18| `model not found` 또는 `you may not have access to it` | [오류 참조](/ko/errors#theres-an-issue-with-the-selected-model) |

19| VS Code 확장이 Claude에 연결되지 않거나 감지하지 못함 | [VS Code 통합](/ko/vs-code#fix-common-issues) |19| VS Code 확장이 Claude에 연결되지 않거나 감지하지 못함 | [VS Code 통합](/ko/vs-code#fix-common-issues) |

20| JetBrains 플러그인 또는 IDE가 감지되지 않음 | [JetBrains 통합](/ko/jetbrains#troubleshooting) |20| JetBrains 플러그인 또는 IDE가 감지되지 않음 | [JetBrains 통합](/ko/jetbrains#troubleshooting) |

21| 높은 CPU 또는 메모리, 느린 응답, 중단, 검색이 파일을 찾지 못함 | [성능 및 안정성](#performance-and-stability) 아래 |21| 높은 CPU 또는 메모리, 느린 응답, 중단, 검색이 파일을 찾지 못함 | [성능 및 안정성](#performance-and-stability) 아래 |

vs-code.md +1 −1

Details

103프롬프트 상자는 여러 기능을 지원합니다:103프롬프트 상자는 여러 기능을 지원합니다:

104 104 

105* **권한 모드**: 프롬프트 상자 하단의 모드 표시기를 클릭하여 모드를 전환하거나 VS Code 설정의 `claudeCode.initialPermissionMode`에서 기본값을 설정합니다. 표시기가 제공하는 모든 모드는 [권한 모드](/ko/permission-modes#switch-permission-modes)를 참조하십시오.105* **권한 모드**: 프롬프트 상자 하단의 모드 표시기를 클릭하여 모드를 전환하거나 VS Code 설정의 `claudeCode.initialPermissionMode`에서 기본값을 설정합니다. 표시기가 제공하는 모든 모드는 [권한 모드](/ko/permission-modes#switch-permission-modes)를 참조하십시오.

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

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

108 * **Edit automatically**: Claude는 요청 없이 편집을 수행합니다.108 * **Edit automatically**: Claude는 요청 없이 편집을 수행합니다.

109* **명령 메뉴**: `/`를 클릭하거나 입력하여 명령 메뉴를 엽니다. 옵션에는 파일 첨부, 모델 전환, 확장 사고 토글, 계획 사용량 보기(`/usage`) 및 [Remote Control](/ko/remote-control) 세션 시작(`/remote-control`)이 포함됩니다. Customize 섹션은 MCP 서버, hooks, 메모리, 권한 및 플러그인에 대한 액세스를 제공합니다. 터미널 아이콘이 있는 항목은 통합 터미널에서 열립니다.109* **명령 메뉴**: `/`를 클릭하거나 입력하여 명령 메뉴를 엽니다. 옵션에는 파일 첨부, 모델 전환, 확장 사고 토글, 계획 사용량 보기(`/usage`) 및 [Remote Control](/ko/remote-control) 세션 시작(`/remote-control`)이 포함됩니다. Customize 섹션은 MCP 서버, hooks, 메모리, 권한 및 플러그인에 대한 액세스를 제공합니다. 터미널 아이콘이 있는 항목은 통합 터미널에서 열립니다.

whats-new.md +16 −0

Details

8 8 

9주간 개발자 다이제스트는 업무 방식을 바꿀 가능성이 가장 높은 기능들을 강조합니다. 각 항목에는 실행 가능한 코드, 짧은 데모, 그리고 전체 문서로의 링크가 포함됩니다. 모든 버그 수정 및 사소한 개선 사항은 [changelog](/ko/changelog)를 참조하십시오.9주간 개발자 다이제스트는 업무 방식을 바꿀 가능성이 가장 높은 기능들을 강조합니다. 각 항목에는 실행 가능한 코드, 짧은 데모, 그리고 전체 문서로의 링크가 포함됩니다. 모든 버그 수정 및 사소한 개선 사항은 [changelog](/ko/changelog)를 참조하십시오.

10 10 

11<Update label="Week 28" description="2026년 7월 6–10일" tags={["v2.1.202–v2.1.206"]}>

12 **Desktop의 인앱 브라우저**: Desktop의 Claude Code는 기본 제공 브라우저를 받아서 Claude가 문서, 디자인 또는 다른 사이트를 불러올 수 있으며 로컬 개발 서버 미리보기와 동일한 방식으로 페이지와 상호작용할 수 있습니다.

13 

14 이번 주의 다른 기능들: \*\*`/doctor`\*\*는 문제를 진단하고 수정할 수 있는 완전한 설정 점검이며, `/checkup`이 별칭입니다. **auto mode**는 트랜스크립트 변조를 차단하고 미해결 변수에서 `rm -rf` 전에 묻습니다. 그리고 **agent view rows**는 색상이 지정된 상태 단어와 분류기가 작성한 헤드라인을 표시합니다.

15 

16 [Week 28 다이제스트 읽기 →](/ko/whats-new/2026-w28)

17</Update>

18 

19<Update label="Week 27" description="2026년 6월 29일 – 7월 3일" tags={["v2.1.195–v2.1.201"]}>

20 **Claude Sonnet 5**: Pro, Team Standard, 그리고 Enterprise 구독 시트의 새로운 기본 모델로, Sonnet 가격대의 최고 수준 코딩 및 도구 사용, 기본 1M 토큰 컨텍스트 윈도우, 그리고 기본적으로 활성화된 적응형 사고를 제공합니다.

21 

22 이번 주의 다른 기능들: **Chrome의 Claude**는 모든 직접 Anthropic 플랜에서 일반적으로 사용 가능합니다. **subagents는 기본적으로 백그라운드에서 실행되므로** Claude가 실행되는 동안 계속 작업합니다. **Linux의 Claude Desktop**은 Ubuntu 및 Debian에서 베타로 출시됩니다. 그리고 \*\*`/radio`\*\*는 Claude FM lo-fi 라디오를 튜닝합니다.

23 

24 [Week 27 다이제스트 읽기 →](/ko/whats-new/2026-w27)

25</Update>

26 

11<Update label="Week 26" description="2026년 6월 22–26일" tags={["v2.1.185–v2.1.193"]}>27<Update label="Week 26" description="2026년 6월 22–26일" tags={["v2.1.185–v2.1.193"]}>

12 **`claude mcp login`**: 대화형 `/mcp` 메뉴 대신 셸에서 구성된 MCP 서버를 인증하고, 나중에 `claude mcp logout`으로 저장된 자격 증명을 지웁니다.28 **`claude mcp login`**: 대화형 `/mcp` 메뉴 대신 셸에서 구성된 MCP 서버를 인증하고, 나중에 `claude mcp logout`으로 저장된 자격 증명을 지웁니다.

13 29 

whats-new/2026-w27.md +103 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 27주차 · 6월 29일 – 7월 3일, 2026

6 

7> Claude Sonnet 5가 기본 모델이 되었으며, Chrome의 Claude가 정식 출시되었고, 서브에이전트가 기본적으로 백그라운드에서 실행되며, Claude Desktop이 Linux에서 베타로 출시되었고, /radio가 Claude FM으로 튜닝됩니다.

8 

9<div className="digest-meta">

10 <span>Releases <a href="/ko/docs/changelog#2-1-195">v2.1.195 → v2.1.201</a></span>

11 <span>5개 기능 · 6월 29일 – 7월 3일</span>

12</div>

13 

14<div className="digest-feature">

15 <div className="digest-feature-header">

16 <span className="digest-feature-title">Claude Sonnet 5</span>

17 <span className="digest-feature-pill">새로운 모델</span>

18 </div>

19 

20 <p className="digest-feature-lede">Sonnet 5는 Pro, Team Standard, Enterprise 구독 시트의 새로운 기본 모델입니다: Sonnet 가격대의 최고 수준 코딩 및 도구 사용, 기본적으로 활성화된 네이티브 1M 토큰 컨텍스트 윈도우 및 적응형 사고. API 가격은 8월 31일까지 MTok당 $2/$10의 프로모션 가격입니다. v2.1.197 이상이 필요합니다.</p>

21 

22 <p className="digest-feature-try">이름으로 Sonnet 5로 전환하거나 모델 선택기에서 선택하세요:</p>

23 

24 ```text Claude Code theme={null}

25 > /model claude-sonnet-5

26 ```

27 

28 <a className="digest-feature-link" href="/ko/docs/model-config#available-models">모델 구성</a>

29</div>

30 

31<div className="digest-feature">

32 <div className="digest-feature-header">

33 <span className="digest-feature-title">Chrome의 Claude가 정식 출시됨</span>

34 <span className="digest-feature-pill">v2.1.198</span>

35 </div>

36 

37 <p className="digest-feature-lede">Chrome 통합이 직접 Anthropic 플랜의 모든 사용자를 위해 미리보기에서 벗어났습니다. Claude Code는 Claude in Chrome 확장 프로그램을 통해 브라우저를 제어합니다: 탭을 열고, 페이지를 클릭하고, 양식을 채우고, 콘솔 로그를 읽고, 로그인 상태를 공유하므로 컨텍스트를 전환하지 않고도 빌드한 앱을 테스트할 수 있습니다.</p>

38 

39 <a className="digest-feature-link" href="/ko/docs/chrome">Chrome에서 Claude Code 사용</a>

40</div>

41 

42<div className="digest-feature">

43 <div className="digest-feature-header">

44 <span className="digest-feature-title">서브에이전트가 기본적으로 백그라운드에서 실행됨</span>

45 <span className="digest-feature-pill">v2.1.198</span>

46 </div>

47 

48 <p className="digest-feature-lede">Claude는 이제 서브에이전트가 실행되는 동안 계속 작동하고 완료되면 결과를 선택하며, 대기하기 위해 대화를 일시 중지하지 않습니다. Claude는 계속하기 전에 결과가 필요할 때 여전히 포그라운드에서 서브에이전트를 실행하며, 백그라운드 서브에이전트는 주 세션에서 모든 권한 프롬프트를 표시합니다. <code>background</code> frontmatter 필드로 서브에이전트의 동작을 고정하세요.</p>

49 

50 <a className="digest-feature-link" href="/ko/docs/sub-agents#run-subagents-in-foreground-or-background">서브에이전트를 포그라운드 또는 백그라운드에서 실행</a>

51</div>

52 

53<div className="digest-feature">

54 <div className="digest-feature-header">

55 <span className="digest-feature-title">Linux의 Claude Desktop</span>

56 <span className="digest-feature-pill">Desktop</span>

57 </div>

58 

59 <p className="digest-feature-lede">Claude 데스크톱 앱은 이제 Ubuntu 22.04+ 및 Debian 12+에서 베타로 x86\_64 및 arm64에서 사용 가능합니다. macOS 및 Windows와 동일한 Chat, Cowork 및 Claude Code 경험을 얻습니다: 병렬 세션, 시각적 diff 검토, 통합 터미널 및 편집기, 라이브 앱 미리보기. Anthropic의 apt 저장소에서 설치되므로 업데이트는 정기적인 패키지 업데이트를 통해 제공됩니다.</p>

60 

61 <a className="digest-feature-link" href="/ko/docs/desktop-linux">Linux의 Claude Desktop</a>

62</div>

63 

64<div className="digest-feature">

65 <div className="digest-feature-header">

66 <span className="digest-feature-title">/radio</span>

67 <span className="digest-feature-pill">CLI</span>

68 </div>

69 

70 <p className="digest-feature-lede">Claude FM이 방송 중입니다. <code>/radio</code>는 코딩할 때 들을 수 있도록 브라우저에서 로파이 라디오 스트림을 열고, 브라우저를 사용할 수 없을 때 스트림 URL을 인쇄합니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다.</p>

71 

72 <Frame>

73 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/x358isu_VzLnyTEN/images/whats-new/radio.mp4?fit=max&auto=format&n=x358isu_VzLnyTEN&q=85&s=36a0c33859cef119c7192dceea8bcbd3" data-path="images/whats-new/radio.mp4" />

74 </Frame>

75 

76 <p className="digest-feature-try">모든 세션에서 튜닝하세요:</p>

77 

78 ```text Claude Code theme={null}

79 > /radio

80 ```

81 

82 <a className="digest-feature-link" href="/ko/docs/commands#all-commands">모든 명령</a>

83</div>

84 

85<div className="digest-wins">

86 <p className="digest-wins-title">기타 개선 사항</p>

87 

88 <div className="digest-wins-grid">

89 <div><a href="/ko/docs/artifacts">Artifacts</a>는 이제 정식 출시되었으며 Pro 및 Max 플랜에 포함되어 Team 및 Enterprise에 합류했습니다</div>

90 <div>관리자는 org 콘솔에서 <a href="/ko/docs/model-config#organization-default-model">조직 기본 모델</a>을 설정할 수 있습니다. 모델을 직접 선택하지 않았을 때 <code>/model</code>에서 "Org default"로 표시됩니다</div>

91 <div><code>/skill-a /skill-b do XYZ</code>와 같은 스택된 스킬 호출은 이제 첫 번째만이 아니라 모든 선행 스킬(최대 5개)을 로드합니다</div>

92 <div><code>AskUserQuestion</code> 대화는 더 이상 기본적으로 자동 계속되지 않습니다. <code>/config</code>를 통해 유휴 시간 초과를 선택하세요</div>

93 <div>"default" 권한 모드는 이제 CLI, `--help`, VS Code 및 JetBrains 전체에서 "Manual"로 명명됩니다. `--permission-mode manual`은 `default`와 함께 허용됩니다</div>

94 <div>새로운 <code>/dataviz</code> 스킬은 차트 및 대시보드 디자인 지침을 제공하며, 실행 가능한 색상 팔레트 검증기를 포함합니다</div>

95 <div>기본 제공 Explore 에이전트는 이제 Haiku에서 실행되는 대신 주 세션의 모델(Opus로 제한)을 상속합니다</div>

96 <div><code>claude agents</code>에서 시작된 백그라운드 에이전트는 이제 worktree에서 코드 작업을 완료할 때 커밋, 푸시 및 드래프트 PR을 열며, 묻기 위해 중지하지 않습니다</div>

97 <div><code>code-reviewer</code>와 같은 하이픈이 있는 식별자를 가진 Hook 매처는 이제 부분 문자열 매칭 대신 정확히 일치합니다. 하이픈이 있는 MCP 서버의 모든 도구를 일치시키려면 <code>mcp\_\_brave-search\_\_.\*</code>를 사용하세요</div>

98 <div>사용 제한과 관련 없는 일시적 서버 속도 제한 오류는 이제 구독자를 위해 백오프로 자동으로 재시도되며 턴이 실패하지 않습니다</div>

99 <div>스트리밍 유휴 워치독은 이제 모든 제공자에 대해 기본적으로 활성화됩니다: 응답 스트림이 5분 동안 이벤트를 생성하지 않으면 중단하고 재시도합니다 (<code>CLAUDE\_ENABLE\_STREAM\_WATCHDOG=0</code>으로 비활성화)</div>

100 </div>

101</div>

102 

103[v2.1.195–v2.1.201의 전체 변경 로그 →](/ko/changelog#2-1-195)

whats-new/2026-w28.md +63 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 28주차 · 2026년 7월 6–10일

6 

7> Desktop 앱의 내장 브라우저에서 외부 사이트를 탐색하고, /doctor로 전체 설정 점검을 실행하며, 자동 모드 트랜스크립트 보호 및 에이전트 뷰 업그레이드를 확인합니다.

8 

9<div className="digest-meta">

10 <span>릴리스 <a href="/ko/docs/changelog#2-1-202">v2.1.202 → v2.1.206</a></span>

11 <span>2가지 기능 · 7월 6–10</span>

12</div>

13 

14<div className="digest-feature">

15 <div className="digest-feature-header">

16 <span className="digest-feature-title">Desktop의 인앱 브라우저</span>

17 <span className="digest-feature-pill">Desktop</span>

18 </div>

19 

20 <p className="digest-feature-lede">Desktop의 Claude Code는 이제 내장 브라우저를 갖추고 있습니다. Claude는 문서, 디자인 또는 다른 사이트를 불러올 수 있으며, 로컬 개발 서버 미리보기와 동일한 방식으로 페이지를 읽고, 클릭하고, 상호작용할 수 있습니다. 브라우저는 샌드박스 처리되고 구성 가능합니다. 사용자가 브라우징 세션의 지속 여부를 선택할 수 있으며, 안전 분류기가 외부 사이트의 작업을 검토합니다.</p>

21 

22 <Frame>

23 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/x358isu_VzLnyTEN/images/whats-new/desktop-browser.mp4?fit=max&auto=format&n=x358isu_VzLnyTEN&q=85&s=8033e85a1cb0a37870a79e702c18f4e4" data-path="images/whats-new/desktop-browser.mp4" />

24 </Frame>

25 

26 <a className="digest-feature-link" href="/ko/docs/desktop#browse-external-sites">외부 사이트 탐색</a>

27</div>

28 

29<div className="digest-feature">

30 <div className="digest-feature-header">

31 <span className="digest-feature-title">/doctor는 전체 설정 점검입니다</span>

32 <span className="digest-feature-pill">v2.1.205</span>

33 </div>

34 

35 <p className="digest-feature-lede"><code>/doctor</code>는 이제 읽기 전용 보고서를 출력하는 대신 문제를 진단하고 해결할 수 있습니다. 설치 상태를 확인하고, 사용하지 않는 skills, MCP 서버 및 플러그인과 그들의 컨텍스트 비용을 찾으며, 로컬 <code>CLAUDE.md</code> 파일을 체크인된 파일과 중복 제거하고, Claude가 코드베이스에서 파생할 수 있는 <code>CLAUDE.md</code> 콘텐츠 정리를 제안하며, 느린 hooks를 표시합니다. 변경 사항을 적용하기 전에 먼저 결과를 보고하고 확인을 요청합니다. <code>/checkup</code>은 이의 별칭입니다.</p>

36 

37 <p className="digest-feature-try">모든 세션에서 점검을 실행합니다:</p>

38 

39 ```text Claude Code theme={null}

40 > /doctor

41 ```

42 

43 <a className="digest-feature-link" href="/ko/docs/commands#all-commands">모든 명령어</a>

44</div>

45 

46<div className="digest-wins">

47 <p className="digest-wins-title">기타 개선 사항</p>

48 

49 <div className="digest-wins-grid">

50 <div>자동 모드는 이제 세션 트랜스크립트 파일 변조를 차단하고, 컨텍스트에서 확인할 수 없는 변수에 대해 <code>rm -rf</code>를 실행하기 전에 확인을 요청합니다</div>

51 <div><code>/cd</code>는 이제 <code>/add-dir</code>과 일치하는 디렉토리 경로를 입력할 때 제안합니다</div>

52 <div><code>/commit-push-pr</code>은 <code>origin</code> 외에도 저장소의 구성된 푸시 원격에 <code>git push</code>를 자동으로 허용합니다</div>

53 <div>Gateway: <code>/login</code>은 이제 Anthropic이 운영하는 공개 게이트웨이 엔드포인트를 지원합니다</div>

54 <div><code>EnterWorktree</code>는 프로젝트의 <code>.claude/worktrees/</code> 디렉토리 외부의 git worktree에 진입하기 전에 확인을 요청합니다</div>

55 <div>백그라운드 에이전트는 연결할 때 느린 stale-session 업그레이드를 지불하는 대신 Claude Code 업데이트 직후 백그라운드에서 새 버전으로 업그레이드됩니다</div>

56 <div>에이전트 뷰 행은 이제 원시 도구 호출 텍스트 대신 색상이 지정된 상태 단어와 분류기가 작성한 헤드라인을 표시하며, 기존 PR을 편집, 병합, 댓글 달기 또는 푸시하는 세션은 <code>claude agents</code>에서 이를 연결합니다</div>

57 <div>자동 업데이트 바이너리 다운로드는 이제 메모리에 버퍼링하는 대신 디스크로 스트리밍되어 업데이터의 피크 메모리 사용량을 약 400 MB 줄입니다</div>

58 <div>백그라운드 작업 알림은 이제 인간의 입력이 발생하지 않았음을 명시적으로 나타내어 트랜스크립트에서 조작된 승인이 실행되는 것을 방지합니다</div>

59 <div>모든 노력 수준에서 Opus 4.8의 <code>/code-review</code> 결과 품질이 개선되었습니다</div>

60 </div>

61</div>

62 

63[v2.1.202–v2.1.206의 전체 변경 로그 →](/ko/changelog#2-1-202)