---
title: 设置速查
nav_title: 设置
description: 16 个设置分栏，每栏能配什么、什么时候需要动它。
order: 6
---

# 设置速查

点侧边栏最底部的「设置」打开。左边 16 个分栏，顺序固定。这一篇按这个顺序过一遍，说清每栏能配什么、什么时候才需要动它。

## 服务商

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

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

## 通用

最常动的一栏，配的都是「用起来顺不顺手」的东西。

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

- **配色主题** — 六套：纯白（默认）、纸墨、经典暖色、青瓷、墨夜、墨夜蓝。另有「跟随系统」开关，打开后可以分别指定浅色模式和深色模式各用哪一套。
- **语言** — 界面显示语言。
- **回复语言** — 让 Claude 始终用某种语言回复，和界面语言分开设。
- **输出风格** — 默认 / 解释型 / 学习型。「解释型」会额外讲清实现选择和代码库里的模式，「学习型」会让你自己动手写一小段。改完对正在跑的会话不生效，新建会话才用新风格。
- **默认会话权限** — 新建会话时用哪一档权限模式。每条会话里还能单独改。
- **推理强度** 与 **思考模式** — 新会话的默认思考档位。关掉思考模式后，DeepSeek 这类需要显式非思考参数的模型会收到对应设置。
- **消息发送方式** — Enter 发送（Shift+Enter 换行），或 `Ctrl/Cmd+Enter` 发送。
- **系统通知** — 授权确认、回复完成、定时任务结果走系统通知中心。开启时会请求系统权限。
- **网络** — 三选一：直连（明确绕过系统代理）、系统代理（按目标地址动态遵循系统规则）、手动代理（填 `http://user:password@127.0.0.1:7890` 这样的地址）。下面还有「AI 请求超时」，默认值不够用时可以加大到 1800 秒。应用自身的更新下载走另一套代理设置，在「关于」里。
- **WebSearch** — 联网搜索走哪条路。自动模式会对 Claude 模型优先用原生 WebSearch，失败或换成非 Claude 模型时再用 Tavily / Brave，这两个需要你自己填 API Key。
- **自动做梦** — 后台定期整理和压缩记忆文件。默认关闭，因为它会额外消耗 token。
- **界面缩放** — 整体放大缩小，也可以用 `⌘+` / `⌘-` 快捷键，`⌘0` 回到 100%。
- **数据存储位置** — 低频高级设置。默认用系统目录 `~/.claude`，也可以改成你指定的绝对路径。切换后会话记录、技能、MCP、插件、服务商配置全部从新目录读取，需要重启应用生效，两个目录之间不会自动合并或迁移。

![同一条会话在「墨夜」深色主题下的样子](../images/app/session-dark.webp)

## H5 访问

在手机浏览器里继续同一条会话。默认关闭。见[手机 H5 与 IM 接力](./remote.md)。

## IM 接入

从微信、钉钉、WhatsApp、Telegram、飞书直接和 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/settings-usage.webp)

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

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

## Trace

记录每条会话的模型请求链路——请求、响应、状态事件、耗时都留档，用来排查卡住、失败和异常等待。开关不在这一栏：要先在 设置 → 通用 里打开「收集 Agent Trace」，这一栏才会有数据。

开启后新会话会把精简记录写到本机 traces 目录。已有记录在关掉之后仍然能看，只是不再写新的。Trace 列表支持搜索、筛选（全部 / LLM / 工具 / 错误）、单独在新窗口打开，也能删除某个会话的 Trace 而不影响聊天记录。

## 诊断

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

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

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

## 关于

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

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