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，会出现浏览器登录页面。按回车，浏览器会自动打开登录页面。

五、核心功能详解

# 第一步: 添加 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 的状态"

Claude Code 核心功能特性一览

六、实际使用场景演示

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

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

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

七、与 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 定价