cc-viewer 1.2.1 → 1.2.3

package/concepts/ko/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# 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 도구가 사용 가능하면 그것을 우선 사용
+
+## cc-viewer에서의 의의
+
+WebFetch 호출은 요청 로그에서 `tool_use` / `tool_result` content block 쌍으로 나타납니다. `tool_result`에는 AI 처리 후의 웹페이지 내용 요약이 포함됩니다.

package/concepts/ko/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## 정의
+
+검색 엔진 쿼리를 실행하여 최신 정보를 얻기 위한 검색 결과를 반환합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `query` | string | 예 | 검색 쿼리 (최소 2자) |
+| `allowed_domains` | string[] | 아니오 | 이 도메인의 결과만 포함 |
+| `blocked_domains` | string[] | 아니오 | 이 도메인의 결과를 제외 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 모델의 지식 컷오프 날짜를 넘는 최신 정보 획득
+- 현재 이벤트 및 최신 데이터 검색
+- 최신 기술 문서 검색
+
+## 주의사항
+
+- 검색 결과는 markdown 하이퍼링크 형식으로 반환
+- 사용 후 응답 끝에 "Sources:" 섹션을 추가하고 관련 URL을 나열해야 함
+- 도메인 필터링 (포함/제외) 지원
+- 검색 쿼리에 현재 연도를 사용해야 함
+- 미국에서만 사용 가능
+
+## cc-viewer에서의 의의
+
+WebSearch 호출은 요청 로그에서 `tool_use` / `tool_result` content block 쌍으로 나타납니다. `tool_result`에는 검색 결과 목록이 포함됩니다.

package/concepts/ko/Tool-Write.md

@@ -0,0 +1,32 @@
+# Write
+
+## 정의
+
+로컬 파일 시스템에 내용을 씁니다. 파일이 이미 존재하면 덮어씁니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `file_path` | string | 예 | 파일의 절대 경로 (절대 경로여야 함) |
+| `content` | string | 예 | 쓸 내용 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 새 파일 생성
+- 파일 내용을 완전히 재작성해야 하는 경우
+
+**적합하지 않은 경우:**
+- 파일 내 부분적인 내용 수정 — Edit를 사용해야 함
+- 문서 파일 (*.md)이나 README를 자발적으로 생성하지 말 것. 사용자가 명시적으로 요청한 경우를 제외
+
+## 주의사항
+
+- 대상 파일이 이미 존재하면 먼저 Read로 읽어야 함. 그렇지 않으면 실패
+- 기존 파일의 전체 내용을 덮어씀
+- 기존 파일 편집에는 Edit를 우선 사용하고, Write는 새 파일 생성 또는 완전한 재작성에만 사용
+
+## cc-viewer에서의 의의
+
+Write 호출은 요청 로그에서 `tool_use` content block으로 나타나며, `input.content`에 쓰여진 전체 내용이 포함됩니다.

package/concepts/ko/Tool-executeCode.md

@@ -0,0 +1,33 @@
+# 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 재시작 후 상태가 소실됨
+
+## cc-viewer에서의 의의
+
+executeCode는 MCP 도구이며, 요청 로그의 `tools` 배열에 `mcp__ide__executeCode` 이름으로 나타납니다. 호출과 반환은 표준 `tool_use` / `tool_result` 패턴을 따릅니다. MCP 도구의 증감은 tools 배열 변화를 일으키며, 캐시 재구축을 트리거할 수 있습니다.

