cx-viewer 1.0.0

package/concepts/ko/UltraPlan.md

@@ -0,0 +1,55 @@
+# UltraPlan — 궁극의 소원 머신
+
+## UltraPlan이란
+
+UltraPlan은 Claude Code의 네이티브 `/ultraplan` 명령에 대한 cc-viewer의 **현지화 구현**입니다. Claude의 공식 원격 서비스를 실행할 필요 없이 로컬 환경에서 `/ultraplan`의 전체 기능을 사용할 수 있으며, Claude Code가 **멀티 에이전트 협업**으로 복잡한 계획 및 구현 작업을 수행하도록 안내합니다.
+
+일반 Plan 모드나 Agent Team과 비교하여 UltraPlan은 다음이 가능합니다:
+- 작업 복잡도를 자동 평가하고 최적의 계획 전략을 선택
+- 여러 병렬 에이전트를 배치하여 다양한 차원에서 코드베이스를 탐색
+- 외부 리서치(webSearch)를 통합하여 업계 모범 사례를 참조
+- 계획 실행 후 자동으로 Code Review Team을 구성하여 코드 리뷰 수행
+- 완전한 **Plan → Execute → Review → Fix** 폐쇄 루프를 형성
+
+---
+
+## 중요 참고사항
+
+### 1. UltraPlan은 만능이 아닙니다
+UltraPlan은 더 강력한 소원 머신이지만, 모든 소원이 이루어지는 것은 아닙니다. Plan과 Agent Team보다 강력하지만 직접 "돈을 벌어주지"는 못합니다. 합리적인 작업 단위를 고려하세요 — 큰 목표를 실행 가능한 중간 규모의 작업으로 분할하고, 한 번에 모든 것을 달성하려 하지 마세요.
+
+### 2. 현재 프로그래밍 프로젝트에 가장 효과적
+UltraPlan의 템플릿과 워크플로우는 프로그래밍 프로젝트에 깊이 최적화되어 있습니다. 다른 시나리오(문서 작성, 데이터 분석 등)도 시도할 수 있지만, 향후 버전의 적응을 기다리는 것이 좋습니다.
+
+### 3. 실행 시간 및 컨텍스트 윈도우 요구사항
+- 성공적인 UltraPlan 실행에는 일반적으로 **30분 이상**이 소요됩니다
+- MainAgent에 큰 컨텍스트 윈도우가 필요합니다 (1M context Opus 모델 권장)
+- 200K 모델만 있는 경우, **실행 전에 반드시 `/clear`로 컨텍스트를 정리하세요**
+- Claude Code의 `/compact`는 컨텍스트 윈도우가 부족하면 성능이 저하됩니다 — 공간이 소진되지 않도록 주의하세요
+- 충분한 컨텍스트 공간을 유지하는 것이 UltraPlan 성공 실행의 핵심 전제 조건입니다
+
+현지화된 UltraPlan에 대한 질문이나 제안이 있으시면 [GitHub Issues](https://github.com/anthropics/claude-code/issues)에서 자유롭게 토론에 참여해 주세요.
+
+---
+
+## 작동 방식
+
+UltraPlan은 두 가지 작동 모드를 제공합니다:
+
+### 자동 모드
+작업 복잡도(점수 4-12)를 자동 분석하여 다른 전략으로 라우팅합니다:
+
+| 경로 | 점수 | 전략 |
+|------|------|------|
+| 경로 A | 4-6 | 경량 계획과 직접적인 코드 탐색 |
+| 경로 B | 7-9 | 구조 다이어그램(Mermaid / ASCII)을 포함한 계획 |
+| 경로 C | 10-12 | 멀티 에이전트 탐색 + 리뷰 폐쇄 루프 |
+
+### 강제 모드
+전체 경로 C 멀티 에이전트 워크플로우를 직접 활성화합니다:
+1. 최대 5개의 병렬 에이전트를 배치하여 코드베이스를 동시에 탐색 (아키텍처, 파일 식별, 위험 평가 등)
+2. 선택적으로 리서치 에이전트를 배치하여 webSearch로 업계 솔루션 조사
+3. 모든 에이전트의 조사 결과를 종합하여 상세한 구현 계획으로 정리
+4. 리뷰 에이전트를 배치하여 여러 관점에서 계획을 면밀히 검토
+5. 승인 후 계획을 실행
+6. 구현 완료 후 자동으로 Code Review Team을 구성하여 코드 품질 검증

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/BodyFields.md

@@ -0,0 +1,42 @@
+# Beskrivelse av Request Body-felt
+
+Beskrivelse av toppnivåfeltene i Claude API `/v1/messages` request body.
+
+## Feltliste
+
+| Felt | Type | Beskrivelse |
+|------|------|------|
+| **model** | string | Navnet på modellen som brukes, f.eks. `claude-opus-4-6`, `claude-sonnet-4-6` |
+| **messages** | array | Samtalens meldingshistorikk. Hver melding inneholder `role` (user/assistant) og `content` (et block-array med tekst, bilder, tool_use, tool_result osv.) |
+| **system** | array | System prompt. Inneholder Codexs kjerneinstruksjoner, veiledning for verktøybruk, miljøinformasjon, CLAUDE.md-innhold m.m. Blokker med `cache_control` blir cachet via prompt caching |
+| **tools** | array | Liste over tilgjengelige verktøydefinisjoner. Hvert verktøy inneholder `name`, `description` og `input_schema` (JSON Schema). MainAgent har vanligvis 20+ verktøy, SubAgent har bare noen få |
+| **metadata** | object | Request-metadata, inneholder vanligvis `user_id` for brukeridentifikasjon |
+| **max_tokens** | number | Maksimalt antall tokens i et enkelt modellsvar, f.eks. `16000`, `64000` |
+| **thinking** | object | Konfigurasjon for utvidet tenkning. `type: "enabled"` aktiverer tenkemodus, `budget_tokens` styrer øvre grense for tenke-tokens |
+| **context_management** | object | Konfigurasjon for kontekststyring. `truncation: "auto"` lar Codex automatisk avkorte for lange meldingshistorikker |
+| **output_config** | object | Utdatakonfigurasjon, f.eks. `format`-innstillinger |
+| **stream** | boolean | Om strømmende svar er aktivert. Codex bruker alltid `true` |
+
+## messages-struktur
+
+Hver meldings `content` er et block-array med vanlige typer:
+
+- **text**: Vanlig tekstinnhold
+- **tool_use**: Modellen kaller et verktøy (inneholder `name`, `input`)
+- **tool_result**: Resultatet av verktøyutførelse (inneholder `tool_use_id`, `content`)
+- **image**: Bildeinnhold (base64 eller URL)
+- **thinking**: Modellens tenkeprosess (utvidet tenkemodus)
+
+## system-struktur
+
+System prompt-arrayet inneholder vanligvis:
+
+1. **Kjerne-agent-instruksjoner** ("You are Codex...")
+2. **Regler for verktøybruk**
+3. **CLAUDE.md-innhold** (prosjektspesifikke instruksjoner)
+4. **Ferdighetspåminnelser** (skills reminder)
+5. **Miljøinformasjon** (OS, shell, git-status osv.) — Codex er faktisk svært avhengig av git. Hvis prosjektet har et git-repository, kan Codex vise bedre forståelse av prosjektet, inkludert henting av fjernendringer og commit-historikk for analyse
+
+Blokker merket med `cache_control: { type: "ephemeral" }` caches av Anthropic API i 5 minutter. Ved cache-treff faktureres de som `cache_read_input_tokens` (betydelig billigere enn `input_tokens`).
+
+> **Merk**: For spesialiserte klienter som Codex er Anthropic-serveren faktisk ikke fullstendig avhengig av `cache_control`-attributten i requesten for å bestemme cacheoppførsel. Serveren anvender automatisk cachestrategier for bestemte felt (som system prompt og tools-definisjoner), selv når requesten ikke eksplisitt inneholder `cache_control`-merking. Derfor trenger du ikke undre deg når du ikke ser denne attributten i request body — serveren har allerede utført cacheoperasjonen bak kulissene, men viser det bare ikke til klienten. Det er en stilltiende avtale mellom Codex og Anthropic API.

package/concepts/no/CacheRebuild.md

@@ -0,0 +1,36 @@
+# 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/GlobalSettings.md

@@ -0,0 +1,232 @@
+# CC-Viewer 全局配置参考
+
+## 一、全局设置面板（UI）
+
+通过左上角菜单 → "全局设置" 打开。
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| 过滤无关请求 | 开关 | 开 | 隐藏心跳、count_tokens、子代理等非主代理请求 |
+| 默认展开 Body Diff JSON | 开关 | 关 | 请求详情面板中的 Body Diff 区域默认展开 |
+| 日志目录设置 | 文本输入 | `~/.claude/cc-viewer` | 项目日志的读写根目录，支持 `~/` 展开。修改后回车或失焦保存，立即生效 |
+
+## 二、显示设置面板（UI）
+
+通过左上角菜单 → "显示设置" 打开。
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| 折叠工具结果 | 开关 | 开 | 聊天视图中折叠工具调用结果块 |
+| 展开思考过程 | 开关 | 开 | 默认展开 Claude 的思考/推理过程块 |
+| 完整展示所有内容 | 开关 | 关 | 显示完整的工具调用内容，不截断 |
+| 自动恢复会话 | 开关 + 选项 | 关 | 遇到会话恢复提示时自动选择：`继续` 或 `新建` |
+
+## 三、偏好设置文件
+
+所有 UI 设置持久化到 `<日志目录>/preferences.json`，通过 `/api/preferences` 接口读写。
+
+```json
+{
+  "lang": "zh",
+  "filterIrrelevant": true,
+  "expandDiff": false,
+  "collapseToolResults": true,
+  "expandThinking": true,
+  "showFullToolContent": false,
+  "logDir": "~/.claude/cc-viewer",
+  "resumeAutoChoice": null,
+  "disabledPlugins": [],
+  "presetShortcuts": []
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `lang` | string | 界面语言（zh/en/zh-TW/ko/ja/de/es/fr/it/da/pl/ru/ar/no/pt-BR/th/tr/uk） |
+| `filterIrrelevant` | boolean | 过滤无关请求 |
+| `expandDiff` | boolean | 默认展开 Body Diff JSON |
+| `collapseToolResults` | boolean | 折叠工具结果 |
+| `expandThinking` | boolean | 展开思考过程 |
+| `showFullToolContent` | boolean | 完整展示内容 |
+| `logDir` | string | 日志目录路径 |
+| `resumeAutoChoice` | null / "continue" / "new" | 自动恢复会话选择 |
+| `disabledPlugins` | string[] | 已禁用的插件文件名列表 |
+| `presetShortcuts` | array | Agent Team 快捷指令预设 |
+
+## 四、环境变量
+
+### CC-Viewer 专有
+
+| 变量名 | 默认值 | 说明 |
+|--------|--------|------|
+| `CCV_LOG_DIR` | `~/.claude/cc-viewer` | 日志存储根目录。特殊值：`tmp`/`temp` 使用系统临时目录 |
+| `CCV_CLI_MODE` | 未设置 | `=1` 启用 CLI 模式（PTY 终端） |
+| `CCV_SDK_MODE` | 未设置 | `=1` 启用 Agent SDK 模式（无终端） |
+| `CCV_WORKSPACE_MODE` | 未设置 | `=1` 启用工作空间选择模式 |
+| `CCV_PROJECT_DIR` | `process.cwd()` | 项目工作目录，用于文件操作和 Git 命令 |
+| `CCV_PROXY_PORT` | 未设置 | 本地 MITM 代理端口 |
+| `CCV_BYPASS_PERMISSIONS` | 未设置 | `=1` 跳过工具权限审批（配合 `--dangerously-skip-permissions`） |
+| `CCV_DISABLE_DELTA` | 未设置 | `=1` 禁用增量日志存储，每次写入完整消息 |
+| `CCV_DEBUG` | 未设置 | `=1` 启用 HTTP 代理调试日志 |
+| `CCV_DEBUG_PLUGINS` | 未设置 | `=1` 启用插件加载调试日志 |
+
+### 内部 IPC
+
+| 变量名 | 说明 |
+|--------|------|
+| `CCVIEWER_PORT` | 服务端口，供 ask-bridge/perm-bridge 通信 |
+| `CCV_EDITOR_PORT` | 服务端口，供 ccv-editor 文件编辑桥接 |
+
+### 外部变量（读取）
+
+| 变量名 | 说明 |
+|--------|------|
+| `ANTHROPIC_BASE_URL` | 自定义 Anthropic API 地址 |
+| `SHELL` | 用户 Shell（PTY 启动和 Shell 配置检测） |
+| `http_proxy` / `HTTPS_PROXY` 等 | HTTP 代理配置（通过 undici EnvHttpProxyAgent） |
+
+## 五、CLI 命令参数
+
+```
+ccv [选项] [claude 参数...]
+```
+
+### CC-Viewer 专有选项
+
+| 参数 | 说明 |
+|------|------|
+| `-logger` | 安装/修复 Claude Code hooks |
+| `--uninstall` / `-uninstall` | 卸载所有 CC-Viewer 集成 |
+| `--help` / `-h` / `help` | 显示帮助信息 |
+| `--version` / `-v` | 显示版本号 |
+| `-SDK` / `--sdk` | 使用 Agent SDK 模式 |
+| `--d` | `--dangerously-skip-permissions` 简写 |
+| `--ad` | `--allow-dangerously-skip-permissions` 简写 |
+| `run` | 通过代理运行命令（`ccv run -- claude ...`） |
+
+### Claude 透传参数（常用）
+
+| 参数 | 说明 |
+|------|------|
+| `-c` / `--continue` | 继续上一次会话 |
+| `-r` / `--resume` | 恢复指定会话 |
+| `-p` / `--print` | 非交互式输出 |
+| `--model` | 指定模型 |
+| `--permission-mode` | 权限模式 |
+| `--system-prompt` | 自定义系统提示词 |
+| `--max-budget-usd` | 最大预算 |
+
+## 六、Hook 配置
+
+CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中：
+
+### 1. AskUserQuestion 桥接
+- **匹配器**: `"AskUserQuestion"`
+- **命令**: `node <安装目录>/lib/ask-bridge.js`
+- **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
+
+### 2. 权限审批桥接
+- **匹配器**: `""` (空 = 匹配所有工具)
+- **命令**: `node <安装目录>/lib/perm-bridge.js`
+- **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
+
+## 七、Shell 集成
+
+CC-Viewer 在 `~/.zshrc`（或 `.bashrc`）中注入 `claude()` 函数：
+
+```bash
+# >>> CC-Viewer Auto-Inject >>>
+claude() { ... }
+# <<< CC-Viewer Auto-Inject <<<
+```
+
+所有 `claude` 命令自动通过 CC-Viewer 代理，实现日志捕获和 Web UI 功能。
+
+卸载：`ccv --uninstall` 或手动删除标记之间的内容。
+
+## 八、代理配置（Proxy Profile）
+
+存储在 `<日志目录>/profile.json`，通过 UI 的"代理切换"面板管理。
+
+```json
+{
+  "active": "max",
+  "profiles": [
+    { "id": "max", "name": "Default" },
+    { "id": "my-proxy", "name": "自定义", "baseURL": "https://...", "apiKey": "sk-..." }
+  ]
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| `active` | 当前激活的配置 ID（`"max"` = 直连，无代理） |
+| `id` | 唯一标识 |
+| `name` | 显示名称 |
+| `baseURL` | 代理 API 地址（替换请求 origin） |
+| `apiKey` | 代理 API 密钥（替换认证头） |
+| `models` | 可用模型列表 |
+| `activeModel` | 当前选中的模型 |
+
+## 九、插件系统
+
+插件目录：`<日志目录>/plugins/`
+
+### 支持的 Hook 类型
+
+| Hook | 类型 | 说明 |
+|------|------|------|
+| `httpsOptions` | 瀑布 | 提供 HTTPS 证书（返回 `{ cert, key }` 或 `{ pfx }`） |
+| `localUrl` | 瀑布 | 修改本地访问 URL |
+| `serverStarted` | 并行 | 服务器启动通知 |
+| `serverStopping` | 并行 | 服务器停止通知 |
+| `onNewEntry` | 并行 | 新日志条目写入通知 |
+
+插件启用/禁用通过 `preferences.json` 的 `disabledPlugins` 数组管理。
+
+## 十、目录结构
+
+```
+~/.claude/cc-viewer/               # 日志根目录
+├── preferences.json               # 用户偏好设置
+├── workspaces.json                # 工作空间注册表
+├── profile.json                   # 代理配置
+├── plugins/                       # 插件目录
+│   └── my-plugin.js
+├── <项目名>/                       # 每个项目的日志目录
+│   ├── <项目名>_20260404_123456.jsonl  # JSONL 日志文件
+│   ├── <项目名>.json              # 统计数据（后台生成）
+│   └── images/                    # 上传图片的持久副本
+└── ...
+
+/tmp/cc-viewer-uploads/            # 临时上传文件目录
+```
+
+## 十一、服务器配置
+
+| 配置 | 值 | 说明 |
+|------|-----|------|
+| 端口范围 | 7008-7099 | 自动扫描可用端口 |
+| 绑定地址 | 0.0.0.0 | 所有网络接口 |
+| 访问令牌 | 随机 16 字节 hex | 局域网访问需要 `?token=xxx`，本机免认证 |
+| HTTPS | 仅通过插件 | 需要插件提供 `httpsOptions` hook |
+| CORS | `*` | 允许所有来源 |
+| 上传限制 | 50MB | 单文件最大上传大小 |
+
+## 十二、URL 参数
+
+| 参数 | 说明 |
+|------|------|
+| `?token=xxx` | 局域网访问认证令牌 |
+| `?logfile=path` | 打开指定历史日志文件（只读模式） |
+
+## 十三、localStorage 配置
+
+| 键 | 说明 |
+|-----|------|
+| `cxv_cacheExpireAt` | 缓存倒计时到期时间 |
+| `cxv_cacheType` | 缓存类型标签 |
+| `ccv_sseSlim` | 启用 SSE 增量裁剪（桌面端性能优化） |
+| `ccv_calibrationModel` | KV-Cache 上下文窗口校准模型 |
+| `ccv_fileExplorerOpen` | 文件浏览器面板开关 |
+| `cc-viewer-terminal-width` | 终端面板宽度（像素） |

package/concepts/no/KVCacheContent.md

@@ -0,0 +1,49 @@
+# 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

package/concepts/no/MainAgent.md

@@ -0,0 +1,23 @@
+# 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 |

package/concepts/no/ProxySwitch.md

@@ -0,0 +1,50 @@
+# Hot-Switch Proxy
+
+## Overview
+
+Hot-Switch Proxy lets you dynamically redirect API requests to a different endpoint without restarting Claude Code. This is useful when using third-party API proxy services.
+
+> ⚠️ Do not use this feature if you are a Claude Max subscriber.
+
+## Fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| **Name** | ✅ | Display name for this proxy, used to identify it |
+| **Base URL** | ✅ | Base URL of the API service (e.g. `https://api.example.com`). The original request origin will be replaced |
+| **API Key** | ✅ | API key for the proxy service, replaces the original authentication |
+| **Models** | ❌ | Comma-separated list of models supported by this proxy (e.g. `model-a, model-b`) |
+| **Active Model** | ❌ | Select the active model from the list. The `model` field in requests will be replaced |
+
+## How It Works
+
+When a proxy is active, `interceptor.js` performs the following before each API request:
+
+1. **URL Rewrite** — Replaces the request origin with the proxy's Base URL
+2. **Auth Replace** — Replaces `x-api-key` or `Authorization` header with the proxy's API Key
+3. **Model Replace** — If an active model is set, replaces the `model` field in the request body
+
+## Config File
+
+Configuration is stored at `~/.claude/cc-viewer/profile.json`. Click the folder icon in the title to open the directory:
+
+```json
+{
+  "active": "my-proxy",
+  "profiles": [
+    { "id": "max", "name": "Max" },
+    {
+      "id": "my-proxy",
+      "name": "My Proxy",
+      "baseURL": "https://api.example.com",
+      "apiKey": "sk-xxx",
+      "models": ["model-a", "model-b"],
+      "activeModel": "model-a"
+    }
+  ]
+}
+```
+
+- `active` — ID of the current profile. Set to `"max"` for direct connection (no proxy)
+- `profiles` — Profile list. `id: "max"` is built-in and cannot be deleted
+- Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed

package/concepts/no/QRCode.md

@@ -0,0 +1,25 @@
+# Mobil QR-kode tilgang
+
+## Slik fungerer det
+
+CC Viewer starter en HTTP-server og genererer en **LAN-adresse** (f.eks. `http://192.168.1.100:7008`). Skann QR-koden for å få tilgang til Claude Code fra telefonen via det samme WiFi-nettverket.
+
+## Hvorfor kan jeg ikke koble til?
+
+1. **Ikke på samme nettverk** — Telefon og datamaskin må være på samme WiFi (samme ruter/samme nettverksnavn)
+2. **Brannmur-blokkering** — Systemets brannmur kan blokkere innkommende tilkoblinger
+3. **Bedriftsnettverk-isolasjon** — AP-isolasjon kan hindre kommunikasjon mellom enheter
+4. **VPN-forstyrrelse** — En VPN kan forstyrre nettverksruten
+
+## Sikkerhetsadvarsel
+
+> ⚠️ CC Viewers LAN-tjeneste er tilgjengelig for alle enheter på samme nettverk.
+
+- Vær forsiktig på **offentlig WiFi**
+- CC Viewer bruker **token-autentisering** for å beskytte LAN-tilgang
+- Anbefales å bruke på pålitelige nettverk
+
+## Utenfor LAN
+
+- **Tunnelverktøy** — frp, ngrok, Tailscale osv.
+- **CC Viewer plugins** — Konfigurer proxy-mellomvare via plugin-systemet

package/concepts/no/ResponseFields.md

@@ -0,0 +1,50 @@
+# Feltbeskrivelse for Response Body
+
+Feltbeskrivelse for responskroppen i Claude API `/v1/messages`.
+
+## Toppnivåfelter
+
+| Felt | Type | Beskrivelse |
+|------|------|------|
+| **model** | string | Det faktiske modellnavnet, f.eks. `claude-opus-4-6` |
+| **id** | string | Unik identifikator for dette svaret, f.eks. `msg_01Tgsr2QeH8AVXGoP2wAXRvU` |
+| **type** | string | Fast verdi `"message"` |
+| **role** | string | Fast verdi `"assistant"` |
+| **content** | array | Array med innholdsblokker fra modellens utdata, inkludert tekst, verktøykall, tenkeprosess m.m. |
+| **stop_reason** | string | Stoppårsak: `"end_turn"` (normal avslutning), `"tool_use"` (verktøy må utføres), `"max_tokens"` (token-grense nådd) |
+| **stop_sequence** | string/null | Sekvensen som utløste stopp, vanligvis `null` |
+| **usage** | object | Statistikk over tokenforbruk (se nedenfor) |
+
+## content-blokktyper
+
+| Type | Beskrivelse |
+|------|------|
+| **text** | Modellens tekstsvar, inneholder feltet `text` |
+| **tool_use** | Forespørsel om verktøykall, inneholder `name` (verktøynavn), `input` (parametere), `id` (kall-ID, brukes til å matche tool_result) |
+| **thinking** | Utvidet tenkeinnhold (vises kun når thinking-modus er aktivert), inneholder feltet `thinking` |
+
+## Detaljer om usage-feltet
+
+| Felt | Beskrivelse |
+|------|------|
+| **input_tokens** | Antall input-tokens uten cache-treff (faktureres til full pris) |
+| **cache_creation_input_tokens** | Antall tokens som ble cachet i denne forespørselen (cache-skriving, faktureres høyere enn vanlig input) |
+| **cache_read_input_tokens** | Antall tokens med cache-treff (cache-lesing, faktureres vesentlig lavere enn vanlig input) |
+| **output_tokens** | Antall tokens i modellens utdata |
+| **service_tier** | Tjenestenivå, f.eks. `"standard"` |
+| **inference_geo** | Inferensregion, f.eks. `"not_available"` betyr at regionsinformasjon ikke er tilgjengelig |
+
+## cache_creation-underfelt
+
+| Felt | Beskrivelse |
+|------|------|
+| **ephemeral_5m_input_tokens** | Antall tokens for korttids-cacheoppretting med 5 minutters TTL |
+| **ephemeral_1h_input_tokens** | Antall tokens for langtids-cacheoppretting med 1 times TTL |
+
+> **Om cache-fakturering**: Enhetsprisen for `cache_read_input_tokens` er vesentlig lavere enn for `input_tokens`, mens enhetsprisen for `cache_creation_input_tokens` er noe høyere enn vanlig input. Derfor kan en høy cache-treffrate i pågående samtaler redusere kostnadene betydelig. Via "treffrate"-metrikken i cc-viewer kan du enkelt overvåke dette forholdet.
+
+## Betydningen av stop_reason
+
+- **end_turn**: Modellen har fullført svaret normalt
+- **tool_use**: Modellen må kalle et verktøy, og content vil inneholde en `tool_use`-blokk. I neste forespørsel må `tool_result` legges til i messages for å fortsette samtalen
+- **max_tokens**: `max_tokens`-grensen er nådd og svaret er avkortet, det kan være ufullstendig

package/concepts/no/SubAgent-Search.md

@@ -0,0 +1,20 @@
+# SubAgent: Search
+
+## Definisjon
+
+Search er en sub-agent-type som startes av Claude Codes hovedagent for å utføre søk i kodebasen. Den kjører målrettede fil- og innholdssøk ved hjelp av verktøy som Glob, Grep og Read, og returnerer deretter resultatene til overordnet agent.
+
+## Atferd
+
+- Startes automatisk når hovedagenten trenger å søke i eller utforske kodebasen
+- Kjører i en isolert kontekst med lesetilgang
+- Bruker Glob for filnønsamsvar, Grep for innholdssøk og Read for filinspeksjon
+- Returnerer søkeresultater til overordnet agent for videre behandling
+
+## Når det vises
+
+Search sub-agenter vises typisk når:
+
+1. Hovedagenten trenger å finne bestemte filer, funksjoner eller kodemønstre
+2. En bred kodebaseutforskning er forespurt av brukeren
+3. Agenten undersøker avhengigheter, referanser eller bruksmønstre

package/concepts/no/Teammate.md

@@ -0,0 +1,26 @@
+# Teammate
+
+## Definisjon
+
+Teammate er en samarbeidende agent i Claude Code Agent Team-modus. Når hovedagenten oppretter et team via `TeamCreate` og genererer teammates ved hjelp av `Agent`-verktøyet, kjører hver teammate som en uavhengig agentprosess med sitt eget kontekstvindu og verktøysett, og kommuniserer med teammedlemmer via `SendMessage`.
+
+## Forskjeller fra SubAgent
+
+| Egenskap | Teammate | SubAgent |
+|----------|----------|----------|
+| Livssyklus | Vedvarende, kan motta flere meldinger | Engangsoppgave, destrueres etter fullførelse |
+| Kommunikasjon | SendMessage toveismeldinger | Forelder→barn enveiskall, returnerer resultat |
+| Kontekst | Uavhengig fullstendig kontekst, bevares på tvers av runder | Isolert oppgavekontekst |
+| Samarbeidsmodell | Teamsamarbeid, kan kommunisere innbyrdes | Hierarkisk struktur, interagerer kun med foreldreagent |
+| Oppgavetype | Komplekse flertrinnsoppgaver | Enkeltoppgaver som søk og utforskning |
+
+## Atferd
+
+- Opprettes av hovedagenten (team lead) via `Agent`-verktøyet og tildeles et `team_name`
+- Deler oppgaveliste via `TaskList` / `TaskGet` / `TaskUpdate`
+- Går i idle-tilstand etter hver utførelsesrunde og venter på å bli vekket av nye meldinger
+- Kan avsluttes elegant via `shutdown_request`
+
+## Forklaring av statistikkpanelet
+
+Teammate-statistikkpanelet viser antall API-kall for hver teammate. Kolonnen `Name` er teammate-navnet (f.eks. `reviewer-security`, `reviewer-pipeline`), og kolonnen `Antall` er det totale antallet API-forespørsler generert av den aktuelle teammatien.