Linux 下 Claude Code 配置文件位置总结

1. 核心结论

Linux 下 Claude Code 的用户级配置文件通常是：

bash 复制代码

~/.claude/settings.json

其中 ~ 表示当前用户的 home 目录。

例如：

当前用户	`~/.claude/settings.json` 实际路径
`root`	`/root/.claude/settings.json`
`ma-user`	`/home/ma-user/.claude/settings.json`
普通用户 `alice`	`/home/alice/.claude/settings.json`

它对应 Windows 下的路径：

text 复制代码

C:\Users\你的用户名\.claude\settings.json

2. Linux 下如何创建或编辑配置文件

如果配置目录不存在，可以先创建：

bash 复制代码

mkdir -p ~/.claude

然后使用编辑器打开：

bash 复制代码

nano ~/.claude/settings.json

或者：

bash 复制代码

vim ~/.claude/settings.json

查看当前配置：

bash 复制代码

cat ~/.claude/settings.json

3. 用户级配置与项目级配置的区别

Claude Code 配置可以分为用户级和项目级。

配置类型	路径	作用范围
用户级配置	`~/.claude/settings.json`	对当前用户的所有项目生效
项目级共享配置	`项目目录/.claude/settings.json`	对当前项目生效，可随项目共享
项目级本地配置	`项目目录/.claude/settings.local.json`	对当前项目生效，通常只用于个人本地配置

4. 项目级配置示例

如果只想对某个项目生效，可以进入项目目录：

bash 复制代码

cd /root/workspace
mkdir -p .claude
nano .claude/settings.json

如果只是个人本地偏好，不希望提交到 Git，可以使用：

bash 复制代码

.claude/settings.local.json

5. 常见 settings.json 配置示例

如果希望 Claude Code 自动接受一些安全的文件编辑操作，可以使用类似配置：

json 复制代码

{
  "defaultMode": "acceptEdits",
  "permissions": {
    "allow": [
      "Bash(ls *)",
      "Bash(cat *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(python --version)",
      "Bash(python -m pytest *)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push *)",
      "Bash(curl *)",
      "Bash(wget *)",
      "Read(./.env)",
      "Read(./secrets/**)"
    ]
  }
}

这个配置的含义是：

默认使用 acceptEdits 模式；
允许一些安全的查看类命令；
允许运行 Python 版本检查和测试命令；
禁止危险删除命令；
禁止 git push；
禁止直接读取 .env 和 secrets 目录。

6. `acceptEdits` 是什么？

acceptEdits 可以理解为：

自动接受 Claude Code 对当前工作目录中的文件创建和编辑操作。

适合以下场景：

生成 Markdown 文件；
修改代码文件；
创建总结文档；
批量整理项目文件；
减少每次编辑都需要手动确认的次数。

但它不是完全无权限限制模式，某些命令或危险操作仍然可能需要确认。

7. MCP 配置和 settings.json 不是同一个东西

需要注意：

Claude Code 的普通设置和 MCP server 配置不是完全放在同一个文件里。

普通行为设置通常在：

bash 复制代码

~/.claude/settings.json

MCP 相关配置常见位置包括：

bash 复制代码

~/.claude.json

以及项目目录下：

bash 复制代码

.mcp.json

因此，如果你要配置 Claude Code 的权限、默认模式、自动确认行为，一般看：

bash 复制代码

~/.claude/settings.json

如果你要配置 MCP server，则需要重点看：

bash 复制代码

~/.claude.json
项目目录/.mcp.json

8. Windows 与 Linux 路径对照

系统	用户级 settings 配置路径
Windows	`C:\Users\用户名\.claude\settings.json`
Linux	`~/.claude/settings.json`
Linux root 用户	`/root/.claude/settings.json`
Linux 普通用户	`/home/用户名/.claude/settings.json`

9. 推荐排查命令

查看当前用户

bash 复制代码

whoami

查看 home 目录

bash 复制代码

echo $HOME

查看 Claude Code 配置目录

bash 复制代码

ls -la ~/.claude

查看 settings.json

bash 复制代码

cat ~/.claude/settings.json

编辑 settings.json

bash 复制代码

nano ~/.claude/settings.json

10. 总结

Linux 下 Claude Code 的主要配置文件是：

bash 复制代码

~/.claude/settings.json

如果当前是 root 用户，实际路径是：

bash 复制代码

/root/.claude/settings.json

如果当前是普通用户，例如 ma-user，实际路径是：

bash 复制代码

/home/ma-user/.claude/settings.json

项目级配置可以放在：

bash 复制代码

项目目录/.claude/settings.json
项目目录/.claude/settings.local.json

MCP 配置需要另外关注：

bash 复制代码

~/.claude.json
项目目录/.mcp.json

一句话总结：

Linux 下的 ~/.claude/settings.json 就相当于 Windows 下 C:\Users\用户名\.claude\settings.json，用于配置 Claude Code 的默认行为、权限策略和自动确认模式；MCP server 配置则通常在 ~/.claude.json 或项目目录的 .mcp.json 中。

Linux 下 Claude Code 配置文件位置总结