简介一套围绕Claude Code的前端源码包采用TypeScript与React技术栈面向希望深入大模型工具链实现的中高级人工智能开发者可作为学习参考或二次开发基线。压缩包内共1903个文件以1332个ts文件和552个tsx文件为主体另有18个js与1个md说明文档覆盖数据预处理、模型调用、界面渲染、部署脚本等常见环节整体大小仅9.43MB目录结构紧凑便于按模块检索。当前已有1112人学习下载。通过研读源码开发者可以理解模块化封装思路掌握在真实项目中接入AI能力的工程实现并基于现有框架进行二次开发md说明文档还能辅助梳理目录结构与运行逻辑代码中的注释和模块划分有助于快速定位关键逻辑、减少踩坑成本。这份源码在AI开源社群中流传为从理论到落地提供了一条直观路径是提升工程实践能力的实用参考。 最近几天我一直在啃claude-code源码起因其实很朴素一个跑在终端里的AI编程代理凭什么能自己读项目、改文件、跑命令还能在出错之后自己重试这事不拆开看永远停留在“用得爽”的层面。我翻遍了安装目录、官方SDK仓库、社区插件把它的外壳、内核、配置体系摸了一遍这篇就是完整的拆解记录。适合两类人看一类是想深入理解终端Agent架构的开发者另一类是准备基于Claude Code做二次开发、接自己工作流的同学通篇不涉及破解和绕过只聊源码、机制和正规的扩展方式。1. 拿到源码安装方式、目录结构和官方开源范围1.1 一条npm命令背后源码到底躺在哪安装Claude Code最常用的方式就一条命令npm install -g anthropic-ai/claude-code装完以后真正的“源码”不在项目目录里而在全局node_modules。Windows上最常见的位置就是热词里那个路径C:\nvm4w\nodejs\node_modules\anthropic-ai\claude-code。如果你没用nvm默认路径一般是C:\Users\你的用户名\AppData\Roaming\npm\node_modules\anthropic-ai\claude-code。macOS或者Linux用户则在/usr/local/lib/node_modules/anthropic-ai/claude-code或者~/.nvm/versions/node/xxx/lib/node_modules/anthropic-ai/claude-code取决于你怎么装的Node。打开这个目录第一眼会看到bin目录下有个cli.js还有对应的claude可执行脚本。再往里翻核心实现其实是打包后的产物一个大得离谱的JavaScript文件Claude Code的主体逻辑全在里头。它不是让你一行一行读源码的设计但所有关键字符串、配置项、提示词、工具调用逻辑都能在这个文件里搜到。这点很重要读懂Claude Code源码的第一要诀不是“从头到尾读”而是“高效搜索”。1.2 官方到底开源了哪些东西社区又能找到什么先说结论Claude Code的完整源码并未全部开放Anthropic主要开源的是面向二次开发的SDK和插件生态。官方GitHub仓库anthropics/claude-code更多承担的是发布、文档、插件机制说明的职能不是传统意义上的完整源码仓库。真正能拿到手研究的官方开源内容包括Claude Agent SDKTypeScript版本和Java SDK它们让你能脱离官方CLI外壳在自有代码里直接调用Claude的Agent能力还有插件市场相关的开源规范。社区里也有不少人在做逆向和复刻比如各家AI网关项目会实现Claude的协议兼容层这些都可以当作“源码”来分析。我整理了一个源码地图方便大家按图索骥路径 / 仓库里面有什么适合干什么node_modules里的cli.js打包后的完整CLI逻辑搜配置项、提示词、工具调用~/.claude.json全局配置包含历史会话、项目级权限排查行为异常、看日志路径.claude/settings.json项目级配置入口自定义权限、hook、模型参数anthropics/claude-code仓库官方文档、插件机制、发布说明了解最新特性和接口约定anthropics/claude-agent-sdkTypeScript版Agent开发SDK自研Agent、嵌入式集成社区网关/协议兼容项目兼容Claude API协议的服务端接入第三方模型、统一计费把这张表吃透剩下的就是在具体场景里反复查、反复试。源码不是拿来膜拜的是拿来用的。2. 从源码看懂Claude Code的核心机制2.1 入口启动cli.js在启动的几秒内做了什么不管你是执行claude还是claude -p xxx最终都会进入cli.js或者对应的打包入口。启动流程大致分四步解析命令行参数、定位用户目录和项目目录、加载配置、启动交互循环。命令行参数部分-pprint模式、--continue继续上一次会话、--model指定模型这些在源码里都有自己的解析分支。这个环节最容易被忽略但极其关键的是“配置加载顺序”全局配置、项目配置、环境变量、命令行参数是层层覆盖的关系后读的覆盖先读的。所以你在命令行传一个--model往往比配置文件里的model优先级还高。我在源码里搜“loadSettings”“config”这类关键词能清晰地看到它先读~/.claude.json再读项目目录下的.claude/settings.json最后合并环境变量。理解了这个顺序你遇到“为什么我改了配置没生效”这类问题时排查思路就清晰了先看是不是有更高优先级的配置把你覆盖了。2.2 Agent循环的源码级还原Claude Code的本质是一个“感知-规划-执行-反馈”的死循环。源码里虽然没有直接叫agent_loop的目录但所有工具调用、权限检查、自我纠错逻辑都是围绕这个循环组织的。感知阶段它会把项目目录结构、文件内容、CLAUDE.md、当前git状态读进上下文。规划阶段模型根据这些信息决定调哪个工具。执行阶段工具调用指令被解析成真实的bash命令、文件写入或HTTP请求。反馈阶段执行结果回传给模型模型判断成功还是失败决定下一步是继续还是换方案。这三个阶段的代码在打包文件里通过大量的事件名称和工具名出现比如ToolCall、BashOutput、EditResult。它们之间通过一个事件总线通信。理解这个架构你就能明白为什么Claude Code能自己改完代码后发现编译报错再改一遍因为反馈是闭环的模型能看到执行结果。这也是它和普通ChatGPT网页版最大的区别它拥有执行环境并且能够看到执行后果。源码里数量最多的字符串就是各种工具调用协议和权限提示。2.3 权限系统它凭什么敢让你直接授权Claude Code最谨慎的部分就是权限控制。源码里有一套完整的权限匹配逻辑默认情况下危险操作需要人工确认和缓操作可以直接放行。具体来说配置项里有两个核心数组allow和deny。判断顺序是先看deny列表命中就直接拒绝再看allow列表命中就直接放行都没命中就进入交互式询问。这个判断逻辑在打包文件里对应一段很直观的前缀匹配代码规则支持通配符比如Bash(npm run lint:* )就表示所有以npm run lint:开头的命令都可以直接执行。项目级配置优先级高于用户级配置这个设计也是源码里明确实现的。实际开发中我强烈建议团队把常用命令写进.claude/settings.local.json的allow列表里减少无谓的人工确认。但危险操作比如rm -rf、git push --force最好还是让它弹确认框安全底线不能省。3. 不碰源码也能改造Claude Code配置与Hook实操3.1 settings.json最值得吃透的扩展入口前面说了.claude/settings.json是项目级配置入口如果你愿意完全可以把它当作“不修改源码的插件系统”。我常用字段有这几个{ model: claude-sonnet-4-20250514, permissions: { allow: [ Bash(npm run lint:*), Read(~/projects/my-app/**) ], deny: [ Bash(git push --force*), Write(secrets/**) ] }, hooks: { PostToolUse: [ { matcher: Edit, hooks: [ { type: command, command: npx prettier --write $CLAUDE_FILE_PATHS } ] } ] } }model字段可以直接换成你想用的模型版本注意要用模型的完整字符串ID写错了claude-code会直接报错。permissions字段控制工具调用权限。hooks字段则是Claude Code最有想象力的部分它能在特定事件发生后执行外部命令等于在Agent的生命周期里塞进了你自己的逻辑。这个文件的优先级高于用户级配置但低于命令行参数。改动以后不需要重启CLI新会话就会生效非常方便。3.2 用Hook把外部流程接进Agent生命周期Hook机制是Claude Code扩展性最强的部分。官方支持的钩子事件有PreToolUse、PostToolUse、Notification、Stop等。我实际用过最顺手的是PostToolUse当Claude改完文件自动跑一次格式化当它跑完测试自动把关键指标写入日志。上面JSON里那个例子就是PostToolUse的完整写法匹配条件是Edit这个工具一旦Claude完成文件编辑就调用npx prettier --write进行格式化。$CLAUDE_FILE_PATHS是事件携带的变量Claude Code会自动替换成实际被编辑的文件路径。Hook命令必须是非交互式的因为它没有stdin可以等待用户输入。它的输出会回传给模型所以你可以利用这一点做“二次监督”比如在Git操作后自动查看diff把结果塞回上下文。这使得Claude Code不再只是“对话式编程工具”而是一个可以嵌入工程规范体系的自动化执行器。3.3 打开Debug模式把黑盒变成白盒源码阅读和问题排查最有力的武器是Debug输出。执行时加两个环境变量claude --debug --log ~/.claude/logs之后CLI会把完整的请求头、响应体、工具调用过程、token消耗都打印出来。这些日志文件实际上是理解源码行为的“活文档”你犯不着一行行读打包后的JS直接看它真实运行时的输入输出效率高得多。我最常用的一种排查方式是拿到一个报错后先在日志里找response和tool_call两个关键词看模型当时到底返回了什么。一次报错、一次重试、一次权限拒绝在日志里都清清楚楚。遇到一些诡异行为比如“明明配置了allow但还是弹确认框”大多数情况在日志里翻翻就能发现是规则匹配只匹配了前缀不是全路径匹配。4. 热搜解析Claude Code调用DeepSeek到底怎么计费4.1 费用从哪来订阅制和API按量计费是两条线这个热搜最近很火我直接用大家听得懂的话拆清楚。Claude Code官方使用方式是对Anthropic订阅用户开放的你在CLI里用的是官方模型费用包含在订阅套餐里和网页版、手机版共享额度不存在额外的“按次计费”。但是Claude Code本身是一个客户端壳子它对模型服务的访问依赖API协议。社区里很多人通过配置网关或者环境变量把Claude Code的模型请求转发到兼容该协议的第三方模型接口上最常见的就包括DeepSeek。这种情况下Claude Code这个工具本身不产生额外费用真正消耗的是你填进去的那个API Key余额也就是DeepSeek平台按token量计费。所以计费问题的本质是只要走的不是Anthropic官方API费用就和你直接调第三方API完全一样跟Claude Code没有关系。4.2 DeepSeek按token计费怎么估算按token计费不是按次数计费也不是按时长计费。它只关心你消耗了多少token包括输入token和输出token。DeepSeek在官网公开的按量价格是每百万token几元人民币的量级具体数值以官网最新价格为准但不管怎么调绝大多数情况下都比海外闭源大模型便宜一个数量级这也是它成为Claude Code替代后端热门选择的原因。但是claude-code有个特别烧token的特点它会把项目目录结构和大量文件内容塞进上下文一个中等规模项目的会话一次请求可能就是几万到几十万的输入token。举个例子假设你让它修复一个功能它先读了十个文件每个文件大约2000行那一次请求的输入token可能就超过10万。按DeepSeek输入侧每百万token几元的价格算一次请求几毛钱一个小时的密集使用下来可能也就几块钱。这个量级对个人开发者来说完全可控。我给你一个通用估算公式单次请求成本 输入token数 / 1000000 × 输入单价 输出token数 / 1000000 × 输出单价把模型返回的token数量除以一百万再乘以对应的单价把两段加起来就是这一轮的费用。长时间任务累加所有轮次即可。4.3 换后端的隐性成本和必须注意的坑价格便宜不代表没有额外成本。首先是模型能力差异DeepSeek在代码生成、工具调用协议上虽然兼容度不错但在长上下文任务、复杂依赖定位、多文件协同修改场景下和Claude官方模型还是有可感知的差距。我实测下来的体感是简单CRUD和脚本编写没问题重构大模块、跨服务追踪逻辑时偶尔会出现“该读的没读、不该改的乱改”的情况。其次是上下文缓存费用很多API平台对长上下文会有缓存机制命中缓存的输入会更便宜但前提是你得开启相应配置。不开启的话反复读同一批文件就是反复付全额输入费用。claude-code这种反复重读文件的使用模式是最吃缓存优化的一类场景。最后是兼容层本身带来的风险网关的稳定性、隐私、数据出境等问题都得自己评估。这东西适合技术底子好、愿意折腾的人纯小白用户在这条路上踩坑的概率不低。我的建议是先在官方订阅模式下把工具本身用熟再去折腾第三方API计费否则出了问题你根本分不清是权限没配对还是网关没调好。5. 源码阅读和日常使用中的排坑实录5.1 高频问题速查表踩过的坑都在这我把实际使用中遇到的高频问题整理成一个速查表按“问题-现象-解决方案”排列问题现象解决方案Windows下claude命令找不到提示claude不是内部或外部命令检查nvm或npm全局路径是否在PATH里重装npm包claude二进制被杀毒软件隔离安装时报毒或运行没反应报错路径形如c:\nvm4w\nodejs\node_modules\anthropic-ai\claude-code\bin\claude.e恢复文件后在杀毒软件里添加信任目录重新安装PowerShell无法执行claude提示“禁止运行脚本”以管理员执行Set-ExecutionPolicy RemoteSigned改settings.json不生效行为没有任何变化检查是不是存在local/settings.local.json覆盖或命令行参数优先级更高模型调用老是超时长时间无响应开启--debug看日志定位是网络问题还是模型卡在等待工具结果日志文件无限膨胀磁盘空间被占满定期清~/.claude/logs或只保留最近一周权限规则不匹配明明allow了某条命令仍然弹确认框检查通配符写法规则只做前缀匹配这里面最值得单独说一句的就是杀毒软件误报那个坑。claude.exe这种没有正式签名的二进制很容易被Windows Defender盯上你可以通过路径去排查报错信息明显指向node_modules里的bin目录那就不是项目配置问题是文件被隔离了。恢复并加入信任目录后大部分情况下就能解决。5.2 阅读源码的最佳路线别再从头硬啃了我最初也尝试过从cli.js第一行往下读结果三个小时后还在前几千行打转。后来发现正确路线是“从报错出发、从关键词搜索、从日志反推”。第一步先跑一个会出错的场景。比如故意写一个不存在的配置项让它报错然后把报错信息里的关键字符串复制下来去打包后的源码文件里搜索。这样你找到的不是无关代码而是真正和问题相关的逻辑。第二步搜索高频配置关键词。permissions、hooks、allow、deny、model这些词在源码里成片出现每个都对应一个完整的功能模块。你只要读懂了其中一个模块就能举一反三理解其他模块。第三步结合Debug日志阅读。日志里会有源码的函数名、文件路径、事件类型把它们当索引反向定位源码位置效率极高。这也是我前面反复强调Debug日志价值的原因。5.3 啃完源码之后的变化把Claude Code源码翻过一遍最大的变化不是我能改它了而是我彻底改变了用它的方式。以前遇到限制只会抱怨“这个工具怎么这么死板”现在第一反应是去settings里加一条permission规则或者写一个hook把流程串起来。以前不理解它为什么每次都要问一遍确认看源码以后才明白它的权限系统本质上是“按你授权的最大边界执行”你不给它放宽边界它永远选择最保守的路线。这也让我体会到这类终端AI工具的设计哲学其实不是“全自动”而是“半自动加及时反馈”。它把决策权保留在你手里把执行和纠错交给Agent。你给它越清晰的规则、越完整的项目上下文它给你的回报就越惊人。折腾源码的过程本身就是一次和工具设计者的深度对话。本文还有配套的精品资源点击获取