乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > Claude Code 详细安装使用教程

Claude Code 详细安装使用教程

当前时间： 2026-08-15 16:19:35 分类：办公文件 评论(0)
Claude Code 详细安装使用教程

Claude Code 详细安装使用教程

作者：墨玄 | 发布日期：2026-05-30

一、引言：为什么 Claude Code 这么火

如果你关注 AI 编程工具，一定注意到 2025 年下半年开始，Claude Code 这个词频繁出现在技术圈。

为什么？因为 Claude Code 代表了一种全新的编程方式。

传统的 AI 编程工具（如 GitHub Copilot）更像是"智能补全"——你写一半，它补一半。而 Claude Code 是一个真正的AI 代理（Agent）——你告诉它要做什么，它会自主完成整个任务：理解代码库、规划方案、编写代码、运行测试、修复问题，甚至提交 Git。

举个例子：

# 你只需要这一句话
claude "add user authentication with JWT, write tests, and commit"

# Claude Code 会自动:
# 1. 分析现有代码库结构
# 2. 设计认证方案
# 3. 在多个文件中编写代码
# 4. 安装依赖、运行测试、修复问题
# 5. 提交 Git commit

简单来说：ChatGPT 是一个"智能问答助手"，Claude Code 是一个"能干活的 AI 程序员"。

二、Claude Code 是什么

2.1 产品定位

Claude Code 是 Anthropic 公司推出的AI 编程代理工具，核心特点：

  • 终端优先：以 CLI（命令行工具）为主要交互方式
  • 多平台支持：终端、VS Code 扩展、JetBrains 插件、桌面应用
  • 真正的代理能力：不仅能生成代码，还能自主执行任务

2.2 与 ChatGPT 的区别

很多人会问：Claude Code 和 ChatGPT 有什么区别？

ChatGPT：

  • 网页对话，只能提供建议
  • 需要你粘贴代码
  • 无法执行命令、修改文件

Claude Code：

  • 终端/IDE 深度集成
  • 可以直接执行命令、修改文件
  • 整个代码库 + 对话上下文
  • 自动 commit、创建 PR

2.3 与 Claude.ai 的关系

Claude Code 需要 Claude Pro/Max/Teams/Enterprise 订阅，或者 Claude Console API 账号。免费的 Claude.ai 账号无法使用 Claude Code。

三、安装教程（含国内网络配置）

3.1 系统要求

  • macOS：macOS 13.0+（Ventura 及以上）
  • Windows：Windows 10 1809+ 或 Windows Server 2019+
  • Linux：Ubuntu 20.04+、Debian 10+
  • 硬件：内存 4 GB+（推荐 8 GB+）

3.2 安装方式一：原生安装（推荐）

这是官方推荐的安装方式，支持自动更新。

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

安装完成后验证：

claude --version

3.3 安装方式二：npm 安装

如果你已经安装了 Node.js：

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

3.4 国内网络环境配置

由于网络原因，国内用户需要配置代理。

export HTTPS_PROXY=https://your-proxy.com:8080

重要提示：

  • Claude Code 不支持 SOCKS 代理
  • 需要允许的域名：api.anthropic.com、claude.ai

3.5 首次运行体验

安装完成后，在你项目目录下运行：

cd your-project
claude

按回车后，浏览器会自动打开 Anthropic 登录页面，登录成功后即可开始使用。

四、首次使用指南

4.1 账号要求

Claude Code 需要以下任一账号类型：

  • Claude Pro：$20/月 个人订阅
  • Claude Max：高级个人订阅
  • Claude for Teams：$25/用户/月 团队订阅
  • Claude Console：API 控制台账号

注意：免费的 Claude.ai 计划不包含 Claude Code 访问权限。

4.2 登录流程

安装完成后，首次启动 claude，会出现浏览器登录页面。按回车，浏览器会自动打开登录页面。

五、核心功能详解

5.1 子代理（Subagents）

通俗解释：就像项目经理把不同任务分给不同专长的团队成员一样，Claude Code 也会把任务分给不同的 AI 子代理。每个子代理有自己的"工作空间"，不会互相干扰。

内置子代理：

  • Explore：快速只读代理，专门搜索和分析代码库
  • Plan：专门制定实施计划的代理
  • General-purpose：处理复杂多步骤任务

