cx-viewer 1.0.3 → 1.0.4

package/concepts/ko/Tool-TaskUpdate.md

@@ -1,123 +0,0 @@
-# TaskUpdate
-
-## 정의
-
-태스크 리스트 내 특정 태스크의 상태, 내용 또는 의존 관계를 업데이트합니다.
-
-## 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `taskId` | string | 예 | 업데이트할 태스크 ID |
-| `status` | enum | 아니오 | 새 상태: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | 아니오 | 새 제목 |
-| `description` | string | 아니오 | 새 설명 |
-| `activeForm` | string | 아니오 | 진행 중 표시할 현재 진행형 텍스트 |
-| `owner` | string | 아니오 | 새 태스크 담당자 (agent 이름) |
-| `metadata` | object | 아니오 | 병합할 메타데이터 (null로 설정하면 키 삭제) |
-| `addBlocks` | string[] | 아니오 | 이 태스크에 의해 차단되는 태스크 ID 목록 |
-| `addBlockedBy` | string[] | 아니오 | 이 태스크를 차단하는 선행 태스크 ID 목록 |
-
-## 상태 전이
-
-```
-pending → in_progress → completed
-```
-
-`deleted`는 모든 상태에서 전이 가능하며, 태스크를 영구 삭제합니다.
-
-## 사용 시나리오
-
-**적합한 경우:**
-- 작업 시작 시 태스크를 `in_progress`로 마킹
-- 작업 완료 후 태스크를 `completed`로 마킹
-- 태스크 간 의존 관계 설정
-- 요구사항 변경 시 태스크 내용 업데이트
-
-**중요 규칙:**
-- 태스크를 완전히 완료한 경우에만 `completed`로 마킹
-- 오류나 차단에 직면하면 `in_progress` 유지
-- 테스트 실패, 구현 불완전, 미해결 오류가 있으면 `completed`로 마킹 불가
-
-## 주의사항
-
-- 업데이트 전 TaskGet으로 태스크의 최신 상태를 가져와 오래된 데이터를 피할 것
-- 태스크 완료 후 TaskList를 호출하여 다음 사용 가능한 태스크 검색
-
-## 원문
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
-
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
-
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
-
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
-
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
-
-## Fields You Can Update
-
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
-
-## Status Workflow
-
-Status progresses: `pending` → `in_progress` → `completed`
-
-Use `deleted` to permanently remove a task.
-
-## Staleness
-
-Make sure to read a task's latest state using `TaskGet` before updating it.
-
-## Examples
-
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
-
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
-```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
-```
-
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
-
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>

package/concepts/ko/Tool-TeamCreate.md

@@ -1,38 +0,0 @@
-# TeamCreate
-
-## 정의
-
-프로젝트를 진행하는 여러 agent를 조율하는 새로운 팀을 생성합니다. 팀은 공유 태스크 목록과 agent 간 메시지 교환을 통해 병렬 태스크 실행을 가능하게 합니다.
-
-## 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `team_name` | string | 예 | 새 팀의 이름 |
-| `description` | string | 아니오 | 팀 설명 / 목적 |
-| `agent_type` | string | 아니오 | 팀 리더의 타입 / 역할 |
-
-## 생성되는 항목
-
-- **팀 설정 파일**: `~/.claude/teams/{team-name}/config.json` — 멤버 목록과 메타데이터 저장
-- **태스크 목록 디렉토리**: `~/.claude/tasks/{team-name}/` — 모든 팀원이 공유하는 태스크 목록
-
-팀과 태스크 목록은 1:1 대응 관계입니다.
-
-## 팀 워크플로우
-
-1. **TeamCreate** — 팀과 태스크 목록 생성
-2. **TaskCreate** — 팀의 태스크 정의
-3. **Agent** (`team_name` + `name` 지정) — 팀에 합류하는 팀원 생성
-4. **TaskUpdate** — `owner`를 통해 팀원에게 태스크 할당
-5. 팀원들이 태스크를 수행하며 **SendMessage**로 소통
-6. 완료 후 팀원 종료, 이후 **TeamDelete**로 정리
-
-## 관련 도구
-
-| 도구 | 용도 |
-|------|------|
-| `TeamDelete` | 팀과 태스크 디렉토리 제거 |
-| `SendMessage` | 팀 내 agent 간 통신 |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 공유 태스크 목록 관리 |
-| `Agent` | 팀에 합류하는 팀원 생성 |

package/concepts/ko/Tool-TeamDelete.md

