spinnerVerbs配置指南
Claude Code v2.1.23(2026年1月28日发布)新增了自定义加载动作文本(spinner verbs) 的隐藏功能,无需官方文档支持,通过简单的配置文件修改,就能替换或追加Claude Code工作时显示的动名词加载提示,让CLI交互更具个性化,本文将详细讲解该功能的配置方法、参数说明及实操示例。
功能核心说明
Claude Code默认会在运行时显示如bloviating...、cogitating...这类动名词加载提示,本次更新新增的spinnerVerbs配置项,支持用户通过本地配置文件,自定义这部分提示文本,支持完全替换默认文本 和在默认基础上追加文本两种模式,且配置过程仅需修改JSON文件,无需复杂的命令行操作。
配置文件位置
需在Claude的本地配置目录中,编辑/创建settings.json文件,文件路径为:
~/.claude/settings.json
核心配置结构
在settings.json中添加spinnerVerbs顶级配置节点,核心Schema结构如下:
json
{
"spinnerVerbs": {
"mode": "replace|append",
"verbs": []
}
}
配置字段详解
| 字段 | 类型 | 取值/说明 |
|---|---|---|
mode |
字符串 | 仅支持replace或append: - replace:完全替换默认加载动作文本 - append:保留默认文本,追加自定义内容 |
verbs |
字符串数组 | 自定义的动名词列表,无需添加末尾的省略号(...),Claude Code会自动补全 |
实操示例
示例1:Replace模式(完全替换)
该模式下,Claude Code将仅使用用户自定义的动名词作为加载提示,不再显示默认内容。
配置代码:
json
{
"spinnerVerbs": {
"mode": "replace",
"verbs": [
"WTFing",
"Hallucinating",
"Cursing",
"Bankrupting"
]
}
}
配置后效果:加载时会循环显示WTFing...、Hallucinating...、Cursing...等自定义提示。
示例2:Append模式(追加自定义)
该模式会保留Claude Code的默认加载动作文本,同时将自定义内容混入循环提示中,适合需要保留默认体验又想增加个性化的场景(如添加团队黑话、领域专属术语)。
配置代码:
json
{
"spinnerVerbs": {
"mode": "append",
"verbs": [
"Obviating",
"Tokenburning",
"Reverting"
]
}
}
配置后效果:加载时会同时循环显示默认提示和Obviating...、Tokenburning...等自定义提示。