---
title: 设置指南
nav_title: 设置
description: 从第一条会话出发，选择必要设置，并按任务查找高级配置。
order: 6
---

# 设置指南

点侧边栏最底部的「设置」打开。第一次使用时，先在「服务商」接通模型，再到「通用」确认权限与语言，就能开始[第一条会话](../start/first-session.md)。其余设置等遇到对应任务再打开。

## 服务商

管理模型接入。支持 Claude 官方、ChatGPT 官方、Grok 官方三种账号登录（不需要 API 密钥），也支持填 API 密钥接入任意 Anthropic / OpenAI 兼容的服务商。

第一次用必须来这里，之后基本不用动。详细步骤见[连接模型服务](../start/models.md)。

## 通用

通用设置分成四件事：界面和表达、Agent 如何工作、网络与提醒、数据保存。第一次只需要确认前两件；遇到具体问题再改后两件。

![设置 → 通用：配色主题、语言、输出风格、默认权限](../images/app/zh-CN/settings-general.webp)

### 第一条会话前：权限与表达

| 设置 | 建议怎么选 | 何时生效 |
|---|---|---|
| 默认会话权限 | 初次使用保持默认的「询问权限」。写文件或运行高风险命令时先看清请求，再决定是否允许。[五档模式](./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 用量

![设置 → Token 用量：热力图与统计卡](../images/app/zh-CN/settings-usage.webp)

基于本机 Claude Code 会话记录统计出来的用量看板，全部在本地算，不上传。

- 顶部是累计 Token 数、峰值、最长任务时长、连续活跃天数。
- 中间是热力图，可以切每日 / 每周 / 累计三种口径，点某一天看当天的会话数、Token、消息和工具调用。
- 下面是活动洞察：活跃率、最常用模型、用过哪些技能、新增与缓存命中的 Token 比例、估算成本。估算成本不含未定价的模型，界面上会写明跳过了几个。

## 诊断

出问题时来这里。记录服务端和 CLI 的启动、服务商、会话运行错误。

- 顶部是日志大小、事件数、24 小时内的警告数、保留策略。
- 「最近事件」列出具体错误，每条带事件 ID，可以单独复制。
- **导出诊断包** / **复制错误摘要** / **复制 Issue 报告** — 提 issue 时用后两个，格式已经整理好。
- **Doctor** — 检查用户和当前项目的配置状态，只读不修改，给出健康 / 未配置 / 缺失 / 无效的清单。会话里输入 `/doctor` 也能直接打开。
- **重置安全 UI 状态** — 只清标签页、主题、缩放这几个可再生的界面键。聊天历史、模型配置、技能、MCP、IM 和 OAuth 始终受保护，不会被它碰到。
- **本地索引** — 显示 SQLite 派生索引的状态和大小，可以重建。重建只影响索引，不删源对话。

:::info
Issue 报告和导出包会尽力脱敏，省略聊天内容、文件内容、完整环境变量和 API 密钥。分享前还是自己扫一眼，看有没有内网域名、用户名或路径。
:::

## 关于

版本号、更新日志、GitHub 仓库、反馈入口。

「应用更新」会检查 GitHub Releases，下载后自动重启安装。更新下载走的是独立的代理设置，和 设置 → 通用 里的网络设置互不影响——公司网络下更新卡住时，来这里配「高级更新代理」。