cx-viewer 1.0.0

package/concepts/tr/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/tr/KVCacheContent.md

@@ -0,0 +1,49 @@
+# KV-Cache Önbellek İçeriği
+
+## Prompt Caching Nedir?
+
+Claude ile sohbet ettiğinizde, her API isteği tam konuşma bağlamını (system prompt + araç tanımları + geçmiş mesajlar) gönderir. Anthropic'in prompt caching mekanizması, daha önce hesaplanmış önek içeriğini sunucuda önbelleğe alır; sonraki isteklerde önek aynıysa, önbellek sonuçları doğrudan yeniden kullanılır ve tekrarlanan hesaplamalar atlanır, bu da gecikmeyi ve maliyeti büyük ölçüde azaltır.
+
+cc-viewer'da bu mekanizma "KV-Cache" olarak adlandırılır ve Anthropic API düzeyindeki prompt caching'e karşılık gelir; LLM içindeki transformer dikkat katmanlarının key-value cache'i değildir.
+
+## Önbellek Nasıl Çalışır
+
+Anthropic'in prompt caching özelliği, önbellek anahtarlarını sabit bir sırayla birleştirir:
+
+```
+Tools → System Prompt → Messages (cache breakpoint'e kadar)
+```
+
+Bu önek, TTL penceresi içindeki herhangi bir önceki istekle tamamen aynı olduğu sürece, API önbelleği vurur (`cache_read_input_tokens` döndürür) ve yeniden hesaplama yapmaz (`cache_creation_input_tokens`).
+
+> **Claude Code `cache_control` özelliğine sıkı sıkıya bağlı değildir; sunucu bu özelliklerin bir kısmını kaldırarak iş birliği yapar, ancak yine de önbelleği başarıyla oluşturabilir. Bu nedenle `cache_control` özelliğini görmemek, önbelleğe alınmadığı anlamına gelmez**
+>
+> Claude Code gibi özel istemciler için, Anthropic sunucusu önbellek davranışını belirlemek için istekteki `cache_control` özelliğine tamamen bağımlı değildir. Sunucu, belirli alanlar (system prompt, araç tanımları gibi) için otomatik olarak önbellek politikası uygular; istekte açıkça `cache_control` etiketi olmasa bile. Bu nedenle, istek gövdesinde bu özelliği görmediğinizde şaşırmayın — sunucu arka planda önbellek işlemini zaten tamamlamıştır, sadece bu bilgiyi istemciye açıklamamıştır. Bu, Claude Code ile Anthropic API arasındaki örtük bir anlaşmadır.
+
+## "Mevcut KV-Cache Önbellek İçeriği" Nedir?
+
+cc-viewer'da gösterilen "Mevcut KV-Cache Önbellek İçeriği", en son MainAgent isteğinden çıkarılan ve önbellek sınırının (cache breakpoint) öncesinde yer alan içeriktir. Özellikle şunları içerir:
+
+- **System Prompt**: Claude Code'un sistem talimatları; temel agent talimatları, araç kullanım kuralları, CLAUDE.md proje talimatları, ortam bilgisi vb. dahil
+- **Tools**: Mevcut kullanılabilir araç tanımlarının listesi (Read, Write, Bash, Agent, MCP araçları vb.)
+- **Messages**: Konuşma geçmişinin önbelleğe alınan kısmı (genellikle daha eski mesajlar, son `cache_control` etiketine kadar)
+
+## Neden Önbellek İçeriğini Görüntülemelisiniz?
+
+1. **Bağlamı Anlama**: Claude'un şu anda "hatırladığı" içeriği bilin ve davranışının beklentilerinize uygun olup olmadığını değerlendirmenize yardımcı olun
+2. **Maliyet Optimizasyonu**: Önbellek isabetlerinin maliyeti yeniden hesaplamadan çok daha düşüktür. Önbellek içeriğini görüntülemek, belirli isteklerin neden önbellek yeniden oluşturmayı (cache rebuild) tetiklediğini anlamanıza yardımcı olur
+3. **Konuşma Hata Ayıklama**: Claude'un yanıtı beklentilerinize uymadığında, önbellek içeriğini kontrol ederek system prompt ve geçmiş mesajların doğru olduğunu onaylayabilirsiniz
+4. **Bağlam Kalitesi İzleme**: Hata ayıklama, yapılandırma değiştirme veya prompt ayarlama sırasında, KV-Cache-Text merkezi bir bakış açısı sağlar ve temel bağlamın bozulmadığını ya da beklenmedik içerikle kirlenmediğini hızlıca doğrulamanıza yardımcı olur — orijinal mesajları tek tek gözden geçirmeye gerek kalmadan
+
+## Çok Katmanlı Önbellek Stratejisi
+
+Claude Code'a karşılık gelen KV-Cache tek bir kopyadan ibaret değildir. Sunucu, Tools ve System Prompt için Messages kısmından bağımsız olarak ayrı önbellekler oluşturur. Bu tasarımın avantajı şudur: mesaj yığınında karışıklık olduğunda (bağlam kısaltma, mesaj değiştirme vb.) yeniden oluşturma gerektiğinde, Tools ve System Prompt önbelleği de birlikte geçersiz olmaz ve tüm yeniden hesaplama önlenir.
+
+Bu, mevcut aşamada sunucu tarafındaki bir optimizasyon stratejisidir — çünkü araç tanımları ve System Prompt normal kullanım sırasında oldukça kararlıdır ve nadiren değişir; bunları ayrı ayrı önbelleğe almak gereksiz yeniden oluşturma maliyetini en aza indirir. Bu nedenle önbelleği gözlemlediğinizde, Tools yeniden oluşturmanın tüm önbelleğin yeniden yüklenmesini gerektirmesi dışında, System Prompt ve Messages hasarının hâlâ miras alınabilir bir önbellek bıraktığını fark edeceksiniz.
+
+## Önbelleğin Yaşam Döngüsü
+
+- **Oluşturma**: İlk istekte veya önbellek sona erdikten sonra, API yeni bir önbellek oluşturur (`cache_creation_input_tokens`)
+- **İsabet**: Sonraki isteklerin öneki tutarlı olduğunda, önbellek yeniden kullanılır (`cache_read_input_tokens`)
+- **Sona Erme**: Önbelleğin 5 dakikalık bir TTL'si (yaşam süresi) vardır ve bu sürenin ardından otomatik olarak sona erer
+- **Yeniden Oluşturma**: System prompt, araç listesi, model veya mesaj içeriği değiştiğinde, önbellek anahtarı eşleşmez ve ilgili düzeyde önbellek yeniden oluşturma tetiklenir

