程序员阿江(Relakkes)
11 KiB
title, nav_title, description, order
| title | nav_title | description | order |
|---|---|---|---|
| 设置指南 | 设置 | 从第一条会话出发，选择必要设置，并按任务查找高级配置。 | 6 |
设置指南
点侧边栏最底部的「设置」打开。第一次使用时，先在「服务商」接通模型，再到「通用」确认权限与语言，就能开始第一条会话。其余设置等遇到对应任务再打开。
服务商
管理模型接入。支持 Claude 官方、ChatGPT 官方、Grok 官方三种账号登录（不需要 API 密钥），也支持填 API 密钥接入任意 Anthropic / OpenAI 兼容的服务商。
第一次用必须来这里，之后基本不用动。详细步骤见连接模型服务。
通用
通用设置分成四件事：界面和表达、Agent 如何工作、网络与提醒、数据保存。第一次只需要确认前两件；遇到具体问题再改后两件。
第一条会话前：权限与表达
| 设置 | 建议怎么选 | 何时生效 |
|---|---|---|
| 默认会话权限 | 初次使用保持默认的「询问权限」。写文件或运行高风险命令时先看清请求，再决定是否允许。五档模式可在会话输入框里单独切换。 | 作为新建聊天会话的默认值；已有会话的权限在会话里调整。 |
| 回复语言 | 想让 Agent 稳定用中文回答就选中文；它与下方的界面语言相互独立。默认不指定。 | 保存后用于后续回复；已生成的内容不会改写。 |
| 输出风格 | 默认最简洁；「解释型」解释实现选择；「学习型」会让你自己写一小段。还可选已安装的自定义风格。 | 新会话、在新进程中继续，或重启会话后生效；当前运行中的提示词不变。 |
| 推理强度与思考模式 | 先沿用模型支持的默认档位。只有想调节速度、成本或遇到模型兼容问题时再改；关闭思考会给需要它的兼容供应商传递非思考参数。 | 新会话默认值；可选推理档位随当前模型变化。 |
**试一次：**选一个有 Git 的练习目录，发「先列出你会改的文件，再做一个最小改动；完成后说明怎么验证」。收到权限请求时看目标文件和命令，结束后在工作区逐行审阅 Diff。
界面与输入：按个人习惯调整
- 配色主题有纯白、纸墨、经典暖色、青瓷、墨夜、墨夜蓝六套。开启「跟随系统」后，可分别指定浅色和深色主题。
- 语言只改变应用界面，支持简体中文、繁体中文、英语、日语和韩语；它不等同于「回复语言」。
- 界面缩放改变整个窗口。macOS 用
⌘+/⌘-，Windows 用Ctrl+/Ctrl-，按0恢复到 100%。 - 消息发送方式默认 Enter 发送、Shift+Enter 换行；常写多行提示词可改成
Ctrl/Cmd+Enter发送。 - 默认编辑器决定文件「打开方式」菜单默认选哪个本机已检测到的编辑器。
需要更复杂的 Agent 工作流时
| 设置 | 何时开启或调整 |
|---|---|
| Ultracode | 默认开启。独立出现的关键词会触发动态 Workflow 编排；普通代码块、引号、路径里的同名文字不会触发。 |
| Agent Teams | 默认开启。需要多个 Agent 分工处理较大任务时使用；设置对新会话生效，已有会话在重启应用后生效。入门先看子 Agent 与任务拆分。 |
| 自动回答问题 | 默认关闭。无人响应 Agent 的选择题时，可在 1、5、10、30 分钟后尝试选择推荐项；没有可靠选择时继续等待。只适合你愿意让任务在无人值守时继续的场景。 |
| 自动做梦 | 默认关闭。会话积累足够后，可在后台整理 auto-memory；会产生额外模型调用和 token 消耗。 |
| Agent Trace | 默认开启。新会话的精简请求、响应与状态事件写入本机 traces 目录，出错时到「Trace」查看；关闭后不再产生新记录，旧记录仍可查看。 |
网络、联网搜索和提醒
- 系统通知默认关闭。需要离开窗口等权限请求、回复或定时任务结果时打开，并授予操作系统通知权限。
- 网络默认采用系统代理。直连会绕过系统及进程代理；手动代理接收 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 接力。
IM 接入
从微信、钉钉、WhatsApp、Telegram、飞书、企业微信、QQ、Slack 直接和 Claude 对话，并管理配对用户。见手机 H5 与 IM 接力和IM 接入。
终端
内嵌一个真实的宿主机 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 与任务拆分。
技能
本机所有可用技能，按来源分组，可以直接读技能的正文和源码。见技能与技能市场。
记忆
查看和编辑 Claude 为每个项目写的 Markdown 记忆文件。左边选项目，中间选文件，右边编辑或预览渲染结果。这些文件在 ~/.claude/projects/<project>/memory/，CLI 运行时会加载它们。
会话里也能直接用 /memory 跳到这里。想知道记忆是怎么写入和召回的，看记忆系统。
插件
插件把技能、Agent、Hook、MCP 服务打包在一起。这里能看已安装插件、健康状态和它们各自暴露了哪些能力，支持启用、禁用、更新、卸载，也能多选批量操作。
启用或禁用之后要点一次「应用变更」，才会把插件变更重新应用到当前运行时。
宠物
一只悬浮在桌面上的小机器人。默认关闭。见桌面宠物。
Computer Use
让 Claude 读屏幕、点鼠标、敲键盘。开启开关、确认全局授权并满足系统权限要求后才能使用；各平台的环境准备步骤不同。见Computer Use。
Token 用量
基于本机 Claude Code 会话记录统计出来的用量看板，全部在本地算，不上传。
- 顶部是累计 Token 数、峰值、最长任务时长、连续活跃天数。
- 中间是热力图，可以切每日 / 每周 / 累计三种口径，点某一天看当天的会话数、Token、消息和工具调用。
- 下面是活动洞察：活跃率、最常用模型、用过哪些技能、新增与缓存命中的 Token 比例、估算成本。估算成本不含未定价的模型，界面上会写明跳过了几个。
Trace
记录每条会话的模型请求链路——请求、响应、状态事件、耗时都留档，用来排查卡住、失败和异常等待。开关在「设置 → 通用」，默认开启；新会话才会产生新记录。
开启后新会话会把精简记录写到本机 traces 目录。已有记录在关掉之后仍然能看，只是不再写新的。Trace 列表支持搜索、筛选（全部 / LLM / 工具 / 错误）、单独在新窗口打开，也能删除某个会话的 Trace 而不影响聊天记录。
诊断
出问题时来这里。记录服务端和 CLI 的启动、服务商、会话运行错误。
- 顶部是日志大小、事件数、24 小时内的警告数、保留策略。
- 「最近事件」列出具体错误，每条带事件 ID，可以单独复制。
- 导出诊断包 / 复制错误摘要 / 复制 Issue 报告 — 提 issue 时用后两个，格式已经整理好。
- Doctor — 检查用户和当前项目的配置状态，只读不修改，给出健康 / 未配置 / 缺失 / 无效的清单。会话里输入
/doctor也能直接打开。 - 重置安全 UI 状态 — 只清标签页、主题、缩放这几个可再生的界面键。聊天历史、模型配置、技能、MCP、IM 和 OAuth 始终受保护，不会被它碰到。
- 本地索引 — 显示 SQLite 派生索引的状态和大小，可以重建。重建只影响索引，不删源对话。
:::info Issue 报告和导出包会尽力脱敏，省略聊天内容、文件内容、完整环境变量和 API 密钥。分享前还是自己扫一眼，看有没有内网域名、用户名或路径。 :::
关于
版本号、更新日志、GitHub 仓库、反馈入口。
「应用更新」会检查 GitHub Releases，下载后自动重启安装。更新下载走的是独立的代理设置，和 设置 → 通用 里的网络设置互不影响——公司网络下更新卡住时，来这里配「高级更新代理」。