cc-viewer 1.7.21 → 1.7.23

package/concepts/ja/Tool-ToolSearch.md

@@ -10,6 +10,11 @@
 
 ツールのスキーマがすでにコンテキストにある場合は、再度検索しないでください — そのまま呼び出してください。
 
+## 有効化
+
+- デフォルトでオンです。
+- `ANTHROPIC_BASE_URL` が非 Anthropic エンドポイントを指している場合 (`ENABLE_TOOL_SEARCH` が設定されていない限り)、`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` が設定されている場合、モデルがツール参照をサポートしていない場合 (Claude 4.5 より前の Vertex AI モデル)、または `"deny": ["ToolSearch"]` で拒否されている場合はオフになります。
+
 ## パラメータ
 
 - `query` (string, required): 遅延ツールを特定するために使用するクエリ。3 つの形式がサポートされています:

package/concepts/ja/Tool-WebSearch.md

@@ -10,6 +10,12 @@
 - モデルがトレーニングされて以降に変わった可能性のある事実を検証する。
 - `WebFetch` で特定のページを取得する前に、トピックに関する複数の視点を発見する。
 
+## 有効化
+
+- 可用性はプロバイダーとモデルに依存します: Anthropic API と Claude Platform on AWS で利用可能。Microsoft Foundry では Anthropic ホストのデプロイメントが必要です。Google Cloud では Claude 4+ モデルで動作します。
+- Amazon Bedrock では利用できません。
+- `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` でセッションあたりの呼び出しを 200 回に制限できます。
+
 ## パラメータ
 
 - `query` (string, required): 検索クエリ。最小 2 文字。「最新」または「最近」の情報について尋ねるときは、結果が新鮮になるよう現在の年を含めてください。

package/concepts/ja/Tools.md

@@ -15,6 +15,7 @@ Claude Code は Anthropic API の tool_use メカニズムを通じてモデル
 | [TaskGet](Tool-TaskGet.md) | タスクの詳細を取得 |
 | [TaskUpdate](Tool-TaskUpdate.md) | タスクのステータス、依存関係などを更新 |
 | [TaskList](Tool-TaskList.md) | すべてのタスクを一覧表示 |
+| [ListAgents](Tool-ListAgents.md) | セッションで利用可能な agent を一覧表示 |
 
 ## ファイル操作
 
@@ -29,11 +30,13 @@ Claude Code は Anthropic API の tool_use メカニズムを通じてモデル
 
 | ツール | 用途 |
 |--------|------|
-| [TeamCreate](Tool-TeamCreate.md) | 協調作業用の agent チームを作成 |
-| [TeamDelete](Tool-TeamDelete.md) | agent チームを解散 |
 | [SendMessage](Tool-SendMessage.md) | 別の agent にメッセージを送信 |
 | [Workflow](Tool-Workflow.md) | 決定論的なマルチエージェントオーケストレーションスクリプトを実行 |
 | [Monitor](Tool-Monitor.md) | 長時間実行スクリプトのイベントを通知としてストリーミング |
+| [SendFile](Tool-SendFile.md) | 別の Claude Code セッションにファイルを送信 |
+| [SendUserFile](Tool-SendUserFile.md) | ユーザーにファイルを送信 |
+| [SendUserMessage](Tool-SendUserMessage.md) | ユーザーにメッセージを送信（旧 Brief ツール） |
+| [EndConversation](Tool-EndConversation.md) | 現在の会話を終了 |
 
 ## 検索
 
@@ -48,6 +51,7 @@ Claude Code は Anthropic API の tool_use メカニズムを通じてモデル
 | ツール | 用途 |
 |--------|------|
 | [Bash](Tool-Bash.md) | シェルコマンドの実行 |
+| [REPL](Tool-REPL.md) | 永続的な Node.js REPL で JavaScript を実行 |
 
 ## Web
 
@@ -66,6 +70,10 @@ Claude Code は Anthropic API の tool_use メカニズムを通じてモデル
 | [ExitPlanMode](Tool-ExitPlanMode.md) | 計画モードを終了し、方針をユーザー承認に提出 |
 | [AskUserQuestion](Tool-AskUserQuestion.md) | ユーザーに質問して確認や判断を取得 |
 | [ReportFindings](Tool-ReportFindings.md) | コードレビューの発見をホスト UI の型指定リストとして報告 |
