⚙️ Claude Config 使用教程

包含基础配置 + MCP 免费工具 + 死循环监控 + AutoIt3 联合使用

⭐ 记住:以下所有操作,都可以让 AI 模型帮你执行!

📦 基础设置(快速上手)

本节适合新用户快速完成 Claude Code 环境搭建。如需定制 MCP 工具、死循环监控或 AutoIt 脚本,请移步【高级设置】。

克隆配置仓库

打开终端(CMD 或 PowerShell),执行:

git clone https://github.com/laiyangli001/claude-config.git ~/.claude

克隆完成后进入目录确认文件完整:

cd ~/.claude
dir

如果看到 CLAUDE.mdsettings.json.examplemcp-servers/ 等文件和目录,说明克隆成功。

💡 也可以直接对我说 "帮我克隆配置仓库",AI 会自动完成以上步骤。

目录结构

组件路径说明
全局 CLAUDE.mdCLAUDE.md身份定义、行为边界、工具规则
设置settings.jsonAPI 端点、模型、权限
MCP 免费工具mcp-servers/mcp-chatgpt-mirror/ChatGPT 镜像站,不消耗 API token
mcp-servers/mcp-chatgpt-official/ChatGPT 官方站,不消耗 API token
mcp-servers/mcp-deepseek/DeepSeek 网页版,不消耗 API token
mcp-servers/mcp-doubao/豆包 AI,图片/文档识别、PPT 生成
死循环监控deadloop-monitor/输出死循环检测 → AutoIt 打断 → 摘要求助
内嵌 Pythonmcp-servers/python3.13.3/嵌入式 Python,无需系统安装,供 GUI 使用
跨对话记忆projects/<slug>/memory/持久化的用户偏好和项目上下文

基础配置(settings.json)

settings.json 是 Claude Code 的核心配置文件,包含 API 凭证、模型选择、权限控制。

首次配置步骤:

  1. 从模板复制(模板不含真实 token):
    copy ~/.claude\settings.json.example ~\.claude\settings.json
  2. 编辑 settings.json,填入以下关键字段:
字段说明示例值
env.ANTHROPIC_BASE_URLAPI 端点地址https://api.deepseek.com/anthropic
env.ANTHROPIC_AUTH_TOKEN你的 API Keysk-xxxxxxxxxxxx
env.ANTHROPIC_MODEL使用的模型deepseek-v4-flash
  1. (可选)调整 systemPrompt、effortLevel、permissions

完整示例:

{
  "systemPrompt": "你的思考过程(thinking)必须全程使用中文。这不是建议,是硬性要求。任何推理、分析、决策、内部对话——一律中文。",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的真实token",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "USER": "你的用户名",
    "USERNAME": "你的用户名"
  },
  "output_config": { "effort": "high/max" },
  "includeCoAuthoredBy": false,
  "effortLevel": "high",
  "permissions": {
    "allow": [
      "mcp__chatgpt-mirror__ask_chatgpt_mirror",
      "mcp__chatgpt-official__ask_chatgpt_official",
      "mcp__deepseek__ask_deepseek",
      "mcp__doubao__ask_doubao",
      "mcp__doubao__download_doubao_file"
    ]
  }
}
⚠️ 安全提醒: settings.json 包含 API token,已在 .gitignore 中排除,不会上传到 GitHub。
💡 也可以直接对我说 "帮我配置 settings.json",AI 会自动从模板复制并引导你填写关键字段。

基础命令与工作流

命令用途示例
/help查看所有可用命令/help
/clear清空当前对话历史/clear
/grill-me新任务前对齐需求/grill-me
/tdd测试驱动开发流程/tdd
/diagnose结构化排查 bug/diagnose
/caveman省 token 模式/caveman
/improve-codebase-architecture架构审查/improve-codebase-architecture
/zoom-out退一步审视设计/zoom-out
/loop <间隔> <命令>定时重复执行/loop 5m /diagnose

记忆系统(跨对话持久化)

Claude Code 会自动保存关键信息到 ~/.claude/projects/<slug>/memory/,实现跨对话记忆。

指令示例
把这段配置写入记忆"把当前的 API 端点配置写入记忆"
记住这个做法"记住这个 deploy 流程"
查看之前的配置"帮我看看之前 MCP 怎么安装的"
设置提醒"以后修改代码时,提醒我用 /tdd"

