工程 Agent

Claude Code 从安装到项目 MVP 终极路线

这是 Claude Code 的完整学习路线：先跑通安装和模型，再学会只读项目、限定权限、看 diff、跑验证，最后再进入 hooks、skills、插件、子智能体和自动化。官网桌面端开发者模式放在 Claude Desktop 教程里，不混在这里讲。

8-15 分钟新手可跟真实代码项目修复报错改网页功能理解陌生项目

照着安装复制 API 配置官方文档

照着做，先跑通一次

不用先研究原理。先复制粘贴把安装、配置和第一句测试跑通，后面再让小白带你做真实任务。

1. 打开入口

下载包、官方页、模型入口都放在这里，不用自己到处搜。

2. 复制粘贴

命令和配置项按顺序填，看到版本号或应用能打开就继续。

3. 让它回一句话

能听懂测试句、能回复你，就可以进入第一个真实任务。

先选模型 API 或本地模型

Agent 本体只是执行工具，模型才是大脑。正式接入前，先看模型排行和价格快照。

模型 = Agent 的大脑

负责理解、推理、写内容和决定下一步。

Agent = 模型的手脚

负责打开工具、读文件、改代码、跑命令和执行任务。

接入 MiniMax

如果用户只是聊天、写文案、问问题，可以先用 MiniMax 会员或 MiniMax API。支持 OpenAI Compatible 的工具，按下面这组填写。

日常对话低成本

照着做

1打开 Agent 或桌面客户端的 Settings / Models / API 设置。

2Provider 选择 OpenAI Compatible / Custom；官方 OpenAI 就选 OpenAI。

3按下方字段填写 Base URL、API Key、Model。

4点击 Save / Enable / Test。

5新建一次对话，发一句测试消息，能回复就算接通。

Provider

OpenAI Compatible / Custom

Base URL

https://api.minimax.io/v1

API Key

你的 MiniMax API Key

日常对话先选

MiniMax-M2.7

更快版本

MiniMax-M2.7-highspeed

保存后怎么测

新建对话，发送：你好，帮我写一句短文案

MiniMax 更适合作为新手日常对话和轻量工作入口；复杂 Agent、长代码任务、企业资料任务后期再按需求换模型。

MiniMax 官方兼容 OpenAI API，Base URL 使用 https://api.minimax.io/v1。

价格和套餐变化很快，正式开会员或接 API 前先看本站模型排行和价格快照，再复核官方价格页。

Claude Code 可视学习路线

从上往下走。不要跳到最后直接做大 App，先把每一层跑通，再进入下一层。

1安装底座

Node.js、Git、VS Code、Claude Code。先看到版本号。

2接模型

官方 Claude、DeepSeek、MiniMax、CC Switch 或 Router。先用一句中文测通。

3只读项目

让它读目录、列计划、说明风险，不改文件。

4小改动

限定范围、看 diff、跑 typecheck / test / build。

5加能力

CLAUDE.md、hooks、skills、插件、MCP、子智能体。

6做 MVP

需求、页面、API、验收、README、复盘。

新手主线能启动 -> 能接模型 -> 能读项目 -> 能小改 -> 能验收 -> 能复用

复制粘贴安装

从第 1 步往下做。每一步只处理一个动作，失败了看下方常见问题，不用反复重装。

1. 先检查 Node.js

打开终端。Windows 打开 PowerShell，Mac 打开 Terminal。复制下面两行，能看到版本号再继续。

node -v
npm -v

2. Windows 直接安装

PowerShell 里复制这一段。这里用 npm.cmd，是为了避开 npm.ps1 被系统策略拦住的问题。

npm.cmd install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
claude --version

3. Mac / Linux / WSL 安装

复制下面这一段。官方提醒不要用 sudo npm install -g，容易产生权限问题。

npm install -g @anthropic-ai/claude-code
claude --version

4. 启动

看到版本号以后，复制下面这一行启动。

claude

启动后先说这句

第一次不要急着做复杂任务。先用一条测试句确认它已经真的能用。

只是打开试试

第一次打开后，先让它解释能力，不要马上改文件。

claude

接好 DeepSeek 后再启动

