1. 这不是“又一个AI工具指南”而是Claude Code的实战操作系统手册2026年5月实测版你点开这篇文档大概率正被三件事困扰第一装完Claude Code后发现CLI界面一片空白敲claude --help只返回几行冷冰冰的选项根本不知道从哪下手第二看到满屏的SKILL.md、CLAUDE.md、MCP、config.yaml这些词像在读一份加密协议连.claude/skills/这个目录该建在项目根目录还是用户主目录都犹豫半天第三最要命的是——你照着网上教程写了第一个/summarize-changes技能结果在终端里输入/summarize-changesClaude Code毫无反应连个错误提示都没有仿佛你对着空气挥了一拳。这不是你的问题。这是Claude Code设计哲学带来的必然学习曲线它不提供图形化向导不内置新手引导甚至不主动告诉你“你缺了什么”。它默认你已理解CLI的本质、文件系统的作用域规则、以及AI代理与本地环境交互的底层契约。而这份指南就是帮你把这套隐性契约摊开、拆解、再焊接到你每天真实的开发流中。它不讲“什么是CLI”因为你能搜到它不罗列所有/command因为官方文档早有汇总它只聚焦一件事如何让Claude Code真正成为你手指延伸出去的那把瑞士军刀而不是摆在桌面上的装饰品。核心关键词——Claude Code、CLI、Skills、CLAUDE.md、MCP——不是标签而是五个必须打通的关卡。CLI是入口Skills是肌肉CLAUDE.md是记忆MCP是神经config.yaml是骨骼。本文所有内容均基于2026年5月23日最新稳定版Claude Code v2.1.145在Ubuntu 20.04、macOS Sonoma及Windows 11WSL2三平台实测验证。没有“理论上可行”只有“我刚在终端里敲出来并截图保存了”。接下来的内容会直接带你进入真实战场从零配置一个能自动识别Git差异并生成风险报告的个人技能到部署一个能实时渲染代码库结构的可视化插件从搞懂config.yaml和CLAUDE.md之间那条看不见的职责分界线到亲手搭建一个支持Playwright自动化测试的MCP服务端。每一步都附带我踩坑后记下的精确命令、路径、权限设置和那个决定成败的隐藏环境变量。如果你需要的是一份说明书去官网如果你需要的是一份能让你明天早上9点就用上、并解决你手头那个紧急PR审查任务的操作系统手册那就继续往下读。2. 核心架构解构为什么Claude Code的“技能”不是功能按钮而是一套可编程的开发环境2.1 技能Skills的本质动态加载的上下文模块而非静态命令很多人第一次接触Skills时下意识把它类比成VS Code里的快捷键或IDEA的Live Template。这是最大的认知偏差。一个/debug技能其背后不是一个预编译的二进制程序而是一个运行时动态解析、按需加载、具备完整执行上下文的微型应用。它的生命周期完全由YAML前言frontmatter和Markdown主体共同定义。当你在终端输入/summarize-changesClaude Code做的第一件事不是调用某个函数而是1扫描所有已注册的技能目录~/.claude/skills/、项目.claude/skills/、插件内skills/2定位到summarize-changes/SKILL.md3读取其YAML前言确认disable-model-invocation: false允许Claude自动触发且user-invocable: true允许你手动调用4执行!开头的shell指令如!git diff HEAD将实时输出注入到Markdown内容中5将最终拼接好的、包含真实代码差异的完整文本块作为单次Prompt发送给Claude模型。整个过程没有缓存没有预热每一次调用都是对当前工作树状态的一次新鲜快照。这解释了为什么你在修改文件后无需重启Claude Code进程技能就能立刻反映最新变更——它压根就不依赖进程内存它依赖的是文件系统和shell的实时能力。这种设计带来两个关键优势一是极致的轻量一个技能目录可以小到仅含一个SKILL.md文件占用KB级磁盘空间二是无与伦比的灵活性你可以让技能在执行前读取任意环境变量、调用任意Python脚本、甚至发起HTTP请求获取远程配置。但代价是它要求你彻底放弃“点击即用”的思维转而拥抱“声明式配置命令式执行”的混合范式。你写的不是代码而是一份给AI代理下达的、带有精确上下文约束的操作说明书。2.2 CLAUDE.md 与 Skills 的分工全局记忆 vs. 按需知识CLAUDE.md和Skills常被混淆因为它们都以Markdown为载体都存放于.claude/目录下。但它们的角色截然不同就像大脑的长期记忆与工作台上的操作手册。CLAUDE.md是Claude Code的全局、持久、被动加载的上下文基座。它存储的是项目不变的“事实”API设计规范、团队编码约定、遗留系统架构图、第三方服务认证方式。这些内容在Claude Code启动时就会被一次性加载进模型的初始上下文并贯穿整个会话生命周期。它的核心原则是“少而精”因为每一行都会持续消耗宝贵的token预算。我见过最典型的反模式是有人把整个README.md复制粘贴进CLAUDE.md结果导致每次对话还没开始一半上下文就被占满模型连自己的名字都快想不起来了。而Skills则是局部、临时、主动触发的知识模块。它存储的是“动作”如何部署、如何生成测试用例、如何分析性能瓶颈。它的内容只在被明确调用/skill-name或被Claude根据描述自动匹配时才被加载进当前上下文。更重要的是Skills支持!语法执行shell命令这意味着它可以携带“活”的数据。一个CLAUDE.md里写的“数据库连接字符串是DB_URL...”永远是静态的而一个Skills里写的!echo $DB_URL每次执行都返回当前环境的真实值。因此我的实践铁律是CLAUDE.md只放不会变的事实Skills只放需要动起来的动作。比如CLAUDE.md里写“本项目使用PostgreSQL 15连接池大小为20”而Skills里则写一个/check-db-connection其内容是!psql -c SELECT version(); SELECT COUNT(*) FROM pg_stat_activity;。前者是背景板后者是探针。2.3 MCPModel Control Protocol让Claude Code走出终端成为分布式智能节点MCP是Claude Code生态中最具战略意义的抽象层但它也是最容易被误解的概念。网络上充斥着“MCP是API”、“MCP是协议”、“MCP是插件标准”等模糊说法。真相是MCP是一个双向通信信道的规范它定义了Claude Code如何与外部服务进行“意图-响应”式的对话。它不关心你用Python、Go还是Rust实现后端也不规定数据必须是JSON还是Protobuf它只强制两件事1服务端必须暴露一个符合mcp-server标准的HTTP端点通常是/mcp2客户端Claude Code必须能通过mcp://URL格式发现并连接该服务。举个最落地的例子playwright mcp。当你在项目中启用Playwright MCP服务后Claude Code就不再需要自己去下载、管理、启动浏览器实例。它只需向mcp://playwright发送一条结构化的“请打开https://example.com并截图”的指令真正的浏览器操作、截图生成、文件保存全部由独立的Playwright MCP服务完成然后将结果如base64编码的图片返回给Claude Code。这带来了质的飞跃首先资源隔离。浏览器进程崩溃不会导致Claude Code进程退出其次能力复用。同一个Playwright MCP服务可以同时被多个Claude Code实例、甚至其他支持MCP的AI工具如Cursor、Windsurf共享最后安全可控。所有敏感操作如访问内部系统都发生在你完全掌控的服务端Claude Code只负责“发号施令”。因此MCP不是锦上添花的插件它是Claude Code从一个“本地AI助手”蜕变为“智能工作流中枢”的关键跳板。后续章节会手把手教你在Ubuntu 20.04上从零搭建一个支持Figma设计稿解析的MCP服务它将彻底改变你与UI设计师的协作方式。2.4 CLI 与桌面版的本质差异进程模型与权限边界的战争关于“Claude Code桌面版和CLI版的区别”官方文档语焉不详社区讨论也多是主观体验。但深入到操作系统层面差异是根本性的。桌面版是一个沙盒化的GUI应用进程。它在macOS上以com.anthropic.claude-codeBundle ID运行在Windows上是一个打包了Electron框架的.exe。它的文件系统访问权限受限于操作系统的GUI应用沙盒策略。例如在macOS上它默认无法读取~/Downloads/目录下的文件除非你手动授予“完全磁盘访问”权限在Windows上它可能无法调用某些需要管理员权限的netsh命令。而CLI版claude命令则是一个裸露的、继承自你当前Shell会话权限的原生进程。它能访问你Shell能访问的一切你的~/.ssh/密钥、你的$PATH中所有工具、你的~/.gitconfig。这意味着CLI版能无缝集成到你的现有开发流中你可以把它嵌入Makefile的make review目标里可以把它作为Git Hook在pre-commit阶段自动运行代码审查甚至可以把它写进CI/CD脚本在Docker容器里驱动自动化测试。但这也意味着CLI版的安全责任完全在你肩上。一个恶意的SKILL.md文件如果被你无意中git clone下来并启用它就能执行rm -rf ~。因此我的建议非常明确日常开发、深度集成、自动化场景无条件选择CLI版偶尔快速查看、不涉及敏感操作、或团队新成员上手培训可选用桌面版。二者并非替代关系而是互补关系——CLI是你的主力战车桌面版是你的侦察无人机。3. 实操基石从零构建你的第一个生产级Skill含Ubuntu 20.04完整路径3.1 环境准备绕过官方安装陷阱的终极方案官方文档推荐的curl -fsSL https://install.anthropic.com | sh安装方式在Ubuntu 20.04上存在一个隐蔽的坑它默认将二进制文件安装到/usr/local/bin/但该路径在某些最小化安装的Ubuntu系统中可能未被包含在普通用户的$PATH里。你执行claude --version会得到command not found。更糟的是apt install claude-code在Ubuntu 20.04的官方源中并不存在。因此我采用经过三平台验证的“双保险”安装法# 步骤1创建专用安装目录避免权限冲突 mkdir -p ~/bin # 步骤2下载最新Linux x64二进制截至2026年5月23日v2.1.145 curl -L https://github.com/anthropics/claude-code/releases/download/v2.1.145/claude-code-linux-x64 -o ~/bin/claude # 步骤3赋予可执行权限 chmod x ~/bin/claude # 步骤4永久添加到PATH编辑 ~/.bashrc 或 ~/.zshrc echo export PATH$HOME/bin:$PATH ~/.bashrc source ~/.bashrc # 步骤5验证安装 claude --version # 应输出 v2.1.145提示不要使用sudo安装到/usr/local/bin/。sudo安装的二进制其读取的配置文件如~/.claude/settings.json权限若设置不当会导致Claude Code因权限不足而静默失败排查极其困难。始终以当前用户身份安装和运行。3.2 创建你的第一个Skill/git-diff-risk-assess精准识别高危代码变更现在我们抛弃所有教程里的“Hello World”直接构建一个能解决真实痛点的Skill/git-diff-risk-assess。它的目标是当开发者执行/git-diff-risk-assess时自动抓取当前git diff并精准识别出其中的硬编码密码、SQL注入风险点、未处理的异常、以及缺失的单元测试覆盖。这不是简单的关键词搜索而是结合了Claude模型的理解力与本地shell的执行力。第一步创建技能目录结构# 在用户级技能目录创建专属文件夹对所有项目生效 mkdir -p ~/.claude/skills/git-diff-risk-assess # 进入该目录 cd ~/.claude/skills/git-diff-risk-assess第二步编写核心SKILL.md文件# 使用nano或vim创建文件 nano SKILL.md将以下内容完整粘贴进去注意YAML前言中的---必须顶格前后不能有空格--- name: git-diff-risk-assess description: Analyzes current git diff for high-risk patterns like hardcoded secrets, SQL injection, unhandled exceptions, and missing test coverage. Use before committing or reviewing PRs. disable-model-invocation: true allowed-tools: Bash(git diff *) Bash(grep -n *) Bash(rg -n *) --- ## Current Git Diff !git diff --no-color HEAD ## Risk Assessment Instructions You are a senior security and quality assurance engineer. Analyze the diff above and identify ONLY the following high-risk issues: 1. **Hardcoded Secrets**: Look for strings matching patterns like password, api_key, SECRET_KEY, AWS_ACCESS_KEY_ID, token followed by long alphanumeric strings. Report the exact line number and context. 2. **SQL Injection Vectors**: Identify raw string concatenation in SQL queries (e.g., SELECT * FROM users WHERE id userId). Report the file, line number, and the vulnerable code snippet. 3. **Unhandled Exceptions**: Find try { ... } catch (Exception e) { } blocks with empty or generic catch bodies, or throw new RuntimeException(error) without proper logging. Report location and risk. 4. **Missing Test Coverage**: If the diff adds new business logic (e.g., new function, new route handler), check if corresponding unit tests are added in *.test.js, *_test.py, or Test*.java files. Report any missing test files. For each issue found, output in this strict format: - [ISSUE_TYPE] File: filename, Line: line_number: brief_description If no issues are found, state: ✅ No high-risk patterns detected in the current diff.第三步关键权限与环境变量设置仅仅有SKILL.md还不够。!语法执行shell命令需要Claude Code明确知道它被允许这么做。这需要在全局设置中开启# 创建或编辑全局设置文件 mkdir -p ~/.claude nano ~/.claude/settings.json在settings.json中必须添加以下配置这是Ubuntu 20.04上!命令能工作的前提{ disableSkillShellExecution: false, permissions: { allow: [Bash] } }注意disableSkillShellExecution: false是默认值但显式写出可避免因配置文件解析错误导致的静默禁用。permissions部分则明确授予Bash工具的使用权限否则Claude Code会在执行!git diff时弹出确认框破坏自动化流程。第四步测试与验证现在找一个你熟悉的Git项目确保有未提交的更改进入其根目录启动Claude Code# 启动Claude Code会自动加载所有技能 claude在Claude Code的交互式终端中输入/git-diff-risk-assess如果一切配置正确你应该立即看到Claude Code执行git diff并将结果注入Prompt然后返回一份结构清晰的风险评估报告。如果失败请立即检查~/.claude/skills/git-diff-risk-assess/SKILL.md文件路径是否100%正确settings.json中的disableSkillShellExecution是否为false当前Shell是否有执行git命令的权限在终端里单独运行git diff HEAD测试3.3 进阶为Skill添加动态参数与多语言支持上面的Skill是“一键式”的但实际工作中你可能只想检查某个特定文件的变更或者只想关注SQL注入风险。这就需要用到Skills的参数传递机制。我们来升级/git-diff-risk-assess让它支持/git-diff-risk-assess --file src/main.py --risk sql这样的调用。修改SKILL.md的YAML前言--- name: git-diff-risk-assess description: Analyzes git diff for high-risk patterns. Use --file to target a specific file, --risk to focus on one category (sql, secrets, exceptions, tests). disable-model-invocation: true allowed-tools: Bash(git diff *) Bash(grep -n *) Bash(rg -n *) arguments: [file, risk] ---修改Markdown主体中的指令部分## Current Git Diff !if [ -n $file ]; then git diff --no-color HEAD -- $file; else git diff --no-color HEAD; fi ## Risk Assessment Instructions You are a senior security and quality assurance engineer. Analyze the diff above and identify ONLY the following high-risk issues: 1. **Hardcoded Secrets**: ... (同上略) 2. **SQL Injection Vectors**: ... (同上略) 3. **Unhandled Exceptions**: ... (同上略) 4. **Missing Test Coverage**: ... (同上略) Focus your analysis STRICTLY on the category specified by the --risk argument. If --risk is sql, only report SQL injection vectors. If --risk is secrets, only report hardcoded secrets. If --risk is not provided, report all categories. For each issue found, output in this strict format: - [ISSUE_TYPE] File: filename, Line: line_number: brief_description If no issues are found in the targeted category, state: ✅ No [RISK_CATEGORY] patterns detected.现在你可以这样调用/git-diff-risk-assess --file backend/api.py --risk secrets只检查backend/api.py中的硬编码密钥/git-diff-risk-assess --risk sql检查整个diff中的SQL注入这个例子展示了Skills的真正威力它不是一个固定程序而是一个可以根据你的即时需求动态调整行为的智能代理。参数$file和$risk在运行时被替换!命令也随之动态变化整个流程完全透明、可控、可审计。4. 高阶实战构建一个可视化代码库探索器含Python脚本全解析4.1 为什么你需要一个“可视化代码库探索器”当你接手一个陌生的大型单体仓库或者需要向新同事快速介绍项目结构时ls -R和tree命令提供的信息是扁平且静态的。你无法直观地看到哪个目录占用了80%的磁盘空间哪些文件类型构成了代码库的主体node_modules到底有多大一个交互式的、可折叠的、带颜色编码的HTML可视化地图能瞬间将混沌的文件系统转化为一张清晰的战略地图。这正是我们接下来要构建的/codebase-visualizer技能的核心价值。4.2 构建步骤详解从零到浏览器打开第一步创建技能目录与脚本子目录mkdir -p ~/.claude/skills/codebase-visualizer/scripts cd ~/.claude/skills/codebase-visualizer第二步编写核心SKILL.md文件nano SKILL.md粘贴以下内容注意allowed-tools中指定了python3这是关键--- name: codebase-visualizer description: Generate an interactive, collapsible HTML tree visualization of your entire codebase. Shows file sizes, directory totals, and file type distribution. Use when onboarding, auditing, or exploring large repos. disable-model-invocation: true allowed-tools: Bash(python3 *) --- # Codebase Visualizer Generate an interactive HTML tree view that shows your projects file structure with collapsible directories. ## Usage Run the visualization script from your project root: bash python3 ${CLAUDE_SKILL_DIR}/scripts/visualize.py .This createscodebase-map.htmlin the current directory and opens it in your default browser.What the visualization showsCollapsible directories: Click folders to expand/collapseFile sizes: Displayed next to each fileColors: Different colors for different file types (e.g., .pyblue, .jsyellow)Directory totals: Shows aggregate size of each folder**第三步编写核心Python可视化脚本** bash nano scripts/visualize.py将以下完整、可运行的Python脚本粘贴进去此脚本仅依赖Python标准库无需pip install任何包完美适配Ubuntu 20.04的Python 3.8#!/usr/bin/env python3 Generate an interactive collapsible tree visualization of a codebase. import json import sys import webbrowser from html import escape from pathlib import Path from collections import Counter # 定义忽略的目录和文件可按需修改 IGNORE {.git, node_modules, __pycache__, .venv, venv, dist, build, .idea, .vscode} def scan(path: Path, stats: dict) - dict: 递归扫描目录树构建JSON数据结构 result {name: path.name, children: [], size: 0} try: for item in sorted(path.iterdir()): # 跳过忽略项 if item.name in IGNORE or item.name.startswith(.): continue if item.is_file(): try: size item.stat().st_size except (OSError, PermissionError): size 0 ext item.suffix.lower() or (no ext) result[children].append({name: item.name, size: size, ext: ext}) result[size] size stats[files] 1 stats[extensions][ext] 1 stats[ext_sizes][ext] size elif item.is_dir(): stats[dirs] 1 child scan(item, stats) if child[children]: # 只添加非空目录 result[children].append(child) result[size] child[size] except (OSError, PermissionError): pass return result def generate_html(data: dict, stats: dict, output: Path) - None: 根据扫描数据生成自包含的HTML文件 ext_sizes stats[ext_sizes] total_size sum(ext_sizes.values()) or 1 # 获取前8大文件类型 sorted_exts sorted(ext_sizes.items(), keylambda x: -x[1])[:8] # 预设颜色映射可扩展 colors { .js: #f7df1e, .ts: #3178c6, .py: #3776ab, .go: #00add8, .rs: #dea584, .rb: #cc342d, .css: #264de4, .html: #e34c26, .json: #6b7280, .md: #083fa1, .yaml: #cb171e, .yml: #cb171e, .mdx: #083fa1, .tsx: #3178c6, .jsx: #61dafb, .sh: #4eaa25, .java: #b07219, .cpp: #f34b7d, .c: #555555, .php: #4f5b93, .swift: #fa7343, .kt: #7f52ff, .scala: #c22d40 } # 生成文件类型占比条形图HTML lang_bars .join( fdiv classbar-rowspan classbar-label{ext}/span fdiv classbar stylewidth:{(size/total_size)*100}%;background:{colors.get(ext,#6b7280)}/div fspan classbar-pct{(size/total_size)*100:.1f}%/span/div for ext, size in sorted_exts ) # 格式化字节大小 def fmt(b): if b 1024: return f{b} B if b 1048576: return f{b/1024:.1f} KB return f{b/1048576:.1f} MB # 构建完整的HTML字符串 html f!DOCTYPE html htmlhead meta charsetutf-8titleCodebase Explorer/title style body {{ font: 14px/1.5 system-ui, sans-serif; margin: 0; background: #1a1a2e; color: #eee; }} .container {{ display: flex; height: 100vh; }} .sidebar {{ width: 280px; background: #252542; padding: 20px; border-right: 1px solid #3d3d5c; overflow-y: auto; flex-shrink: 0; }} .main {{ flex: 1; padding: 20px; overflow-y: auto; }} h1 {{ margin: 0 0 10px 0; font-size: 18px; }} h2 {{ margin: 20px 0 10px 0; font-size: 14px; color: #888; text-transform: uppercase; }} .stat {{ display: flex; justify-content: space-between; padding: 8px 0; border-bottom: 1px solid #3d3d5c; }} .stat-value {{ font-weight: bold; }} .bar-row {{ display: flex; align-items: center; margin: 6px 0; }} .bar-label {{ width: 55px; font-size: 12px; color: #aaa; }} .bar {{ height: 18px; border-radius: 3px; }} .bar-pct {{ margin-left: 8px; font-size: 12px; color: #666; }} .tree {{ list-style: none; padding-left: 20px; }} details {{ cursor: pointer; }} summary {{ padding: 4px 8px; border-radius: 4px; }} summary:hover {{ background: #2d2d44; }} .folder {{ color: #ffd700; }} .file {{ display: flex; align-items: center; padding: 4px 8px; border-radius: 4px; }} .file:hover {{ background: #2d2d44; }} .size {{ color: #888; margin-left: auto; font-size: 12px; }} .dot {{ width: 8px; height: 8px; border-radius: 50%; margin-right: 8px; }} /style /headbody div classcontainer div classsidebar h1 Summary/h1 div classstatspanFiles/spanspan classstat-value{stats[files]:,}/span/div div classstatspanDirectories/spanspan classstat-value{stats[dirs]:,}/span/div div classstatspanTotal size/spanspan classstat-value{fmt(data[size])}/span/div div classstatspanFile types/spanspan classstat-value{len(stats[extensions])}/span/div h2By file type/h2 {lang_bars} /div div classmain h1 {escape(data[name])}/h1 ul classtree idroot/ul /div /div script const data {json.dumps(data)}; const colors {json.dumps(colors)}; function fmt(b) {{ if (b 1024) return b B; if (b 1048576) return (b/1024).toFixed(1) KB; return (b/1048576).toFixed(1) MB; }} function esc(s) {{ return s.replace(/[]/g, c ({{:amp;,:lt;,:gt;,:quot;,:#39;}}[c])); }} function render(node, parent) {{ if (node.children) {{ const det document.createElement(details); det.open parent document.getElementById(root); det.innerHTML summaryspan classfolder ${{esc(node.name)}}/spanspan classsize${{fmt(node.size)}}/span/summary; const ul document.createElement(ul); ul.className tree; node.children.sort((a,b) (b.children?1:0)-(a.children?1:0) || a.name.localeCompare(b.name)); node.children.forEach(c render(c, ul)); det.appendChild(ul); const li document.createElement(li); li.appendChild(det); parent.appendChild(li); }} else {{ const li document.createElement(li); li.className file; li.innerHTML span classdot stylebackground:${{colors[node.ext]||#6b7280}}/span${{esc(node.name)}}span classsize${{fmt(node.size)}}/span; parent.appendChild(li); }} }} data.children.forEach(c render(c, document.getElementById(root))); /script /body/html # 写入HTML文件并打开浏览器 output.write_text(html) print(f✅ Generated {output.absolute()}) webbrowser.open(ffile://{output.absolute()}) if __name__ __main__: # 解析命令行参数 target Path(sys.argv[1] if len(sys.argv) 1 else .).resolve() # 初始化统计字典 stats {files: 0, dirs: 0, extensions: Counter(), ext_sizes: Counter()} # 扫描目录 data scan(target, stats) # 生成HTML out Path(codebase-map.html) generate_html(data, stats, out)第四步赋予脚本可执行权限chmod x scripts/visualize.py第五步测试进入任意一个Git项目根目录启动Claude Codeclaude在交互式终端中输入/codebase-visualizer几秒钟后你的默认浏览器将自动打开一个名为codebase-map.html的页面。你会看到一个左侧是统计摘要、右侧是可折叠树状图的精美界面。点击文件夹图标即可展开/折叠鼠标悬停在文件上能看到详细信息。这个技能的成功证明了Claude Code Skills的终极形态它不再局限于文本生成而是成为了你本地开发环境的“智能指挥官”能够调度Python、Bash、甚至未来接入的MCP服务为你构建出前所未有的工作流。5. MCP深度实践在Ubuntu 20.04上从零部署Playwright MCP Server5.1 MCP Server的核心价值将浏览器自动化能力“服务化”playwright mcp不是另一个Playwright GUI工具。它是将Playwright强大的浏览器自动化能力封装成一个标准的、可被任何MCP客户端包括Claude Code调用的HTTP服务。这意味着你可以用一句/browse https://example.com就让Claude Code驱动一个真实的Chrome浏览器访问网页、截图、提取文本、甚至填写表单。而这一切都发生在你本地机器上数据永不离开你的电脑。这对于需要访问内部管理系统、测试登录流程、或抓取动态渲染内容的场景是革命性的。5.2 部署步骤Ubuntu 20.04专属指南第一步安装Node.js与PlaywrightUbuntu 20.04的apt源中Node.js版本过旧必须使用NodeSource# 安装Node.js 18.xPlaywright v1.40推荐 curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs # 验证 node --version # 应输出 v18.x.x npm --version # 应输出 9.x.x第二步创建MCP Server项目mkdir -p ~/mcp-servers/playwright-mcp cd ~/mcp-servers/playwright-mcp npm init -y # 安装核心依赖 npm install modelcontextprotocol/server-node playwright # 创建主服务文件 nano server.js第三步编写MCP Server核心逻辑server.jsconst { createServer } require(modelcontextprotocol/server-node); const { chromium } require(playwright); // 创建MCP服务器实例 const server createServer
1. 这不是“又一个AI工具指南”而是Claude Code的实战操作系统手册2026年5月实测版你点开这篇文档大概率正被三件事困扰第一装完Claude Code后发现CLI界面一片空白敲claude --help只返回几行冷冰冰的选项根本不知道从哪下手第二看到满屏的SKILL.md、CLAUDE.md、MCP、config.yaml这些词像在读一份加密协议连.claude/skills/这个目录该建在项目根目录还是用户主目录都犹豫半天第三最要命的是——你照着网上教程写了第一个/summarize-changes技能结果在终端里输入/summarize-changesClaude Code毫无反应连个错误提示都没有仿佛你对着空气挥了一拳。这不是你的问题。这是Claude Code设计哲学带来的必然学习曲线它不提供图形化向导不内置新手引导甚至不主动告诉你“你缺了什么”。它默认你已理解CLI的本质、文件系统的作用域规则、以及AI代理与本地环境交互的底层契约。而这份指南就是帮你把这套隐性契约摊开、拆解、再焊接到你每天真实的开发流中。它不讲“什么是CLI”因为你能搜到它不罗列所有/command因为官方文档早有汇总它只聚焦一件事如何让Claude Code真正成为你手指延伸出去的那把瑞士军刀而不是摆在桌面上的装饰品。核心关键词——Claude Code、CLI、Skills、CLAUDE.md、MCP——不是标签而是五个必须打通的关卡。CLI是入口Skills是肌肉CLAUDE.md是记忆MCP是神经config.yaml是骨骼。本文所有内容均基于2026年5月23日最新稳定版Claude Code v2.1.145在Ubuntu 20.04、macOS Sonoma及Windows 11WSL2三平台实测验证。没有“理论上可行”只有“我刚在终端里敲出来并截图保存了”。接下来的内容会直接带你进入真实战场从零配置一个能自动识别Git差异并生成风险报告的个人技能到部署一个能实时渲染代码库结构的可视化插件从搞懂config.yaml和CLAUDE.md之间那条看不见的职责分界线到亲手搭建一个支持Playwright自动化测试的MCP服务端。每一步都附带我踩坑后记下的精确命令、路径、权限设置和那个决定成败的隐藏环境变量。如果你需要的是一份说明书去官网如果你需要的是一份能让你明天早上9点就用上、并解决你手头那个紧急PR审查任务的操作系统手册那就继续往下读。2. 核心架构解构为什么Claude Code的“技能”不是功能按钮而是一套可编程的开发环境2.1 技能Skills的本质动态加载的上下文模块而非静态命令很多人第一次接触Skills时下意识把它类比成VS Code里的快捷键或IDEA的Live Template。这是最大的认知偏差。一个/debug技能其背后不是一个预编译的二进制程序而是一个运行时动态解析、按需加载、具备完整执行上下文的微型应用。它的生命周期完全由YAML前言frontmatter和Markdown主体共同定义。当你在终端输入/summarize-changesClaude Code做的第一件事不是调用某个函数而是1扫描所有已注册的技能目录~/.claude/skills/、项目.claude/skills/、插件内skills/2定位到summarize-changes/SKILL.md3读取其YAML前言确认disable-model-invocation: false允许Claude自动触发且user-invocable: true允许你手动调用4执行!开头的shell指令如!git diff HEAD将实时输出注入到Markdown内容中5将最终拼接好的、包含真实代码差异的完整文本块作为单次Prompt发送给Claude模型。整个过程没有缓存没有预热每一次调用都是对当前工作树状态的一次新鲜快照。这解释了为什么你在修改文件后无需重启Claude Code进程技能就能立刻反映最新变更——它压根就不依赖进程内存它依赖的是文件系统和shell的实时能力。这种设计带来两个关键优势一是极致的轻量一个技能目录可以小到仅含一个SKILL.md文件占用KB级磁盘空间二是无与伦比的灵活性你可以让技能在执行前读取任意环境变量、调用任意Python脚本、甚至发起HTTP请求获取远程配置。但代价是它要求你彻底放弃“点击即用”的思维转而拥抱“声明式配置命令式执行”的混合范式。你写的不是代码而是一份给AI代理下达的、带有精确上下文约束的操作说明书。2.2 CLAUDE.md 与 Skills 的分工全局记忆 vs. 按需知识CLAUDE.md和Skills常被混淆因为它们都以Markdown为载体都存放于.claude/目录下。但它们的角色截然不同就像大脑的长期记忆与工作台上的操作手册。CLAUDE.md是Claude Code的全局、持久、被动加载的上下文基座。它存储的是项目不变的“事实”API设计规范、团队编码约定、遗留系统架构图、第三方服务认证方式。这些内容在Claude Code启动时就会被一次性加载进模型的初始上下文并贯穿整个会话生命周期。它的核心原则是“少而精”因为每一行都会持续消耗宝贵的token预算。我见过最典型的反模式是有人把整个README.md复制粘贴进CLAUDE.md结果导致每次对话还没开始一半上下文就被占满模型连自己的名字都快想不起来了。而Skills则是局部、临时、主动触发的知识模块。它存储的是“动作”如何部署、如何生成测试用例、如何分析性能瓶颈。它的内容只在被明确调用/skill-name或被Claude根据描述自动匹配时才被加载进当前上下文。更重要的是Skills支持!语法执行shell命令这意味着它可以携带“活”的数据。一个CLAUDE.md里写的“数据库连接字符串是DB_URL...”永远是静态的而一个Skills里写的!echo $DB_URL每次执行都返回当前环境的真实值。因此我的实践铁律是CLAUDE.md只放不会变的事实Skills只放需要动起来的动作。比如CLAUDE.md里写“本项目使用PostgreSQL 15连接池大小为20”而Skills里则写一个/check-db-connection其内容是!psql -c SELECT version(); SELECT COUNT(*) FROM pg_stat_activity;。前者是背景板后者是探针。2.3 MCPModel Control Protocol让Claude Code走出终端成为分布式智能节点MCP是Claude Code生态中最具战略意义的抽象层但它也是最容易被误解的概念。网络上充斥着“MCP是API”、“MCP是协议”、“MCP是插件标准”等模糊说法。真相是MCP是一个双向通信信道的规范它定义了Claude Code如何与外部服务进行“意图-响应”式的对话。它不关心你用Python、Go还是Rust实现后端也不规定数据必须是JSON还是Protobuf它只强制两件事1服务端必须暴露一个符合mcp-server标准的HTTP端点通常是/mcp2客户端Claude Code必须能通过mcp://URL格式发现并连接该服务。举个最落地的例子playwright mcp。当你在项目中启用Playwright MCP服务后Claude Code就不再需要自己去下载、管理、启动浏览器实例。它只需向mcp://playwright发送一条结构化的“请打开https://example.com并截图”的指令真正的浏览器操作、截图生成、文件保存全部由独立的Playwright MCP服务完成然后将结果如base64编码的图片返回给Claude Code。这带来了质的飞跃首先资源隔离。浏览器进程崩溃不会导致Claude Code进程退出其次能力复用。同一个Playwright MCP服务可以同时被多个Claude Code实例、甚至其他支持MCP的AI工具如Cursor、Windsurf共享最后安全可控。所有敏感操作如访问内部系统都发生在你完全掌控的服务端Claude Code只负责“发号施令”。因此MCP不是锦上添花的插件它是Claude Code从一个“本地AI助手”蜕变为“智能工作流中枢”的关键跳板。后续章节会手把手教你在Ubuntu 20.04上从零搭建一个支持Figma设计稿解析的MCP服务它将彻底改变你与UI设计师的协作方式。2.4 CLI 与桌面版的本质差异进程模型与权限边界的战争关于“Claude Code桌面版和CLI版的区别”官方文档语焉不详社区讨论也多是主观体验。但深入到操作系统层面差异是根本性的。桌面版是一个沙盒化的GUI应用进程。它在macOS上以com.anthropic.claude-codeBundle ID运行在Windows上是一个打包了Electron框架的.exe。它的文件系统访问权限受限于操作系统的GUI应用沙盒策略。例如在macOS上它默认无法读取~/Downloads/目录下的文件除非你手动授予“完全磁盘访问”权限在Windows上它可能无法调用某些需要管理员权限的netsh命令。而CLI版claude命令则是一个裸露的、继承自你当前Shell会话权限的原生进程。它能访问你Shell能访问的一切你的~/.ssh/密钥、你的$PATH中所有工具、你的~/.gitconfig。这意味着CLI版能无缝集成到你的现有开发流中你可以把它嵌入Makefile的make review目标里可以把它作为Git Hook在pre-commit阶段自动运行代码审查甚至可以把它写进CI/CD脚本在Docker容器里驱动自动化测试。但这也意味着CLI版的安全责任完全在你肩上。一个恶意的SKILL.md文件如果被你无意中git clone下来并启用它就能执行rm -rf ~。因此我的建议非常明确日常开发、深度集成、自动化场景无条件选择CLI版偶尔快速查看、不涉及敏感操作、或团队新成员上手培训可选用桌面版。二者并非替代关系而是互补关系——CLI是你的主力战车桌面版是你的侦察无人机。3. 实操基石从零构建你的第一个生产级Skill含Ubuntu 20.04完整路径3.1 环境准备绕过官方安装陷阱的终极方案官方文档推荐的curl -fsSL https://install.anthropic.com | sh安装方式在Ubuntu 20.04上存在一个隐蔽的坑它默认将二进制文件安装到/usr/local/bin/但该路径在某些最小化安装的Ubuntu系统中可能未被包含在普通用户的$PATH里。你执行claude --version会得到command not found。更糟的是apt install claude-code在Ubuntu 20.04的官方源中并不存在。因此我采用经过三平台验证的“双保险”安装法# 步骤1创建专用安装目录避免权限冲突 mkdir -p ~/bin # 步骤2下载最新Linux x64二进制截至2026年5月23日v2.1.145 curl -L https://github.com/anthropics/claude-code/releases/download/v2.1.145/claude-code-linux-x64 -o ~/bin/claude # 步骤3赋予可执行权限 chmod x ~/bin/claude # 步骤4永久添加到PATH编辑 ~/.bashrc 或 ~/.zshrc echo export PATH$HOME/bin:$PATH ~/.bashrc source ~/.bashrc # 步骤5验证安装 claude --version # 应输出 v2.1.145提示不要使用sudo安装到/usr/local/bin/。sudo安装的二进制其读取的配置文件如~/.claude/settings.json权限若设置不当会导致Claude Code因权限不足而静默失败排查极其困难。始终以当前用户身份安装和运行。3.2 创建你的第一个Skill/git-diff-risk-assess精准识别高危代码变更现在我们抛弃所有教程里的“Hello World”直接构建一个能解决真实痛点的Skill/git-diff-risk-assess。它的目标是当开发者执行/git-diff-risk-assess时自动抓取当前git diff并精准识别出其中的硬编码密码、SQL注入风险点、未处理的异常、以及缺失的单元测试覆盖。这不是简单的关键词搜索而是结合了Claude模型的理解力与本地shell的执行力。第一步创建技能目录结构# 在用户级技能目录创建专属文件夹对所有项目生效 mkdir -p ~/.claude/skills/git-diff-risk-assess # 进入该目录 cd ~/.claude/skills/git-diff-risk-assess第二步编写核心SKILL.md文件# 使用nano或vim创建文件 nano SKILL.md将以下内容完整粘贴进去注意YAML前言中的---必须顶格前后不能有空格--- name: git-diff-risk-assess description: Analyzes current git diff for high-risk patterns like hardcoded secrets, SQL injection, unhandled exceptions, and missing test coverage. Use before committing or reviewing PRs. disable-model-invocation: true allowed-tools: Bash(git diff *) Bash(grep -n *) Bash(rg -n *) --- ## Current Git Diff !git diff --no-color HEAD ## Risk Assessment Instructions You are a senior security and quality assurance engineer. Analyze the diff above and identify ONLY the following high-risk issues: 1. **Hardcoded Secrets**: Look for strings matching patterns like password, api_key, SECRET_KEY, AWS_ACCESS_KEY_ID, token followed by long alphanumeric strings. Report the exact line number and context. 2. **SQL Injection Vectors**: Identify raw string concatenation in SQL queries (e.g., SELECT * FROM users WHERE id userId). Report the file, line number, and the vulnerable code snippet. 3. **Unhandled Exceptions**: Find try { ... } catch (Exception e) { } blocks with empty or generic catch bodies, or throw new RuntimeException(error) without proper logging. Report location and risk. 4. **Missing Test Coverage**: If the diff adds new business logic (e.g., new function, new route handler), check if corresponding unit tests are added in *.test.js, *_test.py, or Test*.java files. Report any missing test files. For each issue found, output in this strict format: - [ISSUE_TYPE] File: filename, Line: line_number: brief_description If no issues are found, state: ✅ No high-risk patterns detected in the current diff.第三步关键权限与环境变量设置仅仅有SKILL.md还不够。!语法执行shell命令需要Claude Code明确知道它被允许这么做。这需要在全局设置中开启# 创建或编辑全局设置文件 mkdir -p ~/.claude nano ~/.claude/settings.json在settings.json中必须添加以下配置这是Ubuntu 20.04上!命令能工作的前提{ disableSkillShellExecution: false, permissions: { allow: [Bash] } }注意disableSkillShellExecution: false是默认值但显式写出可避免因配置文件解析错误导致的静默禁用。permissions部分则明确授予Bash工具的使用权限否则Claude Code会在执行!git diff时弹出确认框破坏自动化流程。第四步测试与验证现在找一个你熟悉的Git项目确保有未提交的更改进入其根目录启动Claude Code# 启动Claude Code会自动加载所有技能 claude在Claude Code的交互式终端中输入/git-diff-risk-assess如果一切配置正确你应该立即看到Claude Code执行git diff并将结果注入Prompt然后返回一份结构清晰的风险评估报告。如果失败请立即检查~/.claude/skills/git-diff-risk-assess/SKILL.md文件路径是否100%正确settings.json中的disableSkillShellExecution是否为false当前Shell是否有执行git命令的权限在终端里单独运行git diff HEAD测试3.3 进阶为Skill添加动态参数与多语言支持上面的Skill是“一键式”的但实际工作中你可能只想检查某个特定文件的变更或者只想关注SQL注入风险。这就需要用到Skills的参数传递机制。我们来升级/git-diff-risk-assess让它支持/git-diff-risk-assess --file src/main.py --risk sql这样的调用。修改SKILL.md的YAML前言--- name: git-diff-risk-assess description: Analyzes git diff for high-risk patterns. Use --file to target a specific file, --risk to focus on one category (sql, secrets, exceptions, tests). disable-model-invocation: true allowed-tools: Bash(git diff *) Bash(grep -n *) Bash(rg -n *) arguments: [file, risk] ---修改Markdown主体中的指令部分## Current Git Diff !if [ -n $file ]; then git diff --no-color HEAD -- $file; else git diff --no-color HEAD; fi ## Risk Assessment Instructions You are a senior security and quality assurance engineer. Analyze the diff above and identify ONLY the following high-risk issues: 1. **Hardcoded Secrets**: ... (同上略) 2. **SQL Injection Vectors**: ... (同上略) 3. **Unhandled Exceptions**: ... (同上略) 4. **Missing Test Coverage**: ... (同上略) Focus your analysis STRICTLY on the category specified by the --risk argument. If --risk is sql, only report SQL injection vectors. If --risk is secrets, only report hardcoded secrets. If --risk is not provided, report all categories. For each issue found, output in this strict format: - [ISSUE_TYPE] File: filename, Line: line_number: brief_description If no issues are found in the targeted category, state: ✅ No [RISK_CATEGORY] patterns detected.现在你可以这样调用/git-diff-risk-assess --file backend/api.py --risk secrets只检查backend/api.py中的硬编码密钥/git-diff-risk-assess --risk sql检查整个diff中的SQL注入这个例子展示了Skills的真正威力它不是一个固定程序而是一个可以根据你的即时需求动态调整行为的智能代理。参数$file和$risk在运行时被替换!命令也随之动态变化整个流程完全透明、可控、可审计。4. 高阶实战构建一个可视化代码库探索器含Python脚本全解析4.1 为什么你需要一个“可视化代码库探索器”当你接手一个陌生的大型单体仓库或者需要向新同事快速介绍项目结构时ls -R和tree命令提供的信息是扁平且静态的。你无法直观地看到哪个目录占用了80%的磁盘空间哪些文件类型构成了代码库的主体node_modules到底有多大一个交互式的、可折叠的、带颜色编码的HTML可视化地图能瞬间将混沌的文件系统转化为一张清晰的战略地图。这正是我们接下来要构建的/codebase-visualizer技能的核心价值。4.2 构建步骤详解从零到浏览器打开第一步创建技能目录与脚本子目录mkdir -p ~/.claude/skills/codebase-visualizer/scripts cd ~/.claude/skills/codebase-visualizer第二步编写核心SKILL.md文件nano SKILL.md粘贴以下内容注意allowed-tools中指定了python3这是关键--- name: codebase-visualizer description: Generate an interactive, collapsible HTML tree visualization of your entire codebase. Shows file sizes, directory totals, and file type distribution. Use when onboarding, auditing, or exploring large repos. disable-model-invocation: true allowed-tools: Bash(python3 *) --- # Codebase Visualizer Generate an interactive HTML tree view that shows your projects file structure with collapsible directories. ## Usage Run the visualization script from your project root: bash python3 ${CLAUDE_SKILL_DIR}/scripts/visualize.py .This createscodebase-map.htmlin the current directory and opens it in your default browser.What the visualization showsCollapsible directories: Click folders to expand/collapseFile sizes: Displayed next to each fileColors: Different colors for different file types (e.g., .pyblue, .jsyellow)Directory totals: Shows aggregate size of each folder**第三步编写核心Python可视化脚本** bash nano scripts/visualize.py将以下完整、可运行的Python脚本粘贴进去此脚本仅依赖Python标准库无需pip install任何包完美适配Ubuntu 20.04的Python 3.8#!/usr/bin/env python3 Generate an interactive collapsible tree visualization of a codebase. import json import sys import webbrowser from html import escape from pathlib import Path from collections import Counter # 定义忽略的目录和文件可按需修改 IGNORE {.git, node_modules, __pycache__, .venv, venv, dist, build, .idea, .vscode} def scan(path: Path, stats: dict) - dict: 递归扫描目录树构建JSON数据结构 result {name: path.name, children: [], size: 0} try: for item in sorted(path.iterdir()): # 跳过忽略项 if item.name in IGNORE or item.name.startswith(.): continue if item.is_file(): try: size item.stat().st_size except (OSError, PermissionError): size 0 ext item.suffix.lower() or (no ext) result[children].append({name: item.name, size: size, ext: ext}) result[size] size stats[files] 1 stats[extensions][ext] 1 stats[ext_sizes][ext] size elif item.is_dir(): stats[dirs] 1 child scan(item, stats) if child[children]: # 只添加非空目录 result[children].append(child) result[size] child[size] except (OSError, PermissionError): pass return result def generate_html(data: dict, stats: dict, output: Path) - None: 根据扫描数据生成自包含的HTML文件 ext_sizes stats[ext_sizes] total_size sum(ext_sizes.values()) or 1 # 获取前8大文件类型 sorted_exts sorted(ext_sizes.items(), keylambda x: -x[1])[:8] # 预设颜色映射可扩展 colors { .js: #f7df1e, .ts: #3178c6, .py: #3776ab, .go: #00add8, .rs: #dea584, .rb: #cc342d, .css: #264de4, .html: #e34c26, .json: #6b7280, .md: #083fa1, .yaml: #cb171e, .yml: #cb171e, .mdx: #083fa1, .tsx: #3178c6, .jsx: #61dafb, .sh: #4eaa25, .java: #b07219, .cpp: #f34b7d, .c: #555555, .php: #4f5b93, .swift: #fa7343, .kt: #7f52ff, .scala: #c22d40 } # 生成文件类型占比条形图HTML lang_bars .join( fdiv classbar-rowspan classbar-label{ext}/span fdiv classbar stylewidth:{(size/total_size)*100}%;background:{colors.get(ext,#6b7280)}/div fspan classbar-pct{(size/total_size)*100:.1f}%/span/div for ext, size in sorted_exts ) # 格式化字节大小 def fmt(b): if b 1024: return f{b} B if b 1048576: return f{b/1024:.1f} KB return f{b/1048576:.1f} MB # 构建完整的HTML字符串 html f!DOCTYPE html htmlhead meta charsetutf-8titleCodebase Explorer/title style body {{ font: 14px/1.5 system-ui, sans-serif; margin: 0; background: #1a1a2e; color: #eee; }} .container {{ display: flex; height: 100vh; }} .sidebar {{ width: 280px; background: #252542; padding: 20px; border-right: 1px solid #3d3d5c; overflow-y: auto; flex-shrink: 0; }} .main {{ flex: 1; padding: 20px; overflow-y: auto; }} h1 {{ margin: 0 0 10px 0; font-size: 18px; }} h2 {{ margin: 20px 0 10px 0; font-size: 14px; color: #888; text-transform: uppercase; }} .stat {{ display: flex; justify-content: space-between; padding: 8px 0; border-bottom: 1px solid #3d3d5c; }} .stat-value {{ font-weight: bold; }} .bar-row {{ display: flex; align-items: center; margin: 6px 0; }} .bar-label {{ width: 55px; font-size: 12px; color: #aaa; }} .bar {{ height: 18px; border-radius: 3px; }} .bar-pct {{ margin-left: 8px; font-size: 12px; color: #666; }} .tree {{ list-style: none; padding-left: 20px; }} details {{ cursor: pointer; }} summary {{ padding: 4px 8px; border-radius: 4px; }} summary:hover {{ background: #2d2d44; }} .folder {{ color: #ffd700; }} .file {{ display: flex; align-items: center; padding: 4px 8px; border-radius: 4px; }} .file:hover {{ background: #2d2d44; }} .size {{ color: #888; margin-left: auto; font-size: 12px; }} .dot {{ width: 8px; height: 8px; border-radius: 50%; margin-right: 8px; }} /style /headbody div classcontainer div classsidebar h1 Summary/h1 div classstatspanFiles/spanspan classstat-value{stats[files]:,}/span/div div classstatspanDirectories/spanspan classstat-value{stats[dirs]:,}/span/div div classstatspanTotal size/spanspan classstat-value{fmt(data[size])}/span/div div classstatspanFile types/spanspan classstat-value{len(stats[extensions])}/span/div h2By file type/h2 {lang_bars} /div div classmain h1 {escape(data[name])}/h1 ul classtree idroot/ul /div /div script const data {json.dumps(data)}; const colors {json.dumps(colors)}; function fmt(b) {{ if (b 1024) return b B; if (b 1048576) return (b/1024).toFixed(1) KB; return (b/1048576).toFixed(1) MB; }} function esc(s) {{ return s.replace(/[]/g, c ({{:amp;,:lt;,:gt;,:quot;,:#39;}}[c])); }} function render(node, parent) {{ if (node.children) {{ const det document.createElement(details); det.open parent document.getElementById(root); det.innerHTML summaryspan classfolder ${{esc(node.name)}}/spanspan classsize${{fmt(node.size)}}/span/summary; const ul document.createElement(ul); ul.className tree; node.children.sort((a,b) (b.children?1:0)-(a.children?1:0) || a.name.localeCompare(b.name)); node.children.forEach(c render(c, ul)); det.appendChild(ul); const li document.createElement(li); li.appendChild(det); parent.appendChild(li); }} else {{ const li document.createElement(li); li.className file; li.innerHTML span classdot stylebackground:${{colors[node.ext]||#6b7280}}/span${{esc(node.name)}}span classsize${{fmt(node.size)}}/span; parent.appendChild(li); }} }} data.children.forEach(c render(c, document.getElementById(root))); /script /body/html # 写入HTML文件并打开浏览器 output.write_text(html) print(f✅ Generated {output.absolute()}) webbrowser.open(ffile://{output.absolute()}) if __name__ __main__: # 解析命令行参数 target Path(sys.argv[1] if len(sys.argv) 1 else .).resolve() # 初始化统计字典 stats {files: 0, dirs: 0, extensions: Counter(), ext_sizes: Counter()} # 扫描目录 data scan(target, stats) # 生成HTML out Path(codebase-map.html) generate_html(data, stats, out)第四步赋予脚本可执行权限chmod x scripts/visualize.py第五步测试进入任意一个Git项目根目录启动Claude Codeclaude在交互式终端中输入/codebase-visualizer几秒钟后你的默认浏览器将自动打开一个名为codebase-map.html的页面。你会看到一个左侧是统计摘要、右侧是可折叠树状图的精美界面。点击文件夹图标即可展开/折叠鼠标悬停在文件上能看到详细信息。这个技能的成功证明了Claude Code Skills的终极形态它不再局限于文本生成而是成为了你本地开发环境的“智能指挥官”能够调度Python、Bash、甚至未来接入的MCP服务为你构建出前所未有的工作流。5. MCP深度实践在Ubuntu 20.04上从零部署Playwright MCP Server5.1 MCP Server的核心价值将浏览器自动化能力“服务化”playwright mcp不是另一个Playwright GUI工具。它是将Playwright强大的浏览器自动化能力封装成一个标准的、可被任何MCP客户端包括Claude Code调用的HTTP服务。这意味着你可以用一句/browse https://example.com就让Claude Code驱动一个真实的Chrome浏览器访问网页、截图、提取文本、甚至填写表单。而这一切都发生在你本地机器上数据永不离开你的电脑。这对于需要访问内部管理系统、测试登录流程、或抓取动态渲染内容的场景是革命性的。5.2 部署步骤Ubuntu 20.04专属指南第一步安装Node.js与PlaywrightUbuntu 20.04的apt源中Node.js版本过旧必须使用NodeSource# 安装Node.js 18.xPlaywright v1.40推荐 curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs # 验证 node --version # 应输出 v18.x.x npm --version # 应输出 9.x.x第二步创建MCP Server项目mkdir -p ~/mcp-servers/playwright-mcp cd ~/mcp-servers/playwright-mcp npm init -y # 安装核心依赖 npm install modelcontextprotocol/server-node playwright # 创建主服务文件 nano server.js第三步编写MCP Server核心逻辑server.jsconst { createServer } require(modelcontextprotocol/server-node); const { chromium } require(playwright); // 创建MCP服务器实例 const server createServer
![[C++]内存管理：串顺序存储的内存回收](http://pic.xiahunao.cn/yaotu/[C++]内存管理：串顺序存储的内存回收)