跨设备同步:记忆文件通过 git 上传到 GitHub,在各设备执行 cd ~/.claude && git pull 即可同步。

备份与同步(可选)

将自己的配置推送到 GitHub,方便多设备共享。

首次推送(创建仓库后):

cd ~/.claude
git remote add origin https://github.com/<你的用户名>/<仓库名>.git
git add -A
git commit -m "chore: 初始化 Claude Code 配置"
git push -u origin master

日常备份:

cd ~/.claude
git status
git add -A
git commit -m "chore: 更新配置"
git push

从另一台设备同步:

cd ~/.claude && git pull

自动排除的内容(已在 .gitignore 中配置):

  • settings.json(含 API token,需手动复制)
  • projects/**/*.jsonl(对话记录,不跨设备共享)
  • 运行时标记文件(.deadloop-*, *.heartbeat
💡 也可以直接对我说 "帮我备份配置到 GitHub""帮我同步配置",AI 会自动执行对应的 git 操作。

🤖 MCP 免费工具:四合一

四个独立 MCP 服务,分别调用 ChatGPT 镜像站、ChatGPT 官方站、DeepSeek 网页版和豆包 AI,不消耗 API token,适合复杂代码审查、长文本分析、联网查资料、图片识别等场景。

✨ 优先使用

ask_chatgpt_mirror

ChatGPT 镜像站 2233.ai

自动打开 Chromium 浏览器 → 手动登录 → session 自动保存 → 后续免登录

国内网络可直接访问,无需 VPN

🔄 备用

ask_chatgpt_official

ChatGPT 官方站 chatgpt.com

自动打开 Chromium 浏览器 → 手动登录 → session 自动保存 → 后续免登录

需要 VPN 访问

🔄 备用

ask_deepseek

DeepSeek 网页版 · 国内直连

自动打开 Chromium 浏览器 → 手动登录 DeepSeek → session 自动保存 → 后续免登录

国内网络可直接访问,无需 VPN

🖼️ 视觉

ask_doubao

豆包 AI · 图片/文档识别、PPT 生成

自动打开 Chromium 浏览器 → 手动登录豆包 → session 自动保存 → 后续免登录

支持图片识别、PPT 生成、Excel 表格处理

使用 download_doubao_file 工具下载生成的文件

文件结构

~/.claude/mcp-servers/
├── mcp-chatgpt-mirror/   # ChatGPT 镜像站
├── mcp-chatgpt-official/ # ChatGPT 官方站
├── mcp-deepseek/         # DeepSeek 网页版
├── mcp-doubao/           # 豆包 AI(图片识别/PPT 生成)
├── deadloop-monitor/     # 死循环监控
├── shared/               # 共享模块(四服务共用)
│   ├── browser.mjs       # 浏览器生命周期
│   ├── answer.mjs        # 回答检测/提取
│   ├── upload.mjs        # 文件上传
│   └── role.mjs          # 角色模板
├── python3.13.3/          # 内嵌 Python(GUI 配置界面)
├── node_modules/          # 依赖(四服务共用)
├── install-mcp-deps.bat  # 一键安装
└── install-mcp-config.mjs # 注册 MCP 配置 → 写入 ~/.claude.json

一键安装(批处理)

~/.claude/ 目录下双击 install-mcp-deps.bat

@echo off
echo [1/2] Installing Chromium browser for Playwright...
cd /d "%~dp0"
npx playwright install chromium
echo [2/2] Registering MCP server config...
node install-mcp-config.mjs
echo Done! Please Reload Window (Ctrl+Shift+P -> Reload Window).
pause

运行方式:右键 → 以管理员身份运行(或双击运行)。

💡 也可以直接对我说 "帮我安装 MCP 依赖",AI 会自动完成以上安装步骤。

MCP 配置文件说明

Claude Code 通过两个配置文件加载 MCP 服务:

配置文件位置优先级说明
.claude.json~/.claude.json(用户家目录)高(主要)install-mcp-config.mjs 写入此文件,始终被 Claude Code 加载
.mcp.json~/.claude/.mcp.json低(次要)本地参考副本,某些工作区可能不自动加载
关键逻辑:
~/.claude.json 是 MCP 服务注册的主要配置文件install-mcp-config.mjs 自动将四个服务的启动路径写入此文件
.mcp.json 是本仓库内的参考副本,实际运行时不一定被 Claude Code 读取
• 仓库克隆后必须执行 install-mcp-deps.bat(或 node install-mcp-config.mjs)将 MCP 配置写入 ~/.claude.json
切换工作区的注意事项:
• MCP 服务路径由 ~/.claude.json 决定,与当前 VSCode 工作区无关
• 如果切换工作区后某 MCP 服务无法调用,优先检查 ~/.claude.json 中的 mcpServers 配置是否完整
• 四个服务的启动命令都使用绝对路径(c:/Users/<用户名>/.claude/mcp-servers/...),不依赖工作区路径

首次使用与登录

手动登录

在弹出窗口中手动登录对应服务(ChatGPT 镜像站 / ChatGPT 官方站 / DeepSeek / 豆包)

关闭窗口

登录完成后关闭浏览器窗口,session 自动保存到独立配置文件中

后续复用

后续调用不再需要重新登录,直接复用已保存的会话

注意:四个服务使用独立的浏览器配置文件,需要分别登录一次。
若需隐藏浏览器窗口(无人值守场景),在 settings.json 的 env 中设置 "CHATGPT_HEADLESS": "true""DEEPSEEK_HEADLESS": "true""DOUBAO_HEADLESS": "true"

提示词模板

模板文件存放在 mcp-servers/shared/templates/ 目录下,以 .md 格式存储,可通过 /mcp-baipiao skill 自动加载。当前已预置模板:

模板文件名适用场景
代码审查code_review.mdPython/JS/TS 等代码审查,含角色设定、分析维度、输出格式
视觉分析vision_analysis.md界面截图/UI Bug 分析,支持点阵归一化坐标
长文本long_text.md长文档/日志总结
批量任务batch_task.md批量格式化/生成/转换
格式化format_task.md纯文本整理/代码高亮等

模板中支持变量插值:{{user_concern}}(关注点)、{{file_name}}(文件名)。/mcp-baipiao 调用时自动完成替换。

🔄 死循环监控(Dead Loop Monitor)

自动检测 Claude Code 输出是否陷入重复、反转、信息停滞,打断并求助第三方 AI 协助脱困。

扩展包文件架构

~/.claude/deadloop-monitor/
├── stop-hook.mjs              # Stop Hook 检测(事件驱动,零延迟)
├── detectors.mjs              # 重复/反转/停滞检测器
├── helpers.mjs                # AutoIt 调用、文件读取
├── deadloop_control.au3       # AutoIt 源码
├── deadloop_control.exe       # 编译后的无窗口 exe
├── config.mjs                 # 所有阈值参数
├── logger.mjs                 # JSON 日志,自动轮转
├── workspace-watcher/         # VS Code 扩展(状态栏 + 配置界面)
│   ├── extension.js
│   └── package.json
├── install-extension.mjs      # 装扩展(由 install-deadloop.mjs 调用)
└── install-deadloop.mjs       # 一键安装:装扩展 + 注册 Hook

一键安装

运行 install-deadloop.bat 或直接执行:

cd ~/.claude/deadloop-monitor
node install-deadloop.mjs

脚本自动完成:装扩展 + 注册 Stop Hook,一步到位。

💡 也可以直接对我说 "帮我安装死循环监控",AI 会自动完成以上安装步骤。

扩展安装与界面

安装扩展

运行 install-deadloop.bat,或在终端手动执行:

cd ~/.claude/deadloop-monitor
node install-extension.mjs

注册 Stop Hook

settings.jsonhooks 字段添加 Stop 事件配置,详见 README.md。

安装成功提示

[deadloop] extension installed to C:\Users\<用户名>\.vscode\extensions\laiyangli.deadloop-workspace-watcher-1.0.0
[deadloop] reload VS Code to activate (Ctrl+Shift+P → Reload Window)

Reload VS Code

Ctrl+Shift+P → 输入 Reload Window → 回车

Reload 后,VS Code 底部状态栏右侧会出现 「🟢 循环守护」 按钮

菜单操作(左键点击状态栏)

操作说明
⏸ 暂停监控暂停检测,进程保留
▶ 恢复监控恢复检测
📋 检测报告打开 .deadloop-report.md
📋 查看日志打开 deadloop-monitor.jsonl

使用说明

💡 也可以直接对我说 "帮我安装死循环监控扩展",AI 会自动完成扩展安装步骤。
💡 也可以直接对我说 "帮我调整循环检测阈值宽松一点",AI 会自动调整循环检测阈值。

⌨️ AutoIt3 脚本编译与调用

AutoIt3 用于模拟鼠标键盘操作,适合自动化控制外部程序、发送按键、窗口管理。

功能概览

功能说明
Send / ControlSend发送按键
MouseClick / MouseMove鼠标模拟
WinActivate / WinWait窗口控制
ClipPut / ClipGet剪贴板操作

生成 au3 脚本的提示词模板

我需要一个 AutoIt3 脚本,实现以下需求:
<描述需求,例如:每 10 秒检测某个窗口是否存在,若存在则发送 F5 刷新>

请生成:
- 完整的 .au3 脚本代码
- 编译命令(使用 @Aut2Exe/Aut2exe_x64.exe,添加 /console 参数)
- 如何从 Node.js / Python 调用该 exe 的示例代码

编译命令模板(必须无窗口静默编译)

cmd //c "@Aut2Exe/Aut2exe_x64.exe /in "C:\Users\<用户名>\.claude\mcp-servers\deadloop-monitor\script.au3" /out "C:\Users\<用户名>\.claude\mcp-servers\deadloop-monitor\script.exe" /console"

也可使用绝对路径(避免当前目录问题):

cmd //c "@C:\Users\<用户名>\.claude\Aut2Exe\Aut2exe_x64.exe /in "C:\full\path\to\script.au3" /out "C:\full\path\to\output.exe" /console"
⚠️ 注意:编译时杀毒软件可能拦截生成的 .exe,需手动添加至信任区(白名单),或临时关闭实时防护。

在 deadloop-monitor 中的实际应用

deadloop_control.exe 通过上述方式编译,提供了三个子命令:

命令说明
esc长按 ESC 5 秒中断输出
inject_file <file>粘贴文件内容 + 自动提交(Enter)
paste_file <file>只粘贴不提交

功能通过 ControlSendClipPut + Ctrl+V 实现,完全无窗口干扰。

🔗 MCP 工具 + 死循环监控 联合使用指南

两者配合可以组成全自动脱困-求助-修复闭环。

典型工作流(自动执行,不需要手动)

监控阶段

死循环监控持续扫描 .jsonl 日志

检测到死循环

deadloop_control.exe esc 打断输出 → 确认停止(扫描 stop_reason: "end_turn"

注入求助指令

inject_file 将预置的摘要生成指令粘贴到 Claude Code 输入框并自动提交 → 收到注入消息后,Claude Code 自动触发 /mcp-baipiao skill,按场景选择最优服务发送问题

获取外部答案

AI 网页版返回代码审查结果或修复建议 → Claude Code 按返回内容修改代码

冷却恢复

10 秒冷却后继续监控

配置要点

常见问题

浏览器没有弹出窗口
检查 settings.json 中 CHATGPT_HEADLESS 是否被设为 "true"。设为 "false" 或删除该变量即可。
"Failed to launch browser" 错误
Playwright Chromium 没有正确安装。手动运行:
cd ~/.claude/mcp-servers && npx playwright install chromium
MCP 工具报 "Page crashed"
常见原因:1) 无法访问目标站点(国内访问官方站需 VPN,尝试切换镜像站);2) 浏览器配置目录被锁定(结束所有 Chrome 进程后重试)。
更新代码后还是旧行为
VS Code 中按 Ctrl+Shift+PReload Window 重启,让 MCP 服务重新加载。
如何调整死循环检测灵敏度?
编辑 deadloop-monitor/config.mjs,调整重复次数、反转词密度、信息增量率等阈值参数。

🔄 维护与更新

拉取最新代码

cd ~/.claude && git pull

提交本地修改

cd ~/.claude
git status
git add -A
git commit -m "描述你的改动"
git push

安装 MCP 依赖

cd ~/.claude/mcp-servers
install-mcp-deps.bat

安装死循环监控

cd ~/.claude/mcp-servers
install-deadloop.bat