@@ -1,30 +0,0 @@
-# TeamDelete
-
-## 정의
-
-다중 agent 협업 작업이 완료되었을 때 팀과 관련 태스크 디렉토리를 제거합니다. TeamCreate의 정리 대응 작업입니다.
-
-## 동작
-
-- 팀 디렉토리 제거: `~/.claude/teams/{team-name}/`
-- 태스크 디렉토리 제거: `~/.claude/tasks/{team-name}/`
-- 현재 세션에서 팀 컨텍스트 초기화
-
-**중요**: 팀에 아직 활성 멤버가 있으면 TeamDelete는 실패합니다. SendMessage 종료 요청을 통해 먼저 모든 팀원을 정상적으로 종료해야 합니다.
-
-## 일반적인 사용 방법
-
-TeamDelete는 팀 워크플로우 종료 시 호출됩니다:
-
-1. 모든 태스크 완료
-2. `SendMessage`로 `shutdown_request`를 보내 팀원 종료
-3. **TeamDelete**가 팀과 태스크 디렉토리 제거
-
-## 관련 도구
-
-| 도구 | 용도 |
-|------|------|
-| `TeamCreate` | 새 팀과 태스크 목록 생성 |
-| `SendMessage` | 팀원과의 통신 / 종료 요청 전송 |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 공유 태스크 목록 관리 |
-| `Agent` | 팀에 합류하는 팀원 생성 |

package/concepts/ko/Tool-WebFetch.md

@@ -1,55 +0,0 @@
-# WebFetch
-
-## 정의
-
-지정된 URL의 웹페이지 내용을 가져와 HTML을 markdown으로 변환하고, AI 모델로 prompt에 따라 내용을 처리합니다.
-
-## 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `url` | string (URI) | 예 | 가져올 완전한 URL |
-| `prompt` | string | 예 | 페이지에서 어떤 정보를 추출할지 설명 |
-
-## 사용 시나리오
-
-**적합한 경우:**
-- 공개 웹페이지의 내용 가져오기
-- 온라인 문서 참조
-- 웹페이지에서 특정 정보 추출
-
-**적합하지 않은 경우:**
-- 인증이 필요한 URL (Google Docs, Confluence, Jira, GitHub 등) — 먼저 전용 MCP 도구를 찾아야 함
-- GitHub URL — `gh` CLI를 우선 사용
-
-## 주의사항
-
-- URL은 완전한 유효 URL이어야 함
-- HTTP는 자동으로 HTTPS로 업그레이드
-- 내용이 너무 크면 결과가 요약될 수 있음
-- 15분 자동 정리 캐시 포함
-- URL이 다른 호스트로 리다이렉트되면 도구가 리다이렉트 URL을 반환하며, 새 URL로 재요청 필요
-- MCP 제공 web fetch 도구가 사용 가능하면 그것을 우선 사용
-
-## 원문
-
-<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
-
-- Fetches content from a specified URL and processes it using an AI model
-- Takes a URL and a prompt as input
-- Fetches the URL content, converts HTML to markdown
-- Processes the content with the prompt using a small, fast model
-- Returns the model's response about the content
-- Use this tool when you need to retrieve and analyze web content
-
-Usage notes:
-  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
-  - The URL must be a fully-formed valid URL
-  - HTTP URLs will be automatically upgraded to HTTPS
-  - The prompt should describe what information you want to extract from the page
-  - This tool is read-only and does not modify any files
-  - Results may be summarized if the content is very large
-  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
-  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
-  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
-</textarea>

package/concepts/ko/Tool-WebSearch.md