+| [TodoWrite](Tool-TodoWrite.md) | セッション用の構造化 todo リストを作成 |
+| [SendFeedback](Tool-SendFeedback.md) | Claude Code に関する構造化フィードバックを Anthropic に送信 |
+| [Projects](Tool-Projects.md) | プロジェクトのナレッジベースドキュメントを管理 |
+| [ProposeGoal](Tool-ProposeGoal.md) | セッションの検証可能な完了ゴールを提案 |
 
 ## Worktrees
 
@@ -84,6 +92,7 @@ Claude Code は Anthropic API の tool_use メカニズムを通じてモデル
 | [ScheduleWakeup](Tool-ScheduleWakeup.md) | 次のウェイクアップをスケジュールして /loop イテレーションを自動調整 |
 | [PushNotification](Tool-PushNotification.md) | ユーザーにデスクトップ/モバイル通知を送信 |
 | [RemoteTrigger](Tool-RemoteTrigger.md) | claude.ai リモートトリガールーチンを管理 |
+| [ReadNotifications](Tool-ReadNotifications.md) | 保留中のセッション通知を読み取り |
 
 ## 拡張
 
@@ -91,10 +100,23 @@ Claude Code は Anthropic API の tool_use メカニズムを通じてモデル
 |--------|------|
 | [Skill](Tool-Skill.md) | スキル（slash command）の実行 |
 
+## MCP と拡張機能
+
+| ツール | 用途 |
+|--------|------|
+| [ListMcpResources](Tool-ListMcpResources.md) | 接続中の MCP サーバーが公開するリソースを一覧表示 |
+| [ReadMcpResource](Tool-ReadMcpResource.md) | URI で単一の MCP サーバーリソースを読み取り |
+| [ReadMcpResourceDir](Tool-ReadMcpResourceDir.md) | URI でディレクトリ型 MCP リソースを一覧表示 |
+| [SearchMcpRegistry](Tool-SearchMcpRegistry.md) | MCP コネクタレジストリをキーワードで検索 |
+| [SuggestConnectors](Tool-SuggestConnectors.md) | レジストリ検索結果からコネクタの詳細を解決 |
+| [ListConnectors](Tool-ListConnectors.md) | インストール済み MCP コネクタを一覧表示 |
+| [SuggestPluginInstall](Tool-SuggestPluginInstall.md) | インラインプラグインインストールカードを表示 |
+| [SuggestSkills](Tool-SuggestSkills.md) | 追加可能なスキルのカードを表示 |
+| [ListPlugins](Tool-ListPlugins.md) | 有効な claude.ai プラグインを一覧表示 |
+| [ListSkills](Tool-ListSkills.md) | 有効な claude.ai スキルを一覧表示 |
+
 ## IDE 統合
 
 | ツール | 用途 |
 |--------|------|
-| [getDiagnostics](Tool-getDiagnostics.md) | VS Code 言語診断情報の取得 |
-| [executeCode](Tool-executeCode.md) | Jupyter kernel でコードを実行 |
 | [LSP](Tool-LSP.md) | 言語サーバークエリ (定義、参照、シンボル) |

package/concepts/ko/Tool-Artifact.md

@@ -9,6 +9,13 @@ HTML 또는 Markdown 파일을 Artifact로 렌더링합니다 — claude.ai에
 - 사용자의 기존 artifacts를 나열하여 이전 세션에서의 파일 찾기 (`action: "list"`)
 - **하지 않을 때**: 로컬에 남겨둬야 할 콘텐츠, 일반 텍스트 답변, 보기 시 외부 네트워크 리소스가 필요한 모든 것——엄격한 CSP가 모든 외부 호스트를 차단합니다
 
+## 활성화
+
+- claude.ai 로그인(`/login`)이 있는 Pro, Max, Team, 또는 Enterprise 플랜이 필요합니다.
+- Anthropic API 전용입니다 — Amazon Bedrock, Google Cloud, Microsoft Foundry에서는 사용할 수 없습니다.
+- Claude Code ≥ 2.1.183 또는 Desktop 앱 ≥ 1.13576.0이 필요합니다.
+- `disableArtifact` 설정 또는 `CLAUDE_CODE_DISABLE_ARTIFACT=1`로 비활성화할 수 있습니다.
+
 ## 매개변수
 
 - `file_path` (문자열): 렌더링할 `.html` 또는 `.md` 파일의 경로. 파일은 발행 시 문서 틀로 래핑되므로 페이지 콘텐츠를 직접 작성합니다 — `<!DOCTYPE>`, `<html>`, `<head>` 또는 `<body>` 태그는 포함하지 않습니다. 동일 경로 → 재배포 시 동일 URL; 다른 경로는 새로운 URL을 청구합니다.

package/concepts/ko/Tool-EndConversation.md

