errors.md +35 −1
19터미널에 표시되는 메시지를 아래 섹션과 일치시킵니다.19터미널에 표시되는 메시지를 아래 섹션과 일치시킵니다.
20 20
21| 메시지 | 섹션 |21| 메시지 | 섹션 |
2222| :----------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------ || :-------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------ |
23| `API Error: 500 ... Internal server error` | [서버 오류](#api-error-500-internal-server-error) |23| `API Error: 500 ... Internal server error` | [서버 오류](#api-error-500-internal-server-error) |
24| `API Error: Repeated 529 Overloaded errors` | [서버 오류](#api-error-repeated-529-overloaded-errors) |24| `API Error: Repeated 529 Overloaded errors` | [서버 오류](#api-error-repeated-529-overloaded-errors) |
25| `Request timed out` | [서버 오류](#request-timed-out), 또는 메시지에 인터넷 연결이 언급된 경우 [네트워크](#unable-to-connect-to-api) |25| `Request timed out` | [서버 오류](#request-timed-out), 또는 메시지에 인터넷 연결이 언급된 경우 [네트워크](#unable-to-connect-to-api) |
33| `Not logged in · Please run /login` | [인증](#not-logged-in) |33| `Not logged in · Please run /login` | [인증](#not-logged-in) |
34| `Invalid API key` | [인증](#invalid-api-key) |34| `Invalid API key` | [인증](#invalid-api-key) |
35| `This organization has been disabled` | [인증](#this-organization-has-been-disabled) |35| `This organization has been disabled` | [인증](#this-organization-has-been-disabled) |
36| `Your organization has disabled Claude subscription access` | [인증](#your-organization-has-disabled-claude-subscription-access) |
36| `Routines are disabled by your organization's policy` | [인증](#routines-are-disabled-by-your-organizations-policy) |37| `Routines are disabled by your organization's policy` | [인증](#routines-are-disabled-by-your-organizations-policy) |
37| `OAuth token revoked` / `OAuth token has expired` | [인증](#oauth-token-revoked-or-expired) |38| `OAuth token revoked` / `OAuth token has expired` | [인증](#oauth-token-revoked-or-expired) |
38| `does not meet scope requirement user:profile` | [인증](#oauth-scope-requirement) |39| `does not meet scope requirement user:profile` | [인증](#oauth-scope-requirement) |
50| `thinking.type.enabled is not supported for this model` | [요청 오류](#thinking-type-enabled-is-not-supported-for-this-model) |51| `thinking.type.enabled is not supported for this model` | [요청 오류](#thinking-type-enabled-is-not-supported-for-this-model) |
51| `max_tokens must be greater than thinking.budget_tokens` | [요청 오류](#thinking-budget-exceeds-output-limit) |52| `max_tokens must be greater than thinking.budget_tokens` | [요청 오류](#thinking-budget-exceeds-output-limit) |
52| `API Error: 400 due to tool use concurrency issues` | [요청 오류](#tool-use-or-thinking-block-mismatch) |53| `API Error: 400 due to tool use concurrency issues` | [요청 오류](#tool-use-or-thinking-block-mismatch) |
54| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [요청 오류](#usage-policy-refusal) |
53| 응답 품질이 평소보다 낮아 보임 | [응답 품질](#responses-seem-lower-quality-than-usual) |55| 응답 품질이 평소보다 낮아 보임 | [응답 품질](#responses-seem-lower-quality-than-usual) |
54 56
55## 자동 재시도57## 자동 재시도
283* 그 후 `/status`를 실행하여 활성 자격 증명이 구독인지 확인합니다.285* 그 후 `/status`를 실행하여 활성 자격 증명이 구독인지 확인합니다.
284* 환경 변수가 설정되지 않았는데도 오류가 지속되면 비활성화된 조직이 `/login`에 연결된 것입니다. 지원팀에 문의하거나 다른 계정으로 로그인합니다.286* 환경 변수가 설정되지 않았는데도 오류가 지속되면 비활성화된 조직이 `/login`에 연결된 것입니다. 지원팀에 문의하거나 다른 계정으로 로그인합니다.
285 287
288### Your organization has disabled Claude subscription access
289
290Claude 조직이 구독 로그인으로 Claude Code에 로그인하는 것을 허용하지 않습니다. 동일한 계정으로 `/login`을 다시 실행하면 동일한 오류가 반환됩니다.
291
292```text theme={null}
293Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
294```
295
296이는 서버 측 조직 설정이므로 로컬 설정, 환경 변수 또는 CLI 플래그에서 재정의할 수 없습니다. Agent SDK 및 `-p` 비대화형 모드는 이를 `oauth_org_not_allowed` 오류 코드로 표시합니다.
297
298**할 일:**
299
300* 관리자에게 조직에 대해 Claude Code 액세스를 활성화하도록 요청합니다.
301* 구독 대신 Console API 키로 인증합니다. 설정은 [Claude Console 인증](/ko/authentication#claude-console-authentication)을 참조하십시오.
302* 관리자이고 액세스를 활성화하는 옵션이 보이지 않으면 [Anthropic 지원](https://support.claude.com)에 문의합니다.
303
286### Routines are disabled by your organization's policy304### Routines are disabled by your organization's policy
287 305
288팀 또는 엔터프라이즈 관리자가 조직 수준에서 루틴을 비활성화했습니다. 오류는 `/schedule` 및 claude.ai/code의 [Routines](/ko/routines) UI에서 루틴을 생성하거나 실행하려고 할 때 나타납니다.306팀 또는 엔터프라이즈 관리자가 조직 수준에서 루틴을 비활성화했습니다. 오류는 `/schedule` 및 claude.ai/code의 [Routines](/ko/routines) UI에서 루틴을 생성하거나 실행하려고 할 때 나타납니다.
573 591
574* `/rewind`를 실행하거나 Esc를 두 번 눌러 손상된 턴 전의 체크포인트로 뒤로 이동하고 거기서 계속합니다. [체크포인팅](/ko/checkpointing)을 참조하여 체크포인트가 생성되고 복원되는 방식을 확인합니다.592* `/rewind`를 실행하거나 Esc를 두 번 눌러 손상된 턴 전의 체크포인트로 뒤로 이동하고 거기서 계속합니다. [체크포인팅](/ko/checkpointing)을 참조하여 체크포인트가 생성되고 복원되는 방식을 확인합니다.
575 593
594### Usage Policy refusal
595
596API가 대화의 내용이 [사용 정책](https://www.anthropic.com/legal/aup) 확인을 트리거했기 때문에 응답을 거부했습니다. 메시지에는 거부가 잘못되었다고 생각하는 경우 지원팀에 인용할 수 있는 요청 ID가 포함됩니다.
597
598```text theme={null}
599API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.
600```
601
602확인은 최신 프롬프트뿐만 아니라 전체 대화를 평가하므로 동일한 세션에서 새 메시지를 보내면 일반적으로 동일한 거부를 다시 트리거합니다. `--continue` 또는 `--resume`으로 세션을 종료하고 다시 열 때도 마찬가지입니다. 디스크의 기록에 여전히 트리거 콘텐츠가 포함되어 있기 때문입니다.
603
604**할 일:**
605
606* Esc를 두 번 누르거나 `/rewind`를 실행하여 거부를 트리거한 턴 전의 체크포인트로 뒤로 이동한 후 다시 표현하거나 다른 접근 방식을 시도합니다. [체크포인팅](/ko/checkpointing)을 참조하십시오.
607* 어느 턴이 원인인지 식별할 수 없으면 `/clear`를 실행하여 동일한 프로젝트에서 새 대화를 시작합니다. 이전 대화는 디스크에 보존되며 `/resume`에서 사용 가능합니다.
608* [비대화형 모드](/ko/headless)(`-p`)에서는 되감기를 사용할 수 없으므로 다시 표현된 프롬프트로 다시 시도하거나 `--continue` 없이 새 세션을 시작합니다.
609
576## 응답 품질이 평소보다 낮아 보임610## 응답 품질이 평소보다 낮아 보임
577 611
578Claude의 답변이 오류 없이 예상보다 덜 유능해 보이면 원인은 일반적으로 모델 자체가 아닌 대화 상태입니다. Claude Code는 모델 버전을 자동으로 변경하지 않습니다. Opus 할당량에 도달하거나 Bedrock 또는 Vertex AI 지역이 모델이 없는 경우와 같은 특정 경우에 대체 모델로 전환할 수 있습니다. 아래의 모델 선택 확인이 둘 다 포착하고 [모델 구성](/ko/model-config)은 대체가 적용되는 시기를 설명합니다.612Claude의 답변이 오류 없이 예상보다 덜 유능해 보이면 원인은 일반적으로 모델 자체가 아닌 대화 상태입니다. Claude Code는 모델 버전을 자동으로 변경하지 않습니다. Opus 할당량에 도달하거나 Bedrock 또는 Vertex AI 지역이 모델이 없는 경우와 같은 특정 경우에 대체 모델로 전환할 수 있습니다. 아래의 모델 선택 확인이 둘 다 포착하고 [모델 구성](/ko/model-config)은 대체가 적용되는 시기를 설명합니다.