5.2 MCP（Model Context Protocol）

通俗解释：MCP 就像是给 AI 装上了"外接插座"，让它能连上你的 GitHub、数据库、项目管理工具等外部服务。

完整 MCP 配置教程（以连接 GitHub 为例）：

# 第一步: 添加 GitHub MCP 服务器
claude mcp add --transport http github https://mcp.github.com/mcp

# 第二步: 查看配置文件
cat ~/.claude/mcp_config.json

# 第三步: 验证 MCP 服务器
claude mcp list

# 第四步: 使用 GitHub MCP
claude "查看我最近 5 个 PR 的状态"

5.3 上下文管理

Claude Code 拥有强大的上下文管理能力。上下文窗口最大 200K tokens，自动压缩旧对话部分。

CLAUDE.md 文件层级：

  • 用户指令：~/.claude/CLAUDE.md（个人偏好）
  • 项目指令：./CLAUDE.md（项目级指令）
  • 本地指令：./CLAUDE.local.md（个人项目偏好）

5.4 沙箱模式（Sandboxing）

通俗解释：当 Claude Code 执行命令时，沙箱模式就像给它戴上了"安全手套"，限制它只能访问特定文件和目录，防止误操作。

平台支持：

  • macOS：使用内置 Seatbelt 框架
  • Linux/WSL2：需要安装 bubblewrap 和 socat

5.5 Skills（技能）

通俗解释：Skills 就像是 Claude 的"技能包"，你创建一个 SKILL.md 文件，Claude 就学会了这个技能。

什么时候创建 Skill？

  • 发现自己重复粘贴相同指令时
  • 有多步骤程序需要反复执行时

Claude Code 核心功能特性一览

六、实际使用场景演示

场景一：自动化日常任务

claude "为 auth 模块编写测试,运行测试并修复所有失败"

Claude Code 会分析代码结构，自动编写测试用例，运行测试并修复所有失败的测试。

场景二：功能开发

claude "为 Express 应用添加 JWT 用户认证功能"

Agent 会自动分析代码库、安装依赖、创建认证相关文件并实现完整的认证逻辑。

场景三：MCP 集成工作流

claude "实现 JIRA-1234 描述的功能并创建 PR"

配合已配置的 GitHub MCP 和 JIRA MCP，Claude Code 可以跨平台自动完成任务。

七、与 Cursor 对比

Claude Code 特点：

  • 终端 CLI + VS Code 扩展
  • 内置 Explore、Plan、General-purpose 子代理
  • 原生沙箱模式支持（macOS/Linux）
  • 需要 Pro/Teams/Enterprise 订阅（$20+/月）
  • 国内访问需要代理

我的建议：

  • 终端重度用户：Claude Code 更适合
  • 图形界面偏好者：Cursor 是更好的选择
  • 两者可以结合使用：在需要深入理解代码库时用 Claude Code，在需要精细编辑时用 Cursor

八、定价方案

  • Claude Pro：$20/月，适合个人开发者
  • Claude for Teams：$25/用户/月，适合小团队（3-5人）
  • Claude Console：基于 API 使用计费，适合有大量并发需求的团队

九、卸载方法

# macOS/Linux
rm -rf ~/.claude
npm uninstall -g @anthropic-ai/claude-code

十、已知局限性

  • 国内访问需要配置代理
  • 需要 Pro/Teams/Enterprise 订阅
  • 学习曲线较陡（需要理解子代理、MCP 等概念）
  • Windows 原生不支持沙箱模式（需在 WSL2 中运行）
  • 对某些语言/框架的支持可能不完善

总结

Claude Code 代表了 AI 编程工具的新方向：从"智能补全"到"自主代理"。它不仅能理解你的代码库，还能自主执行复杂任务，真正成为你的 AI 结对程序员。

核心优势：

  • 🚀 真正的代理能力：从任务描述到完成，全程自主
  • 🧠 深度上下文理解：记住你的偏好，理解你的项目
  • 🔧 强大的扩展性：MCP 生态、Skills 系统
  • 🛡️ 企业级安全：沙箱模式、SSO、合规支持

如果你正在寻找一个能真正"干活"的 AI 编程助手，Claude Code 值得一试。

本文由墨玄创作，如有问题欢迎在评论区讨论。

相关链接：Claude Code 官方文档 | Claude 定价