Documentation 2026-07-01 21:01 UTC to 2026-07-02 23:59 UTC

89| :---------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |89| :---------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |

90| 관리형 정책 설정 | 엔드포인트 관리형 정책(MDM plist, 레지스트리 정책 또는 관리형 설정 파일)은 호스트에서 로드되며, [서버 관리형 설정](/ko/server-managed-settings)은 조직 OAuth 로그인 또는 직접 구성된 API 키로 세션이 인증될 때 [적격 구성](/ko/server-managed-settings#platform-availability)에서 가져와집니다 | 엔드포인트 정책: 호스트에서 관리형 설정 파일, plist 또는 레지스트리 정책을 제거합니다. 서버 관리형 설정: 조직 관리자가 제어하며, SDK에서 비활성화할 수 없습니다 |90| 관리형 정책 설정 | 엔드포인트 관리형 정책(MDM plist, 레지스트리 정책 또는 관리형 설정 파일)은 호스트에서 로드되며, [서버 관리형 설정](/ko/server-managed-settings)은 조직 OAuth 로그인 또는 직접 구성된 API 키로 세션이 인증될 때 [적격 구성](/ko/server-managed-settings#platform-availability)에서 가져와집니다 | 엔드포인트 정책: 호스트에서 관리형 설정 파일, plist 또는 레지스트리 정책을 제거합니다. 서버 관리형 설정: 조직 관리자가 제어하며, SDK에서 비활성화할 수 없습니다 |

91| `~/.claude.json` 전역 구성 | 항상 읽음 | `env`의 `CLAUDE_CONFIG_DIR`로 재배치 |91| `~/.claude.json` 전역 구성 | 항상 읽음 | `env`의 `CLAUDE_CONFIG_DIR`로 재배치 |

92| `~/.claude/projects/<project>/memory/`의 자동 메모리 | 기본적으로 시스템 프롬프트에 로드됨 | 설정에서 `autoMemoryEnabled: false` 설정 또는 `env`에서 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` 설정 |92| `~/.claude/projects/<project>/memory/`의 자동 메모리 | 세션 시작 시 시스템 프롬프트에 로드됩니다. 에이전트는 전용 메모리 도구가 아닌 표준 `Write` 및 `Edit` 도구를 사용하여 새 메모리를 작성하므로, 에이전트가 메모리를 저장하려면 이러한 도구를 활성화해야 합니다 | 설정에서 `autoMemoryEnabled: false`를 설정하거나, `env`에서 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`을 설정합니다 |

93| [claude.ai MCP 커넥터](/ko/mcp#use-mcp-servers-from-claude-ai) | 활성 인증 방법이 claude.ai 구독일 때 로드됨. `mcpServers: {}`를 전달해도 이들을 억제하지 않음 | `strictMcpConfig: true` 설정, [`disableClaudeAiConnectors: true`](/ko/mcp#disable-claude-ai-connectors) 설정 또는 `env`에서 `ENABLE_CLAUDEAI_MCP_SERVERS=false` 설정 |93| [claude.ai MCP 커넥터](/ko/mcp#use-mcp-servers-from-claude-ai) | 활성 인증 방법이 claude.ai 구독일 때 로드됨. `mcpServers: {}`를 전달해도 이들을 억제하지 않음 | `strictMcpConfig: true` 설정, [`disableClaudeAiConnectors: true`](/ko/mcp#disable-claude-ai-connectors) 설정 또는 `env`에서 `ENABLE_CLAUDEAI_MCP_SERVERS=false` 설정 |

94 94 

95<Warning>95<Warning>

4 4 

5# 아티팩트로 세션 출력 공유5# 아티팩트로 세션 출력 공유

6 6 

7> 아티팩트는 Claude Code의 작업을 조직 내에서 공유할 수 있는 비공개 URL의 라이브 인터랙티브 페이지로 변환합니다.7> 아티팩트는 Claude Code의 작업을 claude.ai의 비공개 URL에서 라이브 인터랙티브 페이지로 변환합니다.

8 8 

9{/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}9{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}

10 10 

11<Note>11<Note>

12 아티팩트는 베타 버전입니다. Team 또는 Enterprise 플랜과 [`/login`](/ko/setup#authenticate)으로 로그인한 세션이 필요합니다. 전체 요구사항은 [가용성](#availability)을 참조하십시오.12 아티팩트는 Pro, Max, Team, Enterprise 플랜에서 사용 가능하며 [`/login`](/ko/setup#authenticate)으로 로그인한 세션이 필요합니다. 전체 요구사항은 [가용성](#availability)을 참조하십시오.

13</Note>13</Note>

14 14 

15아티팩트는 Claude Code가 세션에서 claude.ai의 비공개 URL로 게시하는 라이브 인터랙티브 웹 페이지입니다. 브라우저에서 열면 세션이 계속되면서 제자리에서 업데이트됩니다. 팀원이 보기를 원할 때 페이지 헤더에서 공유하십시오. 예를 들어, 아티팩트를 사용하여 주석이 달린 diff로 풀 요청을 검토자에게 설명하거나, 세션 데이터에서 대시보드를 구축하거나, Claude가 작업하면서 채워지는 조사 타임라인을 유지할 수 있습니다.15아티팩트는 Claude Code가 세션에서 claude.ai의 비공개 URL로 게시하는 라이브 인터랙티브 웹 페이지입니다. 브라우저에서 열면 세션이 계속되면서 제자리에서 업데이트됩니다. Team 및 Enterprise 플랜에서는 팀원이 보기를 원할 때 페이지 헤더에서 공유할 수 있습니다. 예를 들어, 아티팩트를 사용하여 주석이 달린 diff로 풀 요청을 검토자에게 설명하거나, 세션 데이터에서 대시보드를 구축하거나, Claude가 작업하면서 채워지는 조사 타임라인을 유지할 수 있습니다.

16 16 

17<Frame>17<Frame>

18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="claude.ai/code/artifact에서 열린 아티팩트입니다. 뷰어 헤더는 아티팩트 제목 acme-funnel-fix, 공유 버튼, 작성자 아바타를 표시합니다. 공유 메뉴는 최신 버전 항상 공유 토글, 버전 2를 읽는 버전 선택기, Acme 대상 선택기, 링크 복사 버튼과 함께 열려 있습니다. 헤더 아래에서 아티팩트 페이지는 두 개의 모바일 목업을 나란히, 깔때기 차트, 메트릭 카드 행을 표시합니다." width="2511" height="1890" data-path="images/artifacts-viewer.png" />18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="claude.ai/code/artifact에서 열린 아티팩트입니다. 뷰어 헤더는 아티팩트 제목 acme-funnel-fix, 공유 버튼, 작성자 아바타를 표시합니다. 공유 메뉴는 최신 버전 항상 공유 토글, 버전 2를 읽는 버전 선택기, Acme 대상 선택기, 링크 복사 버튼과 함께 열려 있습니다. 헤더 아래에서 아티팩트 페이지는 두 개의 모바일 목업을 나란히, 깔때기 차트, 메트릭 카드 행을 표시합니다." width="2511" height="1890" data-path="images/artifacts-viewer.png" />

84 아티팩트 공유84 아티팩트 공유

85</h2>85</h2>

86 86 

87새 아티팩트는 사용자에게만 표시됩니다. 브라우저에서 열고 페이지 헤더의 **공유** 컨트롤을 사용하여 조직의 특정 사람 또는 모든 사람에게 액세스 권한을 부여하십시오. 헤더는 사용자를 아티팩트의 작성자로 표시하므로 공유하는 모든 사람이 페이지를 게시한 사람을 볼 수 있습니다. 또한 [claude.ai/code/artifacts](https://claude.ai/code/artifacts)의 갤러리에 링크되어 생성한 모든 아티팩트를 나열합니다.87새 아티팩트는 사용자에게만 표시됩니다. Pro 및 Max 플랜에서는 아티팩트가 사용자에게만 비공개로 유지됩니다. Team 및 Enterprise 플랜에서는 브라우저에서 아티팩트를 열고 페이지 헤더의 **공유** 컨트롤을 사용하여 조직의 특정 사람 또는 모든 사람에게 액세스 권한을 부여하십시오. 헤더는 사용자를 아티팩트의 작성자로 표시하므로 공유하는 모든 사람이 페이지를 게시한 사람을 볼 수 있습니다. 또한 [claude.ai/code/artifacts](https://claude.ai/code/artifacts)의 갤러리에 링크되어 생성한 모든 아티팩트를 나열합니다.

88 88 

89공유는 조직에서 중지됩니다. 뷰어는 아티팩트를 게시한 동일한 조직의 구성원으로 claude.ai에 로그인해야 하며, 조직 외부에서 볼 수 있도록 하는 옵션이 없습니다. 기본 콘텐츠를 조직 외부의 누군가에게 보내려면 Claude에 HTML 파일을 요청하고 해당 파일을 직접 공유하십시오.89공유는 조직에서 중지됩니다. 뷰어는 아티팩트를 게시한 동일한 조직의 구성원으로 claude.ai에 로그인해야 하며, 조직 외부에서 볼 수 있도록 하는 옵션이 없습니다. 기본 콘텐츠를 조직 외부의 누군가에게 보내려면 Claude에 HTML 파일을 요청하고 해당 파일을 직접 공유하십시오.

90 90 

189아티팩트는 아래의 모든 조건이 필요합니다. 하나가 충족되지 않으면 Claude는 로컬 HTML 파일을 작성하거나 게시할 수 없다고 말합니다.189아티팩트는 아래의 모든 조건이 필요합니다. 하나가 충족되지 않으면 Claude는 로컬 HTML 파일을 작성하거나 게시할 수 없다고 말합니다.

190 190 

191| 요구사항 | 사용 가능한 경우 |191| 요구사항 | 사용 가능한 경우 |

192| :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |192| :----- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

193| 플랜 | Team 또는 Enterprise. Team 플랜에서는 아티팩트가 기본적으로 켜져 있습니다. Enterprise 플랜에서는 Owner가 claude.ai 관리 설정에서 [활성화](#manage-artifacts-for-your-organization)합니다. |193| 플랜 | Pro, Max, Team 또는 Enterprise. Pro 및 Max 플랜에서는 아티팩트가 사용자에게만 비공개이며 관리자 관리가 적용되지 않습니다. Team 플랜에서는 아티팩트가 기본적으로 켜져 있습니다. Enterprise 플랜에서는 Owner가 claude.ai 관리 설정에서 [활성화](#manage-artifacts-for-your-organization)합니다. |

194| 인증 | `/login`으로 claude.ai에 로그인했습니다. API 키, [게이트웨이 토큰](/ko/llm-gateway) 또는 클라우드 공급자 자격증명을 사용하는 세션은 게시할 수 없습니다. |194| 인증 | `/login`으로 claude.ai에 로그인했습니다. API 키, [게이트웨이 토큰](/ko/llm-gateway) 또는 클라우드 공급자 자격증명을 사용하는 세션은 게시할 수 없습니다. |

195| 모델 공급자 | Anthropic API. [Amazon Bedrock](/ko/amazon-bedrock), [Google Cloud Vertex AI](/ko/google-vertex-ai) 또는 [Microsoft Foundry](/ko/microsoft-foundry)에서는 사용할 수 없습니다. |195| 모델 공급자 | Anthropic API. [Amazon Bedrock](/ko/amazon-bedrock), [Google Cloud Vertex AI](/ko/google-vertex-ai) 또는 [Microsoft Foundry](/ko/microsoft-foundry)에서는 사용할 수 없습니다. |

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

50 50 

51 <Step title="실행 및 로그인">51 <Step title="실행 및 로그인">

52 애플리케이션 런처에서 **Claude**를 실행하거나 터미널에서 `claude-desktop`을 실행한 후 Anthropic 계정으로 로그인합니다.52 애플리케이션 런처에서 **Claude**를 실행하거나 터미널에서 `claude-desktop`을 실행한 후 Anthropic 계정으로 로그인합니다.

53 

54 Linux 앱은 macOS 및 Windows와 동일한 방식으로 로그인합니다: claude.ai 구독 또는 조직의 SSO를 통해 로그인합니다. Desktop은 Claude Console API 키를 직접 허용하지 않습니다. API 키 인증의 경우 [CLI](/ko/quickstart)를 사용하세요. Desktop을 Google Cloud의 Agent Platform 또는 LLM 게이트웨이로 라우팅하는 엔터프라이즈 배포의 경우 [엔터프라이즈 구성 가이드](https://support.claude.com/en/articles/12622667-enterprise-configuration) 및 [네트워크 구성](/ko/network-config)을 참조하세요.

53 </Step>55 </Step>

54</Steps>56</Steps>

55 57 

729 Model is restricted by your organization's settings729 Model is restricted by your organization's settings

730</h3>730</h3>

731 731 

732조직 관리자가 Claude Console에서 이 모델을 비활성화했거나 관리되는 설정의 [`availableModels`](/ko/model-config#restrict-model-selection) 허용 목록으로 제외되었습니다. 제한된 모델이 `--model`, `ANTHROPIC_MODEL` 또는 `model` 설정으로 설정되었을 때 Claude Code는 허용된 모델로 대체하고 계속합니다. 제한된 모델에 대해 `/model <name>`을 입력하면 `Run /model to choose a different model.`로 거부되고 세션은 현재 모델을 유지합니다.732조직 관리자가 claude.ai 관리 콘솔에서 이 모델을 비활성화했거나 관리되는 설정의 [`availableModels`](/ko/model-config#restrict-model-selection) 허용 목록으로 제외되었습니다. 제한된 모델이 `--model`, `ANTHROPIC_MODEL` 또는 `model` 설정으로 설정되었을 때 Claude Code는 허용된 모델로 대체하고 계속합니다. 제한된 모델에 대해 `/model <name>`을 입력하면 `Run /model to choose a different model.`로 거부되고 세션은 현재 모델을 유지합니다.

733 733 

734```text theme={null}734```text theme={null}

735Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.735Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

50* [Remote Control](/ko/remote-control)50* [Remote Control](/ko/remote-control)

51* [Chrome 확장](/ko/chrome)51* [Chrome 확장](/ko/chrome)

52* [Computer use](/ko/computer-use): Pro 및 Max 플랜52* [Computer use](/ko/computer-use): Pro 및 Max 플랜

53* [Artifacts](/ko/artifacts): Team 및 Enterprise 플랜53* [Artifacts](/ko/artifacts): Pro, Max, Team 및 Enterprise 플랜

54* [음성 받아쓰기](/ko/voice-dictation)54* [음성 받아쓰기](/ko/voice-dictation)

55 55 

56Desktop은 부분적인 예외입니다: Enterprise 배포는 [관리되는 설정](https://support.claude.com/en/articles/12622667-enterprise-configuration)을 통해 Desktop을 Vertex AI 또는 게이트웨이 제공자로 라우팅할 수 있으며, [Cowork on 3P 연구 미리보기](https://claude.com/docs/cowork/3p/overview)는 Bedrock, Vertex AI, Foundry 또는 자체 호스팅 LLM 게이트웨이에서 Code 탭을 실행합니다. 이러한 기능의 플랜별 가용성은 [구독 플랜별 가용성](#availability-by-subscription-plan)을 참조하십시오.56Desktop은 부분적인 예외입니다: Enterprise 배포는 [관리되는 설정](https://support.claude.com/en/articles/12622667-enterprise-configuration)을 통해 Desktop을 Vertex AI 또는 게이트웨이 제공자로 라우팅할 수 있으며, [Cowork on 3P 연구 미리보기](https://claude.com/docs/cowork/3p/overview)는 Bedrock, Vertex AI, Foundry 또는 자체 호스팅 LLM 게이트웨이에서 Code 탭을 실행합니다. 이러한 기능의 플랜별 가용성은 [구독 플랜별 가용성](#availability-by-subscription-plan)을 참조하십시오.

286| [Computer use](/ko/computer-use) | ✓ | ✓ | ✗ | ✗ |286| [Computer use](/ko/computer-use) | ✓ | ✓ | ✗ | ✗ |

287| Dispatch ([Desktop](/ko/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |287| Dispatch ([Desktop](/ko/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

288| [Code Review](/ko/code-review) | ✗ | ✗ | ✓ | ✓ |288| [Code Review](/ko/code-review) | ✗ | ✗ | ✓ | ✓ |

289| [Artifacts](/ko/artifacts) | ✗ | ✗ | ✓ | 관리자 활성화 |289| [Artifacts](/ko/artifacts) | ✓ | ✓ | ✓ | 관리자 활성화 |

290| [분석 대시보드, API, 기여도 메트릭](/ko/analytics) | ✗ | ✗ | ✓ | ✓ |290| [분석 대시보드, API, 기여도 메트릭](/ko/analytics) | ✗ | ✗ | ✓ | ✓ |

291| [서버 관리 설정](/ko/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |291| [서버 관리 설정](/ko/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

292| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |292| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

37| `Ctrl+R` | 역방향 검색 명령 기록 | 이전 명령을 대화형으로 검색 |37| `Ctrl+R` | 역방향 검색 명령 기록 | 이전 명령을 대화형으로 검색 |

38| `Ctrl+V` 또는 `Cmd+V` (iTerm2) 또는 `Alt+V` (Windows 및 WSL) | 클립보드에서 이미지 붙여넣기 | 커서에 `[Image #N]` 칩을 삽입하여 프롬프트에서 위치별로 참조할 수 있습니다. WSL에서는 `Ctrl+V`와 `Alt+V` 모두 바인딩되어 있습니다. 터미널이 `Ctrl+V`를 가로채면 `Alt+V`를 사용하세요 |38| `Ctrl+V` 또는 `Cmd+V` (iTerm2) 또는 `Alt+V` (Windows 및 WSL) | 클립보드에서 이미지 붙여넣기 | 커서에 `[Image #N]` 칩을 삽입하여 프롬프트에서 위치별로 참조할 수 있습니다. WSL에서는 `Ctrl+V`와 `Alt+V` 모두 바인딩되어 있습니다. 터미널이 `Ctrl+V`를 가로채면 `Alt+V`를 사용하세요 |

39| `Ctrl+B` | 백그라운드 실행 작업 | Bash 명령 및 에이전트를 백그라운드로 실행합니다. Tmux 사용자는 두 번 누르기 |39| `Ctrl+B` | 백그라운드 실행 작업 | Bash 명령 및 에이전트를 백그라운드로 실행합니다. Tmux 사용자는 두 번 누르기 |

40| `Ctrl+T` | 작업 목록 토글 | 터미널 상태 영역에서 [작업 목록](#task-list) 표시 또는 숨기기 |40| `Ctrl+T` | Claude의 작업 체크리스트 토글 | 상태 영역에서 [Claude의 할 일 체크리스트](#task-list)를 표시하거나 숨깁니다. 이는 백그라운드 작업 보기가 아닙니다. [`/tasks`](/ko/commands)를 사용하여 실행 중인 셸 및 서브에이전트를 확인하세요 |

41| `Left/Right 화살표` | 대화 상자 탭 순환 | 권한 대화 상자 및 메뉴의 탭 간 탐색 |41| `Left/Right 화살표` | 대화 상자 탭 순환 | 권한 대화 상자 및 메뉴의 탭 간 탐색 |

42| `Up/Down 화살표` 또는 `Ctrl+P`/`Ctrl+N` | 커서 이동 또는 명령 기록 탐색 | 입력이 여러 시각적 줄에 걸쳐 있을 때(줄 바꿈 또는 여러 줄 여부), 먼저 프롬프트 내에서 커서를 이동합니다. 커서가 첫 번째 또는 마지막 시각적 줄에 있으면 다시 누르면 명령 기록을 탐색합니다. {/* min-version: 2.1.169 */}v2.1.169부터 줄 바꿈된 단일 줄 입력은 여러 줄과 동일하게 작동합니다 |42| `Up/Down 화살표` 또는 `Ctrl+P`/`Ctrl+N` | 커서 이동 또는 명령 기록 탐색 | 입력이 여러 시각적 줄에 걸쳐 있을 때(줄 바꿈 또는 여러 줄 여부), 먼저 프롬프트 내에서 커서를 이동합니다. 커서가 첫 번째 또는 마지막 시각적 줄에 있으면 다시 누르면 명령 기록을 탐색합니다. {/* min-version: 2.1.169 */}v2.1.169부터 줄 바꿈된 단일 줄 입력은 여러 줄과 동일하게 작동합니다 |

43| `Esc` | Claude 중단 | 현재 응답 또는 도구 호출을 중간에 중지하여 리다이렉트할 수 있습니다. Claude는 지금까지 수행한 작업을 유지합니다 |43| `Esc` | Claude 중단 | 현재 응답 또는 도구 호출을 중간에 중지하여 리다이렉트할 수 있습니다. Claude는 지금까지 수행한 작업을 유지합니다 |

387 작업 목록387 작업 목록

388</h2>388</h2>

389 389 

390복잡한 다단계 작업을 수행할 때 Claude는 진행 상황을 추적하기 위해 작업 목록을 만듭니다. 작업은 터미널의 상태 영역에 표시되며 보류 중, 진행 중 또는 완료된 항목을 나타내는 표시기가 있습니다.390작업 목록은 Claude의 할 일 체크리스트입니다: Claude가 다단계 작업을 계획하기 위해 생성한 항목으로, 보류 중, 진행 중 또는 완료된 항목을 나타내는 표시기가 있습니다. 이는 백그라운드 작업 보기와는 별개입니다. 실행 중인 셸과 서브에이전트를 보려면 [`/tasks`](/ko/commands) 대신 사용하세요.

391 391 

392* `Ctrl+T`를 눌러 작업 목록 보기를 토글하세요. 디스플레이는 한 번에 최대 5개의 작업을 표시합니다392* `Ctrl+T`를 눌러 작업 목록 보기를 토글하세요. 디스플레이는 한 번에 최대 5개의 작업을 표시합니다. Claude가 아직 체크리스트 항목을 생성하지 않았을 때는 표시할 것이 없기 때문에 토글이 눈에 띄는 효과가 없습니다

393* 모든 작업을 보거나 지우려면 Claude에 직접 요청하세요: "show me all tasks" 또는 "clear all tasks"393* 모든 작업을 보거나 지우려면 Claude에 직접 요청하세요: "show me all tasks" 또는 "clear all tasks"

394* 작업은 컨텍스트 압축 전체에서 지속되어 Claude가 더 큰 프로젝트에서 조직화된 상태를 유지하도록 도와줍니다394* 작업은 컨텍스트 압축 전체에서 지속되어 Claude가 더 큰 프로젝트에서 조직화된 상태를 유지하도록 도와줍니다

395* 세션 간에 작업 목록을 공유하려면 `CLAUDE_CODE_TASK_LIST_ID`를 `~/.claude/tasks/`의 명명된 디렉토리로 사용하도록 설정하세요: `CLAUDE_CODE_TASK_LIST_ID=my-project claude`395* 세션 간에 작업 목록을 공유하려면 `CLAUDE_CODE_TASK_LIST_ID`를 `~/.claude/tasks/`의 명명된 디렉토리로 사용하도록 설정하세요: `CLAUDE_CODE_TASK_LIST_ID=my-project claude`

86`Global` 컨텍스트에서 사용 가능한 작업:86`Global` 컨텍스트에서 사용 가능한 작업:

87 87 

88| 작업 | 기본값 | 설명 |88| 작업 | 기본값 | 설명 |

89| :--------------------- | :-------- | :------------- |89| :--------------------- | :-------- | :------------------------------------------------------------------------- |

90| `app:interrupt` | Ctrl+C | 현재 작업 취소 |90| `app:interrupt` | Ctrl+C | 현재 작업 취소 |

91| `app:exit` | Ctrl+D | Claude Code 종료 |91| `app:exit` | Ctrl+D | Claude Code 종료 |

92| `app:redraw` | (바인딩 해제됨) | 터미널 다시 그리기 강제 |92| `app:redraw` | (바인딩 해제됨) | 터미널 다시 그리기 강제 |

93| `app:toggleTodos` | Ctrl+T | 작업 목록 표시 여부 전환 |93| `app:toggleTodos` | Ctrl+T | Claude의 할 일 체크리스트 표시 여부 전환. 이것은 [`/tasks`](/ko/commands) 백그라운드 작업 보기가 아닙니다 |

94| `app:toggleTranscript` | Ctrl+O | 상세 트랜스크립트 전환 |94| `app:toggleTranscript` | Ctrl+O | 상세 트랜스크립트 전환 |

95 95 

96<h3 id="history-actions">96<h3 id="history-actions">

236 조직 모델 제한236 조직 모델 제한

237</h3>237</h3>

238 238 

239조직 관리자는 Claude 콘솔에서 개별 모델을 비활성화하여 구성원이 실행할 수 있는 모델을 제한합니다. 구성원이 Anthropic API를 통해 인증하고 설정 파일을 배포하지 않고 조직 전체 스위치를 원할 때 `availableModels` 대신 이 콘솔 토글을 사용합니다. 이 제한은 Claude Code가 인증할 때 계정의 자격과 함께 전달되며, 설정의 `availableModels` 목록과 별개이며, 서버는 세션이 생성될 때 동일한 제한을 독립적으로 적용합니다. Claude Code v2.1.187 이상이 필요합니다.239Claude Enterprise 플랜의 조직 관리자는 claude.ai 관리 콘솔에서 개별 모델을 비활성화하여 구성원이 실행할 수 있는 모델을 제한합니다. 이 제한은 Claude Code가 인증할 때 계정의 자격과 함께 전달되며, 설정의 `availableModels` 목록과 별개이며, 서버는 세션이 생성될 때 동일한 제한을 독립적으로 적용합니다. Claude Code v2.1.187 이상이 필요합니다.

240 

241제한은 구성원이 로그인하거나 자신의 API 키를 사용할 때 적용됩니다. 조직 서비스 키와 같은 조직 범위 자격증명은 사용자에게 연결되지 않으므로 제한이 이에 적용되지 않습니다.

242 

243Claude Console에는 모델 제한 제어가 없습니다. Claude Enterprise 플랜이 없는 조직(Anthropic API를 통해 인증하는 구성원을 포함)은 대신 [관리 설정](/ko/settings#settings-files)에서 [`availableModels`](#restrict-model-selection)을 사용하여 모델을 제한하고, Default 옵션을 다루기 위해 [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model)을 추가합니다. 이러한 설정은 서버가 아닌 Claude Code 자체에 의해 적용됩니다.

240 244 

241제한된 모델은 `/model` 선택기에서 숨겨집니다. `--model`, `ANTHROPIC_MODEL` 환경 변수 또는 `model` 설정으로 이름으로 선택하면 `Model "<name>" is restricted by your organization's settings. Using <model> instead.` 알림이 표시되고 세션은 허용된 모델에서 시작됩니다. 제한된 모델에 대해 `/model <name>`을 입력하면 `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.`로 거부되고 세션은 현재 모델을 유지합니다.245제한된 모델은 `/model` 선택기에서 숨겨집니다. `--model`, `ANTHROPIC_MODEL` 환경 변수 또는 `model` 설정으로 이름으로 선택하면 `Model "<name>" is restricted by your organization's settings. Using <model> instead.` 알림이 표시되고 세션은 허용된 모델에서 시작됩니다. 제한된 모델에 대해 `/model <name>`을 입력하면 `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.`로 거부되고 세션은 현재 모델을 유지합니다.

242 246 

62 62 

63<Steps>63<Steps>

64 <Step title="플러그인 디렉토리 만들기">64 <Step title="플러그인 디렉토리 만들기">

65 모든 플러그인은 skills, agents 또는 hooks를 포함하는 자체 디렉토리에 있으며, 선택적으로 `.claude-plugin/plugin.json` 매니페스트와 함께 있습니다. 지금 만들어보세요:65 모든 플러그인은 skills, agents 또는 hooks를 포함하는 자체 디렉토리에 있으며, 선택적으로 `.claude-plugin/plugin.json` 매니페스트와 함께 있습니다. 이 빠른 시작에서는 `--plugin-dir`을 사용하여 테스트 단계에서 Claude Code가 디렉토리를 가리키기 때문에 위치는 중요하지 않습니다. 스크래치 폴더나 프로젝트 디렉토리와 같이 편리한 곳 어디든 만들 수 있습니다:

66 66 

67 ```bash theme={null}67 ```bash theme={null}

68 mkdir my-first-plugin68 mkdir my-first-plugin

69 ```69 ```

70 

71 나머지 단계는 상위 디렉토리에서 실행되며 `my-first-plugin/...`과 같은 경로를 상대 경로로 참조합니다.

70 </Step>72 </Step>

71 73 

72 <Step title="플러그인 매니페스트 만들기">74 <Step title="플러그인 매니페스트 만들기">

438 440 

439<Steps>441<Steps>

440 <Step title="플러그인 구조 만들기">442 <Step title="플러그인 구조 만들기">

441 새 플러그인 디렉토리를 만듭니다:443 프로젝트 루트에 새 플러그인 디렉토리를 만듭니다. 기존 `.claude/` 폴더와 함께 배치하여 다음 단계의 상대 `cp` 경로가 올바르게 해석되도록 합니다:

442 444 

443 ```bash theme={null}445 ```bash theme={null}

444 mkdir -p my-plugin/.claude-plugin446 mkdir -p my-plugin/.claude-plugin

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

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

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

16| `Artifact` | HTML 또는 Markdown 파일을 [artifact](/ko/artifacts)로 게시합니다: 조직 내에서 공유할 수 있는 claude.ai의 비공개 대화형 페이지입니다. {/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}Team 또는 Enterprise 플랜이 필요하며 `/login` 인증이 필요합니다. [가용성](/ko/artifacts#availability) 참조 | 예 |16| `Artifact` | HTML 또는 Markdown 파일을 [artifact](/ko/artifacts)로 게시합니다: claude.ai의 비공개 대화형 페이지입니다. Team 및 Enterprise 플랜에서는 조직 내에서 공유할 수 있습니다. {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Pro, Max, Team 또는 Enterprise 플랜이 필요하며 `/login` 인증이 필요합니다. [가용성](/ko/artifacts#availability) 참조 | 예 |

17| `AskUserQuestion` | 요구사항을 수집하거나 모호함을 명확히 하기 위해 객관식 질문을 합니다 | 아니오 |17| `AskUserQuestion` | 요구사항을 수집하거나 모호함을 명확히 하기 위해 객관식 질문을 합니다 | 아니오 |

18| `Bash` | 환경에서 shell 명령을 실행합니다. [Bash 도구 동작](#bash-tool-behavior) 참조 | 예 |18| `Bash` | 환경에서 shell 명령을 실행합니다. [Bash 도구 동작](#bash-tool-behavior) 참조 | 예 |

19| `CronCreate` | 현재 세션 내에서 반복 또는 일회성 프롬프트를 예약합니다. 작업은 세션 범위이며 `--resume` 또는 `--continue`에서 만료되지 않으면 복원됩니다. [예약된 작업](/ko/scheduled-tasks) 참조 | 아니오 |19| `CronCreate` | 현재 세션 내에서 반복 또는 일회성 프롬프트를 예약합니다. 작업은 세션 범위이며 `--resume` 또는 `--continue`에서 만료되지 않으면 복원됩니다. [예약된 작업](/ko/scheduled-tasks) 참조 | 아니오 |

212 212 

213Claude는 목록을 구조화된 데이터로 전달하므로 스크립트는 먼저 구문 분석하지 않고도 `args`에서 배열 및 객체 메서드를 직접 호출할 수 있습니다. `args`가 생략되면 스크립트 내부의 전역 변수는 `undefined`입니다.213Claude는 목록을 구조화된 데이터로 전달하므로 스크립트는 먼저 구문 분석하지 않고도 `args`에서 배열 및 객체 메서드를 직접 호출할 수 있습니다. `args`가 생략되면 스크립트 내부의 전역 변수는 `undefined`입니다.

214 214 

215<h2 id="example-workflow-prompts">

216 예제 워크플로우 프롬프트

217</h2>

218 

219워크플로우는 작업이 한 에이전트가 컨텍스트에 보유할 수 있는 것보다 크거나, 같은 단계를 많은 항목에 걸쳐 실행해야 할 때 가장 적합합니다. 아래 프롬프트는 일반적인 형태를 보여줍니다. 각각은 Claude에게 해당 작업을 위한 워크플로우를 작성하고 실행하도록 요청합니다; 스크립트를 직접 작성하지 않습니다.

220 

221<h3 id="audit-many-files-for-the-same-issue">

222 많은 파일을 같은 문제에 대해 감사하기

223</h3>

224 

225파일당 하나의 에이전트를 확산시킨 후 발견 사항을 수집하고 검증합니다.

226 

227```text theme={null}

228> use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it

229```

230 

231<h3 id="keep-fixing-until-a-check-passes">

232 검사가 통과할 때까지 계속 수정하기

233</h3>

234 

235검사기를 실행하고, 실패한 것을 수정하며, 통과하거나 진행이 멈출 때까지 반복합니다.

236 

237```text theme={null}

238> use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress

239```

240 

241<h3 id="migrate-many-files-in-parallel">

242 많은 파일을 병렬로 마이그레이션하기

243</h3>

244 

245마이그레이션할 파일을 발견하고, 편집이 충돌하지 않도록 각각을 격리된 복사본에서 변환하며, 각 결과를 검증합니다.

246 

247```text theme={null}

248> use a workflow to migrate every component under src/components/ from styled-components to Tailwind, working on each file in its own isolated copy

249```

250 

251<h3 id="review-every-changed-file-and-write-one-summary">

252 모든 변경된 파일을 검토하고 하나의 요약 작성하기

253</h3>

254 

255파일당 하나의 검토자를 실행한 후 모든 발견 사항을 하나의 에이전트에 전달하여 순위를 매기고 중복을 제거합니다.

256 

257```text theme={null}

258> use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary

259```

260 

261<h3 id="research-a-topic-across-many-sources">

262 많은 소스에서 주제 연구하기

263</h3>

264 

265변경 로그, 문제, 문서에 걸쳐 읽기를 확산시킨 후 종합합니다. 번들된 `/deep-research` 워크플로우가 이를 수행합니다; 더 좁은 버전을 설명할 수도 있습니다.

266 

267```text theme={null}

268> use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches

269```

270 

271<h3 id="find-issues-until-the-list-stops-growing">

272 목록이 더 이상 증가할 때까지 문제 찾기

273</h3>

274 

275라운드에서 계속 검색하고 새 라운드가 새로운 것을 찾지 못하면 중지합니다.

276 

277```text theme={null}

278> use a workflow to find flaky tests in this repo: run the suite repeatedly, record which tests fail intermittently, and stop once two rounds in a row find nothing new

279```

280 

281<h3 id="what-the-saved-script-looks-like">

282 저장된 스크립트가 어떻게 보이는지

283</h3>

284 

285[워크플로우를 저장](#save-the-workflow-for-reuse)하면 `.claude/workflows/`의 파일은 `meta` 블록 다음에 서브에이전트를 조율하는 스크립트 본문을 보유합니다. 일반적으로 편집할 필요가 없지만, 여기는 Claude가 생성한 것을 인식할 수 있도록 작은 것의 형태입니다:

286 

287```javascript theme={null}

288export const meta = {

289 name: 'audit-routes',

290 description: 'Audit every route handler for missing auth checks',

291}

292 

293const found = await agent('List every .ts file under src/routes/.', {

294 schema: { type: 'object', required: ['files'], properties: { files: { type: 'array', items: { type: 'string' } } } },

295})

296 

297const audits = await pipeline(found.files, file =>

298 agent(`Audit ${file} for missing authentication checks.`, { label: file }),

299)

300 

301return audits.filter(Boolean)

302```

303 

304본문은 최상위 `await`를 포함한 순수 JavaScript입니다. `agent()`는 하나의 서브에이전트를 생성하고 `pipeline()`은 목록의 각 항목당 하나를 실행합니다. 스크립트를 직접 편집하려면 Claude에게 변경 사항을 안내해 달라고 요청하거나, [Agent SDK 참조](/ko/agent-sdk/typescript)의 Workflow 도구 항목에서 전체 옵션 집합을 참조하십시오.

305 

215<h2 id="how-a-workflow-runs">306<h2 id="how-a-workflow-runs">

216 워크플로우가 어떻게 실행되는지307 워크플로우가 어떻게 실행되는지

217</h2>308</h2>