@@ -0,0 +1,35 @@
+# EndConversation
+
+현재 대화를 종료하고 이후 어떤 메시지도 전송되지 않도록 합니다.
+
+## 사용 시점
+
+- 지속적인 사용자 학대, 또는 사용자가 이 도구의 시연을 명시적으로 요청하는 경우에만.
+
+이것은 최후의 수단입니다: 도구 자체의 규칙이 사용 전에 먼저 경고하고 확인할 것을 요구하며, 자해 또는 위해 관련 상황에서는 절대 사용해서는 안 됩니다.
+
+## 활성화
+
+- Claude Code 2.1.213+ 및 Opus 4.8 / Sonnet 5 / Fable 5 이상 제품군의 모델이 필요합니다.
+- 대화형 터미널 세션 전용입니다 — `--bare` 모드에서는 절대 제공되지 않으며, 서브에이전트에게는 제공되지 않습니다.
+- Amazon Bedrock, AWS의 Claude Platform, Vertex AI, Microsoft Foundry, 또는 클라우드 게이트웨이에서는 사용할 수 없습니다.
+- 서버 측 기능 플래그가 필요합니다 — 대부분의 세션은 이 도구를 제공하지 않습니다.
+
+## 매개변수
+
+이 도구는 매개변수를 받지 않습니다.
+
+## 예시
+
+### 예시 1: 대화 종료
+
+```
+EndConversation()
+```
+
+흐름은 2단계입니다: 첫 호출은 반영 메시지를 반환하고, 곧바로 이어지는 두 번째 호출이 실제로 대화를 종료합니다(`ended: true`).
+
+## 참고사항
+
+- 강하게 게이트되어 있습니다: 지원되는 모델, CLI 진입점, 서버 측 기능 플래그가 필요합니다 — 대부분의 세션은 이 도구를 제공하지 않습니다.
+- 일단 종료되면 대화에서 더 이상 메시지를 보낼 수 없습니다.

package/concepts/ko/Tool-LSP.md

