Claude Code 配置报错 Expected object, but received undefined 的排查与修复

运行 Claude Code 时命令行直接抛出 Settings (C:\Users\reanod\.claude\settings.json): Expected object, but received undefined，这个错误的核心原因是配置文件损坏或格式异常。Claude Code 在启动时需要读取该 JSON 文件的根节点，当文件不存在、内容为空或者解析失败时，系统获取到的就是 undefined 而不是预期中的 JSON 对象。

解决这个问题的关键在于定位文件当前状态，在保留已有配置的前提下重新生成合法的 JSON 结构。

错误产生的根本原因

Claude Code 依赖 C:\Users\reanod\.claude\settings.json 来保存全局偏好与环境参数。配置读取器在加载该路径时存在三类触发场景：

  • 路径下根本没有 settings.json 文件。
  • 文件已创建，但内容为 0 字节（例如上一次写入时意外中断）。
  • 文件包含非法语法，导致 JSON 解析器直接返回空值。

第一步：排查当前配置文件状态

在修改任何文件前，先用只读命令确认文件的实际存在性与体积大小。打开 PowerShell 或 CMD 运行：

Get-Item -Path "C:\Users\reanod\.claude\settings.json" -ErrorAction SilentlyContinue | Select-Object Name, Length, LastWriteTime

执行后观察命令行输出结果：

  • 若无任何内容返回，说明文件未创建。
  • 若 Length 显示为 0，说明文件内容为空。
  • 若 Length 大于 0，说明文件存在但内部 JSON 语法已损坏。

第二步：修复与重置配置

根据第一步排查出的结果，选择对应的命令进行恢复。

场景 A：文件不存在或为空（直接新建）

如果文件不存在或大小为 0 字节，可以直接向该路径写入最基础的合法 JSON 对象 {}。在 PowerShell 中运行：

New-Item -Path "C:\Users\reanod\.claude\settings.json" -ItemType File -Value "{}`n" -Force

这会在 .claude 目录下生成一个合法的配置文件，Claude Code 再次启动时即可正常解析并写入默认参数。

场景 B：文件已存在但语法损坏（备份后重置）

如果文件大于 0 字节，直接覆盖可能会丢失之前配置好的 Key 或参数。建议先将原文件重命名备份，再写入新的空对象：

Rename-Item -Path "C:\Users\reanod\.claude\settings.json" -NewName "settings.json.bak" -Force
New-Item -Path "C:\Users\reanod\.claude\settings.json" -ItemType File -Value "{}`n" -Force

完成后打开 settings.json.bak，检查其中是否有需要手工还原的配置项，修正语法错误后再补回新文件中。

操作速览表

故障现象 诊断方法 修复方式
文件缺失 Get-Item 无输出 运行 New-Item 写入 {}
文件 0 字节 Length 为 0 运行 New-Item 覆盖写入 {}
JSON 语法错误 Length 大于 0 重命名为 .bak 备份，再新建 {} 文件

常见问题 FAQ

Q1: 为什么配置文件会出现 Expected object, but received undefined 报错？

因为 Claude Code 期望从 settings.json 解析出一个包含配置键值的 JSON 对象。当文件为空、缺失或 JSON 格式非法时，解析器返回了空值 undefined，导致类型校验失败。

Q2: 修复这个问题会清除我之前的 Claude Code 设定吗？

如果直接执行新建覆盖，会重置为默认状态。如果原本的文件里有自定义配置，可以通过备份重命名为 settings.json.bak 的方式保留旧内容，方便后续提取。

Q3: 写入 {} 就能让 Claude Code 正常工作吗？

可以。{} 代表一个标准的空 JSON 对象。Claude Code 读取到空对象后不会报错，并会在后续运行中自动将默认配置填充进去。

Q4: 如何手动检查 settings.json 里的语法是否正确？

可以使用 VS Code 等编辑器打开该文件，如果 JSON 语法有误，编辑器会自动弹出红线提示。也可以使用命令行 JSON 校验工具检查格式。

Q5: 执行 New-Item 命令提示权限不足怎么办？

请以管理员身份运行 PowerShell，或者检查 C:\Users\reanod\.claude 文件夹的属性，确保当前 Windows 用户拥有该目录的写入权限。