我把 Claude Code 摸透了:安装、国产模型配置、Skills、Subagents、MCP 一篇全搞定
副标题:2026 年最强 AI 编程 Agent 全攻略,从零到精通只需这一篇
前言
Claude Code 是什么?
如果你还在用 ChatGPT 或 Cursor 帮你写代码,那你可能错过了一个更强大的工具。
Claude Code 不是聊天工具,而是一个能真正理解你项目代码、直接修改文件、运行终端命令的 AI 编程 Agent。它是 Anthropic 官方推出的 CLI(命令行界面)工具,让你在终端里和 Claude 一起干活。
和其他工具有什么区别?
| 工具 | 定位 | 核心能力 | 局限性 |
|---|---|---|---|
| Claude Code | 终端 Agent | 读代码、改文件、跑命令、Skills/Subagents | 需要命令行基础 |
| Cursor | AI 编辑器 | 代码补全、内联编辑 | 无法直接操作文件系统 |
| GitHub Copilot | 代码补全 | IDE 集成、自动补全 | 缺少上下文理解 |
| ChatGPT | 聊天机器人 | 对话问答 | 无法直接操作你的电脑 |
核心价值
Claude Code = Claude 的超强编程能力 + 完整的文件系统访问 + 终端命令执行
想象一下:
- ✅ 直接读取你整个项目的代码库(不是零散地复制粘贴)
- ✅ 自动修改文件(不是让你手动复制粘贴代码)
- ✅ 运行测试、启动服务、安装依赖(全自动化)
- ✅ 支持 Skills(可复用的技能包)
- ✅ 支持 Subagents(专业化的子代理)
- ✅ 支持 MCP(第三方工具集成)
一句话总结:Claude Code 是让你的 AI 同事真正能"干活"的工具,而不只是能"聊天"的工具。
第一章:安装(保姆级)
本章你将学到
- 在 macOS/Linux/Windows 上安装 Claude Code
- 多种安装方式(curl/Homebrew/WinGet)
- 验证安装是否成功
- 了解系统要求
系统要求
- 操作系统:macOS 12+、Linux(主流发行版)、Windows 10/11
- 网络:需要访问 Claude API(或使用国内替代方案)
- 终端:macOS 终端、Linux Shell、Windows PowerShell/CMD/WSL
macOS / Linux 安装(推荐)
打开终端,复制粘贴这一行命令,回车:
curl -fsSL https://claude.ai/install.sh | bash
安装过程:
- 脚本会自动检测你的系统架构(Intel/Apple Silicon)
- 下载最新版本的 Claude Code
- 安装到
/usr/local/bin目录 - 添加到 PATH 环境变量
验证安装:
claude --version
看到类似输出就成功了:
Claude Code version 1.23.0
[截图:终端显示 claude --version 输出]
Windows 安装(三种方式)
方式一:PowerShell(推荐)
右键开始菜单,选择"Windows PowerShell",输入:
irm https://claude.ai/install.ps1 | iex
方式二:CMD 命令提示符
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
方式三:WSL(Windows Subsystem for Linux)
如果你在 WSL 里开发,直接用 Linux 安装命令:
curl -fsSL https://claude.ai/install.sh | bash
[截图:Windows PowerShell 安装过程]
Homebrew 安装(macOS)
如果你用 Homebrew 管理软件,可以:
brew install --cask claude-code
WinGet 安装(Windows)
Windows 10/11 自带的包管理器:
winget install Anthropic.ClaudeCode
安装问题排查
问题 1:提示"command not found: claude"
# 检查 PATH
echo $PATH
# 手动添加到 PATH(macOS/Linux)
export PATH="$HOME/.local/bin:$PATH"
# 写入 shell 配置文件永久生效
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # macOS
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # Linux
问题 2:Windows 安装后无法在 CMD 中使用
- 重启终端
- 或手动添加到 PATH:
%USERPROFILE%\.claude\bin
第二章:登录认证
本章你将学到
- 四种登录认证方式
- 认证优先级
- 根据需求选择合适的方式
方式一:Claude Pro/Max 订阅(最简单)
适用场景:个人开发者,希望最省心
步骤:
- 访问 claude.ai 订阅 Pro($20/月)或 Max($40/月)
- 在终端运行:
claude
- 终端会显示一个登录链接,按 Ctrl+Click 打开浏览器
- 在浏览器中登录你的 Claude 账号
- 授权后回到终端,自动登录成功
[截图:Claude Code 浏览器登录界面]
优点:
- ✅ 无需 API Key
- ✅ 自动使用最新模型
- ✅ 无需配置环境变量
缺点:
- ❌ 需要订阅(国内信用卡支付困难)
- ❌ 遵守 Claude 使用政策
方式二:API Key(推荐国内用户)
适用场景:有 API Key,想灵活控制成本
步骤:
- 访问 console.anthropic.com
- 创建 API Key
- 设置环境变量:
macOS/Linux:
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
# 写入配置文件永久生效
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.zshrc
source ~/.zshrc
Windows PowerShell:
$env:ANTHROPIC_API_KEY="sk-ant-xxxxx"
# 永久设置
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-xxxxx', 'User')
- 验证:
claude --version
方式三:Anthropic Console(团队)
适用场景:企业团队,需要统一管理
在项目目录创建 .claude/settings.json:
{
"providers": [
{
"name": "anthropic",
"base_url": "https://api.anthropic.com",
"api_key": "sk-ant-team-xxxxx"
}
]
}
方式四:云服务商
支持的平台:
- AWS Bedrock
- Google Vertex AI
- Foundry(Microsoft Azure)
示例(AWS Bedrock):
export AWS_PROFILE="your-profile"
export ANTHROPIC_BASE_URL="https://bedrock-runtime.us-east-1.amazonaws.com"
认证优先级
Claude Code 按以下顺序查找认证信息:
- 环境变量(
ANTHROPIC_API_KEY) - 项目配置(
.claude/settings.json) - 全局配置(
~/.claude/settings.json) - 浏览器登录(Claude Pro/Max)
建议:优先使用环境变量,灵活且安全。
第三章:国内用户配置——DeepSeek V4 接入
本章你将学到
- 3 步完成 DeepSeek V4 接入 Claude Code
- 模型选择与推荐配置
为什么选 DeepSeek V4?
DeepSeek V4 完全兼容 Anthropic API 格式,直接替换 Claude 后端,无需修改任何使用方式。Tool Use、Thinking 模式、JSON Output 全部支持。
定价参考(DeepSeek 官方,2026年4月):
| 模型 | 输入 | 输出 |
|---|---|---|
| deepseek-v4-flash | ¥1/百万 tokens | ¥2/百万 tokens |
| deepseek-v4-pro | ¥12/百万 tokens | ¥24/百万 tokens |
日常开发用 flash,复杂任务用 pro,具体费用请查看 DeepSeek 官方定价页。
第一步:获取 API Key
- 访问 platform.deepseek.com
- 注册/登录账号
- 进入「API Keys」页面
- 点击「Create API Key」
第二步:配置环境变量
macOS/Linux(加到 ~/.bashrc 或 ~/.zshrc):
export ANTHROPIC_API_KEY="sk-deepseek-xxxxx"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
Windows PowerShell:
$env:ANTHROPIC_API_KEY="sk-deepseek-xxxxx"
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
第三步:验证
claude
输入测试消息,确认 DeepSeek V4 响应正常即可。
推荐:项目级别配置
在项目目录创建 .claude/settings.json,可以按项目指定模型:
{
"providers": [
{
"name": "deepseek",
"base_url": "https://api.deepseek.com/anthropic",
"api_key": "sk-deepseek-xxxxx",
"models": [
{
"id": "deepseek-v4-flash",
"alias": "sonnet"
},
{
"id": "deepseek-v4-pro",
"alias": "opus"
}
]
}
],
"model": "sonnet"
}
deepseek-v4-flash别名为sonnet——日常开发默认用这个,快且便宜deepseek-v4-pro别名为opus——遇到复杂架构或 Debug 时手动切换
第四章:核心操作指南
本章你将学到
- Claude Code 基本操作和常用命令
- 模型切换与 Effort Level
- 非交互式模式
- CLAUDE.md 配置要点
启动 Claude Code
# 进入你的项目目录
cd ~/projects/my-app
# 启动 Claude Code
claude
常用命令速查表
| 命令 | 功能 | 示例 |
|---|---|---|
/help |
显示帮助 | /help |
/model |
切换模型 | /model opus |
/config |
查看配置 | /config |
/clear |
清空对话 | /clear |
/effort |
设置努力程度 | /effort high |
/skill |
使用技能 | /skill code-review |
/agent |
使用子代理 | /agent debugger |
/exit |
退出 | /exit |
模型切换与 Effort Level
切换模型:
/model opus # 强推理(复杂任务)
/model sonnet # 日常编码
/model opusplan # Opus 规划,Sonnet 执行
Effort Level(努力程度):
| Level | 适用场景 |
|---|---|
low |
简单问题、代码查询 |
medium |
日常开发 |
high |
复杂任务、架构设计(默认) |
xhigh |
非常复杂的问题 |
max |
挑战性任务 |
/effort high
非交互式模式
一次性执行任务,适合脚本和自动化:
# 直接执行
claude -p "帮我写一个 Python Hello World"
# 管道输入
cat main.py | claude -p "分析这段代码的问题"
git diff | claude -p "帮我 review 这些改动"
tail -100 error.log | claude -p "找出这些错误的原因"
配置文件体系
Claude Code 支持多层配置,优先级从高到低:
1. 环境变量(ANTHROPIC_*) ← 最高优先级
2. 项目本地(.claude/settings.local.json) ← 不提交 Git
3. 项目共享(.claude/settings.json) ← 提交 Git
4. 全局配置(~/.claude/settings.json) ← 所有项目通用
💡 API Key 等敏感信息放
settings.local.json,模型偏好等放settings.json。
CLAUDE.md——项目的使用说明书
在项目根目录创建 CLAUDE.md,告诉 Claude Code 如何理解你的项目。核心是写清楚三件事:
- 项目是什么:技术栈、项目结构
- 代码规范:命名约定、目录约定
- 常用命令:构建、测试、部署
# 项目名称
## 项目概述
用 Next.js + TypeScript 构建的电商网站。
## 技术栈
- 前端:Next.js 14, React 18, TypeScript 5
- 样式:Tailwind CSS
- 数据库:PostgreSQL + Prisma
## 代码规范
- 使用函数组件,PascalCase 命名
- 工具函数放在 `lib/` 目录
## 测试与部署
- 单元测试:Vitest / E2E:Playwright
- 部署到 Vercel,环境变量在 `.env.local`
💡 写得越清晰,Claude Code 的输出质量越高。不需要面面俱到,关键是把你团队的约定告诉它。
第五章:Skills 系统(重点章节)
本章你将学到
- 什么是 Skill
- 如何创建和使用自定义 Skill
- 实用 Skill 推荐
5.1 什么是 Skill?
Skill = 给 Claude Code 的可复用技能包
一个 Skill 就是一个 SKILL.md 文件,定义了这个技能做什么、什么时候用、需要什么参数。
Skill vs CLAUDE.md:
| 特性 | CLAUDE.md | Skill |
|---|---|---|
| 作用域 | 项目级 | 全局/项目级 |
| 加载方式 | 自动加载 | 手动调用 /skill xxx |
| 用途 | 项目说明 | 可复用技能 |
内置 Skills(开箱即用):
| Skill | 功能 |
|---|---|
/simplify |
简化复杂代码 |
/batch |
大规模代码变更,自动拆分为并行任务 |
/debug |
系统化调试流程 |
/loop |
循环执行直到满足条件 |
5.2 创建自定义 Skill
目录结构
~/.claude/skills/
├── explain-code/
│ └── SKILL.md
├── code-review/
│ └── SKILL.md
└── ui-design/
└── SKILL.md
SKILL.md 基本格式
---
name: explain-code # 调用名:/skill explain-code
description: 用通俗语言解释代码
when_to_use: 遇到看不懂的代码时使用
argument-hint: 文件路径或代码片段
model: sonnet # 可选:指定模型
context: inline # inline=共享上下文 / fork=独立上下文
---
# 正文:用 Markdown 写清楚这个技能的工作流程和输出格式
Frontmatter 常用字段:
name:Skill 名称description:一句话说明arguments:参数定义(name、required、description)allowed-tools:限制可用的工具(如 read、write、exec)model:强制使用特定模型
创建好后,直接调用:
/skill explain-code src/utils/api.ts
5.3 推荐 Skill / Plugin
| 项目 | 说明 | 安装 |
|---|---|---|
| ng-workflow | 7 Agent + 8 Skills 的全栈工作流 Plugin | GitHub |
| Karpathy CLAUDE.md | 极简单文件增强,改善 Claude Code 行为 | 放到项目根目录即可 |
| Awesome Claude Code | 精选资源合集(Skills/Hooks/Plugins/MCP) | GitHub 搜索 “awesome claude code” |
发现更多 Skills:
- GitHub 搜索
claude code skills - Claude Code 内置
/plugin命令浏览 Marketplace - 官方文档:code.claude.com/docs/en/skills
第六章:Subagents 子代理
本章你将学到
- 什么是 Subagent
- Subagent vs Skill 的区别
- 如何创建和使用 Subagent
什么是 Subagent?
Subagent = 独立上下文窗口的专业 AI
Subagent 是一个独立的 Agent,拥有自己的上下文窗口,专门处理特定领域的任务。通过 /agent xxx 调用。
Subagent vs Skill
| 特性 | Skill | Subagent |
|---|---|---|
| 上下文 | 共享主对话上下文 | 独立上下文窗口 |
| 适用场景 | 通用技能、快速调用 | 复杂任务、深度分析 |
| 配置方式 | SKILL.md | AGENT.md |
| 调用方式 | /skill xxx |
/agent xxx |
内置 Subagents
| Subagent | 用途 |
|---|---|
| Explore | 探索新代码库、理解项目结构 |
| Plan | 制定开发计划、任务分解 |
| General-purpose | 处理各种通用任务 |
创建自定义 Subagent
在 ~/.claude/agents/ 下创建目录,放入 AGENT.md:
~/.claude/agents/
└── code-improver/
└── AGENT.md
AGENT.md 格式:
---
name: code-improver
description: 代码质量改进专家
---
你是一个代码质量改进专家,擅长发现代码中的问题并提供具体的改进方案。
## 工作流程
1. 阅读代码
2. 发现问题
3. 提供改进方案
4. 实施改进
Frontmatter 字段和 Skill 类似(name、description、model 等)。创建好后通过 /agent code-improver 调用。
第七章:MCP 工具集成
本章你将学到
- MCP 是什么
- 如何添加 MCP Server
- 常用 MCP Server 推荐
MCP 是什么?
MCP = Model Context Protocol(模型上下文协议)
MCP 是一个开放协议,让 Claude Code 可以连接外部工具和服务,像插件一样扩展能力。
添加 MCP Server
命令行添加(推荐):
claude mcp add <server-name>
配置文件添加:
编辑 ~/.claude/settings.json:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
常用 MCP Server
开发工具类:
- GitHub:管理 Issue、PR、Repo
- Figma:读取设计稿
- Sentry:错误监控和日志分析
数据库类:
- PostgreSQL:查询数据库
- SQLite:轻量级本地数据库
通讯类:
- Slack:发送消息
文件系统:
- Filesystem:文件操作
⚠️ GitHub、Slack 需要访问国外服务,建议配置代理。数据库和文件系统类无网络限制。
所有 Server 均通过 claude mcp add <name> 安装。
第八章:Plugin 系统
本章你将学到
- Plugin vs Standalone 配置
- 创建 Plugin 的步骤
- Plugin 结构
- 发布到 Marketplace
Plugin vs Standalone
| 特性 | Plugin | Standalone |
|---|---|---|
| 安装方式 | claude plugin install |
复制文件 |
| 作用域 | 全局 | 项目级 |
| 更新方式 | 自动更新 | 手动更新 |
| 分享方式 | Marketplace | Git 仓库 |
创建 Plugin
目录结构
my-plugin/
├── .claude-plugin/
│ └── plugin.json # Plugin 配置
├── skills/ # Skills
│ ├── my-skill/
│ │ └── SKILL.md
│ └── another-skill/
│ └── SKILL.md
├── agents/ # Subagents
│ └── my-agent/
│ └── AGENT.md
└── README.md # 说明文档
plugin.json 格式
{
"name": "my-plugin",
"version": "1.0.0",
"description": "我的 Claude Code 插件",
"author": "Your Name",
"license": "MIT",
"claude": {
"minVersion": "1.20.0"
},
"skills": [
"skills/my-skill",
"skills/another-skill"
],
"agents": [
"agents/my-agent"
]
}
本地测试 Plugin
# 在项目目录中创建符号链接
cd ~/.claude/plugins
ln -s /path/to/my-plugin my-plugin
# 重启 Claude Code
claude
发布到 Marketplace
- 准备发布:
# 确保插件完整
cd my-plugin
ls -la .claude-plugin/skills/agents/
- 提交到 GitHub:
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/yourusername/my-plugin.git
git push -u origin main
- 发布到 Marketplace:
- 访问 Claude Code Marketplace
- 点击"Submit Plugin"
- 填写插件信息
- 等待审核
写在最后
适用人群
Claude Code 特别适合:
- ✅ 全栈开发者:前后端都能开发
- ✅ 独立开发者:一个人完成整个项目
- ✅ 学生/初学者:学习编程和最佳实践
- ✅ 效率追求者:希望提升开发效率
- ✅ 技术博主:需要快速创建示例代码
不太适合:
- ❌ 不熟悉命令行的用户
- ❌ 只需要简单代码补全的用户
- ❌ 习惯 GUI IDE 的用户(可以用 Cursor)
学习路径建议
阶段 1:入门(1-2 天)
- 安装 Claude Code
- 配置 DeepSeek V4(节省成本)
- 学习基本命令
- 创建第一个项目
阶段 2:进阶(1 周)
- 掌握 CLAUDE.md 编写
- 创建自己的 Skills
- 配置 MCP Server
- 学习非交互式模式
阶段 3:精通(2-4 周)
- 创建自定义 Subagents
- 开发自己的 Plugin
- 集成到团队工作流
- 探索高级功能
常见问题 FAQ
Q1:Claude Code 和 Cursor 哪个更好?
A:取决于你的需求:
- Claude Code:更适合全栈开发、后端开发、DevOps
- Cursor:更适合前端开发、快速补全
最佳方案:两者都使用,Claude Code 处理复杂任务,Cursor 用于日常编码。
Q2:DeepSeek V4 能完全替代 Claude 吗?
A:大部分场景可以:
- ✅ 日常开发:DeepSeek V4 Flash 完全够用
- ✅ 复杂任务:DeepSeek V4 Pro 接近 Claude Sonnet
- ⚠️ 极限挑战:Claude Opus 仍然最强
建议:日常用 DeepSeek,遇到特别难的问题切换到 Claude Opus。
Q3:如何降低 API 成本?
A:几个技巧:
- 使用 DeepSeek V4 Flash:成本只有 Claude 的 1/10
- 合理设置 Effort Level:简单任务用 low/medium
- 使用缓存:DeepSeek V4 支持缓存,大幅降低成本
- 非交互式模式:减少对话轮数
Q4:Claude Code 会泄露我的代码吗?
A:隐私说明:
- API 模式:代码会发送到 API 服务器(DeepSeek/Anthropic)
- 本地模型:如果支持本地模型,代码不会离开你的电脑
- 企业版:Claude Code 企业版提供零数据留存选项
建议:敏感项目使用本地模型或企业版。
Q5:如何在团队中使用 Claude Code?
A:团队协作建议:
- 统一配置:在项目根目录添加
.claude/settings.json - 共享 Skills:创建项目级别的 Skills
- CLAUDE.md:编写详细的项目说明
- 代码审查:使用 code-review Skill
- 规范 Git:使用 gitflow Skill 统一 commit message
结语
Claude Code 不是一个简单的 AI 聊天工具,而是一个能真正改变你工作方式的 AI 编程 Agent。
从现在开始:
- 安装 Claude Code
- 配置 DeepSeek V4
- 创建第一个 Skill
- 让 AI 帮你写代码
记住:AI 是你的助手,不是替代品。最好的方式是学会如何与 AI 协作,让 AI 帮你完成重复性工作,你专注于创造性任务。
祝你在 AI 辅助编程的道路上越走越远! 🚀
参考资料:
一键安装命令(复制即可使用):
# macOS/Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
快速配置 DeepSeek(复制即可使用):
# macOS/Linux
export ANTHROPIC_API_KEY="sk-deepseek-xxxxx"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
# Windows PowerShell
$env:ANTHROPIC_API_KEY="sk-deepseek-xxxxx"
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
开始使用:
claude
享受 AI 编程的乐趣! ✨
更多推荐
所有评论(0)