Windows 用户在同一个 PowerShell 窗口里先复制下面几行，最后一行 claude 会直接启动。不要在命令前面加空格。

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek_API_Key"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
claude

在项目里使用

先进入你的项目文件夹，再启动 Claude Code。

cd 你的项目文件夹路径
claude

跑通验收标准

能打开工具，或在终端看到版本号。

能输入一句测试问题，并得到一次正常回复。

知道它是 Agent、桌面助手、模型客户端里的哪一种。

装好以后做一个 MVP

安装不是终点。工具能启动以后，马上用一个小任务验证它能不能帮你交付结果。

1验证安装

先完成一次正常回复、一次文件/项目读取或一次命令验证。

进入 2改一个小功能

工程 Agent 跑通后，用真实项目做一个很小的页面或逻辑修改。

进入 3接知识库 Bot

桌面助理或平台工具跑通后，做一个可演示的知识库问答。

进入 4回学习路线

MVP 做完以后，继续进入 Agent、自动化或一人公司项目分支。

进入

第一次让它说什么

这些不是装饰文案，是用来确认工具真的能工作的第一组测试。

请先告诉我你能做什么，不要修改我的文件。

请先阅读这个项目，不要改文件，告诉我它是什么技术栈、主要目录和下一步建议。

只改我指定的文件，改之前先列计划，改完告诉我修改了哪里。

装好后，把它训练成你的 Agent

模型接好只是有大脑，还要给它岗位、人设、记忆结构、权限边界和验收标准。

1. 先做只读体检：别一上来让它改项目

Claude Code 装好以后，第一件事不是写 App，而是确认它能看懂你的项目，又不会乱动文件。新手先把读项目、列计划、等确认这三件事练熟。

进入一个 Git 项目目录后再启动 claude，不要在桌面空文件夹里乱试。

第一句话要求它只读项目，不要修改文件。

让它输出技术栈、启动命令、主要目录、风险点和最小可改任务。

如果它要执行命令，先让它解释命令作用，再决定是否允许。

请先只读这个项目，不要修改任何文件，也不要执行会改变文件的命令。

请按下面格式回答：
1. 这个项目是什么技术栈
2. 主要目录分别做什么
3. 本地启动命令可能是什么
4. 现在最适合新手修改的一个小功能
5. 修改前需要我确认什么

它没有改文件。它能说清项目结构。它给出的下一步很小，可以回滚。

2. 接第三方模型：先跑通，再谈强不强

很多国内用户不是不会用 Claude Code，而是卡在官方服务、API Key、模型名和 base_url。模型接入要先用最小测试跑通，再逐步换更强模型。

先选一种路线：官方 Claude、DeepSeek Anthropic Compatible、MiniMax，或 CC Switch / Claude Code Router。

Windows PowerShell 用 $env:，Mac / Linux / WSL 用 export，不要混着复制。

先用便宜或快速模型问一句中文测试，能回复再换长上下文或强推理模型。

出现 401、model not found、timeout 时，先检查 Key、模型名、base_url 和余额，不要反复重装 Claude Code。

我现在要给 Claude Code 接第三方模型。

我的系统：Windows / Mac / WSL
我用的模型服务商：DeepSeek / MiniMax / Kimi / 其他
我的 Base URL：这里填
我的模型名：这里填

请你只帮我检查配置项，不要让我把 API Key 发给你。

API Key 没发给别人。测试问题能正常回复。知道当前窗口环境变量关闭后会失效。

3. 学会权限和 diff：让 Agent 真改，但别失控

Claude Code 真正有价值，是能读文件、改文件、跑命令。风险也在这里。新手必须先学会限定范围、看 diff、跑验证。

每次只给一个小任务，例如改一个按钮文案、修一个报错、补一个表单校验。

任务开始前要求它列计划和涉及文件。

修改后先看 diff，再允许继续做下一步。

让它运行项目已有检查命令，并明确哪些没验证。

我要让你改一个小功能。

目标：这里写清楚
允许修改的文件：这里写文件或目录
不要修改：这里写不能动的页面、配置、数据库或样式

请先列计划和会涉及的文件，等我确认后再改。
改完后请总结 diff、验证命令和剩余风险。