@@ -10,6 +10,11 @@ Language Server Protocol (LSP) 서버에 질의하여 코드 인텔리전스 —
 - 인터페이스나 추상 메서드의 구현 찾기 (`goToImplementation`)
 - 함수의 호출 계층 따라가기 (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
 
+## 활성화
+
+- 해당 언어의 코드 인텔리전스 플러그인이 설치되기 전까지는 비활성 상태입니다(서버 바이너리는 별도로 설치됩니다).
+- 이 도구는 LSP 클라이언트가 연결된 경우에만 나타납니다.
+
 ## 매개변수
 
 - `operation` (string, 필수): 위에 나열된 작업 중 하나.

package/concepts/ko/Tool-ListAgents.md

@@ -0,0 +1,35 @@
+# ListAgents
+
+`SendMessage`를 보낼 수 있는 agent를 나열합니다: 여러분이 생성한 프로세스 내 서브에이전트, 이 머신의 다른 로컬 Claude 세션, 클라우드 세션(이 세션에 클라우드 액세스가 있을 때), 그리고 — 원격 제어가 연결된 경우 — 여러분 계정의 다른 세션. 각 행은 종류별로 라벨이 붙습니다.
+
+## 사용 시점
+
+- 메시지를 보내기 전에 피어 세션이나 서브에이전트의 정확한 이름이 필요합니다.
+- 이 세션에서 현재 도달 가능한 세션을 확인하고 싶습니다.
+
+## 활성화
+
+- Claude Code 2.1.224+ 및 세션 간 메시징(서버 측 기능 플래그, 기본적으로 꺼짐)이 필요합니다.
+- 세션 간 메시징은 Amazon Bedrock, AWS의 Claude Platform, Google Cloud Agent Platform, Microsoft Foundry에서 사용할 수 없습니다.
+- `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, 또는 `DISABLE_GROWTHBOOK`이 설정되면 꺼집니다.
+- `CLAUDE_CODE_HARBOR_KITE=1`로 강제 활성화할 수 있습니다.
+
+## 매개변수
+
+- `channel` (string, 선택): 이 빌드에서는 사용할 수 없습니다. 설정하지 않은 채로 두십시오.
+- `q` (string, 선택): 이 빌드에서는 사용할 수 없습니다. 설정하지 않은 채로 두십시오.
+
+## 예시
+
+### 예시 1: 도달 가능한 agent 나열
+
+```
+ListAgents()
+```
+
+각 행은 이름을 출력합니다 — 그 이름이 주소입니다. `SendMessage({to: "<name>", message: "..."})`로 보내되, 이름을 출력된 그대로 정확히 복사하십시오. 행의 ` [ref]`는 베어 이름이 모호할 때만(두 행이 공유하거나 오류가 명확화를 요구할 때) 덧붙이십시오.
+
+## 참고사항
+
+- 읽기 전용이며 동시성에 안전합니다.
+- 클라우드 세션은 메시지를 받을 수는 있지만 아직 답장할 수 없습니다 — 해당 세션의 트랜스크립트에서 답을 읽으십시오.

package/concepts/ko/Tool-ListConnectors.md

@@ -0,0 +1,34 @@
+# ListConnectors
+
+사용자의 claude.ai 조직에 설치된 MCP 커넥터를 나열하며, 선택적으로 키워드로 필터링합니다.
+
+## 사용 시점
+
+- 새 커넥터를 제안하기 전에 이미 설치된 커넥터를 알아야 합니다.
+- 사용자가 자신의 조직에 어떤 통합이 있는지 묻습니다.
+
+## 활성화
+
+- 퍼스트파티 API의 원격(claude.ai) 세션에서만 사용할 수 있습니다.
+
+## 매개변수
+
+- `keywords` (array of strings, 선택): 목록 필터 — 최대 8개 항목, 각각 1-64자. 생략하면 전체를 나열합니다.
+
+## 예시
+
+### 예시 1: 설치된 모든 커넥터 나열
+
+```
+ListConnectors()
+```
+
+### 예시 2: 키워드로 필터링
+
+```
+ListConnectors(keywords=["github"])
+```
+
+## 참고사항
+
+- 전체 찾기-및-활성화 흐름을 위해 `SearchMcpRegistry`(발견)와 `SuggestConnectors`(상세 정보)를 함께 사용하십시오.

package/concepts/ko/Tool-ListMcpResources.md

@@ -0,0 +1,35 @@
+# ListMcpResources
+
+연결된 MCP 서버가 노출하는 리소스를 나열하며, 선택적으로 한 서버로 필터링합니다.
+
+## 사용 시점
+
+- 읽기 전에 MCP 서버가 제공하는 리소스(파일, 레코드, 문서)를 발견해야 합니다.
+- 연결된 모든 서버의 전체 리소스 개요를 원합니다.
+
+## 활성화
+
+- 항상 활성화되어 있지만 모델의 도구 목록에는 노출되지 않습니다 — 씬 클라이언트/사이드카 사용을 위한 것입니다.
+
+## 매개변수
+
+- `server` (string, 선택): 리소스를 필터링할 서버 이름. 생략하면 연결된 모든 서버의 리소스를 나열합니다.
+
+## 예시
+
+### 예시 1: 전체 나열
+
+```
+ListMcpResources()
+```
+
+### 예시 2: 한 서버의 리소스 나열
+
+```
+ListMcpResources(server="github")
+```
+
+## 참고사항
+
+- 이것은 발견 단계입니다: 흥미로운 URI를 `ReadMcpResource`(단일 리소스) 또는 `ReadMcpResourceDir`(디렉터리 목록)로 넣으십시오.
+- 서버는 세션 수명 동안 연결되고 해제됩니다. 서버가 방금 추가되었다면 다시 나열하십시오.

package/concepts/ko/Tool-ListPlugins.md

@@ -0,0 +1,35 @@
+# ListPlugins
+
+사용자의 활성화된 claude.ai 플러그인을 나열하며, 선택적으로 키워드로 필터링합니다.
+
+## 사용 시점
+
+- 이미 활성화된 플러그인을 알아야 합니다 — 예를 들어 `SuggestPluginInstall` 카드 후에 설치된 것을 확인하기 위해.
+- 사용자가 어떤 플러그인을 갖고 있는지 묻습니다.
+
+## 활성화
+
+- 플러그인 레지스트리 접근 권한이 필요합니다.
+- 사용 가능 여부는 세션 유형과 기능 롤아웃에 따라 다릅니다 — HIPAA 환경에서는 비활성화되고, 원격 세션에서는 항상 사용할 수 있습니다.
+
+## 매개변수
+
+- `keywords` (array of strings, 선택): 목록 필터 — 최대 8개 항목, 각각 1-64자. 생략하면 전체를 나열합니다.
+
+## 예시
+
+### 예시 1: 활성화된 플러그인 나열
+
+```
+ListPlugins()
+```
+
+### 예시 2: 키워드로 필터링
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## 참고사항
+
+- 플러그인 카탈로그에 도달할 수 없는 경우(forbidden), 도구는 실패하는 대신 경고와 함께 빈 목록으로 저하됩니다.

package/concepts/ko/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+사용자의 활성화된 claude.ai 스킬을 나열하며, 선택적으로 키워드로 필터링합니다.
+
+## 사용 시점
+
+- 현재 활성화된 스킬의 권위 있는 목록이 필요합니다 — 스킬을 호출하기 전에, 또는 `SuggestSkills` 카드가 추가한 것을 확인하기 위해.
+- 사용자가 어떤 스킬을 갖고 있는지 묻습니다.
+
+## 활성화
+
+- 플러그인 레지스트리 접근 권한이 필요합니다.
+- HIPAA 환경에서는 비활성화됩니다.
+- 원격 세션에서는 항상 사용할 수 있습니다.
+
+## 매개변수
+
+- `keywords` (array of strings, 선택): 목록 필터 — 최대 8개 항목, 각각 1-64자. 생략하면 전체를 나열합니다.
+
+## 예시
+
+### 예시 1: 활성화된 스킬 나열
+
+```
+ListSkills()
+```
+
+### 예시 2: 키워드로 필터링
+
+```
+ListSkills(keywords=["review"])
+```
+
+## 참고사항
+
+- 카탈로그에 도달할 수 없는 경우(forbidden), 도구는 실패하는 대신 경고와 함께 빈 목록으로 저하됩니다.
+- 이것은 *활성화된* 스킬을 나열합니다. 사용자가 추가할 수 있는 스킬을 표시하려면 `SuggestSkills`를 사용하십시오.

package/concepts/ko/Tool-Monitor.md

@@ -10,6 +10,13 @@
 - 많은 반복에 걸쳐 특정 조건을 기다릴 때 (예: 학습 단계 마일스톤 또는 큐 소진)
 - 단순한 "완료까지 대기"에는 **사용하지 않는다** — 그 경우 `run_in_background`가 있는 `Bash`를 사용하면 프로세스 종료 시 완료 알림이 한 번 전송된다
 
+## 활성화
+
+- 기본적으로 꺼져 있습니다(서버 측 기능 플래그).
+- Amazon Bedrock, Google Cloud, Microsoft Foundry에서는 사용할 수 없습니다.
+- `DISABLE_TELEMETRY` 또는 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`이 설정되면 꺼집니다.
+- WebSocket 소스에는 Claude Code 2.1.195+가 필요합니다.
+
 ## 매개변수
 
 - `command` (문자열, 필수): 실행할 셸 명령 또는 스크립트. 표준 출력에 쓰인 각 줄이 독립적인 알림 이벤트가 된다. 프로세스가 종료되면 모니터가 끝난다.

package/concepts/ko/Tool-Projects.md

@@ -0,0 +1,46 @@
+# Projects
+
+사용자의 Claude 프로젝트 지식 베이스에 있는 프로젝트 문서를 관리합니다: 문서 읽기, 검색, 쓰기, 삭제, 또는 프로젝트 정보 가져오기.
+
+## 사용 시점
+
+- 문서(산출물, 노트, 참고 자료)를 사용자의 프로젝트에 영속화하여 세션이 끝나도 남도록 합니다.
+- 기존 프로젝트 문서를 읽거나 검색하여 현재 태스크를 이전 컨텍스트에 근거시키려고 합니다.
+- 로컬 파일을 그 내용을 컨텍스트에 로드하지 않고 프로젝트에 업로드합니다.
+- 오래된 프로젝트 문서를 제거합니다.
+
+## 매개변수
+
+- `method` (string, 필수): `project_info`, `project_read`, `project_search`, `project_write`, `project_delete` 중 하나.
+- `path` (string, 선택): `project_read`/`project_write`/`project_delete`의 경우: 문서 경로. `project_write`의 경우: 기존 경로는 그 자리에서 대체되고, 새 단순 파일명("/" 없음)은 `claude/<name>`으로 네임스페이스됩니다.
+- `content` (string, 선택): `project_write`의 경우: 인라인 문서 텍스트. `local_path`와 상호 배타적입니다.
+- `local_path` (string, 선택): `project_write`의 경우: 작업 디렉터리 안의 파일을 업로드 — 내용은 컨텍스트에 절대 들어오지 않습니다. `content`와 상호 배타적입니다.
+- `present_to_user` (boolean, 선택): `project_write`의 경우: 이 문서를 사용자가 봐야 하는 산출물로 표시합니다. 기본값 false. 일상적인 저장과 일괄 쓰기에는 설정하지 않은 채로 두십시오.
+- `query` (string, 선택): `project_search`의 경우: 지식 베이스 쿼리.
+- `n` (number, 선택): `project_search`의 경우: 히트 수 (기본값 5).
+
+## 예시
+
+### 예시 1: 산출물을 프로젝트에 쓰기
+
+```
+Projects(
+  method="project_write",
+  path="claude/migration-plan.md",
+  local_path="./migration-plan.md",
+  present_to_user=true
+)
+```
+
+로컬 파일의 내용을 컨텍스트로 끌어오지 않고 업로드하며, 사용자의 산출물로 표시합니다.
+
+### 예시 2: 지식 베이스 검색
+
+```
+Projects(method="project_search", query="authentication refresh tokens", n=5)
+```
+
+## 참고사항
+
+- `content`는 인라인으로 작성하는 텍스트용이고 `local_path`는 이미 디스크에 있는 모든 것용입니다 — 둘을 섞지 마십시오.
+- `present_to_user=true`는 아껴서 사용하십시오: 사용자가 요청했거나 반드시 조치해야 하는 문서 하나에만 사용하십시오.

package/concepts/ko/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+세션의 검증 가능한 완료 목표를 제안합니다. 목표는 (기본적으로) 승인 대화상자로 사용자에게 표시되며, 일단 설정되면 나머지 대화를 확인 가능한 결과로 이끕니다.
+
+## 사용 시점
+
+- 세션에 평가자가 대화에서 확인할 수 있는 구체적인 종료 상태가 있습니다 (예: "all tests in test/auth pass").
+- 상당한 작업을 하기 전에 "완료"가 무엇을 의미하는지 사용자의 명시적인 동의를 얻고 싶습니다.
+- 사용자 자신의 말로 결과가 이미 명시되어 있고 이를 세션 목표로 기록하고 싶습니다.
+
+## 활성화
+
+- 기본적으로 꺼져 있습니다(서버 측 기능 플래그).
+- 대화형 및 백그라운드 세션에서 제외됩니다.
+- `modelProposedGoals: "disabled"` 설정 키로 꺼집니다.
+
+## 매개변수
+
+- `condition` (string, 필수): 별도의 평가자가 대화에서 확인할 수 있도록 작성된 완료 조건 (예: "all tests in test/auth pass (bun test exits 0)"). 최대 500자 — 승인 대화상자에서 사용자가 전체 조건을 읽을 수 있어야 합니다.
+- `ask_user` (boolean, 선택): 목표가 설정되기 전에 사용자에게 승인을 요청할지 여부. 기본값 true (승인 대화상자가 표시됨). 이 대화에서 사용자 자신의 말로 이 결과를 원한다고 명시한 경우에만 false로 설정하십시오. 목표는 가시적인 안내와 함께 직접 설정되고, 사용자는 `/goal clear`로 지울 수 있습니다.
+
+## 예시
+
+### 예시 1: 테스트로 뒷받침되는 목표 제안
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+사용자는 승인 대화상자에서 조건을 보고 수락, 편집, 또는 거부할 수 있습니다.
+
+### 예시 2: 사용자가 명시한 결과 직접 채택
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+사용자가 대화에서 앞서 그 결과를 명시적으로 말했기 때문에 유효합니다.
+
+## 참고사항
+
+- `condition`을 짧고 객관적으로 확인 가능하게 유지하십시오 — 모호한 목표("더 좋게 만들기")는 목적을 무색하게 만듭니다.
+- `ask_user=false`는 사용자가 스스로 명시한 결과에만 엄격히 제한됩니다. 그 외의 모든 것은 승인 대화상자를 거쳐야 합니다.

package/concepts/ko/Tool-PushNotification.md

@@ -14,6 +14,12 @@
 
 작업 중 일상적인 진행 상황 업데이트에는 알림을 보내지 마십시오. 사용자가 방금 질문하고 명백히 기다리고 있는 경우에도 마찬가지입니다. 짧은 작업이 완료되었을 때도 알림은 불필요합니다. 사용자가 제출 직후 기다리고 있다면 알림은 아무 가치가 없고, 이후 알림에 대한 신뢰만 떨어뜨립니다. 기본적으로 보내지 않는 방향으로 강하게 권장합니다.
 
+## 활성화
+
+- 기본적으로 꺼져 있습니다(서버 측 기능 플래그).
+- 전송은 Anthropic 호스팅 인프라를 통해 이루어집니다 — Amazon Bedrock, AWS의 Claude Platform, Google Cloud, Microsoft Foundry에서는 사용할 수 없습니다.
+- 휴대폰 푸시는 추가로 연결된 원격 제어 클라이언트가 필요합니다.
+
 ## 매개변수
 
 - `message` (문자열, 필수): 알림 본문. 200자 이내로 유지하십시오. 모바일 운영체제는 긴 문자열을 잘라냅니다. 사용자가 행동을 취할 수 있는 내용으로 시작하십시오: "build failed: 2 auth tests"는 "task complete"보다 훨씬 유용합니다.

package/concepts/ko/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+세션 내부의 영속적인 Node.js vm 컨텍스트에서 JavaScript를 실행합니다. 최상위 `await`가 지원되며, 한 호출에서 정의된 변수/함수는 이후 호출에서도 계속 사용할 수 있습니다.
+
+## 사용 시점
+
+- 셸 원라이너보다 코드로 작성하는 편이 쉬운 빠른 계산, 데이터 변환, 또는 JSON 다루기.
+- 호출 사이에 중간 상태(카운터, 누적 결과)가 유지되어야 하는 다단계 스크립팅.
+- 파일에 작성하기 전에 API나 라이브러리 동작을 대화형으로 탐색.
+
+## 활성화
+
+- 기본적으로 꺼져 있습니다 — 활성화하려면 `CLAUDE_CODE_REPL=true`를 설정하십시오.
+- 터미널(`cli`) 및 claude.ai(`remote`) 세션에서는 서버 측 기능 플래그가 이를 활성화할 수도 있습니다.
+- 꺼져 있으면 REPL은 모델의 도구 목록에서 숨겨집니다. 켜져 있으면 `Read`, `Glob`, `Grep`, `Bash`, `PowerShell`, `NotebookEdit`가 REPL 축약형으로 대체됩니다.
+
+## 매개변수
+
+- `code` (string, 필수): 실행할 JavaScript 코드. 최상위 await를 지원합니다. 상태는 호출 간에 유지됩니다.
+- `description` (string, 선택): 이 스크립트가 무엇을 하는지 능동태로 작성한 명확하고 간결한 설명 (5-10단어), 예: "Trace upgrade message to its GrowthBook flag".
+- `timeout` (number, 선택): 밀리초 단위 타임아웃. 기본값 30000, 최대 600000.
+
+## 예시
+
+### 예시 1: 계산하고 상태 재사용
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+`2`를 반환합니다. `counts`는 같은 세션의 후속 REPL 호출에서 정의된 상태로 유지됩니다.
+
+### 예시 2: 더 긴 타임아웃과 함께 최상위 await
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## 참고사항
+
+- 상태는 세션 단위입니다: 세션을 재시작하면 모든 정의가 지워집니다.
+- 이것은 JavaScript(Node) 환경입니다 — 셸 명령, 파일시스템 중심 작업, 또는 비-JS 런타임에는 Bash를 사용하십시오.
+- 장시간 실행되는 코드는 명시적인 `timeout`을 설정해야 합니다. 기본 30초는 그보다 느린 모든 것을 종료시킵니다.

package/concepts/ko/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+연결된 MCP(Model Context Protocol) 서버가 노출하는 단일 리소스를 URI로 지정하여 읽습니다.
+
+## 사용 시점
+
+- MCP 서버가 컨텍스트에 필요한 콘텐츠를 가진 리소스(파일, 레코드, 문서)를 광고합니다.
+- `ListMcpResources`, 서버 문서, 또는 이전 도구 결과에서 구체적인 리소스 URI를 알고 있습니다.
+
+## 활성화
+
+- 항상 활성화되어 있지만 모델의 도구 목록에는 노출되지 않습니다 — 씬 클라이언트/사이드카 사용을 위한 것입니다.
+
+## 매개변수
+
+- `server` (string, 필수): MCP 서버 이름.
+- `uri` (string, 필수): 읽을 리소스 URI.
+
+## 예시
+
+### 예시 1: URI로 서버 리소스 읽기
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+`github` MCP 서버가 제공하는 리소스 콘텐츠를 반환합니다.
+
+## 참고사항
+
+- 서버가 어떤 리소스를 노출하는지 모른다면 먼저 `ListMcpResources`를 사용하십시오. 디렉터리형 목록에는 `ReadMcpResourceDir`를 사용하십시오.
+- URI 스킴은 서버별로 다릅니다(`file://`, `https://`, 사용자 정의 스킴) — 대상 서버가 광고하는 것을 확인하십시오.

package/concepts/ko/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+연결된 MCP 서버가 노출하는 디렉터리형 리소스의 항목을 URI로 지정하여 나열합니다.
+
+## 사용 시점
+
+- MCP 서버가 리소스를 계층적으로 구성하며 그 계층의 한 수준을 열거해야 합니다.
+- `ReadMcpResource`로 개별 리소스를 읽기 전에 탐색하고 싶습니다.
+
+## 활성화
+
+- 항상 활성화되어 있지만 모델의 도구 목록에는 노출되지 않습니다 — 씬 클라이언트/사이드카 사용을 위한 것입니다.
+
+## 매개변수
+
+- `server` (string, 필수): MCP 서버 이름.
+- `uri` (string, 필수): 나열할 디렉터리 리소스 URI.
+
+## 예시
+
+### 예시 1: 리소스 디렉터리 나열
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+서버가 해당 디렉터리 URI 아래에서 노출하는 하위 항목을 반환합니다.
+
+## 참고사항
+
+- 리소스를 디렉터리로 모델링하는 서버만 이를 지원합니다. 평면적인 서버는 오류 또는 빈 목록을 반환합니다 — `ListMcpResources`로 폴백하십시오.
+- `ReadMcpResource`와 결합하여 관련 있어 보이는 항목으로 파고드십시오.

package/concepts/ko/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+현재 세션에서 어시스턴트에게 대기 중인 알림을 읽습니다 — 구독한 PR의 GitHub 활동(`github_webhook`), 스케줄된 트리거 발화(`trigger_fire`), 그리고 다른 Claude 세션에서 도착한 메시지(`mcp_send_message`).
+
+## 사용 시점
+
+- 무언가 일어났다는 알림을 받았고(구독한 PR 업데이트, 스케줄된 트리거 발화, 다른 세션의 메시지) 실제 페이로드가 필요합니다.
+- 백로그 소진: 큰 배치는 부분적으로 반환되므로, 결과가 0 `remaining`을 보고할 때까지 계속 호출하십시오.
+
+## 매개변수
+
+이 도구는 매개변수를 받지 않습니다.
+
+## 예시
+
+### 예시 1: 보류 중인 알림 소진
+
+```
+ReadNotifications()
+```
+
+대기 중인 알림을 가장 오래된 것부터 반환합니다. 결과에는 이번 소진 후에도 여전히 대기 중인 알림의 `remaining` 개수가 포함됩니다 — 나머지를 읽으려면 도구를 다시 호출하십시오.
+
+## 참고사항
+
+- 소진은 크기 예산이 정해져 있습니다: 후속 호출은 새 도착분만이 아니라 같은 큐의 나머지(새로 도착한 것을 더한)를 반환합니다. `remaining`이 0이 될 때까지 반복하십시오.
+- 알림은 구독한 PR의 GitHub 웹훅, 스케줄된 트리거, 그리고 다른 Claude 세션의 메시지에서 발생합니다. 현재 버전에는 필터링 매개변수가 없습니다.

package/concepts/ko/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@ claude.ai 원격 트리거 API를 호출하여 예약된 작업과 온디맨드
 - 모든 현재 트리거를 나열하거나 감사하여 구성 및 상태 검토
 - 트리거를 재생성하지 않고 일정, 페이로드 또는 설명과 같은 트리거 설정 업데이트
 
+## 활성화
+
+- claude.ai Pro, Max, Team, 또는 Enterprise 플랜이 필요합니다.
+- Amazon Bedrock, AWS의 Claude Platform, Google Cloud, Microsoft Foundry에서는 사용할 수 없습니다.
+- 서버 측 기능 플래그와 `allow_remote_sessions` / `allow_routines` 정책 설정이 필요합니다.
+- 원격 세션 자체를 위한 것이 아닙니다.
+
 ## 매개변수
 
 - `action` (string, 필수): 수행할 작업 — `list`, `get`, `create`, `update`, `run` 중 하나

package/concepts/ko/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@
 - 사용자 프롬프트 없이 자율 루프를 실행할 때 — 리터럴 센티널 `<<autonomous-loop-dynamic>>`을 `prompt`로 전달
 - 곧 상태가 변경될 프로세스를 폴링할 때 (짧은 지연으로 캐시를 워밍 상태로 유지)
 
+## 활성화
+
+- Amazon Bedrock, AWS의 Claude Platform, Google Cloud Agent Platform, Microsoft Foundry에서는 사용할 수 없습니다.
+- 기능 플래그 가져오기가 비활성화된 경우에도 꺼집니다(텔레메트리/트래픽 환경 변수).
+
 ## 매개변수
 
 - `delaySeconds` (숫자, 필수): 재개까지의 초 단위 시간. 런타임이 값을 자동으로 `[60, 3600]` 범위로 클램프하므로 직접 클램프할 필요가 없습니다.