Hello 铁子们,这里是「笛笛AI搜推实验室」,一个聚焦用产品、商业思维帮助普通人学会 AI、提升效率的频道,我们持续探索并实践 AI 时代下超级个体的生存生活方式,如果你对 AI、商业以及超级个体感兴趣,欢迎关注我们。最近社群很多小伙伴在问 Claude Code 安装以及被封号的问题,大家都想用上目前 Coding Agent 领域的王者。为什么大家对 Claude Code、Codex 这类正在崛起的新型软件编程工具有这么高涨的热情,核心是它们代表了软件开发领域发生了一个根本性的范式变化。过去,我们使用 AI 是为了“提高写代码的速度”,现在,像 Claude Code 这类 Agent 可以直接参与“构建软件”。它们的核心价值并不是生成代码,而是缩短“想法到可运行软件”之间的距离。有了编程 Agent,它们是类似 AI 工程师的角色,你可以用自然语言提出目标,让 Agent 自己完成探索代码、定位问题、实施修改、运行验证等复杂的流程。这也是为什么我也强烈推荐大家一定要用上 Claude Code/Codex,它可以帮你快速验证想法、做内容创作、排查网络问题甚至是帮你检查签证申请填写问题回答的准确度,你和它就可以是一个团队。那今天的这篇文章是 AI 编程入门系列的第一期,我将带你从 0 安装 Claude Code,并接入国产大模型、用它做出第一个能跑、能用的产品并学会工作流 Skills,全程不用复杂环境,小白也可以跟着操作。话不多说,我们直接开始。- 新手上路:从第一章到第五章跟练,最后可以跑出一个网页小工具算AI编程工具入门;
- 遇到报错:如果遇到报错,莫慌莫慌,直接粘贴报错信息/截图丢给豆包/ChatGPT,描述自己在哪一步,看到什么报错,比查 Google 效率高超多倍;
在开始安装 Claude Code 之前,我们先建立一个简单的认知(已知同学请自行跳过)。因为有一些同学第一次接触 AI 编程,会搞不清楚:为了搞清楚上面这些问题,我们需要先理解 3 个核心概念:大模型就是 AI 的“大脑”,比如:Claude、GPT、DeepSeek、Kimi、MiniMax,它们负责:理解语言、分析问题、生成内容、进行推理。但是,光有大脑还不够。我们日常使用的 ChatGPT、豆包、Claude 网页版,都属于 Chatbot(聊天机器人)。它们非常擅长:回答问题、生成内容、辅助思考。但是它们通常停留在“对话”。比如你让它:“帮我做一个网站”,它可能会告诉你:应该怎么做。但是:创建文件、安装环境、运行项目、修改 bug,这些事情还是需要我们自己完成。Agent 是 AI 编程时代的核心概念。简单理解:Agent = 大脑 + 工具 + 执行能力。它不仅思考,更会主动完成任务。它会:理解目标 -> 拆解任务 -> 调用工具 -> 执行操作 -> 验证结果。Claude Code 就属于一种 Agent 工具。当它连接上大模型这个“大脑”后,它就变成了一个真正能帮你写代码、改 Bug 的“AI 程序员”。那国产大模型在里面扮演什么角色?Claude 经常会存在封号的问题,而像 DeepSeek 这类国产大模型,具备极高的性价价比和优秀的中文理解能力,成为了我们本地开发时的“平替大脑”。在后面的教程中,我们会教大家如何把 Claude Code 的身体,连接到国产大模型的脑子上,实现“高性价比编程”。安装 Claude Code,需要按顺序前置安装 4 样东西:Git → Node.js → VS Code → Claude Code。
为什么需要这些?因为 Claude Code = AI 程序员,AI 程序员要像人类一样工作,也需要一套趁手的工具和环境:Git 是代码基础设施,Node.js 是运行环境,VS Code 是操作界面,Claude Code 是真正帮你写代码的 AI Agent。
| | | |
| | | 它是代码世界的基建。Claude Code 需要通过 Git 来读取你的代码历史、提交修改,没有 Git 就无法感知代码的变化。 |
| | | Claude Code 实质是用 JS 写的命令行程序。就像游戏需要运行的引擎,Claude Code 必须依赖 Node.js 才能在电脑里跑起来。 |
| | | 可以当作 AI 工作台,用来实时查看 AI 帮我们写好的代码文件和项目结构。 |
| | | 基础环境配齐后,最后安装它。它会住进你的终端里,听调听宣。 |
后续下载 Node.js、VSCode 等安装包要分 ARM 和 x86 两类,先确认自己电脑芯片类型:- Mac:左上角苹果图标 → "关于本机",看"芯片"那一栏。M1/M2/M3/M4 这种是 ARM;Intel 是 x86_64;
- Windows:右键"我的电脑" → 属性,看"处理器"。Intel/AMD 是 x86_64;如果显示 ARM 那就是 ARM;
Mark 下自己电脑的芯片类型,后续安装包会用到;- Mac 用户:打开"终端"(启动台搜索"终端"),粘贴下面这条命令,回车:
/bin/zsh -c "$(curl -fsSL https://gitee.com/happyaicoder/HomebrewCN/raw/master/Homebrew.sh)"
- 中途需要输入电脑开机密码(输入时不会显示,直接打完回车即可);
- 显示选项选择 1,中间需要确实 Y/N,选择 Y;
上述指令采用了国内 HomebrewCN 镜像脚本下载 Homebrew,正常情况下无需科学上网,执行命令过程,根据提示选择国内镜像源,如果遇到下载慢或失败,优先检查网络环境配置。- 打开 <https://git-scm.com/>,点首页中间的 Install for Windows,根据电脑的芯片类型,选择对应的安装包进行下载;
装完桌面或开始菜单会出现 Git Bash 图标;不要自己改 Git 的安装目录,改了后面 Claude Code 会报错。
2.3 装 Node.js(Claude Code 运行环境)Node.js 版本要求:最低:Node.js 18+,版本太老可能会存在安装失败、部分功能无法兼容的问题;/bin/zsh -c "$(curl -fsSL https://gitee.com/iamzhihuix/nvm-install-cn/raw/main/install.sh)"
上述命令会通过国内镜像安装 nvm(Node Version Manager,Node.js 版本管理工具),通过 nvm 安装 Node.js;
1、打开 <https://nodejs.org/>,下载 LTS 版安装程序(.msi)2、双击安装,默认下一步,遇到"是否对设备更改"选"是"。如果 npm -v 报错"无法执行脚本",先跑一条策略命令再试:Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
1、打开 <https://code.visualstudio.com/>,下载对应系统的安装包;- Mac:双击 zip 解压后,把 Visual Studio Code 拖到"应用程序"文件夹;
- Windows:双击 exe 安装,勾选"添加到 PATH"和"通过右键打开"等所有选项;
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
通过国内 npm 镜像(npmmirror / 淘宝镜像)安装 Claude Code如果报权限错误,前面加 sudo 再跑一次(要输入开机密码):sudo npm install -g @anthropic-ai/claude-code
以管理员身份打开 PowerShell,先跑一条策略命令:Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
第三章节:给 Claude Code 配上国产模型Claude Code 是工具(外壳),还需要一个模型(大脑)。官方 Claude 模型需要外网、海外信用卡、有封号风险。对国内用户最现实的方案是:用 cc-switch 配国产模型。目前在 Claude Code 上体验和质量比较好的国产模型有 4 家,大家可以根据自己的需求选择:新手 MiniMax 套餐 29 元/月起,DeepSeek 10 元/月起,足够试水;3.2 装 cc-switch(模型一键切换工具)CC Switch 是一款跨平台桌面应用,专为使用 AI 工具的开发者设计。它会帮助你统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes 等受管应用的配置。它可以在日常开发中帮你解决以下核心痛点;- 多供应商切换麻烦:使用不同的 API 供应商(官方、中转服务商),需要手动修改配置文件
- 配置分散难管理:Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes 各有独立的配置文件,格式不同
- 无法监控用量:不知道 API 调用了多少次,花了多少钱
下载页:<https://github.com/farion1231/cc-switch/releases>下载慢就用国内镜像:<https://gitee.com/iamzhihuix/cc-switch-mirror>- Windows:下 .msi 双击安装;如果报错下"Portable"免安装版,解压到固定目录,右键以管理员身份运行;
- Mac:下 .dmg,双击后拖到"应用程序"。第一次打开会提示"无法打开"——别慌,系统设置 → 隐私与安全性 → 拉到最下面 → 仍要打开,然后输入开机密码即可;
3.3 拿到模型的 API Key(以 DeepSeek 为例)1、打开 DeepSeeek 官网,购买 key:https://platform.deepseek.com/usage;3、DeepSeek 针对用户推出固定费率的「订阅套餐」官方网页版和手机App提供免费、无次数的对话与深度思考(R1)功能;API 服务面向开发者与企业,采用灵活的「按量计费」(Prepaid 预付值储)模式;大家可以根据自己的需求选择购买金额,初期试水 10RMB+够用;4、付完款,进 https://platform.deepseek.com/api_keys 地址获取 API Keys5、点"复制",把 Key 保存到一个文本文件里;其他模型(GLM、Kimi、DeepSeek 等)流程一样:注册 → 进控制台 → 创建 API Key → 复制。
1、打开 cc-switch,左上角点 Claude 图标2、右上角点 +,选模型供应商(如 MiniMax / Zhipu GLM / DeepSeek)4、回主页面,鼠标移到该模型上,看到"使用中"或点"启用"打开终端(Mac 终端 / Windows PowerShell),输入:sqlite3 -header -column ~/.cc-switch/cc-switch.db \"select provider_id, model, request_model, status_code,case when created_at > 100000000000 then datetime(created_at/1000,'unixepoch','localtime') else datetime(created_at,'unixepoch','localtime') end as time from proxy_request_logs where app_type='claude' order by created_at desc limit 10;"
如果回复了正确的模型名(如 MiniMax-M2.7 / GLM 5.1/deepseek),配置成功:我们回到终端,输入claude,回车:就可以正常启动 claude code 了;第一次使用,可以做一些初始化设置,比如输入 /theme 颜色模式,模式下面有代码预览,大家根据自己的喜好来就好,选中回车;然后我们启动的时候,因为上下文设计,为了让他有约束,更加的专注,所以我们是需要对着一个文件夹进行启动的,而不是直接在根目录启动 Claude Code。1、VS Code 左侧扩展面板搜 Claude Code(认准 Anthropic 出品);2、安装,重启 VS Code,右上角会出现 Claude Code 图标,点它就能打开对话框和 Claude 开始进行对话;如果用插件方式打开后出现"订阅"画面,回 cc-switch 设置里勾上 "应用到 Claude Code 插件",重启 VS Code。
4.3 让 Claude 记住你的偏好 CLAUDE.md学会启动后,你就可以正式和 Claude Code 对话,随便和它对话。但在深度使用之前,有一件非常重要的事情是先定义好你的 CLAUDE.md 文件。- 什么是 CLAUDE.md?(顶层穿透的约束体系)
这个东西,它不简单是一份普通的 Markdown 文件。在 Claude Code 的世界里,它是一个从上往下分层穿透的“法律和道德约束体系”。Claude 每次启动时,都会强制、自动地先通读一遍这个文件,把它刻进自己的“长期记忆”里。全局级 CLAUDE.md (~/.claude/CLAUDE.md) └── 解决你是谁、你做事的底层原则、全局协作习惯 项目级 CLAUDE.md (当前项目根目录/CLAUDE.md) └── 解决这个具体项目的代码规范、特殊约定、干活流程
- 全局级 CLAUDE.md:放在你电脑的用户总目录下(~/.claude/CLAUDE.md)。只要你打开 Claude Code,不管你进的是哪个文件夹,它都会被自动加载和遵守,这是它的“最高宪法”。
- 项目级 CLAUDE.md:放在具体某个项目的根目录下。它只在你进入这个项目时被激活。全局规则和项目规则冲突时,项目规则优先。
我是个产品经理,我想在我的 code/my_experiments 目录下做点零碎的 AI 实验,或者写点临时脚本。 每次我 cd 进去启动 Claude,直接对它说:“帮我写个自媒体文案自动抓取工具”。- Claude 的直男反应:它会稀里糊涂地直接在当前目录下噼里啪啦生成一堆 main.py、utils.py。
- 混乱的后果:过了几天,这个目录下全是各种实验留下的散落文件,你根本分不清哪个文件属于哪个工具,项目目录乱成一锅粥。你还得每次打字警告它:“我是产品经理,写注释用中文,别给我整太复杂的底层代码!”——每次启动都要重复废话。
现在,我们直接在 code/my_experiments/CLAUDE.md 里写下这段极简的约束规则:# 协作身份- 我是产品经理(不写代码),所有技术原理解释请用大白话和形象的比喻(费曼学习法)。- 所有生成的文件中,代码注释必须统一使用中文。# 文件管理规范(核心核心!)- 当我提出一个全新的需求或新工具时,严禁直接在当前根目录生成文件。- 你必须自动在当前目录下,为这个新需求新建一个独立的子文件夹(英文命名),并将所有相关文件、输出成果统一归纳进该子文件夹中。
配置好后,你再次 cd 进目录启动 Claude Code,一句话不说,直接丢给它一句话:“帮我做个小红书爆款文案生成器。”Claude 读完你的 CLAUDE.md 记忆,不需要你再做任何解释,它会自动在后台帮你创建一个叫 xiaohongshu-generator/ 的新文件夹,把代码、甚至生成的 outputs/ 文案规规矩矩地码在里面。同时,它跟你汇报时会说:“Boss,工具做好了!代码注释我全写成了中文。这个工具的运行原理简单来说,就像把你的输入丢进了一个自动化流水线,输入要求,自动出货……”它把你的混乱的岗文件夹,变成了一个井井有条的自动化工作室。你懒得每次都建新文件夹?没关系,它看懂了你的规则,它帮你建。
第 5 章 用 Claude Code 做一个小产品"赛博塔罗牌·今日运势占卜"咱们不要急着做大项目,先用一个简单的小工具体验完整流程。小红书爆点:#塔罗牌占卜 #今日运势 #心理测试。玄学是小红书上的流量密码,做个占卜小网页,挂上自己的私域引流码,引流效果惊人;用户感知点:感知 Claude 对 CSS 3D 翻牌动画特效、复杂的随机算法、以及精美卡牌视觉排版 的全栈拿捏能力;1、VS Code → 文件 → 打开文件夹 → 新建一个文件夹(如 早读神器) → 打开;2、在 VS Code 里新建一个文件 prd.md(PRD = 产品需求文档)。3、把下面这段需求贴进去,保存(Mac:Cmd+S;Win:Ctrl+S):请用 HTML + CSS + JS 创建一个"赛博塔罗牌·今日运势占卜"应用:1. 视觉与动效(核心): - 神秘学复古暗色背景(带星空或星座线条装饰)。 - 屏幕中央并排展示 3 张背面图案相同的塔罗牌,必须带有炫酷的鼠标悬停浮动、发光阴影特效。 - 点击任意一张牌,卡牌执行【3D 翻转动画】,翻开正面,展示出具体的卡牌名称和图案。2. 核心功能: - 内置一个包含至少 10 张经典塔罗牌(如:愚者、魔术师、女祭司、命运之轮等)的数据矩阵,每张牌包含:牌名、正位/逆位状态、以及一段简短的“今日工作/恋爱/财富运势解读”。 - 随机算法:用户点击时,随机抽出一张牌,并随机决定它是“正位”还是“逆位”(逆位时图片要倒过来显示),并弹出精美弹窗显示今日运势解说。3. 细节设计: - 底部带有一个“每日只能占卜一次”的限制逻辑(通过 localStorage 记录今天是否抽过牌,若抽过,则提示“天机不可泄露,明天再来吧”)。
5.2 在 VS Code 右边点击插件启动 Claude Code 开启对话回车,等它跑完(一般 2-5 分钟)。期间会自动建文件、写代码、跑测试- 项目目录里右键 index.html → 选择"用谷歌浏览器打开"(Mac 在 Finder 里右键,Win 在文件资源管理器里右键 → "用浏览器打开")。
- 打开网页之后可以看到赛博塔罗牌的网页,根据你的心意点击某一张卡牌,会看到抽取的卡片信息
走到这里,恭喜你!!跑通了,恭喜你做出第一个 Claude Code 产品。- 挖需求:找到对标产品,截图问 AI"我想复刻这个,先帮我写好 PRD";
- PRD 先于代码:好的需求文档让 AI 一次写对,省 80% 的来回沟通;@文件名 是 Claude Code 的核心语法:让它精准聚焦到某个文件;
- 不会写代码也能做出产品:你负责想清楚"要什么",AI 负责"怎么做";
如果说第 5 章你已经在用 Claude Code:“帮我写一个小产品”,那 Skill 做的事情是:把你已经让 AI 做过的事情,变成一句话就能重复调用的“工作流程按钮”;一句话总结,Skill 的实质是: 一份“写给 AI 的免翻阅操作手册 + 自动触发开关”。它用规范的格式告诉 Claude:- SKILL.md:核心配置文件,定义这个 Skill 干什么、什么时候触发、按什么步骤执行
- templates/(可选):模板文件,规定输出格式
- examples/(可选):示例文件,AI 会模仿示例的结构
作为新手,我们甚至不需要管代码和模板,只需要看懂 SKILL.md 里的两块核心内容:---name: xhs-script-expertdescription: 当用户提到“写小红书、构思爆款文案、拆解短视频脚本”时自动激活此技能---
👉 Claude 每次听到你说话,都会扫一遍所有 Skill 的 description。这个描述,就是它的“听音辨字触发开关”。# 运行步骤1. 读取用户提供的原始素材或网页链接。2. 提取出核心痛点,并按照小红书黄金三段式进行重构。3. 自动在 `outputs/` 目录下生成一个以当前日期命名的 `.md` 脚本。
这部分就是 AI 照着执行的“保姆级操作说明书”。所以,Skill 的价值,在于把“你和 AI 的零散对话”,升级成了“你和 AI 的确定性系统”。根据您提供的这 6 个极具实操性且在日常工作中高频使用的 Skill,我帮您将它们归纳整理为 3 大核心分类:效率提升、内容创作、办公场景:让 Claude Code 帮你做一个 Skill:每次写完文章,自动生成 3 张插画风格的配图。步骤 1:拿到图像生成 API Key(APImart)打开 https://apimart.ai/zh/model/nano-banana-2-api注册登录(邮箱 / Google / GitHub 都行),完成邮箱验证;点【API 密钥】→【创建 API 密钥】→ 起名(如 Claude-skill)→ 复制并保存;进【账单】→ 充值,首次推荐 5-10 美元(每次生成 3 张图约 0.05 美元)。步骤 2:让 Claude Code 创建这个 Skill启动 Claude Code,在新项目目录里输入:我需要你帮我设计一个 skill,主要用来帮我实现文章配图。当我写完一篇文章之后,调用这个 skill,帮我文章配图。我的 API 是 apimart,调用模型选择 gemini-3-pro-image-preview(Nano Banana 2),调用文档:https://docs.apimart.ai/要求:- 每篇文章只生成 3 张图片,前 30%、中间 30%、最后 30% 各一张- 图片中的文字必须是中文- 图片风格固定为手绘漫画风格,温暖、亲和、有故事感,不偏写实、不偏赛博朋克- 横向或方形构图,画面干净,主体清晰这个 skill 的名字叫"插画风格配图生成 skill"。
Claude Code 会询问 API Key,直接粘贴:我的 APImart API Key 是:[粘贴你的 Key]请把它配置到 skill 中,并测试一下能不能用。
/插画风格配图生成skill "这是一篇关于夏天的文章,描述了花开的冲浪、日光和冰凉美味的水果。"
6.3 Skills vs MCP vs Plugin(3 种扩展机制别搞混)经常有人问" SKill 和 MCP、Plugin"的区别,为帮助我们彻底搞懂,我们用“赛博后厨”来打个形象的比方:📜 Skill (技能) ─── 菜谱:规范 AI 的做菜步骤和 SOP 流程🔌 MCP (上下文协议) ─── 厨具与水电:给 AI 接入外部数据库、浏览器和 API 的能力📦 Extension (打包) ─── 满汉全席套餐:将上述能力打包好,一键分发给你的整体包
- Skill (技能) 像【菜谱 SOP】:它不给 AI 增加新工具,而是规范干活的流程。告诉厨师先切菜、后放盐、最后必须摆盘;
- MCP (模型上下文协议) 像【厨房的水电气和新厨具】:它不教 AI 怎么做菜,而是给 AI 接通外部世界的能力。比如给它连上联网搜索、连上你本地的数据库、或者连上 Google Calendar;
- Extension (扩展包) 像【一键导入的半成品预制菜大礼包】:在 2026 年的 AI 生态里,我们一般管 Vercel 或社区里那种“既带说明书、又带自动化脚本”的综合技能集合叫扩展包或技能仓库(如 baoyu-skills),它是一站式打包送给你的;
- 想让 Claude 稳定完成某个流程 → 写 Skill
- 想让 Claude 能用某个外部服务/工具 → 装 MCP
如果你能走到这里,其实已经完成了一件很重要的事情——你不再只是“用 AI 写代码的人”,而是开始尝试用 Claude Code 去搭建自己的工作流和小产品。从 PRD 到代码生成,从一次性 demo 到可复用 Skill,本质上是在把“人工编程”逐步转变为“系统化自动生产”。接下来真正拉开差距的,不是你会不会用工具,而是你能不能把工具变成体系。如果你希望继续深入学习 AI 编程和产品化实践,可以关注我的公众号(小红书、抖音同名):产品经理胡笛笛,后续我会持续更新更多真实可落地的 AI 产品案例。