修改范围没有扩大。能看到 diff 摘要。有验证命令和结果。

4. 再学 hooks、skills、插件和子智能体

这些不是炫技功能，而是把 Claude Code 从一次性聊天变成可复用工作系统。顺序很重要：先会小改动，再加规则和能力。

CLAUDE.md / AGENTS.md：写项目说明、运行命令、禁止事项和交付标准。

Hooks：把硬性检查放进去，例如完成前提醒跑 typecheck、测试或安全检查。

Skills：把常用工作方法沉淀成可复用步骤，例如 UI 审计、教程改写、接口排错。

Plugins / MCP：连接浏览器、GitHub、Figma、数据库、飞书等外部工具，但先从只读权限开始。

Subagents：把研究、测试、UI、文案等任务拆给不同角色，避免一个 Agent 什么都做。

请帮我为这个项目设计 Claude Code 协作规则。

需要包含：
1. CLAUDE.md 应该写哪些项目规则
2. 哪些检查适合做成 hook
3. 哪些重复任务适合做成 skill
4. 哪些工具可以通过 MCP 或插件接入
5. 哪些任务适合拆给 subagent

要求：先给方案，不要直接创建文件。

规则能解释为什么要加。工具权限默认保守。每个子智能体有清楚边界。

5. 最后做项目 MVP：从需求到上线检查

看完教程不等于会用。真正合格的 Claude Code 教程，最后要让新手做出一个小项目，并知道怎么验收。

先选小项目：AI 文案生成器、资料摘要页、报价计算器、客服 FAQ Bot 或个人作品页。

让 Claude Code 先写需求、页面结构、数据结构和验收标准。

分两到三轮实现，不要一次让它做完所有功能。

每轮都看 diff、跑检查、用浏览器打开看页面。

最后整理 README、环境变量说明、常见错误和下一步优化。

我们做一个最小可用 AI 网页 App。

项目名称：
目标用户：
核心功能：
必须有的页面：
不做的功能：
验收标准：

请先输出 MVP 计划、文件改动范围和分阶段任务。不要马上写代码。

MVP 功能很小但完整。页面能打开。有 README、环境变量和验证记录。

生态桌面端

模型切换

CC Switch

适合用图形界面管理第三方模型和 Claude Code 模型切换。先确认来源可靠，再填 API Key。

模型路由

Claude Code Router

适合需要多模型路由、预算控制或团队统一配置的人。新手先理解 base_url、model、key 三件事。

工具扩展

MCP 工具连接

把浏览器、数据库、GitHub、飞书等能力接给 Agent。先用只读权限，确认日志和边界。

可选 Skills

先把 Agent 本体跑通，再按真实场景加能力。

Frontend Design / UI 审计

做网页页面、视觉系统、组件整理时使用。

在 Claude Code 插件/skills 管理里搜索前端设计相关 skill，先项目级安装。

Superpowers / 需求拆解

做完整项目 MVP 前，用来脑暴、拆计划、复盘和 review。

从可用插件列表安装到当前项目或个人目录，先看它会创建哪些文件。

项目专属 Skill

当你反复做同一类任务，例如资讯更新、教程改写、UI QA。

让 Claude Code 先写 skill 草案和使用边界，确认后再放进项目规则。

常见问题

先看症状，再对照解决，不要把模型问题、网络问题和本体安装问题混在一起。

npm.ps1 被禁止运行

这是 PowerShell 安全策略，不是 Node.js 坏了。优先把 npm 改成 npm.cmd。

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

看到 changed packages 后 npx 又报红

说明 Claude Code 已经装好了。不要再用 npx，直接验证 claude 命令。

claude --version

Unable to connect to Anthropic services

软件启动成功了，但默认服务连不上。国内用户先按下面 DeepSeek Anthropic Compatible 配置。

打开 Claude Desktop 开发者模式后还是不能填 DeepSeek Key

这是正常情况。Claude Desktop 和 Claude Code 是两个教程。桌面端开发者模式主要配置 MCP 工具和扩展；要让工程 Agent 接 DeepSeek，就用本页的 Anthropic Compatible 环境变量命令。

其他 Agent 安装

小白天枢 OpenAI Codex OpenClaw Hermes Agent