包含基础配置 + MCP 免费工具 + 死循环监控 + AutoIt3 联合使用
⭐ 记住:以下所有操作,都可以让 AI 模型帮你执行!
本节适合新用户快速完成 Claude Code 环境搭建。如需定制 MCP 工具、死循环监控或 AutoIt 脚本,请移步【高级设置】。
打开终端(CMD 或 PowerShell),执行:
git clone https://github.com/laiyangli001/claude-config.git ~/.claude
克隆完成后进入目录确认文件完整:
cd ~/.claude
dir
如果看到 CLAUDE.md、settings.json.example、mcp-servers/ 等文件和目录,说明克隆成功。
| 组件 | 路径 | 说明 |
|---|---|---|
| 全局 CLAUDE.md | CLAUDE.md | 身份定义、行为边界、工具规则 |
| 设置 | settings.json | API 端点、模型、权限 |
| 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 打断 → 摘要求助 |
| 内嵌 Python | mcp-servers/python3.13.3/ | 嵌入式 Python,无需系统安装,供 GUI 使用 |
| 跨对话记忆 | projects/<slug>/memory/ | 持久化的用户偏好和项目上下文 |
settings.json 是 Claude Code 的核心配置文件,包含 API 凭证、模型选择、权限控制。
首次配置步骤:
copy ~/.claude\settings.json.example ~\.claude\settings.json| 字段 | 说明 | 示例值 |
|---|---|---|
env.ANTHROPIC_BASE_URL | API 端点地址 | https://api.deepseek.com/anthropic |
env.ANTHROPIC_AUTH_TOKEN | 你的 API Key | sk-xxxxxxxxxxxx |
env.ANTHROPIC_MODEL | 使用的模型 | deepseek-v4-flash |
完整示例:
{
"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"
]
}
}
| 命令 | 用途 | 示例 |
|---|---|---|
/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)四个独立 MCP 服务,分别调用 ChatGPT 镜像站、ChatGPT 官方站、DeepSeek 网页版和豆包 AI,不消耗 API token,适合复杂代码审查、长文本分析、联网查资料、图片识别等场景。
ChatGPT 镜像站 2233.ai
自动打开 Chromium 浏览器 → 手动登录 → session 自动保存 → 后续免登录
国内网络可直接访问,无需 VPN
ChatGPT 官方站 chatgpt.com
自动打开 Chromium 浏览器 → 手动登录 → session 自动保存 → 后续免登录
需要 VPN 访问
DeepSeek 网页版 · 国内直连
自动打开 Chromium 浏览器 → 手动登录 DeepSeek → session 自动保存 → 后续免登录
国内网络可直接访问,无需 VPN
豆包 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
运行方式:右键 → 以管理员身份运行(或双击运行)。
node_modules/ 和 python3.13.3/ 已直接入仓,clone 后无需额外安装依赖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
~/.claude.json 决定,与当前 VSCode 工作区无关~/.claude.json 中的 mcpServers 配置是否完整c:/Users/<用户名>/.claude/mcp-servers/...),不依赖工作区路径
在弹出窗口中手动登录对应服务(ChatGPT 镜像站 / ChatGPT 官方站 / DeepSeek / 豆包)
登录完成后关闭浏览器窗口,session 自动保存到独立配置文件中
后续调用不再需要重新登录,直接复用已保存的会话
"CHATGPT_HEADLESS": "true"、"DEEPSEEK_HEADLESS": "true" 或 "DOUBAO_HEADLESS": "true"。
模板文件存放在 mcp-servers/shared/templates/ 目录下,以 .md 格式存储,可通过 /mcp-baipiao skill 自动加载。当前已预置模板:
| 模板 | 文件名 | 适用场景 |
|---|---|---|
| 代码审查 | code_review.md | Python/JS/TS 等代码审查,含角色设定、分析维度、输出格式 |
| 视觉分析 | vision_analysis.md | 界面截图/UI Bug 分析,支持点阵归一化坐标 |
| 长文本 | long_text.md | 长文档/日志总结 |
| 批量任务 | batch_task.md | 批量格式化/生成/转换 |
| 格式化 | format_task.md | 纯文本整理/代码高亮等 |
模板中支持变量插值:{{user_concern}}(关注点)、{{file_name}}(文件名)。/mcp-baipiao 调用时自动完成替换。
自动检测 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,一步到位。
运行 install-deadloop.bat,或在终端手动执行:
cd ~/.claude/deadloop-monitor
node install-extension.mjs
在 settings.json 的 hooks 字段添加 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)
按 Ctrl+Shift+P → 输入 Reload Window → 回车
Reload 后,VS Code 底部状态栏右侧会出现 「🟢 循环守护」 按钮
| 操作 | 说明 |
|---|---|
| ⏸ 暂停监控 | 暂停检测,进程保留 |
| ▶ 恢复监控 | 恢复检测 |
| 📋 检测报告 | 打开 .deadloop-report.md |
| 📋 查看日志 | 打开 deadloop-monitor.jsonl |
config.mjs 中调整阈值(重复次数、反转词密度、信息增量率)node install-extension.mjs 再 Reload 即可AutoIt3 用于模拟鼠标键盘操作,适合自动化控制外部程序、发送按键、窗口管理。
| 功能 | 说明 |
|---|---|
Send / ControlSend | 发送按键 |
MouseClick / MouseMove | 鼠标模拟 |
WinActivate / WinWait | 窗口控制 |
ClipPut / ClipGet | 剪贴板操作 |
我需要一个 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"
deadloop_control.exe 通过上述方式编译,提供了三个子命令:
| 命令 | 说明 |
|---|---|
esc | 长按 ESC 5 秒中断输出 |
inject_file <file> | 粘贴文件内容 + 自动提交(Enter) |
paste_file <file> | 只粘贴不提交 |
功能通过 ControlSend 和 ClipPut + Ctrl+V 实现,完全无窗口干扰。
两者配合可以组成全自动脱困-求助-修复闭环。
死循环监控持续扫描 .jsonl 日志
deadloop_control.exe esc 打断输出 → 确认停止(扫描 stop_reason: "end_turn")
inject_file 将预置的摘要生成指令粘贴到 Claude Code 输入框并自动提交 → 收到注入消息后,Claude Code 自动触发 /mcp-baipiao skill,按场景选择最优服务发送问题
AI 网页版返回代码审查结果或修复建议 → Claude Code 按返回内容修改代码
10 秒冷却后继续监控
mcp__chatgpt-mirror__ask_chatgpt_mirror、mcp__chatgpt-official__ask_chatgpt_official、mcp__deepseek__ask_deepseek、mcp__doubao__ask_doubao、mcp__doubao__download_doubao_fileconfig.mjs 中的冷却时间、触发阈值可根据工作节奏调整CHATGPT_HEADLESS=true 设为隐藏浏览器模式(但首次仍需登录)CHATGPT_HEADLESS 是否被设为 "true"。设为 "false" 或删除该变量即可。cd ~/.claude/mcp-servers && npx playwright install chromiumCtrl+Shift+P → Reload Window 重启,让 MCP 服务重新加载。deadloop-monitor/config.mjs,调整重复次数、反转词密度、信息增量率等阈值参数。cd ~/.claude && git pull
cd ~/.claude
git status
git add -A
git commit -m "描述你的改动"
git push
cd ~/.claude/mcp-servers
install-mcp-deps.bat
cd ~/.claude/mcp-servers
install-deadloop.bat