mirror of
https://github.com/NanmiCoder/claude-code-haha.git
synced 2026-10-10 11:53:10 +08:00
程序员阿江-Relakkes
3754d1f2a5
Sessions get a Chat / Trajectory switch in the header. The trajectory is a dense one-line-per-event ledger (system prompt, user, injected context such as skills and system reminders, assistant responses, tool calls) with a three-lane minimap, turn folding, search, and a detail panel per row. - CLI: record a deduplicated prompt snapshot sidecar for desktop sessions (system prompt, tool catalog, user context) without touching the transcript. - Server: project transcript records into trajectory rows with bounded, cursor-paged reads, live appends, a turn index, row detail by byte range, snapshot blobs, and a time-window lookup into the raw trace capture. - Desktop: windowed ledger, minimap, detail panel with a raw request summary, chat <-> trajectory navigation, subagent drill-in. - Remove the Settings trace list, trace tabs and the standalone trace window; migrate persisted trace tabs to session tabs.
150 lines
11 KiB
Markdown
150 lines
11 KiB
Markdown
---
|
||
title: 设置指南
|
||
nav_title: 设置
|
||
description: 从第一条会话出发，选择必要设置，并按任务查找高级配置。
|
||
order: 6
|
||
---
|
||
|
||
# 设置指南
|
||
|
||
点侧边栏最底部的「设置」打开。第一次使用时，先在「服务商」接通模型，再到「通用」确认权限与语言，就能开始[第一条会话](../start/first-session.md)。其余设置等遇到对应任务再打开。
|
||
|
||
## 服务商
|
||
|
||
管理模型接入。支持 Claude 官方、ChatGPT 官方、Grok 官方三种账号登录（不需要 API 密钥），也支持填 API 密钥接入任意 Anthropic / OpenAI 兼容的服务商。
|
||
|
||
第一次用必须来这里，之后基本不用动。详细步骤见[连接模型服务](../start/models.md)。
|
||
|
||
## 通用
|
||
|
||
通用设置分成四件事：界面和表达、Agent 如何工作、网络与提醒、数据保存。第一次只需要确认前两件；遇到具体问题再改后两件。
|
||
|
||
|
||
|
||
### 第一条会话前：权限与表达
|
||
|
||
| 设置 | 建议怎么选 | 何时生效 |
|
||
|---|---|---|
|
||
| 默认会话权限 | 初次使用保持默认的「询问权限」。写文件或运行高风险命令时先看清请求，再决定是否允许。[五档模式](./sessions.md#五档权限模式)可在会话输入框里单独切换。 | 作为新建聊天会话的默认值；已有会话的权限在会话里调整。 |
|
||
| 回复语言 | 想让 Agent 稳定用中文回答就选中文；它与下方的界面语言相互独立。默认不指定。 | 保存后用于后续回复；已生成的内容不会改写。 |
|
||
| 输出风格 | 默认最简洁；「解释型」解释实现选择；「学习型」会让你自己写一小段。还可选已安装的自定义风格。 | 新会话、在新进程中继续，或重启会话后生效；当前运行中的提示词不变。 |
|
||
| 推理强度与思考模式 | 先沿用模型支持的默认档位。只有想调节速度、成本或遇到模型兼容问题时再改；关闭思考会给需要它的兼容供应商传递非思考参数。 | 新会话默认值；可选推理档位随当前模型变化。 |
|
||
|
||
**试一次：**选一个有 Git 的练习目录，发「先列出你会改的文件，再做一个最小改动；完成后说明怎么验证」。收到权限请求时看目标文件和命令，结束后在工作区逐行[审阅 Diff](./workspace.md#diff-评审给某一行留话)。
|
||
|
||
### 界面与输入：按个人习惯调整
|
||
|
||
- **配色主题**有纯白、纸墨、经典暖色、青瓷、墨夜、墨夜蓝六套。开启「跟随系统」后，可分别指定浅色和深色主题。
|
||
- **语言**只改变应用界面，支持简体中文、繁体中文、英语、日语和韩语；它不等同于「回复语言」。
|
||
- **界面缩放**改变整个窗口。macOS 用 `⌘+` / `⌘-`，Windows 用 `Ctrl+` / `Ctrl-`，按 `0` 恢复到 100%。
|
||
- **消息发送方式**默认 Enter 发送、Shift+Enter 换行；常写多行提示词可改成 `Ctrl/Cmd+Enter` 发送。
|
||
- **默认编辑器**决定文件「打开方式」菜单默认选哪个本机已检测到的编辑器。
|
||
|
||
### 需要更复杂的 Agent 工作流时
|
||
|
||
| 设置 | 何时开启或调整 |
|
||
|---|---|
|
||
| Ultracode | 默认开启。独立出现的关键词会触发动态 Workflow 编排；普通代码块、引号、路径里的同名文字不会触发。 |
|
||
| Agent Teams | 默认开启。需要多个 Agent 分工处理较大任务时使用；设置对新会话生效，已有会话在重启应用后生效。入门先看[子 Agent 与任务拆分](./agents.md)。 |
|
||
| 自动回答问题 | 默认关闭。无人响应 Agent 的选择题时，可在 1、5、10、30 分钟后尝试选择推荐项；没有可靠选择时继续等待。只适合你愿意让任务在无人值守时继续的场景。 |
|
||
| 自动做梦 | 默认关闭。会话积累足够后，可在后台整理 auto-memory；会产生额外模型调用和 token 消耗。 |
|
||
| Agent Trace | 默认开启。新会话的原始请求、响应与状态事件写入本机 traces 目录，出错时在会话「轨迹」里点开助手行，看「原始请求」页；关闭后不再产生新记录，旧记录仍可查看。 |
|
||
|
||
### 网络、联网搜索和提醒
|
||
|
||
- **系统通知**默认关闭。需要离开窗口等权限请求、回复或定时任务结果时打开，并授予操作系统通知权限。
|
||
- **网络**默认采用系统代理。直连会绕过系统及进程代理；手动代理接收 HTTP/HTTPS 地址，带认证的例子是 `http://user:password@127.0.0.1:7890`。改完点「保存」，对新请求生效；正在执行的请求仍用原来的路由。模型服务、账号登录、MCP 与 Agent 工具受此设置影响，应用更新另在「关于」配置代理。
|
||
- **AI 请求超时**默认 1800 秒，可填写至少 30 秒。只在模型首个响应或连接测试确实超时时调高；本地模型长时间思考可按需填 14400 秒（4 小时）。
|
||
- **WebFetch 预检**默认跳过上游域名预检，以免第三方服务商或受限网络误报。只有明确需要恢复上游预检时才关闭此选项。
|
||
- **WebSearch**默认「自动」：Claude 模型优先使用原生搜索，失败或非 Claude 模型再尝试 Tavily / Brave。想明确指定某条路径，可选 Claude、Tavily、Brave 或关闭；后两者需要填自己的 API Key 并点「保存」。
|
||
|
||
### 数据保留与存放：改前先确认结果
|
||
|
||
- **会话记录**默认保留 365 天，可设置 0–3650 天。缩短时间会立即删除更早记录，设置为 0 会删除已有全部记录并停止记录会话内容；界面会先预览并再次确认。这里不能用来代替备份。
|
||
- **数据存储位置**默认是 `~/.claude`（Windows 为 `%USERPROFILE%\\.claude`）。便携模式可以指定一个不在应用安装目录内的绝对路径。切换后，配置、任务、会话、技能和插件将从新目录读取，重启应用才生效；两个目录不会自动合并或迁移。若启动时设置了 `CLAUDE_CONFIG_DIR`，需先移除该环境变量才能在界面里切换。
|
||
|
||
本文的产品截图统一使用「纯白」主题，避免不同配色影响界面对比。
|
||
|
||
## H5 访问
|
||
|
||
在手机浏览器里继续同一条会话。默认关闭。见[手机 H5 与 IM 接力](./remote.md)。
|
||
|
||
## IM 接入
|
||
|
||
从微信、钉钉、WhatsApp、Telegram、飞书、企业微信、QQ、Slack 直接和 Claude 对话，并管理配对用户。见[手机 H5 与 IM 接力](./remote.md)和[IM 接入](../im/index.md)。
|
||
|
||
## 终端
|
||
|
||
内嵌一个真实的宿主机 Shell，用来装插件、技能、MCP 这类需要命令行的东西。桌面端已经内置 `claude-haha` 命令，文档里写 `claude <参数>` 的地方都可以换成 `claude-haha <参数>`。
|
||
|
||
Windows 用户可以在这里指定启动 Shell（系统默认 / PowerShell 7 / Windows PowerShell / 命令提示符 / 自定义可执行文件），以及一个 Bash 路径——工具调用 `grep`、`sed` 这类 Unix 命令时会用到，通常指向 Git Bash。
|
||
|
||
## MCP
|
||
|
||
添加外部工具和数据源。支持 STDIO、Streamable HTTP、SSE 三种传输方式，配置范围和 CLI 保持一致：
|
||
|
||
- **项目私有** — 只对你生效，但绑定到某一个项目。
|
||
- **项目共享** — 写进项目的 `.mcp.json`，团队成员共享。
|
||
- **全局用户** — 写进你的全局配置，所有项目生效。
|
||
|
||
顶部三个数字是服务总数、当前已连接、需要处理。STDIO 类型的命令会直接在你的机器上运行，Node、Python、Bun 这些运行时需要你自己装好并保证在 PATH 里。
|
||
|
||
## Agents
|
||
|
||
浏览已安装的 Agent，创建自己的。见[子 Agent 与任务拆分](./agents.md)。
|
||
|
||
## 技能
|
||
|
||
本机所有可用技能，按来源分组，可以直接读技能的正文和源码。见[技能与技能市场](./skills.md)。
|
||
|
||
## 记忆
|
||
|
||
查看和编辑 Claude 为每个项目写的 Markdown 记忆文件。左边选项目，中间选文件，右边编辑或预览渲染结果。这些文件在 `~/.claude/projects/<project>/memory/`，CLI 运行时会加载它们。
|
||
|
||
会话里也能直接用 `/memory` 跳到这里。想知道记忆是怎么写入和召回的，看[记忆系统](../internals/memory.md)。
|
||
|
||
## 插件
|
||
|
||
插件把技能、Agent、Hook、MCP 服务打包在一起。这里能看已安装插件、健康状态和它们各自暴露了哪些能力，支持启用、禁用、更新、卸载，也能多选批量操作。
|
||
|
||
启用或禁用之后要点一次「应用变更」，才会把插件变更重新应用到当前运行时。
|
||
|
||
## 宠物
|
||
|
||
一只悬浮在桌面上的小机器人。默认关闭。见[桌面宠物](./pets.md)。
|
||
|
||
## Computer Use
|
||
|
||
让 Claude 读屏幕、点鼠标、敲键盘。开启开关、确认全局授权并满足系统权限要求后才能使用；各平台的环境准备步骤不同。见[Computer Use](./computer-use.md)。
|
||
|
||
## Token 用量
|
||
|
||
|
||
|
||
基于本机 Claude Code 会话记录统计出来的用量看板，全部在本地算，不上传。
|
||
|
||
- 顶部是累计 Token 数、峰值、最长任务时长、连续活跃天数。
|
||
- 中间是热力图，可以切每日 / 每周 / 累计三种口径，点某一天看当天的会话数、Token、消息和工具调用。
|
||
- 下面是活动洞察：活跃率、最常用模型、用过哪些技能、新增与缓存命中的 Token 比例、估算成本。估算成本不含未定价的模型，界面上会写明跳过了几个。
|
||
|
||
## 诊断
|
||
|
||
出问题时来这里。记录服务端和 CLI 的启动、服务商、会话运行错误。
|
||
|
||
- 顶部是日志大小、事件数、24 小时内的警告数、保留策略。
|
||
- 「最近事件」列出具体错误，每条带事件 ID，可以单独复制。
|
||
- **导出诊断包** / **复制错误摘要** / **复制 Issue 报告** — 提 issue 时用后两个，格式已经整理好。
|
||
- **Doctor** — 检查用户和当前项目的配置状态，只读不修改，给出健康 / 未配置 / 缺失 / 无效的清单。会话里输入 `/doctor` 也能直接打开。
|
||
- **重置安全 UI 状态** — 只清标签页、主题、缩放这几个可再生的界面键。聊天历史、模型配置、技能、MCP、IM 和 OAuth 始终受保护，不会被它碰到。
|
||
- **本地索引** — 显示 SQLite 派生索引的状态和大小，可以重建。重建只影响索引，不删源对话。
|
||
|
||
:::info
|
||
Issue 报告和导出包会尽力脱敏，省略聊天内容、文件内容、完整环境变量和 API 密钥。分享前还是自己扫一眼，看有没有内网域名、用户名或路径。
|
||
:::
|
||
|
||
## 关于
|
||
|
||
版本号、更新日志、GitHub 仓库、反馈入口。
|
||
|
||
「应用更新」会检查 GitHub Releases，下载后自动重启安装。更新下载走的是独立的代理设置，和 设置 → 通用 里的网络设置互不影响——公司网络下更新卡住时，来这里配「高级更新代理」。
|