副标题: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

安装过程:

  1. 脚本会自动检测你的系统架构(Intel/Apple Silicon)
  2. 下载最新版本的 Claude Code
  3. 安装到 /usr/local/bin 目录
  4. 添加到 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 订阅(最简单)

适用场景:个人开发者,希望最省心

步骤:

  1. 访问 claude.ai 订阅 Pro($20/月)或 Max($40/月)
  2. 在终端运行:
claude
  1. 终端会显示一个登录链接,按 Ctrl+Click 打开浏览器
  2. 在浏览器中登录你的 Claude 账号
  3. 授权后回到终端,自动登录成功

[截图:Claude Code 浏览器登录界面]

优点

  • ✅ 无需 API Key
  • ✅ 自动使用最新模型
  • ✅ 无需配置环境变量

缺点

  • ❌ 需要订阅(国内信用卡支付困难)
  • ❌ 遵守 Claude 使用政策

方式二:API Key(推荐国内用户)

适用场景:有 API Key,想灵活控制成本

步骤:

  1. 访问 console.anthropic.com
  2. 创建 API Key
  3. 设置环境变量:

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')
  1. 验证:
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 按以下顺序查找认证信息:

  1. 环境变量ANTHROPIC_API_KEY
  2. 项目配置.claude/settings.json
  3. 全局配置~/.claude/settings.json
  4. 浏览器登录(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

  1. 访问 platform.deepseek.com
  2. 注册/登录账号
  3. 进入「API Keys」页面
  4. 点击「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 如何理解你的项目。核心是写清楚三件事:

  1. 项目是什么:技术栈、项目结构
  2. 代码规范:命名约定、目录约定
  3. 常用命令:构建、测试、部署
# 项目名称

## 项目概述
用 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:

  1. GitHub 搜索 claude code skills
  2. Claude Code 内置 /plugin 命令浏览 Marketplace
  3. 官方文档: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
  1. 准备发布
# 确保插件完整
cd my-plugin
ls -la .claude-plugin/skills/agents/
  1. 提交到 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
  1. 发布到 Marketplace

写在最后

适用人群

Claude Code 特别适合

  • 全栈开发者:前后端都能开发
  • 独立开发者:一个人完成整个项目
  • 学生/初学者:学习编程和最佳实践
  • 效率追求者:希望提升开发效率
  • 技术博主:需要快速创建示例代码

不太适合

  • ❌ 不熟悉命令行的用户
  • ❌ 只需要简单代码补全的用户
  • ❌ 习惯 GUI IDE 的用户(可以用 Cursor)

学习路径建议

阶段 1:入门(1-2 天)

  1. 安装 Claude Code
  2. 配置 DeepSeek V4(节省成本)
  3. 学习基本命令
  4. 创建第一个项目

阶段 2:进阶(1 周)

  1. 掌握 CLAUDE.md 编写
  2. 创建自己的 Skills
  3. 配置 MCP Server
  4. 学习非交互式模式

阶段 3:精通(2-4 周)

  1. 创建自定义 Subagents
  2. 开发自己的 Plugin
  3. 集成到团队工作流
  4. 探索高级功能

常见问题 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:几个技巧:

  1. 使用 DeepSeek V4 Flash:成本只有 Claude 的 1/10
  2. 合理设置 Effort Level:简单任务用 low/medium
  3. 使用缓存:DeepSeek V4 支持缓存,大幅降低成本
  4. 非交互式模式:减少对话轮数
Q4:Claude Code 会泄露我的代码吗?

A:隐私说明:

  • API 模式:代码会发送到 API 服务器(DeepSeek/Anthropic)
  • 本地模型:如果支持本地模型,代码不会离开你的电脑
  • 企业版:Claude Code 企业版提供零数据留存选项

建议:敏感项目使用本地模型或企业版。

Q5:如何在团队中使用 Claude Code?

A:团队协作建议:

  1. 统一配置:在项目根目录添加 .claude/settings.json
  2. 共享 Skills:创建项目级别的 Skills
  3. CLAUDE.md:编写详细的项目说明
  4. 代码审查:使用 code-review Skill
  5. 规范 Git:使用 gitflow Skill 统一 commit message

结语

Claude Code 不是一个简单的 AI 聊天工具,而是一个能真正改变你工作方式的 AI 编程 Agent。

从现在开始

  1. 安装 Claude Code
  2. 配置 DeepSeek V4
  3. 创建第一个 Skill
  4. 让 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 编程的乐趣!

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