package/concepts/tr/MainAgent.md

@@ -0,0 +1,23 @@
+# MainAgent
+
+## Tanım
+
+MainAgent, Claude Code'un agent team durumunda olmadığı zamanlardaki ana istek zinciridir. Kullanıcının Claude Code ile her etkileşimi bir dizi API isteği üretir ve bunlar arasında MainAgent istekleri çekirdek konuşma zincirini oluşturur — tam system prompt, araç tanımları ve mesaj geçmişi taşırlar.
+
+## Tanımlama Yöntemi
+
+cc-viewer'da MainAgent, `req.mainAgent === true` ile tanımlanır ve `interceptor.js` tarafından istek yakalama sırasında otomatik olarak işaretlenir.
+
+Belirleme koşulları (tümü karşılanmalı):
+- İstek gövdesi `system` alanı içerir (system prompt)
+- İstek gövdesi `tools` dizisi içerir (araç tanımları)
+- system prompt "Claude Code" karakteristik metni içerir
+
+## SubAgent ile Farkları
+
+| Özellik | MainAgent | SubAgent |
+|---------|-----------|----------|
+| system prompt | Tam Claude Code ana prompt'u | Göreve özel kısaltılmış prompt |
+| tools dizisi | Tüm kullanılabilir araçları içerir | Genellikle yalnızca görev için gereken az sayıda araç |
+| Mesaj geçmişi | Tam konuşma bağlamını biriktirir | Yalnızca alt görevle ilgili mesajlar |
+| Önbellek davranışı | Prompt caching var (5 dakika TTL) | Genellikle önbellek yok veya küçük önbellek |

package/concepts/tr/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/tr/QRCode.md

