嵌入式开发的人用AI编程工具和写Web、写业务系统的完全是两个画风。你要的是一个能看懂寄存器手册、能帮你把编译错误从几百行log里捞出来的助手而不是一个只会生成CRUD的生成器。Claude Code在这个场景里属于少有的、真能在终端里干活的工具。系列写到第14篇这篇继续深挖基本操作重点放在安装、权限、会话管理、MCP、Skills这些每个嵌入式开发者都会用到、但官方文档又讲得不够细的地方。1. 把Claude Code装对三个平台的环境准备与初始化配置新接触Claude Code的人百分之八十的安装问题都出在环境不一致上。嵌入式开发者的机器尤其复杂有人主力Windows有人macOS跑着ARM交叉编译链还有人直接在Ubuntu容器里干活。三个平台的安装路径不完全一样但核心依赖是同一个Node.js环境。1.1 安装前置Node版本与npm源Claude Code本质是npm包先确保安装Node.js。官方建议Node 18以上我用过的18.x和22.x都没问题但如果你还在用Node 14或更低大概率会遇到API兼容报错别浪费时间折腾直接升级。安装方式各平台略有差异macOS用户系统里装了Homebrew的话最省事。先用brew安装Node再安装Claude Code。Windows用户强烈建议用Windows Terminal而不是老旧的cmd编码和交互体验完全不一样。安装包下载受限的环境要处理下载失败问题。通用解法是切换npm源到国内镜像大包秒下之后再跑一次安装命令。Ubuntu/Debian系统如果apt里的Node版本老更推荐直接装NodeSource源或nvm来管理Node版本方便随时切换。# macOSHomebrew路线 brew install node npm install -g anthropic-ai/claude-code # WindowsPowerShell npm install -g anthropic-ai/claude-code # npm源切换网络原因导致安装失败的通用解法 npm config set registry https://registry.npmmirror.com npm install -g anthropic-ai/claude-code安装成功后执行claude --version确认版本号。网络受限机器上即使下载过程漫长只要出现了版本号后续登录和模型调用就畅通无阻。1.2 首次启动登录认证与订阅校验首次在终端输入claude会进入登录流程浏览器自动弹出OAuth认证页面登录账号后回终端即可开始会话。这一步要特别提醒Claude Code要求账号具备有效订阅或API额度否则登录后也会卡在额度不足的报错上。我实际遇到过一个坑企业内网环境浏览器弹出不了认证页。解法是复制终端里那串URL拿到能联网的机器上打开完成授权后再回到终端。另外多账号用户注意登录态是全局的claude命令会读取当前用户配置切换账号前记得先登出。1.3 更新与卸载很多人忽略的两个操作Claude Code更新频率比较快旧版本容易出现工具调用异常或模型行为偏差。更新用claude update它会自动检查最新版本并完成升级。卸载更简单npm全局卸载即可npm uninstall -g anthropic-ai/claude-code卸载后可以顺手清理残留配置目录macOS/Linux下是~/.claudeWindows在%USERPROFILE%\.claude避免下次安装时旧配置干扰新版本。2. 会话的命脉清空、压缩与多任务切换第一次上手Claude Code的人最容易搞混的就是会话管理逻辑。它和浏览器聊天窗口不一样每次会话是带着完整上下文密度来的上下文越长推理越慢、消耗越大。嵌入式项目动辄几十个文件如果不管理会话聊着聊着你会发现它开始答非所问甚至把STM32的寄存器名串到GD32的工程里。2.1 /clear彻底清场别让它带着旧需求/clear命令会清空当前会话的全部历史。什么时候该用当你切换到一个全新的子任务时——比如刚才还在调UART驱动现在突然要写一份I2C扫描代码——残留的UART上下文对I2C没有任何帮助反而会污染判断。实际使用中我习惯随时用/clear每完成一个独立功能模块就清一次。代价是会丢失中间过程信息但换来的是每次对话都有干净的上下文起点。要找回之前会话用claude --resume或claude -r恢复历史会话列表从上次断点继续。2.2 /compact上下文压缩的平衡艺术/clear是彻底放弃/compact则是把当前对话的关键信息浓缩后继续。它适合那种任务没完成、但上下文已经快撑爆的场景——比如你让它分析了一段冗长的编译日志讨论了很久突然发现漏贴了一个关键宏定义。执行/compact后Claude Code会把之前的对话摘要成精简版本并保留文件状态、未完成的修改记录。我实测过几十次多数情况下压缩后再续聊行为连续性比直接重开强很多尤其适合跨文件重构这类长任务。不过有个细节压缩后的摘要会不会丢细节取决于模型对摘要的理解力遇到复杂架构设计我更倾向直接用/rewind回退到问题发生前的消息节点而不是压缩。2.3 多会话并行嵌入式开发的正确用法真正提升效率的是同时开多个会话。一个会话专门查芯片手册和寄存器定义另一个会话处理编译错误再开一个做代码审查。终端里CtrlC不会杀进程重新运行claude就是新会话旧会话保留在恢复列表里。多会话配合/resume机制实际体验就是给每个任务建一个专属工位互不干扰。我建议按模块分会话而不是按时间分会话这样恢复时意图明确不用翻历史消息猜当时在干嘛。3. 给Claude Code配操作权限从“只读浏览”到“完全放权”Claude Code不是只和你聊天的它要读文件、改代码、执行构建命令、跑测试脚本。这些操作都需要权限控制。嵌入式场景下权限设计尤为重要——一个误操作可能触发make flash把开发板刷成砖。3.1 权限模型四种模式分别干嘛每次交互时Claude Code会按操作类型向你申请权限主要分文件编辑、命令执行、MCP工具调用这几类。交互式模式下每来一个操作请求终端都会提示允许或拒绝。一旦允许后续同类操作通常自动放行。想跳过提示直接用有两个参数# 自动接受文件编辑权限 claude -a # 完全跳过权限检查危险不建议日常使用 claude --dangerously-skip-permissions这里要重点强调--dangerously-skip-permissions能不用就不用。它在CI自动化、无人工干预脚本里确实有用但日常开发一旦带上这个参数Claude Code执行任何命令都不再问你。遇到过同事在RTOS工程里开着skip模式让它重构结果它顺手执行了一个清理缓存命令整个build目录被删掉重来几个小时的编译时间白费。3.2 权限的精细控制自定义规则文件想灵活一些在~/.claude/settings.json里配权限规则。这个文件支持permissions配置可以指定allow和deny列表{ permissions: { allow: [ Bash(make *), Bash(echo *), Read(~/workspace/**) ], deny: [ Bash(rm -rf *), Bash(make flash) ] } }规则格式支持通配符力度可以很细。我个人的策略是开发库代码时开-a但涉及烧录、擦除Flash、批量删除这类高危操作用deny列表锁死。单独给嵌入式场景题一个醒——千万别放行make flash这类命令换成make build、make debug更稳妥。3.3 团队协作中的权限管理如果你在团队里推广Claude Code权限规则必须进版本库。最实用的做法是把统一的settings.json放在用户级配置里让团队成员拉取后直接覆盖——尤其是deny列表能拦住90%以上的危险操作。项目级的.claude/settings.json也会被自动读取适合针对单个工程定制允许/禁止项。4. 让Claude Code长出手脚MCP服务器配置实战很多人在终端里用Claude Code觉得它只能读文件、写文件这是对MCP(模型上下文协议)没概念。MCP是Claude Code连接外部工具的标准通道通过配置MCP服务器它就能操作数据库、发HTTP请求、读取串口、访问文件系统之外的资源。4.1 MCP是什么嵌入式开发有什么用MCP削平了模型与具体工具之间的门槛实现了一次配置、全局复用的工具生态。你给Claude Code装一个MCP服务器它就多了一项能力。嵌入式开发中常用的文件系统MCP让它访问指定目录之外的文件适合跨目录查阅芯片手册、参考代码。SQLite MCP把编译产物、测试数据、串口日志存进SQLite让它用SQL查日志分析效率翻倍。HTTP请求MCP直接请求设备REST接口或内部服务调试网络协议栈时不用再手动curl。串口MCP直接和开发板串口交互读打印日志发指令。拿串口MCP举例调试蓝牙模块时代码写完不再需要自己开串口工具去发AT指令验证直接让Claude Code通过MCP打开串口、写入指令、读取响应并判断结果。这对交叉编译环境下快速验证驱动逻辑真的是质的提升。4.2 MCP命令实操添加、查看、管理配置MCP服务器最常见的方式是用claude mcp命令# 添加一个MCP服务器npx方式启动 claude mcp add my-serial -- npx modelcontextprotocol/server-serial # 查看已配置的MCP服务器列表 claude mcp list # 查看某个MCP服务器的详细配置 claude mcp get my-serial # 移除 claude mcp remove my-serialadd后面的服务器名可以自定义Claude Code会把它注册进配置文件中。注意MCP服务器本身是独立进程Claude Code启动时会自动拉起进程异常或依赖缺失会导致MCP不可用通常先检查Node环境和依赖是否安装完整。4.3 JSON配置方式与权限联动有些MCP服务器不好用命令行参数描述可以直接编辑配置文件。位置在~/.claude.json或项目根目录.mcp.json{ mcpServers: { sqlite-db: { command: npx, args: [-y, modelcontextprotocol/server-sqlite, --db-path, ./build_meta.db], env: { DB_PATH: ./build_meta.db } } } }配置完重启Claude Code新会话才会加载。我还发现权限和MCP是联动的MCP工具调用同样受permissions规则约束你可以在settings中明确禁止某类MCP工具访问敏感路径防止Claude Code通过MCP误读密钥文件。5. 自己动手扩展技能Claude Code Skills的完整体验Skills是Claude Code里一个高级但极其实用的能力相当于给Claude Code准备一个“任务手册”包含特定领域的知识、流程、示例你要它执行某类任务时它会自动加载手册并严格按流程来做。这很适合嵌入式开发的规范化和经验沉淀。5.1 Skills的目录结构与SKILL.md格式每个技能是一个目录放在~/.claude/skills/下项目范围就放项目目录.claude/skills/。技能目录里必须有一个SKILL.md文件用YAML frontmatter描述元信息--- name: stm32-driver-review description: 用于评审STM32外设驱动代码重点检查寄存器配置、中断优先级、DMA描述符初始化 --- # STM32驱动评审流程 ## 输入 嵌入驱动代码文件路径或粘贴关键代码片段。 ## 步骤 1. 检查外设时钟使能是否遗漏。 2. 检查GPIO复用功能配置与数据手册是否一致。 3. 检查中断服务函数是否在中断向量表中注册。 4. 检查DMA描述符是否在初始化时清零。 5. 给出高/中/低三级风险清单。 ## 输出 按风险优先级输出评审结果每条必须引用代码行号和寄存器名。description字段是核心Claude Code根据它与当前任务的语义匹配度决定是否加载技能。因此描述要写得具体包含项目专有名词比如芯片型号、接口协议、代码规范名称。5.2 从GitHub手动安装Skills两大途径热词里频繁出现“claude code怎么手动装github上的skills”这里完整展开。社区生态里已经有不少开源Skills仓库手动安装的本质就是两步下载、放目录。方法一直接把GitHub仓库clone或下载zip把技能目录复制到~/.claude/skills/。方法二如果你的项目里已经集成了Plugin机制或Claude Code市场可以用/plugin命令从市场搜索并安装。但很多时候是手动方式更可控尤其技能包依赖特定Python库或外部工具时clone下来后还需要检查一下依赖说明。装好后在会话中并不需要刻意“触发”直接提出相关任务Claude Code会根据描述自动匹配。想强制指定技能在提示词里写明“按照xxx技能工作”即可。5.3 技巧把个人经验沉淀成自定义技能我建了一个团队内部技能依托这个机制把“编译错误排查”这套经验固化了下来。仓库代码里统一放一份SKILL.md描述怎么写、报错日志怎么分类Claude Code一遇到编译报错就直接加载这套规则。沉淀技能最大的收益是让团队的“老师傅经验”变成可复用资产新人按技能走一遍也能复现老手的排查思路比自己翻文档效率高得多。写技能时建议先从小范围场景开始跑通了再扩充避免一上来写得太大、语义匹配效果不佳。6. 和编辑器与桌面工具联动从命令行走向可视化终端用多了你会发现有个硬伤代码改动了想对照上下文看眼睛要在终端和编辑器之间来回跳。这时候用IDE集成或桌面版体验会好很多。6.1 VSCode里配置Claude CodeVSCode官方扩展安装好后侧边栏会出现独立的Claude Code面板。配置方式并不复杂在扩展设置里指向Claude Code的可执行文件路径登录一次后它复用终端的认证态。实际体验中VSCode版最大的优势是代码改动直接diff在编辑器里接受/拒绝非常自然。嵌入式工程的文件结构复杂VSCode的资源管理器配合Claude Code的“查看文件、修改文件”能力比纯终端直观太多了。需要注意VSCode集成面板和终端版共享同一份配置包括MCP服务器和权限规则改动一处两处都生效。6.2 桌面版客户端重操作场景的更好选择如果你的工作流重度依赖交互式审查代码桌面版值得试试。它本质是给Claude Code一个更舒适的操作界面支持分栏显示、会话历史浏览、更清晰的文件修改记录。桌面版刚推出的时候有人觉得是“套壳”实际高频使用下来大项目里的体验提升是很明显的。尤其是同时开着芯片手册、原理图、代码工程的人独立窗口的灵活布局比终端专注度好得多。注意桌面版和CLI版的配置目录是兼容的但启动的会话互不继承需要自己管理。6.3 团队协同场景cc-connect与飞书联动团队协作中有一个社区工具叫cc-connect可以把Claude Code的能力接入飞书这类IM工具常见用法是把汇总报告、构建状态、测试结果推送到飞书群团队成员不用聚在终端前也能看到AI的产出。这类联动本质是Claude Code在后台跑任务完成后通过webhook把结果发给IM机器人。这边有一个前提机器人配置和webhook地址需要严格的权限管控避免任务内容泄露。内部使用反馈来看推送构建失败原因到飞书群比截图贴日志高效得多。7. 高频问题排查实录安装失败、权限卡住、上下文丢失用这套工具跑了几个月资料里踩过的坑基本都遇到了。整理几个高频问题每个都附排查思路按顺序查比逐条试错快得多。7.1 安装下载失败与版本过旧现象npm install -g长时间停滞、报ETIMEDOUT、版本号旧。排查顺序先拉一下npm源配置npm config get registry。如果指向了不知名源重置为官方源或国内镜像源。版本过旧的话不用反复重装直接claude update它会自动拉取更新。首次安装就失败检查Node版本确保在18以上Node版本正常但仍失败检查网络限制下载受阻时优先用镜像源或从其他机器拷贝安装包。7.2 权限提示反复出现无法正常对话现象每个操作都弹确认极其影响节奏。原因默认权限模式下非白名单命令每条都问。嵌入式工程里编译命令多容易造成频繁确认。解决在settings.json的allow列表里加入高频命令模式比如Bash(make *)、Bash(gcc *)。注意deny列表里始终保留高危命令。想彻底不问就用claude -a但代价是所有文件编辑都会自动接受适合已建立好代码回滚习惯的团队。7.3 恢复会话后上下文丢失现象--resume恢复会话发现之前的文件修改记录、思路摘要都没了。原因会话恢复依赖上下文压缩长任务如果中间执行过/compact原始细节会被弱化。另外多终端恢复同一个会话状态会被最后一个启用的会话覆盖。解决重要任务不要中途/clear用/compact只压缩处理阶段跨终端接管会话时先看恢复列表别同时从两个终端操作同一个会话。7.4 中文乱码和输出格式问题现象Windows下输出中文变乱码代码块缩进丢失。原因终端编码页不支持UTF-8或输出渲染异常。解决Windows Terminal里设置默认编码为UTF-8Claude Code本身输出Markdown格式如果粘贴到别处格式不对用“复制原始代码块”重新拷贝。排查问题有个总原则先看环境再看权限最后才怀疑工具本身。Claude Code毕竟是构建在Node生态上的终端工具绝大多数问题都出在环境配置不统一上修好环境一切顺畅。收个尾说点实操中的心得这个系列写到现在越用越觉得Claude Code和嵌入式开发是难得合拍的。以前写驱动最烦对着几百页芯片手册翻寄存器定义现在一句话就能让它把关键配置列出来再生成代码框架我再结合电路核对效率完全不一样。但也要泼盆冷水别指望它替代你读懂原理图和数据手册——它更适合当一个称职的“副驾”懂工具、会查文档、能快速表达关键决策仍然要你自己拍板。想进阶的话建议从给Claude Code攒一套私有Skills开始把你们项目的开发规范、评审清单、排查路径都包装成技能包让AI慢慢“懂你们团队”这一步做扎实了后边的效率提升比任何调参都实在。