Claude Code 学习笔记
目录一、Claude本地接入1、环境部署2、Claude安装二、Visual Studio x Claude Code1、Claude Code扩展安装2、小Tips3、实用扩展推荐 1.Claude Manager 2.Claude Context Bar三、开源资源的内网部署1、第三方MarketPlace部署2、官方插件部署1. 整体方法2. 官方插件安装(src:local)3.官方插件安装(src:url)3、实用插件推荐 1.skill-creator 2.claude-md-management 3.plugin-dev4. document-SKILLs四、claude基础拆解1、组件2、说明文档 1. 定义 2. 加载机制3、程序流五、Agent 开发1、四级架构 1. 概述2. 文件树结构3. 全局级 (1)CLAUDE.md建设 (2)上下文与记忆 1)上下文扩容 2)记忆管理策略 (3)Hooks Notifier (4)SVN 自动备份插件一、Claude本地接入1、环境部署安装Git:注:安装包不依赖网络环境。 CMD验证:git --version安装Node.js长期支持版,版本号 ≥ 18;注:安装包不依赖网络环境。 CMD验证:node --version //输出版本号 npm --version //输出版本号2、Claude安装通过npm全局安装npm install -g @anthropic-ai/claude-code CMD验证:claude 全局变量: 要让CMD中的Claude正常运行,需要配置一些全局变量。 在此电脑的环境变量中添加: 添加完成后,在命令行界面中就可以尝试和Claude对话了。二、Visual Studio x Claude Code 在实际使用时,在命令行中使用Claude Code让人没什么欲望。好在Visual Studio Code中,已经支持了Claude Code扩展,我们可以根据网络环境选择安装扩展的方式。注:通过VSIX安装不需要依赖网络环境。1、Claude Code扩展安装 扩展名:Claude Code for VS Code 安装版本:最好和命令行中的Claude进行版本对齐。 安装好之后,需要对扩展的json文件进行环境变量配置,原因和部署CMD版本一样。在扩展设置中找到.json文件配置环境变量打开.json文件添加如下配置:"claudeCode.environmentVariables": [ { "name": "ANTHROPIC_BASE_URL", "value":"模型URL", }, { "name": "ANTHROPIC_AUTH_TOKEN", "value":"你的KEY", }, { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value":"你的模型名", }, { "name": "CLAUDE_CODE_MAX_OUTPUT_TOKENS", "value":"1000000", }, { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value":"你的模型名", }, { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value":"你的模型名" }, ],注:使用VS code切换到计划模式后,会自动切回OPUS模型,如果不添加ANTHROPIC_DEFAULT_OPUS_MODEL,计划模式是无法使用的。CMD端同理,也需要在全局变量中添加才可使用。 完成以上配置之后,应该就可以在VS Code中和Claude对话了。 2、小Tips(1)我们可以通过选择自己的对话气泡的右上角的箭头。这张图片展示了一个深色背景的弹出式菜单,包含三个选项: 1)Fork conversation from here从当前对话位置分叉出一个新的对话分支,用于并行讨论不同话题。 2)Rewind code to here将代码回退到当前节点,可能用于调试或版本回溯。 3)Fork conversation and rewind code同时执行“分叉对话”和“回退代码”,用于在新对话分支中从指定代码状态开始工作。(2)我们可以通过右下角选择对话模式(也可以用shift+Tab快捷键),也可以在里面切换Effort等级。注:effort等级标志着claude的思考发散程度。 (3)可以在左侧选中这个目标后使用shift+alt+c快捷键快速复制路径,节省打字和选择的时间,方便在对话中快速选择要claude处理的文件对象3、实用扩展推荐 1.Claude Manager这是一个集成在左侧活动栏的扩展,可以在其中查看当前Claude Code打开的会话、具备的技能、插件、钩子、命令等等,也可以修改Claude Code的配置,在开发claude的过程中是一个比较方便的扩展。我们时常需要一边coding code一边修改全局的skills,这个扩展很好的解决了两者实现同窗查看和编辑的痛点。尤其是在2026-05-19版本后,其已经具备了识别插件内的技能、agents、commands、hooks的能力。这对于检验插件、技能的正常装载也有侧面印证的作用。 2.Claude Context Bar这是一个集成在vscode右下角的扩展,安装之后,每当你和claude code对话,他都会短暂提示你当前的上下文消耗,虽然/context也可以查上下文消耗,但是这个扩展插件的好处就是小而美,可以省去手动查询的力气。三、开源资源的内网部署 Anthropics拥有极其丰富的第三方开源市场和官方市场支持。首先,通过网络获取的这些组件(技能、插件、市场),应该如何区分呢?类型显著特征市场拥有\.claude-plugin\marketplace注册信息插件拥有\.claude-plugin\plugin.json注册信息技能内涵SKILL.md的文件夹而然,因为网络环境限制,通常我们无法通过url安装插件、技能(最开始是发现Anthropic官方的插件我都无法在红网装)。为了正面解决这个难题,我们可以试着先部署一个本地第三方的MarketPlace。1、第三方MarketPlace部署 首先,我们可以从github上任取一个第三方的插件市场:awesome-claude-code-plugins/plugins at main · ccplugins/awesome-claude-code-plugins · GitHub注:当然,还有很多其他的插件库,这里只是举个栗子。 将这包解压到D:\Local Market目录中,我们首先将客制的插件市场接入到Claude中。