@@ -1,58 +0,0 @@
-# WebSearch
-
-## 정의
-
-검색 엔진 쿼리를 실행하여 최신 정보를 얻기 위한 검색 결과를 반환합니다.
-
-## 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `query` | string | 예 | 검색 쿼리 (최소 2자) |
-| `allowed_domains` | string[] | 아니오 | 이 도메인의 결과만 포함 |
-| `blocked_domains` | string[] | 아니오 | 이 도메인의 결과를 제외 |
-
-## 사용 시나리오
-
-**적합한 경우:**
-- 모델의 지식 컷오프 날짜를 넘는 최신 정보 획득
-- 현재 이벤트 및 최신 데이터 검색
-- 최신 기술 문서 검색
-
-## 주의사항
-
-- 검색 결과는 markdown 하이퍼링크 형식으로 반환
-- 사용 후 응답 끝에 "Sources:" 섹션을 추가하고 관련 URL을 나열해야 함
-- 도메인 필터링 (포함/제외) 지원
-- 검색 쿼리에 현재 연도를 사용해야 함
-- 미국에서만 사용 가능
-
-## 원문
-
-<textarea readonly>
-- Allows Claude to search the web and use the results to inform responses
-- Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
-- Use this tool for accessing information beyond Claude's knowledge cutoff
-- Searches are performed automatically within a single API call
-
-CRITICAL REQUIREMENT - You MUST follow this:
-  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
-  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
-  - This is MANDATORY - never skip including sources in your response
-  - Example format:
-
-    [Your answer here]
-
-    Sources:
-    - [Source Title 1](https://example.com/1)
-    - [Source Title 2](https://example.com/2)
-
-Usage notes:
-  - Domain filtering is supported to include or block specific websites
-  - Web search is only available in the US
-
-IMPORTANT - Use the correct year in search queries:
-  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
-  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
-</textarea>

package/concepts/ko/Tool-Write.md

@@ -1,39 +0,0 @@
-# Write
-
-## 정의
-
-로컬 파일 시스템에 내용을 씁니다. 파일이 이미 존재하면 덮어씁니다.
-
-## 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `file_path` | string | 예 | 파일의 절대 경로 (절대 경로여야 함) |
-| `content` | string | 예 | 쓸 내용 |
-
-## 사용 시나리오
-
-**적합한 경우:**
-- 새 파일 생성
-- 파일 내용을 완전히 재작성해야 하는 경우
-
-**적합하지 않은 경우:**
-- 파일 내 부분적인 내용 수정 — Edit를 사용해야 함
-- 문서 파일 (*.md)이나 README를 자발적으로 생성하지 말 것. 사용자가 명시적으로 요청한 경우를 제외
-
-## 주의사항
-
-- 대상 파일이 이미 존재하면 먼저 Read로 읽어야 함. 그렇지 않으면 실패
-- 기존 파일의 전체 내용을 덮어씀
-- 기존 파일 편집에는 Edit를 우선 사용하고, Write는 새 파일 생성 또는 완전한 재작성에만 사용
-
-## 원문
-
-<textarea readonly>Writes a file to the local filesystem.
-
-Usage:
-- This tool will overwrite the existing file if there is one at the provided path.
-- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
-- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
-- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
-- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>

package/concepts/ko/Tool-executeCode.md

@@ -1,41 +0,0 @@
-# executeCode (mcp__ide__executeCode)
-
-## 정의
-
-현재 notebook 파일의 Jupyter kernel에서 Python 코드를 실행합니다.
-
-## 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `code` | string | 예 | 실행할 Python 코드 |
-
-## 사용 시나리오
-
-**적합한 경우:**
-- Jupyter notebook 환경에서 코드 실행
-- 코드 스니펫 테스트
-- 데이터 분석 및 계산
-
-**적합하지 않은 경우:**
-- 비 Jupyter 환경에서의 코드 실행 — Bash를 사용해야 함
-- 파일 수정 — Edit 또는 Write를 사용해야 함
-
-## 주의사항
-
-- 이것은 MCP (Model Context Protocol) 도구이며, IDE 통합에 의해 제공
-- 코드는 현재 Jupyter kernel에서 실행되며, 상태는 호출 간에 유지
-- 사용자가 명시적으로 요청하지 않는 한 변수 선언이나 kernel 상태 변경을 피해야 함
-- kernel 재시작 후 상태가 소실됨
-
-## 원문
-
-<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
-    
-    All code will be executed in the current Jupyter kernel.
-    
-    Avoid declaring variables or modifying the state of the kernel unless the user
-    explicitly asks for it.
-    
-    Any code executed will persist across calls to this tool, unless the kernel
-    has been restarted.</textarea>

package/concepts/ko/Tool-getDiagnostics.md

@@ -1,32 +0,0 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
-
-## 정의
-
-VS Code에서 언어 진단 정보를 가져옵니다. 구문 오류, 타입 오류, lint 경고 등을 포함합니다.
-
-## 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `uri` | string | 아니오 | 파일 URI. 제공하지 않으면 모든 파일의 진단 정보를 가져옴 |
-
-## 사용 시나리오
-
-**적합한 경우:**
-- 코드의 구문, 타입, lint 등 시맨틱 문제 확인
-- 코드 편집 후 새로운 오류가 도입되지 않았는지 검증
-- Bash 명령 대신 코드 품질 확인
-
-**적합하지 않은 경우:**
-- 테스트 실행 — Bash를 사용해야 함
-- 런타임 오류 확인 — Bash로 코드를 실행해야 함
-
-## 주의사항
-
-- 이것은 MCP (Model Context Protocol) 도구이며, IDE 통합에 의해 제공
-- VS Code / IDE 환경에서만 사용 가능
-- 코드 문제 확인에는 Bash 명령보다 이 도구를 우선 사용
-
-## 원문
-
-<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/ko/Tools.md

@@ -1,67 +0,0 @@
-# Claude Code 도구 목록
-
-Claude Code는 Anthropic API의 tool_use 메커니즘을 통해 모델에 일련의 내장 도구를 제공합니다. 각 MainAgent 요청의 `tools` 배열에 이러한 도구의 완전한 JSON Schema 정의가 포함되며, 모델은 응답 내의 `tool_use` content block으로 이를 호출합니다.
-
-다음은 모든 도구의 카테고리별 인덱스입니다.
-
-## Agent 시스템
-
-| 도구 | 용도 |
-|------|------|
-| [Task](Tool-Task.md) | 서브 agent (SubAgent)를 시작하여 복잡한 다단계 태스크 처리 |
-| [TaskOutput](Tool-TaskOutput.md) | 백그라운드 태스크의 출력 가져오기 |
-| [TaskStop](Tool-TaskStop.md) | 실행 중인 백그라운드 태스크 중지 |
-| [TaskCreate](Tool-TaskCreate.md) | 구조화된 태스크 리스트 항목 생성 |
-| [TaskGet](Tool-TaskGet.md) | 태스크 상세 정보 가져오기 |
-| [TaskUpdate](Tool-TaskUpdate.md) | 태스크 상태, 의존 관계 등 업데이트 |
-| [TaskList](Tool-TaskList.md) | 모든 태스크 목록 표시 |
-
-## 파일 작업
-
-| 도구 | 용도 |
-|------|------|
-| [Read](Tool-Read.md) | 파일 내용 읽기 (텍스트, 이미지, PDF, Jupyter notebook 지원) |
-| [Edit](Tool-Edit.md) | 정확한 문자열 치환으로 파일 편집 |
-| [Write](Tool-Write.md) | 파일 쓰기 또는 덮어쓰기 |
-| [NotebookEdit](Tool-NotebookEdit.md) | Jupyter notebook 셀 편집 |
-
-## 검색
-
-| 도구 | 용도 |
-|------|------|
-| [Glob](Tool-Glob.md) | 파일명 패턴 매칭으로 파일 검색 |
-| [Grep](Tool-Grep.md) | ripgrep 기반 파일 내용 검색 |
-
-## 터미널
-
-| 도구 | 용도 |
-|------|------|
-| [Bash](Tool-Bash.md) | 셸 명령 실행 |
-
-## Web
-
-| 도구 | 용도 |
-|------|------|
-| [WebFetch](Tool-WebFetch.md) | 웹페이지 내용을 가져와 AI로 처리 |
-| [WebSearch](Tool-WebSearch.md) | 검색 엔진 쿼리 |
-
-## 계획 및 상호작용
-
-| 도구 | 용도 |
-|------|------|
-| [EnterPlanMode](Tool-EnterPlanMode.md) | 계획 모드 진입, 구현 방안 설계 |
-| [ExitPlanMode](Tool-ExitPlanMode.md) | 계획 모드 종료 및 방안을 사용자 승인에 제출 |
-| [AskUserQuestion](Tool-AskUserQuestion.md) | 사용자에게 질문하여 확인 또는 결정 획득 |
-
-## 확장
-
-| 도구 | 용도 |
-|------|------|
-| [Skill](Tool-Skill.md) | 스킬 (slash command) 실행 |
-
-## IDE 통합
-
-| 도구 | 용도 |
-|------|------|
-| [getDiagnostics](Tool-getDiagnostics.md) | VS Code 언어 진단 정보 가져오기 |
-| [executeCode](Tool-executeCode.md) | Jupyter kernel에서 코드 실행 |

package/concepts/no/CacheRebuild.md

@@ -1,36 +0,0 @@
-# Cache Rebuild (cache-gjenoppbygging)
-
-## Bakgrunn
-
-Anthropics prompt caching-mekanisme setter sammen system → tools → messages (til cache-brytepunktet) i rekkefølge som cache-nøkkel. Når cache-nøkkelen er helt identisk med forrige forespørsel, returnerer API-et `cache_read_input_tokens` (cache-treff); når nøkkelen endres, oppretter API-et cachen på nytt og returnerer en stor mengde `cache_creation_input_tokens`, altså cache-gjenoppbygging.
-
-Cache-gjenoppbygging betyr ekstra token-kostnader (prisen for cache creation er høyere enn cache read), så å identifisere årsaken til gjenoppbygging har direkte verdi for kostnadsoptimalisering.
-
-## Klassifisering av årsaker til cache-gjenoppbygging
-
-cc-viewer bestemmer nøyaktig årsaken til cache-gjenoppbygging ved å sammenligne body fra to påfølgende MainAgent-forespørsler:
-
-| reason | Betydning | Bestemmelsesmetode |
-|--------|-----------|-------------------|
-| `ttl` | Cache utløpt | Mer enn 5 minutter siden forrige MainAgent-forespørsel |
-| `system_change` | System prompt endret | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
-| `tools_change` | Verktøydefinisjoner endret | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
-| `model_change` | Modellbytte | `prev.model !== curr.model` |
-| `msg_truncated` | Meldingsstakk avkortet | Gjeldende forespørsel har færre meldinger enn forrige, vanligvis utløst av kontekstvindu-overflyt |
-| `msg_modified` | Historiske meldinger endret | Prefiks-meldingsinnhold stemmer ikke overens (ved normal tillegging skal prefikset være helt identisk) |
-| `key_change` | Ukjent nøkkelendring | Fallback når ingen av betingelsene ovenfor matcher |
-
-## Prioriteringsrekkefølge
-
-1. Sjekk tidsintervall først — over 5 minutter gir direkte `ttl`-bestemmelse uten body-sammenligning
-2. Deretter sjekkes model, system, tools og messages i rekkefølge
-3. En forespørsel kan matche flere årsaker samtidig (f.eks. modellbytte + system prompt-endring), da inneholder `reasons`-arrayen alle matchende elementer og tooltip vises med flere linjer
-
-## Vanlige scenarioer
-
-- **`ttl`**: Brukeren pauset i mer enn 5 minutter og fortsatte deretter, cachen utløp naturlig
-- **`system_change`**: Claude Code oppdaterte system prompt (f.eks. lastet ny CLAUDE.md eller endring i prosjektinstruksjoner)
-- **`tools_change`**: MCP-server tilkobling/frakobling førte til endring i tilgjengelig verktøyliste
-- **`model_change`**: Brukeren byttet modell via `/model`-kommandoen
-- **`msg_truncated`**: Lang samtale utløste kontekstvindu-håndtering, Claude Code avkortet tidlige meldinger
-- **`msg_modified`**: Claude Code redigerte historiske meldinger (f.eks. `/compact` komprimeringssammendrag erstattet originale meldinger)

package/concepts/no/KVCacheContent.md

@@ -1,49 +0,0 @@
-# KV-Cache hurtigbufferinnhold
-
-## Hva er Prompt Caching?
-
-Når du samtaler med Claude, sender hver API-forespørsel den komplette samtalekonteksten (system prompt + verktøydefinisjoner + meldingshistorikk). Anthropics prompt caching-mekanisme hurtigbufrer allerede beregnet prefiksinnhold på serversiden, og hvis prefikset er det samme ved påfølgende forespørsler, gjenbrukes hurtigbufferresultatet direkte, noe som hopper over gjentatte beregninger og reduserer forsinkelse og kostnader betydelig.
-
-I cc-viewer kalles denne mekanismen "KV-Cache", som tilsvarer prompt caching på Anthropic API-nivå — ikke key-value cachen i transformerens oppmerksomhetslag internt i LLM-en.
-
-## Hvordan hurtigbufferen fungerer
-
-Anthropics prompt caching setter sammen hurtigbuffernøkler i en fast rekkefølge:
-
-```
-Tools → System Prompt → Messages (til cache breakpoint)
-```
-
-Så lenge dette prefikset er helt identisk med en hvilken som helst forespørsel innenfor TTL-vinduet, vil API-et treffe hurtigbufferen (returnerer `cache_read_input_tokens`) i stedet for å beregne på nytt (`cache_creation_input_tokens`).
-
-> **Claude Code er ikke sterkt avhengig av `cache_control`-attributten — serveren fjerner noen av disse attributtene, men kan likevel opprette hurtigbuffer fint, så fraværet av `cache_control`-attributten betyr ikke at innholdet ikke er hurtigbufret**
->
-> For spesialklienter som Claude Code er Anthropics server ikke fullstendig avhengig av `cache_control`-attributten i forespørselen for å bestemme hurtigbufferatferd. Serveren utfører automatisk hurtigbufferstrategier for spesifikke felt (som system prompt og verktøydefinisjoner), selv når forespørselen ikke eksplisitt inneholder `cache_control`-markører. Derfor trenger du ikke undre deg når du ikke ser denne attributten i forespørselens body — serveren har allerede utført hurtigbufferoperasjonen bak kulissene, den har bare ikke eksponert denne informasjonen for klienten. Dette er en stilltiende avtale mellom Claude Code og Anthropic API.
-
-## Hva er "gjeldende KV-Cache hurtigbufferinnhold"?
-
-"Gjeldende KV-Cache hurtigbufferinnhold" som vises i cc-viewer, er innhold hentet fra den siste MainAgent-forespørselen, som befinner seg før hurtigbuffergrensen (cache breakpoint). Det inkluderer spesifikt:
-
-- **System Prompt**: Claude Codes systeminstruksjoner, inkludert kjerne-agentinstruksjoner, retningslinjer for verktøybruk, CLAUDE.md-prosjektinstruksjoner, miljøinformasjon osv.
-- **Tools**: Listen over tilgjengelige verktøydefinisjoner (som Read, Write, Bash, Agent, MCP-verktøy osv.)
-- **Messages**: Den hurtigbufrede delen av samtalehistorikken (vanligvis eldre meldinger, opp til siste `cache_control`-markering)
-
-## Hvorfor se på hurtigbufferinnholdet?
-
-1. **Forstå konteksten**: Vit hva Claude for øyeblikket "husker", og hjelp deg med å vurdere om atferden er som forventet
-2. **Kostnadsoptimalisering**: Hurtigbuffertreff koster langt mindre enn omberegning. Å se hurtigbufferinnholdet hjelper deg med å forstå hvorfor visse forespørsler utløste hurtigbuffer-gjenoppbygging (cache rebuild)
-3. **Feilsøking av samtale**: Når Claudes svar ikke samsvarer med forventningene, kan kontroll av hurtigbufferinnholdet bekrefte om system prompt og meldingshistorikk er korrekte
-4. **Overvåking av kontekstkvalitet**: Under feilsøking, endring av konfigurasjon eller justering av prompts gir KV-Cache-Text et sentralisert perspektiv som hjelper deg med raskt å bekrefte om kjernekonteksten har forverret seg eller blitt forurenset av uventet innhold — uten å måtte gjennomgå originale meldinger én etter én
-
-## Flerlags hurtigbufferstrategi
-
-KV-Cachen tilhørende Claude Code er ikke bare én enkelt hurtigbuffer. Serveren genererer separate hurtigbuffere for Tools og System Prompt, uavhengig av Messages-hurtigbufferen. Fordelen med dette designet er: når meldingsstabelen blir forstyrret (f.eks. kontekstavkorting, meldingsendringer) og krever gjenoppbygging, invaliderer det ikke samtidig Tools- og System Prompt-hurtigbuffrene, noe som unngår fullstendig omberegning.
-
-Dette er en optimaliseringsstrategi på serversiden — fordi Tools-definisjoner og System Prompt er relativt stabile under normal bruk og sjelden endres, maksimerer separat hurtigbufring av dem reduksjonen av unødvendig gjenoppbyggingskostnad. Så når du observerer hurtigbufferen, vil du legge merke til at bortsett fra Tools-gjenoppbygging, som krever fullstendig oppdatering av alle hurtigbuffere, kan ødeleggelse av System Prompt og Messages fortsatt arve tilgjengelige hurtigbuffere.
-
-## Hurtigbufferlivssyklus
-
-- **Opprettelse**: Ved første forespørsel eller etter at hurtigbufferen er utløpt, oppretter API-et en ny hurtigbuffer (`cache_creation_input_tokens`)
-- **Treff**: Påfølgende forespørsler med identisk prefiks gjenbruker hurtigbufferen (`cache_read_input_tokens`)
-- **Utløp**: Hurtigbufferen har en TTL (levetid) på 5 minutter og utløper automatisk deretter
-- **Gjenoppbygging**: Når system prompt, verktøyliste, modell eller meldingsinnhold endres, samsvarer ikke hurtigbuffernøkkelen, noe som utløser gjenoppbygging av det tilsvarende nivået