@@ -0,0 +1,25 @@
+# Mobil QR Kod Erişimi
+
+## Nasıl çalışır
+
+CC Viewer bir HTTP sunucusu başlatır ve bir **LAN adresi** oluşturur (ör: `http://192.168.1.100:7008`). QR kodu tarayarak aynı WiFi ağı üzerinden telefonunuzdan Claude Code'a erişebilirsiniz.
+
+## Neden bağlanamıyorum?
+
+1. **Aynı ağda değil** — Telefon ve bilgisayar aynı WiFi'ye bağlı olmalıdır (aynı yönlendirici/aynı ağ adı)
+2. **Güvenlik duvarı engeli** — Sistem güvenlik duvarı gelen bağlantıları engelleyebilir
+3. **Kurumsal ağ izolasyonu** — AP izolasyonu cihazlar arası iletişimi engelleyebilir
+4. **VPN müdahalesi** — VPN ağ yolunu bozabilir
+
+## Güvenlik uyarısı
+
+> ⚠️ CC Viewer'ın LAN hizmeti aynı ağdaki tüm cihazlara açıktır.
+
+- **Herkese açık WiFi**'da dikkatli olun
+- CC Viewer, LAN erişimini korumak için **token kimlik doğrulaması** kullanır
+- Güvenilir ağlarda kullanılması önerilir
+
+## LAN ötesi
+
+- **Tünel araçları** — frp, ngrok, Tailscale vb.
+- **CC Viewer eklentileri** — Eklenti sistemiyle proxy middleware yapılandırın

package/concepts/tr/ResponseFields.md