package/concepts/ko/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## 정의
+
+VS Code에서 언어 진단 정보를 가져옵니다. 구문 오류, 타입 오류, lint 경고 등을 포함합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `uri` | string | 아니오 | 파일 URI. 제공하지 않으면 모든 파일의 진단 정보를 가져옴 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 코드의 구문, 타입, lint 등 시맨틱 문제 확인
+- 코드 편집 후 새로운 오류가 도입되지 않았는지 검증
+- Bash 명령 대신 코드 품질 확인
+
+**적합하지 않은 경우:**
+- 테스트 실행 — Bash를 사용해야 함
+- 런타임 오류 확인 — Bash로 코드를 실행해야 함
+
+## 주의사항
+
+- 이것은 MCP (Model Context Protocol) 도구이며, IDE 통합에 의해 제공
+- VS Code / IDE 환경에서만 사용 가능
+- 코드 문제 확인에는 Bash 명령보다 이 도구를 우선 사용
+
+## cc-viewer에서의 의의
+
+getDiagnostics는 MCP 도구이며, 요청 로그의 `tools` 배열에 `mcp__ide__getDiagnostics` 이름으로 나타납니다. 호출과 반환은 표준 `tool_use` / `tool_result` 패턴을 따릅니다. MCP 도구의 증감은 tools 배열 변화를 일으키며, 캐시 재구축을 트리거할 수 있습니다.

package/concepts/ko/Tools.md

@@ -0,0 +1,73 @@
+# 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에서 코드 실행 |
+
+## cc-viewer에서의 의의
+
+도구 호출은 Claude Code 요청 로그에서 가장 핵심적인 관측 가능 데이터 중 하나입니다. 각 MainAgent 요청의 `tools` 배열은 모델이 사용 가능한 도구 세트를 정의하고, 응답 내의 `tool_use` / `tool_result` content block은 실제 도구 호출과 반환을 기록합니다. cc-viewer는 이러한 데이터를 파싱하여 Chat Mode에서 완전한 도구 호출 체인을 재현합니다.
+
+도구 정의의 변화 (MCP server 연결/해제로 인한 도구 증감 등)는 캐시 재구축을 트리거합니다. 자세한 내용은 [CacheRebuild](CacheRebuild.md)를 참조하세요.

