Claude Code 完美调和配置
这是经过多轮磨合后的全局配置,可以直接复制到新电脑的
~/.claude/settings.json使用。 也可以直接让 AI 处理一切。
完整配置文件
~/.claude/settings.json
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的token",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_REASONING_MODEL": "deepseek-v4-pro[1m]",
"API_TIMEOUT_MS": "1200000",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "80",
"CLAUDE_CODE_EFFORT_LEVEL": "max",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro[1m]"
},
"permissions": {
"allow": ["*"],
"ask": [
"Bash(sudo :*)",
"Bash(curl :* | bash :*)",
"Bash(:* | sh :*)"
],
"defaultMode": "acceptEdits",
"deny": [
"Bash(rm -rf :*)",
"Bash(:* > /dev/sda :*)",
"Bash(:* :* > /etc/:*)",
"Bash(chmod 777 :*)"
]
},
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"任务已完成\" with title \"Claude Code\" sound name \"Glass\"'"
}
]
}
],
"StopFailure": [
{
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"任务异常终止\" with title \"Claude Code\" sound name \"Basso\"'"
}
]
}
],
"PermissionRequest": [
{
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"需要你的权限确认\" with title \"Claude Code\" sound name \"Ping\"'"
}
]
}
],
"PostToolUseFailure": [
{
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"工具执行失败\" with title \"Claude Code\" sound name \"Frog\"'"
}
]
}
]
}
}
配置逐项说明
1. env --- 模型与后端
| 变量 | 值 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL |
https://api.deepseek.com/anthropic |
使用 DeepSeek 作为后端 API |
ANTHROPIC_MODEL |
deepseek-v4-pro[1m] |
默认模型,1M 上下文窗口 |
ANTHROPIC_DEFAULT_OPUS_MODEL |
deepseek-v4-pro[1m] |
Opus 级别任务模型 |
ANTHROPIC_DEFAULT_SONNET_MODEL |
deepseek-v4-pro[1m] |
Sonnet 级别任务模型 |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
deepseek-v4-flash |
Haiku 级别任务模型(轻量快速) |
ANTHROPIC_REASONING_MODEL |
deepseek-v4-pro[1m] |
推理模型 |
CLAUDE_CODE_SUBAGENT_MODEL |
deepseek-v4-pro[1m] |
子 agent 使用的模型 |
API_TIMEOUT_MS |
1200000 |
API 超时 20 分钟 |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE |
80 |
上下文达到 80% 时自动压缩 |
CLAUDE_CODE_EFFORT_LEVEL |
max |
最大努力程度 |
2. permissions --- 权限控制
| 配置项 | 值 | 说明 |
|---------------|---------------|--------------------------------|----------------------|
| allow | ["*"] | 默认允许所有操作 |
| defaultMode | acceptEdits | 编辑类操作不弹框,其他操作仍会确认 |
| ask | 管道命令类 | 涉及 sudo、`curl | bash、sh` 等危险管道需确认 |
| deny | 危险命令 | rm -rf、写磁盘、chmod 777 等直接拦截 |
核心思路: 允许一切 + 黑名单拦截高危操作 + acceptEdits 减少常规弹框。既安全又不打扰。
3. hooks --- 系统通知(macOS 专用)
| 事件 | 提示音 | 触发时机 |
|---|---|---|
Stop |
Glass | 任务正常完成 |
StopFailure |
Basso | 任务异常终止 |
PermissionRequest |
Ping | 需要确认权限 |
PostToolUseFailure |
Frog | 工具执行失败 |
Windows/Linux 需替换
osascript为对应的通知命令。
已安装的 MCP 服务器
全部 5 个 MCP 统一配置在 ~/.mcp.json(按 Claude Code 规范,用户级 MCP 放此文件)。
| 服务器 | 命令 | 用途 |
|---|---|---|
| playwright | playwright-mcp |
浏览器自动化测试、网页截图、表单填写 |
| godot | godot-mcp |
Godot 游戏引擎编辑器控制、节点管理、动画编辑 |
| context7 | context7-mcp |
实时查询最新库/SDK/框架文档 |
| godot-docs | mcp-server-godot-docs |
Godot 引擎文档查询 |
| github | github-mcp-server stdio |
GitHub 仓库操作(PR、Issue 等) |
新电脑快速部署步骤
- 复制上面的 JSON 到
~/.claude/settings.json - 替换
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL为你自己的 API 凭证 - 安装 MCP 服务器命令,然后复制下面的
~/.mcp.json - 如果是 macOS,hooks 的 osascript 通知直接生效;Windows/Linux 需要修改 hook 命令
- 重启 Claude Code 或输入
/hooks加载配置
配套 ~/.mcp.json
json
{
"mcpServers": {
"playwright": {
"command": "playwright-mcp"
},
"godot": {
"command": "godot-mcp"
},
"context7": {
"command": "context7-mcp"
},
"godot-docs": {
"command": "mcp-server-godot-docs",
"env": {
"GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot"
}
},
"github": {
"command": "github-mcp-server",
"args": ["stdio"]
}
}
}
每个服务器的 command 需要提前通过
npm install -g xxx-mcp或对应方式安装。godot-docs需要指定 Godot 引擎路径。