Claude Code 配置指南
🔧 官方文档依据：code.claude.com/docs/en/setup

Claude Code 关闭自动更新指南

这份指南只讲一件事：怎么关掉 Claude Code 的自动更新。通过修改 settings.json 配置文件完成设置。

👤 作者：大瑜 📱 公众号：大瑜聊AI 💬 微信：helloaigc2023
📂 配置文件位置
配置文件路径：~/.claude/settings.json（位于用户目录下，不是在某个项目文件夹里。放错地方不会生效。）
1

打开「终端」(Terminal)

在 Spotlight 中搜索 "Terminal" 或从「应用程序 → 实用工具」中打开。

2

创建配置文件并写入设置

复制下面整段命令，粘贴进终端，回车执行：

Terminal
$ mkdir -p ~/.claude
$ cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}
EOF
⚠️ 注意
如果你这个文件之前就有内容，上面的命令会把它覆盖掉。这种情况别直接粘贴，改成用文本编辑器打开 ~/.claude/settings.json，手动把下面这段加进去。
3

验证是否生效

运行以下命令检查：

$ claude doctor

看输出里自动更新（Auto-updates）那项是否已经显示为关闭状态。

✅ 手动操作方式
如果 settings.json 已有其他内容，用文本编辑器打开 ~/.claude/settings.json，手动添加：
"env": {"DISABLE_AUTOUPDATER": "1"}
📂 配置文件位置
配置文件路径：C:\Users\你的用户名\.claude\settings.json（位于用户目录下，不是在某个项目文件夹里。放错地方不会生效。）
1

打开「PowerShell」

在开始菜单搜索 "PowerShell"，右键选择「以管理员身份运行」（非必须，但推荐）。

2

创建配置文件并写入设置

复制下面整段命令，粘贴进 PowerShell，回车执行：

PowerShell
PS> mkdir "$env:USERPROFILE\.claude" -Force
PS> @'
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}
'@ | Out-File "$env:USERPROFILE\.claude\settings.json" -Encoding utf8
⚠️ 注意
如果你这个文件之前就有内容，上面的命令会把它覆盖掉。这种情况别直接粘贴，改成用「记事本」或 VS Code 打开该文件，手动把下面这段加进去（保存时选 UTF-8 编码）。
3

验证是否生效

运行以下命令检查：

PS> claude doctor

看输出里自动更新（Auto-updates）那项是否已经显示为关闭状态。

✅ 手动操作方式
如果 settings.json 已有其他内容，用「记事本」或 VS Code 打开 C:\Users\你的用户名\.claude\settings.json，手动添加：
"env": {"DISABLE_AUTOUPDATER": "1"}（保存时选 UTF-8 编码）

❓ 常见疑问解答

Q 关掉之后还能手动更新吗？
能。DISABLE_AUTOUPDATER 只停掉后台自动更新，你想更新时仍然可以手动运行 claude update 命令进行更新。
Q 怎么再打开自动更新？
把 settings.json 里 "DISABLE_AUTOUPDATER": "1" 改成 "0"，或者直接删掉这一行，保存即可。修改后自动更新功能即刻恢复。
Q 用 WinGet (Windows) 或 Homebrew (Mac) 装的需要做这个吗？
不需要。这两种方式本来就不会自动更新。只有原生安装器和 npm 安装的才会自动更新，才需要按本文操作。不确定自己是哪种安装方式？运行 claude doctor 查看安装方式。
Q settings.json 文件不存在怎么办？
这是正常的。settings.json 默认不存在，没有是正常现象。按照本文的步骤操作即可自动创建。确保文件放在正确的用户目录路径下，而不是项目文件夹里。
✅

验证配置是否成功

完成上述步骤后，在终端或 PowerShell 中运行 claude doctor

查找输出中的 Auto-updates 项，确认其状态显示为 disabled 或 关闭。