package/concepts/ko/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# 번역 API 컨텍스트 오염
+
+## 배경
+
+CC-Viewer에는 Anthropic Messages API를 활용한 내장 번역 기능(`POST /api/translate`)이 포함되어 있습니다. 초기 구현에서는 번역 요청이 Claude Code 세션에서 캐시된 인증 자격 증명(`x-api-key`와 `authorization` 헤더 모두)을 재사용했습니다. 이로 인해 미묘하지만 심각한 문제가 발생했습니다: 번역 결과에 관련 없는 콘텐츠가 빈번하게 반환되었습니다.
+
+## 근본 원인
+
+### 두 가지 인증 방식의 본질적 차이
+
+Anthropic API는 두 가지 인증 방식을 지원합니다:
+
+| 방식 | 헤더 | 일반적인 출처 | 특징 |
+|------|------|---------------|------|
+| API 키 | `x-api-key: sk-ant-...` | 환경 변수 / Console | 무상태, 각 요청이 독립적 |
+| OAuth 토큰 | `authorization: Bearer sessionToken` | Claude Code 구독 로그인 | 세션에 바인딩, 서버가 컨텍스트 연관을 유지 |
+
+핵심 차이점: **API 키는 무상태(stateless)**로 각 요청이 완전히 독립적입니다. 반면 **OAuth 세션 토큰은 상태 유지(stateful)**로, Anthropic 서버가 동일한 토큰을 사용하는 요청을 같은 세션 컨텍스트에 연관시킵니다.
+
+### 오염 체인
+
+Claude Code가 구독형 OAuth 로그인을 사용할 때 인증 흐름은 다음과 같습니다:
+
+```
+Claude Code 메인 대화 ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                    ↑
+CC-Viewer 번역 요청 ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+번역 요청이 동일한 세션 토큰을 재사용했기 때문에, Anthropic 서버가 번역 요청을 Claude Code의 메인 대화 컨텍스트에 연관시킬 수 있었습니다. 이로 인해 다음과 같은 문제가 발생합니다:
+
+1. **번역 결과가 메인 대화 컨텍스트의 영향을 받음**: 번역 요청의 시스템 프롬프트는 "당신은 번역가입니다"이지만, 서버 컨텍스트에는 여전히 Claude Code의 대화 기록이 포함되어 있어 모델에 간섭할 수 있습니다
+2. **메인 대화가 번역 요청에 의해 교란됨**: 번역 요청 내용(UI 텍스트 조각)이 메인 대화 컨텍스트에 주입되어 Claude Code의 응답이 벗어날 수 있습니다
+3. **예측 불가능한 동작**: 컨텍스트 오염은 서버 측 동작이므로 클라이언트에서 감지하거나 제어할 수 없습니다
+
+## 교훈
+
+- **OAuth 세션 토큰은 "단순한 또 다른 API 키"가 아닙니다** — 서버 측 상태를 가지고 있으며, 재사용은 컨텍스트 공유를 의미합니다
+- **내부 서비스 호출은 독립적이고 무상태인 인증을 사용해야** 하며, 사용자 세션과의 연관을 피해야 합니다
+
+## 참고 자료
+
+- [Anthropic API Authentication Docs](https://docs.anthropic.com/en/api/getting-started)
+- [Claude Code Authentication](https://support.claude.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code)
+- [Anthropic Bans Subscription OAuth in Third-Party Apps](https://winbuzzer.com/2026/02/19/anthropic-bans-claude-subscription-oauth-in-third-party-apps-xcxwbn/)
+- [Claude Code Authentication: API Keys, Subscriptions, and SSO](https://developertoolkit.ai/en/claude-code/quick-start/authentication/)

package/concepts/no/BodyDiffJSON.md

@@ -0,0 +1,32 @@
+# Body Diff JSON (inkrementell sammenligning av forespørselskropp)
+
+## Bakgrunn
+
+MainAgent i Claude Code bruker en mekanisme for sending av full kontekst — hver forespørsel inneholder komplett samtalehistorikk, system prompt, verktøydefinisjoner osv. Dette betyr at forespørselskroppen blir stadig større etter hvert som samtalen skrider frem, og det er vanskelig å raskt finne ut "hva som faktisk er nytt i denne runden" ved å se på rå Body direkte.
+
+Body Diff JSON er laget for å løse dette problemet: den sammenligner automatisk to påfølgende MainAgent-forespørsler og trekker ut den inkrementelle delen, slik at du med ett blikk kan se hva som faktisk er nytt i denne forespørselen.
+
+## Virkemåte
+
+1. **Identifisere påfølgende MainAgent-forespørsler**: Gjeldende forespørsel må være av typen MainAgent, og det må finnes en tidligere MainAgent-forespørsel
+2. **Felt-for-felt-sammenligning**: Alle toppnivåfelt i forespørselskroppen gjennomgås, interne egenskaper med `_`-prefiks hoppes over
+3. **Smart differanseekstraksjon**:
+   - Nye felt: vises direkte
+   - Slettede felt: vises ikke (påvirker vanligvis ikke forståelsen)
+   - Endrede felt: gjeldende verdi vises
+   - Spesialhåndtering av `messages`-arrayen: bare nye meldinger vises (fordi normal samtale bruker tilleggsmodus, og prefiks-meldinger forblir uendret)
+4. **Deteksjon av krympet forespørselskropp**: Hvis gjeldende forespørselskropp er mindre enn den forrige, betyr det at kontekstavkorting eller sesjonstilbakestilling har skjedd, og da vises en informasjonsmelding i stedet for diff
+
+## Typiske scenarioer
+
+I en normal samtalerunde inneholder Body Diff JSON vanligvis:
+- `messages`: 1–2 nye meldinger (brukerens inndata + assistentens svar fra forrige runde)
+
+Hvis du ser endringer i felt som `system`, `tools` eller `model` i diffen, betyr det at en konfigurasjonsendring har skjedd i denne runden, noe som ofte er årsaken til cache-gjenoppbygging.
+
+## Bruk
+
+- Body Diff JSON vises i detaljpanelet for MainAgent-forespørselen
+- Klikk på tittelen for å utvide/skjule
+- Støtter JSON- og Text-visningsmodus, samt kopiering med ett klikk
+- I **CC-Viewer → Globale innstillinger** øverst til venstre kan du angi "Utvid Body Diff JSON som standard"

package/concepts/no/CacheRebuild.md

@@ -0,0 +1,40 @@
+# 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)
+
+## Visning i cc-viewer
+
+I forespørselslisten viser forespørsler med cache-gjenoppbygging en rød prikkindikator på cache-linjen. Tooltip vises ved musepeker med detaljert beskrivelse av gjenoppbyggingsårsaken (støtter 18 språk).

package/concepts/no/MainAgent.md

@@ -0,0 +1,30 @@
+# MainAgent
+
+## Definisjon
+
+MainAgent er hovedforespørselskjeden i Claude Code når den ikke er i agent team-modus. Hver interaksjon mellom brukeren og Claude Code produserer en serie API-forespørsler, der MainAgent-forespørslene utgjør den sentrale samtalekjeden — de bærer komplett system prompt, verktøydefinisjoner og meldingshistorikk.
+
+## Identifisering
+
+I cc-viewer identifiseres MainAgent gjennom `req.mainAgent === true`, som automatisk settes av `interceptor.js` ved forespørselsfangst.
+
+Bestemmelsesvilkår (alle må oppfylles):
+- Forespørselskroppen inneholder `system`-felt (system prompt)
+- Forespørselskroppen inneholder `tools`-array (verktøydefinisjoner)
+- System prompt inneholder "Claude Code"-kjennetekst
+
+## Forskjell fra SubAgent
+
+| Egenskap | MainAgent | SubAgent |
+|----------|-----------|----------|
+| system prompt | Komplett Claude Code hoved-prompt | Forenklet oppgavespesifikt prompt |
+| tools-array | Inneholder alle tilgjengelige verktøy | Inneholder vanligvis bare verktøy som trengs for oppgaven |
+| Meldingshistorikk | Akkumulerer full samtalekontekst | Inneholder bare meldinger relatert til deloppgaven |
+| Cache-oppførsel | Har prompt caching (5 minutters TTL) | Vanligvis ingen cache eller liten cache |
+
+## Betydning i cc-viewer
+
+- **Cache-sporing**: Prompt caching-status for MainAgent-forespørsler påvirker kostnadene direkte. Ved å overvåke forholdet mellom `cache_creation_input_tokens` og `cache_read_input_tokens` kan man vurdere cache-treffrate
+- **Analyse av cache-tap**: Når MainAgent-forespørsler viser store mengder cache creation (i stedet for cache read), betyr det at cachen er tapt og gjenoppbygget, og cc-viewer markerer disse forespørslene med en rød prikkindikator
+- **Hovedkjedeanalyse**: MainAgent-forespørselssekvensen gjenspeiler den komplette interaksjonsprosessen mellom brukeren og Claude Code, og er kjernedata for analyse av sesjonsatferd
+- **Sesjonsrekonstruksjon**: cc-viewer rekonstruerer samtalevisningen (Chat Mode) gjennom meldingshistorikken i MainAgent-forespørsler

package/concepts/no/Tool-AskUserQuestion.md

@@ -0,0 +1,54 @@
+# AskUserQuestion
+
+## Definisjon
+
+Stiller spørsmål til brukeren under utførelse, for å få avklaringer, verifisere antakelser eller be om beslutninger.
+
+## Parametere
+
+| Parameter | Type | Påkrevd | Beskrivelse |
+|-----------|------|---------|-------------|
+| `questions` | array | Ja | Spørsmålsliste (1–4 spørsmål) |
+| `answers` | object | Nei | Svar samlet inn fra brukeren |
+| `annotations` | object | Nei | Merknader for hvert spørsmål (f.eks. notater for forhåndsvisning av valg) |
+| `metadata` | object | Nei | Metadata for sporing og analyse |
+
+Hvert `question`-objekt:
+
+| Felt | Type | Påkrevd | Beskrivelse |
+|------|------|---------|-------------|
+| `question` | string | Ja | Fullstendig spørsmålstekst, bør ende med spørsmålstegn |
+| `header` | string | Ja | Kort etikett (maks 12 tegn), vises som etikett-chip |
+| `options` | array | Ja | 2–4 alternativer |
+| `multiSelect` | boolean | Ja | Om flervalg er tillatt |
+
+Hvert `option`-objekt:
+
+| Felt | Type | Påkrevd | Beskrivelse |
+|------|------|---------|-------------|
+| `label` | string | Ja | Visningstekst for alternativet (1–5 ord) |
+| `description` | string | Ja | Beskrivelse av alternativet |
+| `markdown` | string | Nei | Forhåndsvisningsinnhold (for visuell sammenligning av ASCII-layout, kodesnutter osv.) |
+
+## Bruksscenarioer
+
+**Egnet for bruk:**
+- Samle inn brukerpreferanser eller krav
+- Avklare tvetydige instruksjoner
+- Få beslutninger under implementering
+- Gi brukeren retningsvalg
+
+**Ikke egnet for bruk:**
+- Spørre "er planen OK?" — bruk ExitPlanMode
+
+## Merknader
+
+- Brukeren kan alltid velge "Other" for å gi egendefinert inndata
+- Anbefalt alternativ plasseres først, med "(Recommended)" lagt til på slutten av label
+- `markdown`-forhåndsvisning støttes kun for enkeltvalg-spørsmål
+- Alternativer med `markdown` bytter til side-ved-side-layout
+- I planleggingsmodus brukes dette til å avklare krav før planen fastsettes
+
+## Betydning i cc-viewer
+
+AskUserQuestion-kall vises i forespørselsloggen som `tool_use` content block, som inneholder spørsmåls- og alternativdefinisjoner. Brukerens svar vises i meldingshistorikken for påfølgende forespørsler.

package/concepts/no/Tool-Bash.md

@@ -0,0 +1,47 @@
+# Bash
+
+## Definisjon
+
+Kjører shell-kommandoer, med støtte for valgfri tidsavbrudd. Arbeidskatalogen vedvarer mellom kommandoer, men shell-tilstand (miljøvariabler osv.) vedvarer ikke.
+
+## Parametere
+
+| Parameter | Type | Påkrevd | Beskrivelse |
+|-----------|------|---------|-------------|
+| `command` | string | Ja | Bash-kommandoen som skal kjøres |
+| `description` | string | Nei | Kort beskrivelse av kommandoen |
+| `timeout` | number | Nei | Tidsavbrudd (millisekunder), maks 600000, standard 120000 |
+| `run_in_background` | boolean | Nei | Om den skal kjøres i bakgrunnen |
+
+## Bruksscenarioer
+
+**Egnet for bruk:**
+- git-operasjoner (commit, push, branch osv.)
+- npm/yarn og andre pakkebehandlingskommandoer
+- docker-operasjoner
+- Kompilerings- og byggekommandoer
+- Liste kataloginnhold (`ls`)
+- Andre systemkommandoer som krever shell-kjøring
+
+**Ikke egnet for bruk:**
+- Lese filer — bruk Read
+- Søke etter filnavn — bruk Glob
+- Søke i filinnhold — bruk Grep
+- Redigere filer — bruk Edit
+- Skrive filer — bruk Write
+- Vise informasjon til brukeren — skriv direkte i responsteksten
+- Langvarige prosesser (dev server, watch-modus) — anbefal brukeren å kjøre manuelt
+
+## Merknader
+
+- Stier med mellomrom må omsluttes med doble anførselstegn
+- Utdata over 30 000 tegn blir avkortet
+- Resultater fra bakgrunnskommandoer hentes via TaskOutput
+- Bruk helst absolutte stier, unngå `cd`
+- Uavhengige kommandoer kan kalle flere Bash parallelt
+- Avhengige kommandoer lenkes med `&&`
+- Shell-miljøet initialiseres fra brukerens profil (bash eller zsh)
+
+## Betydning i cc-viewer
+
+Bash-kall vises i forespørselsloggen som et par av `tool_use` (inneholder kommandoen) og `tool_result` (inneholder utdata) content blocks. Kommandoutdata kan brukes til å analysere modellens operasjonsatferd.

package/concepts/no/Tool-Edit.md

@@ -0,0 +1,38 @@
+# Edit
+
+## Definisjon
+
+Redigerer filer via nøyaktig strengerstatning. Erstatter `old_string` med `new_string` i filen.
+
+## Parametere
+
+| Parameter | Type | Påkrevd | Beskrivelse |
+|-----------|------|---------|-------------|
+| `file_path` | string | Ja | Absolutt sti til filen som skal endres |
+| `old_string` | string | Ja | Originalteksten som skal erstattes |
+| `new_string` | string | Ja | Ny tekst etter erstatning (må være forskjellig fra old_string) |
+| `replace_all` | boolean | Nei | Om alle treff skal erstattes, standard `false` |
+
+## Bruksscenarioer
+
+**Egnet for bruk:**
+- Endre spesifikke kodedeler i eksisterende filer
+- Fikse feil, oppdatere logikk
+- Gi nytt navn til variabler (med `replace_all: true`)
+- Alle scenarioer som krever nøyaktig endring av filinnhold
+
+**Ikke egnet for bruk:**
+- Opprette nye filer — bruk Write
+- Omfattende omskriving — kan kreve Write for å overskrive hele filen
+
+## Merknader
+
+- Filen må først leses via Read før bruk, ellers oppstår feil
+- `old_string` må være unik i filen, ellers mislykkes redigeringen. Hvis den ikke er unik, må du gi mer kontekst for å gjøre den unik, eller bruke `replace_all`
+- Behold original innrykk (tab/mellomrom) ved redigering av tekst, ikke inkluder linjenummerprefikset fra Read-utdata
+- Foretrekk å redigere eksisterende filer fremfor å opprette nye
+- `new_string` må være forskjellig fra `old_string`
+
+## Betydning i cc-viewer
+
+Edit-kall vises i forespørselsloggen som `tool_use` content block, der `input` inneholder `old_string` og `new_string`, som kan brukes til å spore hvilke endringer modellen har gjort i filer.

package/concepts/no/Tool-EnterPlanMode.md

@@ -0,0 +1,43 @@
+# EnterPlanMode
+
+## Definisjon
+
+Bytter Claude Code til planleggingsmodus, for å utforske kodebasen og designe løsninger før implementering.
+
+## Parametere
+
+Ingen parametere.
+
+## Bruksscenarioer
+
+**Egnet for bruk:**
+- Implementering av nye funksjoner — krever arkitekturbeslutninger
+- Det finnes flere mulige løsninger — krever brukervalg
+- Kodeendringer påvirker eksisterende atferd eller struktur
+- Endringer i flere filer — kan involvere mer enn 2–3 filer
+- Uklare krav — trenger utforskning først for å forstå omfanget
+- Brukerpreferanser er viktige — implementeringen kan ha flere rimelige retninger
+
+**Ikke egnet for bruk:**
+- Enkeltlinje- eller fålinjefikser (skrivefeil, åpenbare feil)
+- Brukeren har gitt svært spesifikke instruksjoner
+- Rene forsknings-/utforskningsoppgaver — bruk Task (Explore-type)
+
+## Atferd i planleggingsmodus
+
+Etter å ha gått inn i planleggingsmodus vil Claude Code:
+1. Bruke Glob-, Grep- og Read-verktøy for å utforske kodebasen grundig
+2. Forstå eksisterende mønstre og arkitektur
+3. Designe implementeringsplan
+4. Sende planen til brukeren for godkjenning
+5. Bruke AskUserQuestion for avklaring ved behov
+6. Gå ut via ExitPlanMode når planen er klar
+
+## Merknader
+
+- Dette verktøyet krever brukersamtykke for å gå inn i planleggingsmodus
+- Hvis du er usikker på om planlegging er nødvendig, foretrekk planlegging — å justere på forhånd er bedre enn å gjøre om
+
+## Betydning i cc-viewer
+
+EnterPlanMode-kall vises i forespørselsloggen som `tool_use` content block. Etter å ha gått inn i planleggingsmodus består forespørselssekvensene vanligvis hovedsakelig av utforskende verktøykall (Glob, Grep, Read), inntil ExitPlanMode kalles.

package/concepts/no/Tool-ExitPlanMode.md

@@ -0,0 +1,39 @@
+# ExitPlanMode
+
+## Definisjon
+
+Går ut av planleggingsmodus og sender planen til brukeren for godkjenning. Planinnholdet leses fra planfilen som ble skrevet tidligere.
+
+## Parametere
+
+| Parameter | Type | Påkrevd | Beskrivelse |
+|-----------|------|---------|-------------|
+| `allowedPrompts` | array | Nei | Liste over tillatelsesbeskrivelser som kreves for implementeringsplanen |
+
+Hvert element i `allowedPrompts`-arrayen:
+
+| Felt | Type | Påkrevd | Beskrivelse |
+|------|------|---------|-------------|
+| `tool` | enum | Ja | Gjeldende verktøy, for øyeblikket støttes kun `Bash` |
+| `prompt` | string | Ja | Semantisk beskrivelse av operasjonen (f.eks. "run tests", "install dependencies") |
+
+## Bruksscenarioer
+
+**Egnet for bruk:**
+- Planen er ferdig i planleggingsmodus og klar til å sendes for brukergodkjenning
+- Brukes kun for implementeringsoppgaver som krever kodeskriving
+
+**Ikke egnet for bruk:**
+- Rene forsknings-/utforskningsoppgaver — trenger ikke å gå ut av planleggingsmodus
+- Spørre "er planen OK?" — dette er nettopp funksjonen til dette verktøyet, ikke bruk AskUserQuestion for det
+
+## Merknader
+
+- Dette verktøyet aksepterer ikke planinnhold som parameter — det leser fra planfilen som ble skrevet tidligere
+- Brukeren vil se innholdet i planfilen for godkjenning
+- Ikke bruk AskUserQuestion før du kaller dette verktøyet for å spørre "er planen OK", det er overflødig
+- Ikke nevn "planen" i spørsmål, fordi brukeren ikke ser planinnholdet før ExitPlanMode
+
+## Betydning i cc-viewer
+
+ExitPlanMode-kall markerer slutten på planleggingsfasen. I forespørselsloggen går forespørslene etter dette kallet vanligvis over til implementeringsoperasjoner (Edit, Write, Bash osv.).

package/concepts/no/Tool-Glob.md

@@ -0,0 +1,34 @@
+# Glob
+
+## Definisjon
+
+Raskt filnavnmønstermatchingsverktøy som støtter kodebaser av enhver størrelse. Returnerer matchende filstier sortert etter endringstid.
+
+## Parametere
+
+| Parameter | Type | Påkrevd | Beskrivelse |
+|-----------|------|---------|-------------|
+| `pattern` | string | Ja | Glob-mønster (f.eks. `**/*.js`, `src/**/*.ts`) |
+| `path` | string | Nei | Søkekatalog, standard er gjeldende arbeidskatalog. Ikke send "undefined" eller "null" |
+
+## Bruksscenarioer
+
+**Egnet for bruk:**
+- Søke etter filer med filnavnmønster
+- Finne alle filer av en bestemt type (f.eks. alle `.tsx`-filer)
+- Lokalisere filer når du søker etter en bestemt klassedefinisjon (f.eks. `class Foo`)
+- Kan starte flere Glob-kall parallelt i en enkelt melding
+
+**Ikke egnet for bruk:**
+- Søke i filinnhold — bruk Grep
+- Åpen utforskning som krever flere søkerunder — bruk Task (Explore-type)
+
+## Merknader
+
+- Støtter standard glob-syntaks: `*` matcher ett nivå, `**` matcher flere nivåer, `{}` matcher flere valg
+- Resultater sortert etter endringstid
+- Anbefales fremfor `find`-kommandoen i Bash
+
+## Betydning i cc-viewer
+
+Glob-kall vises i forespørselsloggen som et par av `tool_use` / `tool_result` content blocks. `tool_result` inneholder listen over matchende filstier.