@@ -0,0 +1,50 @@
+# Response Body Alan Açiklamasi
+
+Claude API `/v1/messages` yanit gövdesinin alan açiklamasi.
+
+## Üst Düzey Alanlar
+
+| Alan | Tür | Açiklama |
+|------|------|------|
+| **model** | string | Gerçekte kullanilan model adi, örnegin `claude-opus-4-6` |
+| **id** | string | Bu yanitin benzersiz tanimlayicisi, örnegin `msg_01Tgsr2QeH8AVXGoP2wAXRvU` |
+| **type** | string | Sabit deger `"message"` |
+| **role** | string | Sabit deger `"assistant"` |
+| **content** | array | Modelin ürettigi içerik bloklari dizisi; metin, araç çagrilari, düsünme süreci vb. içerir |
+| **stop_reason** | string | Durma nedeni: `"end_turn"` (normal bitis), `"tool_use"` (araç çalistirmak gerekiyor), `"max_tokens"` (token sinirana ulasildi) |
+| **stop_sequence** | string/null | Durmayi tetikleyen dizi, genellikle `null` |
+| **usage** | object | Token kullanim istatistikleri (ayrintilari asagida) |
+
+## content Blok Türleri
+
+| Tür | Açiklama |
+|------|------|
+| **text** | Modelin metin yaniti, `text` alani içerir |
+| **tool_use** | Araç çagri istegi; `name` (araç adi), `input` (parametreler), `id` (çagri ID'si, tool_result ile eslestirilir) içerir |
+| **thinking** | Genisletilmis düsünme içerigi (yalnizca thinking modu açikken görünür), `thinking` alani içerir |
+
+## usage Alani Ayrintilari
+
+| Alan | Açiklama |
+|------|------|
+| **input_tokens** | Önbellege isabet etmeyen giris token sayisi (tam fiyatla ücretlendirilir) |
+| **cache_creation_input_tokens** | Bu istekte yeni olusturulan önbellek token sayisi (önbellek yazma, normal giristen daha yüksek ücretlendirilir) |
+| **cache_read_input_tokens** | Önbellege isabet eden token sayisi (önbellek okuma, normal giristen çok daha düsük ücretlendirilir) |
+| **output_tokens** | Modelin çikis token sayisi |
+| **service_tier** | Hizmet seviyesi, örnegin `"standard"` |
+| **inference_geo** | Çikarim bölgesi, örnegin `"not_available"` bölge bilgisinin mevcut olmadigini belirtir |
+
+## cache_creation Alt Alanlari
+
+| Alan | Açiklama |
+|------|------|
+| **ephemeral_5m_input_tokens** | 5 dakika TTL'li kisa süreli önbellek olusturma token sayisi |
+| **ephemeral_1h_input_tokens** | 1 saat TTL'li uzun süreli önbellek olusturma token sayisi |
+
+> **Önbellek ücretlendirmesi hakkinda**: `cache_read_input_tokens` birim fiyati `input_tokens`'dan çok daha düsüktür; `cache_creation_input_tokens` birim fiyati ise normal giristen biraz daha yüksektir. Bu nedenle, sürekli konusmalarda yüksek önbellek isabet oranini korumak maliyetleri önemli ölçüde azaltabilir. Bu orani cc-viewer'daki "isabet orani" göstergesiyle görsel olarak izleyebilirsiniz.
+
+## stop_reason Anlamlari
+
+- **end_turn**: Model yaniti normal sekilde tamamladi
+- **tool_use**: Modelin araç çagirmasi gerekiyor, content içinde `tool_use` blogu bulunacaktir. Konusmaya devam etmek için sonraki istekte messages'a `tool_result` eklenmesi gerekir
+- **max_tokens**: `max_tokens` sinirana ulasilarak kesildi, yanit eksik olabilir

package/concepts/tr/SubAgent-Search.md

@@ -0,0 +1,20 @@
+# SubAgent: Search
+
+## Tanım
+
+Search, kod tabanında arama yapmak üzere Claude Code'un ana agent'ı tarafından oluşturulan bir sub-agent türüdür. Glob, Grep ve Read gibi araçları kullanarak hedefli dosya ve içerik aramaları gerçekleştirir, ardından sonuçları üst agent'a döndürür.
+
+## Davranış
+
+- Ana agent'ın kod tabanını araması veya keşfetmesi gerektiğinde otomatik olarak oluşturulur
+- Salt okunur erişimle izole bir bağlamda çalışır
+- Dosya deseni eşleştirme için Glob, içerik arama için Grep ve dosya inceleme için Read kullanır
+- Arama sonuçlarını daha fazla işlenmek üzere üst agent'a döndürür
+
+## Ne Zaman Görünür
+
+Search sub-agent'ları genellikle şu durumlarda görünür:
+
+1. Ana agent'ın belirli dosyaları, fonksiyonları veya kod desenlerini bulması gerektiğinde
+2. Kullanıcı tarafından geniş kapsamlı bir kod tabanı keşfi talep edildiğinde
+3. Agent bağımlılıkları, referansları veya kullanım desenlerini araştırdığında

package/concepts/tr/Teammate.md

@@ -0,0 +1,26 @@
+# Teammate
+
+## Tanım
+
+Teammate, Claude Code Agent'ın Takım Modu (Team Mode) altındaki iş birlikçi agent'tır. Ana agent `TeamCreate` ile bir takım oluşturup `Agent` aracını kullanarak teammate ürettiğinde, her teammate bağımsız bir agent süreci olarak çalışır, kendi bağlam penceresine ve araç setine sahiptir ve `SendMessage` aracılığıyla takım üyeleriyle iletişim kurar.
+
+## SubAgent ile Farkları
+
+| Özellik | Teammate | SubAgent |
+|---------|----------|----------|
+| Yaşam döngüsü | Kalıcıdır, birden fazla mesaj alabilir | Tek seferlik görev, tamamlandığında yok edilir |
+| İletişim yöntemi | SendMessage ile çift yönlü mesajlaşma | Üst→alt tek yönlü çağrı, sonuç döndürme |
+| Bağlam | Bağımsız ve eksiksiz bağlam, turlar arası korunur | İzole edilmiş görev bağlamı |
+| İş birliği modeli | Takım iş birliği, birbirleriyle iletişim kurabilir | Hiyerarşik yapı, yalnızca üst agent ile etkileşir |
+| Görev türü | Karmaşık çok adımlı görevler | Arama, keşif gibi tekil görevler |
+
+## Davranış
+
+- Ana agent (team lead) tarafından `Agent` aracıyla oluşturulur ve `team_name` atanır
+- `TaskList` / `TaskGet` / `TaskUpdate` aracılığıyla görev listesini paylaşır
+- Her tur yürütmesi tamamlandıktan sonra idle durumuna geçer, yeni bir mesajla uyandırılmayı bekler
+- `shutdown_request` ile zarif bir şekilde sonlandırılabilir
+
+## İstatistik Paneli Açıklaması
+
+Teammate istatistik paneli, her teammate'in API çağrı sayısını gösterir. `Name` sütunu teammate adını (örneğin `reviewer-security`, `reviewer-pipeline`), `Sayı` sütunu ise o teammate'in ürettiği toplam API istek sayısını gösterir.

package/concepts/tr/Tool-Agent.md

@@ -0,0 +1,125 @@
+# Agent
+
+## Tanım
+
+Karmaşık çok adımlı görevleri otonom olarak işlemek için bir alt agent (SubAgent) başlatır. Alt agent'lar bağımsız alt süreçlerdir ve her birinin kendine özel araç seti ve bağlamı vardır. Agent, yeni Claude Code sürümlerinde Task aracının yeniden adlandırılmış versiyonudur.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `prompt` | string | Evet | Alt agent'ın yürüteceği görev açıklaması |
+| `description` | string | Evet | 3-5 kelimelik kısa özet |
+| `subagent_type` | string | Evet | Alt agent türü, kullanılabilir araç setini belirler |
+| `model` | enum | Hayır | Model belirtme (sonnet / opus / haiku), varsayılan üst seviyeden miras |
+| `max_turns` | integer | Hayır | Maksimum agentic tur sayısı |
+| `run_in_background` | boolean | Hayır | Arka planda çalıştırılıp çalıştırılmayacağı, arka plan görevleri output_file yolu döndürür |
+| `resume` | string | Hayır | Devam ettirilecek agent ID'si, son yürütmeden devam eder. Bağlamı kaybetmeden önceki bir alt agent'ı sürdürmek için kullanışlı |
+| `isolation` | enum | Hayır | İzolasyon modu, `worktree` geçici git worktree oluşturur |
+
+## Alt Agent Türleri
+
+| Tür | Kullanım Amacı | Kullanılabilir Araçlar |
+|-----|----------------|----------------------|
+| `Bash` | Komut çalıştırma, git işlemleri | Bash |
+| `general-purpose` | Genel amaçlı çok adımlı görevler | Tüm araçlar |
+| `Explore` | Hızlı kod tabanı keşfi | Agent/Edit/Write/NotebookEdit/ExitPlanMode hariç tüm araçlar |
+| `Plan` | Uygulama planı tasarlama | Agent/Edit/Write/NotebookEdit/ExitPlanMode hariç tüm araçlar |
+| `claude-code-guide` | Claude Code kullanım kılavuzu soru-cevap | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Durum çubuğu yapılandırma | Read, Edit |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Çok adımlı otonom tamamlama gerektiren karmaşık görevler
+- Kod tabanı keşfi ve derinlemesine araştırma (Explore türü ile)
+- İzole ortam gerektiren paralel çalışma
+- Arka planda çalıştırılması gereken uzun süreli görevler
+
+**Kullanıma uygun değil:**
+- Belirli dosya yolunu okuma — doğrudan Read veya Glob kullanın
+- 2-3 bilinen dosyada arama — doğrudan Read kullanın
+- Belirli sınıf tanımı arama — doğrudan Glob kullanın
+
+## Dikkat Edilecekler
+
+- Alt agent tamamlandığında tek bir mesaj döndürür; sonuçları kullanıcıya görünmez, ana agent'ın aktarması gerekir
+- Verimliliği artırmak için tek mesajda birden fazla paralel Agent çağrısı yapılabilir
+- Arka plan görevleri TaskOutput aracıyla ilerleme kontrolü yapılır
+- Explore türü doğrudan Glob/Grep çağrısından yavaştır, yalnızca basit arama yeterli olmadığında kullanın
+- Anında sonuç gerektirmeyen uzun süreli görevler için `run_in_background: true` kullanın; devam etmeden önce sonuç gerektiğinde ön plan modunu (varsayılan) kullanın
+- `resume` parametresi, daha önce başlatılmış bir alt agent oturumunu birikmiş bağlamı koruyarak sürdürmeye olanak tanır
+
+## Orijinal Metin
+
+<textarea readonly>Launch a new agent to handle complex, multi-step tasks autonomously.
+
+The Agent tool launches specialized agents (subprocesses) that autonomously handle complex tasks. Each agent type has specific capabilities and tools available to it.
+
+Available agent types and the tools they have access to:
+- general-purpose: General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you. (Tools: *)
+- statusline-setup: Use this agent to configure the user's Claude Code status line setting. (Tools: Read, Edit)
+- Explore: Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (eg. "src/components/**/*.tsx"), search code for keywords (eg. "API endpoints"), or answer questions about the codebase (eg. "how do API endpoints work?"). When calling this agent, specify the desired thoroughness level: "quick" for basic searches, "medium" for moderate exploration, or "very thorough" for comprehensive analysis across multiple locations and naming conventions. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
+- Plan: Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a task. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
+- claude-code-guide: Use this agent when the user asks questions ("Can Claude...", "Does Claude...", "How do I...") about: (1) Claude Code (the CLI tool) - features, hooks, slash commands, MCP servers, settings, IDE integrations, keyboard shortcuts; (2) Claude Agent SDK - building custom agents; (3) Claude API (formerly Anthropic API) - API usage, tool use, Anthropic SDK usage. **IMPORTANT:** Before spawning a new agent, check if there is already a running or recently completed claude-code-guide agent that you can resume using the "resume" parameter. (Tools: Glob, Grep, Read, WebFetch, WebSearch)
+
+When using the Agent tool, you must specify a subagent_type parameter to select which agent type to use.
+
+When NOT to use the Agent tool:
+- If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly
+- If you are searching for a specific class definition like "class Foo", use the Glob tool instead, to find the match more quickly
+- If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly
+- Other tasks that are not related to the agent descriptions above
+
+Usage notes:
+- Always include a short description (3-5 words) summarizing what the agent will do
+- Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses
+- When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.
+- You can optionally run agents in the background using the run_in_background parameter. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead.
+- **Foreground vs background**: Use foreground (default) when you need the agent's results before you can proceed — e.g., research agents whose findings inform your next steps. Use background when you have genuinely independent work to do in parallel.
+- Agents can be resumed using the `resume` parameter by passing the agent ID from a previous invocation. When resumed, the agent continues with its full previous context preserved. When NOT resuming, each invocation starts fresh and you should provide a detailed task description with all necessary context.
+- When the agent is done, it will return a single message back to you along with its agent ID. You can use this ID to resume the agent later if needed for follow-up work.
+- Provide clear, detailed prompts so the agent can work autonomously and return exactly the information you need.
+- Agents with "access to current context" can see the full conversation history before the tool call. When using these agents, you can write concise prompts that reference earlier context (e.g., "investigate the error discussed above") instead of repeating information. The agent will receive all prior messages and understand the context.
+- The agent's outputs should generally be trusted
+- Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent
+- If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.
+- If the user specifies that they want you to run agents "in parallel", you MUST send a single message with multiple Agent tool use content blocks. For example, if you need to launch both a build-validator agent and a test-runner agent in parallel, send a single message with both tool calls.
+- You can optionally set `isolation: "worktree"` to run the agent in a temporary git worktree, giving it an isolated copy of the repository. The worktree is automatically cleaned up if the agent makes no changes; if changes are made, the worktree path and branch are returned in the result.
+
+Example usage:
+
+<example_agent_descriptions>
+"test-runner": use this agent after you are done writing code to run tests
+"greeting-responder": use this agent to respond to user greetings with a friendly joke
+</example_agent_descriptions>
+
+<example>
+user: "Please write a function that checks if a number is prime"
+assistant: Sure let me write a function that checks if a number is prime
+assistant: First let me use the Write tool to write a function that checks if a number is prime
+assistant: I'm going to use the Write tool to write the following code:
+<code>
+function isPrime(n) {
+  if (n <= 1) return false
+  for (let i = 2; i * i <= n; i++) {
+    if (n % i === 0) return false
+  }
+  return true
+}
+</code>
+<commentary>
+Since a significant piece of code was written and the task was completed, now use the test-runner agent to run the tests
+</commentary>
+assistant: Now let me use the test-runner agent to run the tests
+assistant: Uses the Agent tool to launch the test-runner agent
+</example>
+
+<example>
+user: "Hello"
+<commentary>
+Since the user is greeting, use the greeting-responder agent to respond with a friendly joke
+</commentary>
+assistant: "I'm going to use the Agent tool to launch the greeting-responder agent"
+</example>
+</textarea>