大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



---

Claude Code 是什么？

如果你还在用 ChatGPT 或 Cursor 帮你写代码，那你可能错过了一个更强大的工具。

Claude Code 不是聊天工具，而是一个能真正理解你项目代码、直接修改文件、运行终端命令的 AI 编程 Agent。它是 Anthropic 官方推出的 CLI（命令行界面）工具，让你在终端里和 Claude 一起干活。

和其他工具有什么区别？

核心价值

Claude Code = Claude 的超强编程能力 + 完整的文件系统访问 + 终端命令执行

想象一下：

• ✅ 直接读取你整个项目的代码库（不是零散地复制粘贴）
• ✅ 自动修改文件（不是让你手动复制粘贴代码）
• ✅ 运行测试、启动服务、安装依赖（全自动化）
• ✅ 支持 Skills（可复用的技能包）
• ✅ 支持 Subagents（专业化的子代理）
• ✅ 支持 MCP（第三方工具集成）

一句话总结：Claude Code 是让你的 AI 同事真正能”干活”的工具，而不只是能”聊天”的工具。

---

本章你将学到

• 在 macOS/Linux/Windows 上安装 Claude Code
• 多种安装方式（curl/Homebrew/WinGet）
• 验证安装是否成功
• 了解系统要求

系统要求

• 操作系统：macOS 12+、Linux（主流发行版）、Windows ¹⁰⁄₁₁
• 网络：需要访问 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 ¹⁰⁄₁₁ 自带的包管理器：

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%.claudebin

---

本章你将学到

• 四种登录认证方式
• 认证优先级
• 根据需求选择合适的方式

方式一：Claude Pro/Max 订阅（最简单）

适用场景：个人开发者，希望最省心

步骤：

1. 访问 claude.ai 订阅 Pro（\(20/月）或 Max（\)40/月）
2. 在终端运行：

claude 

3. 终端会显示一个登录链接，按 Ctrl+Click 打开浏览器
4. 在浏览器中登录你的 Claude 账号
5. 授权后回到终端，自动登录成功

[截图：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’)

4. 验证：

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）

建议：优先使用环境变量，灵活且安全。

---

本章你将学到

• 3 步完成 DeepSeek V4 接入 Claude Code
• 模型选择与推荐配置

为什么选 DeepSeek V4？

DeepSeek V4 完全兼容 Anthropic API 格式，直接替换 Claude 后端，无需修改任何使用方式。Tool Use、Thinking 模式、JSON Output 全部支持。

定价参考（DeepSeek 官方，2026年4月）：

日常开发用 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

常用命令速查表

模型切换与 Effort Level

切换模型：

/model opus # 强推理（复杂任务） /model sonnet # 日常编码 /model opusplan # Opus 规划，Sonnet 执行 

Effort Level（努力程度）：

/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_*） ← 最高优先级

1. 项目本地（.claude/settings.local.json） ← 不提交 Git
2. 项目共享（.claude/settings.json） ← 提交 Git
3. 全局配置（~/.claude/settings.json） ← 所有项目通用

   CLAUDE.md——项目的使用说明书

   在项目根目录创建 CLAUDE.md，告诉 Claude Code 如何理解你的项目。核心是写清楚三件事：

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

   # 项目名称

   💡 API Key 等敏感信息放 settings.local.json，模型偏好等放 settings.json。

项目概述

用 Next.js + TypeScript 构建的电商网站。

技术栈

• 前端：Next.js 14, React 18, TypeScript 5
• 样式：Tailwind CSS
• 数据库：PostgreSQL + Prisma

代码规范

• 使用函数组件，PascalCase 命名
• 工具函数放在 lib/ 目录

测试与部署

• 单元测试：Vitest / E2E：Playwright
• 部署到 Vercel，环境变量在 .env.local

  ---

  💡 写得越清晰，Claude Code 的输出质量越高。不需要面面俱到，关键是把 你团队的约定告诉它。

本章你将学到

• 什么是 Skill
• 如何创建和使用自定义 Skill
• 实用 Skill 推荐

5.1 什么是 Skill？

Skill = 给 Claude Code 的可复用技能包

一个 Skill 就是一个 SKILL.md 文件，定义了这个技能做什么、什么时候用、需要什么参数。

Skill vs CLAUDE.md：

内置 Skills（开箱即用）：

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

发现更多 Skills：

1. GitHub 搜索 claude code skills
2. Claude Code 内置 /plugin 命令浏览 Marketplace
3. 官方文档：code.claude.com/docs/en/skills

---

本章你将学到

• 什么是 Subagent
• Subagent vs Skill 的区别
• 如何创建和使用 Subagent

什么是 Subagent？

Subagent = 独立上下文窗口的专业 AI

Subagent 是一个独立的 Agent，拥有自己的上下文窗口，专门处理特定领域的任务。通过 /agent xxx 调用。

Subagent vs Skill

内置 Subagents

创建自定义 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 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 安装。

---

本章你将学到

• Plugin vs Standalone 配置
• 创建 Plugin 的步骤
• Plugin 结构
• 发布到 Marketplace

Plugin vs Standalone

创建 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/ 

2. 提交到 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 

3. 发布到 Marketplace：

• 访问 Claude Code Marketplace
• 点击”Submit Plugin”
• 填写插件信息
• 等待审核

---

适用人群

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 的 ¹⁄₁₀
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 辅助编程的道路上越走越远！ 🚀

---

参考资料：

• Claude Code 官方文档
• DeepSeek API 文档
• MCP 协议规范

---

一键安装命令（复制即可使用）：

# 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 编程的乐趣！ ✨