Claude Code 保姆级安装使用教程 | Anthropic AI编程终端助手

📌 01 · 工具概览

什么是 Claude Code？

Claude Code 是 Anthropic 推出的 AI 编程助手，不是简单的代码补全工具，而是能独立行动的 Agent——读取项目文件、编辑代码、运行测试、操作Git，通过自然语言指令完成复杂开发任务。

🧠

自主Agent

独立理解整个代码库，执行多步骤任务，跨会话保持上下文

📝

多文件编辑

跨多个文件协调修改，自动更新导入、依赖和引用

🔀

Git深度集成

对话式Git操作，自动提交、创建分支、解决合并冲突

🔗

MCP协议

连接Google Drive、Jira、Slack、数据库等外部工具和数据源

🖥️

多平台支持

CLI终端、桌面应用、VS Code、JetBrains、Web端全覆盖

⚡

并行执行

桌面版支持多会话并行，同时处理多个任务

五种使用方式

💻

终端 CLI

最强大，全功能

🖥️

桌面应用

可视化，并行会话

🧩

VS Code

IDE内嵌，可视Diff

🐱

JetBrains

IntelliJ等全家桶

👥 02 · 适合人群

Claude Code 适合谁？

Claude Code 定位专业开发工具，特别适合需要深度代码理解和复杂推理的开发场景。

👨‍💻 资深开发者 🏗️ 全栈工程师 🔧 DevOps工程师 📊 数据科学家 🏢 企业团队 🔬 研究人员 📱 开源贡献者

定价方案

Pro

$20

/月

适合大多数开发者
小代码库短冲刺
含 Sonnet 4.5 + Opus 4.5

Max 5x

$100

/月

日常高强度使用
大型代码库
5倍用量额度

Max 20x

$200

/月

重度用户
多并行会话
20倍用量额度

⚠️ 注意

Claude Code 需要付费订阅，免费版 Claude 无法使用。API用户按Token计费（$15/$75 每百万Token）。运行多个并行会话会成倍消耗Token，Pro用户需注意用量。

🖥️ 03 · 设备选型

设备与环境要求

Claude Code 对硬件要求极低，因为AI计算在云端完成，本地只是一个轻量级客户端。

操作系统

macOS / Linux / Windows(WSL)

Windows推荐使用WSL2获得最佳体验

内存

4GB+ 即可

本地客户端极轻量，AI在云端运行

网络

稳定互联网连接

必须联网，建议低延迟网络

账户

Claude Pro/Max 订阅

或Anthropic Console API账户

使用场景	推荐设备	配置建议
个人开发者	MacBook Air/Pro M2+	8GB+ 内存，终端+iCloud同步
专业开发	MacBook Pro M3 Pro	18GB+ 内存，大屏幕更佳
Windows用户	任意PC + WSL2	16GB内存，安装WSL2和Git
服务器/CI	云服务器	2GB+即可，用于自动化流水线

📥 04 · 安装教程

保姆级安装流程

Claude Code 支持多种安装方式，推荐使用原生安装（自动更新）。

方法一：原生安装（推荐）

原生安装无需 Node.js，自动后台更新，Anthropic 签名二进制文件：

                    Bash
                    # macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
                

💡 原生安装的优势

无需Node.js环境 → 自动后台更新保持最新版 → Anthropic官方签名，安全可靠 → 安装后二进制位于 ~/.local/bin/claude

方法二：Homebrew 安装（macOS）

                    Bash
                    # 稳定版（推荐）
brew install --cask claude-code

# 最新版（跟进最快，可能不稳定）
brew install --cask claude-code@latest

# 手动更新
brew upgrade claude-code
                

方法三：WinGet 安装（Windows）

                    PowerShell
                    # 安装
winget install Anthropic.ClaudeCode

# 更新
winget upgrade Anthropic.ClaudeCode
                

首次运行与登录

                    Bash
                    # 进入项目目录
cd your-project

# 启动 Claude Code
claude

# 首次启动会提示登录
# 选择登录方式：
1. Claude 账户登录（Pro/Max订阅用户）
2. Anthropic Console API Key
3. 第三方提供商（如Amazon Bedrock等）

# 登录成功后即可开始使用！
                

⚡

Claude Code 终端界面 - 欢迎界面与首次登录

IDE 扩展安装

                    Guide
                    # VS Code 扩展
1. 打开 VS Code
2. 搜索 "Claude Code"
3. 点击 Install

# JetBrains 插件
1. 打开 IntelliJ / PyCharm / WebStorm 等
2. Settings → Plugins → 搜索 "Claude Code"
3. 点击 Install

# 桌面应用
1. 从 claude.ai 下载桌面版
2. 支持可视Diff、并行会话等高级功能
                

🎯 05 · 使用指南

核心功能使用指南

掌握 Claude Code 的核心命令和工作流，从入门到精通。

基础命令速查

                    CLI
                    # 启动交互式会话
claude

# 单次命令执行
claude -p "解释这个项目的架构"

# 继续上一次对话
claude --continue

# 查看帮助
claude --help
claude --version

# 在会话中的常用命令
/help      # 查看帮助
/init      # 初始化项目配置
/compact   # 压缩上下文
/cost      # 查看Token用量
/logout    # 退出登录
                

CLAUDE.md 项目配置文件

在项目根目录创建 CLAUDE.md 文件，让 Claude Code 了解项目背景和规范：

                    Markdown
                    # CLAUDE.md 示例

## 项目概述
这是一个React + TypeScript前端项目，使用Vite构建。

## 代码规范
- 使用函数组件和Hooks
- 变量命名使用驼峰式
- 所有组件必须有TypeScript接口定义
- 测试文件放在 __tests__ 目录下

## 常用命令
- npm run dev - 启动开发服务器
- npm run build - 构建生产版本
- npm run test - 运行测试
- npm run lint - 代码检查

## 架构说明
- src/components/ - UI组件
- src/hooks/ - 自定义Hooks
- src/services/ - API调用层
- src/utils/ - 工具函数
                

💡 最佳实践

将 CLAUDE.md 提交到 Git 仓库，团队成员共享同一份项目规范。Claude Code 会在每次会话开始时自动读取此文件，确保生成代码符合项目标准。

权限模式

Claude Code 提供三种权限模式，控制AI的自主程度：

模式	说明	适合场景
确认模式（默认）	每次文件修改和命令执行都需确认	初次使用、重要项目
自动编辑	自动应用文件修改，命令仍需确认	日常开发
全自动	文件修改和命令都自动执行	快速原型、低风险任务

MCP 扩展集成

                    MCP
                    # 通过MCP连接外部工具

# Google Drive - 读取设计文档
claude mcp add google-drive

# Jira/Linear - 更新任务状态
claude mcp add jira

# Slack - 拉取团队讨论上下文
claude mcp add slack

# 数据库 - 查询生产数据调试
claude mcp add database

# 查看已连接的MCP服务
claude mcp list
                

🛠️ 06 · 实战案例

实战案例详解

案例1：功能开发 - 添加JWT认证

                    Workflow
                    # 步骤1：描述需求
👤 实现用户JWT认证，包含注册、登录、Token刷新

# Claude Code 自动完成：
✓ 创建 auth 相关文件结构
✓ 实现 JWT 生成和验证中间件
✓ 创建注册/登录 API 路由
✓ 添加 Token 刷新逻辑
✓ 更新相关的类型定义

# 步骤2：添加密码重置流程
👤 添加密码重置功能，发送邮件链接

# 步骤3：编写测试
👤 为所有认证端点编写单元测试
                

案例2：Bug修复 - 调试Safari登录问题

                    Workflow
                    👤 登录功能在Safari上失败，帮我排查原因

# Claude Code 会：
1. 检查认证相关代码
2. 识别Safari特定的兼容性问题
3. 定位问题根因（如Cookie SameSite策略）
4. 提供修复方案并应用

# 验证修复
👤 检查修改了哪些文件
👤 提交代码，写一个描述性的commit message
                

案例3：代码重构 - Class组件转Hooks

                    Workflow
                    👤 将所有Class组件转换为函数组件和Hooks

# Claude Code 会：
✓ 扫描项目中所有Class组件
✓ 逐一转换，保留原有逻辑
✓ 提取共享逻辑到自定义Hooks
✓ 更新所有import语句
✓ 确保类型定义正确

# 后续操作
👤 运行测试确认没有破坏性变更
👤 提交所有修改
                

🚀 07 · 进阶技巧

进阶技巧与最佳实践

1. 充分利用上下文窗口

将完整的错误日志、完整测试套件喂给 Claude Code，200K上下文窗口可以一次处理大量信息，不需要分块。

2. 迭代开发策略

先让AI生成骨架代码 → 人工审查 → 逐步完善细节。不要期望一步到位，分步迭代效果更好。

3. 安全审查不可少

AI生成的代码必须审查，尤其是认证逻辑、数据处理等关键部分。Claude Code是助手，不是替代品。

4. 合理使用MCP工具

只连接必要的工具，每多一个MCP连接都会增加API消耗。按需配置。

5. 使用 /compact 节省Token

长对话后上下文会变大，使用 /compact 命令压缩上下文，保持核心信息同时减少Token消耗。

❓ 08 · 常见问题

常见问题

Q：Claude Code 免费吗？

不免费。需要 Claude Pro（$20/月）或更高级别订阅。也支持 API 按量付费。

Q：Windows 原生支持吗？

支持！Claude Code 现在可以在 Windows 原生环境运行，也支持 WSL2（推荐WSL2获得更完整体验）。推荐安装 Git for Windows。

Q：如何使用第三方AI提供商？

CLI 和 VS Code 版本支持配置第三方提供商，如 Amazon Bedrock、Google Vertex AI 等。详见官方文档的第三方集成章节。

Q：如何查看Token使用量？

在会话中输入 /cost 即可查看当前会话的Token消耗。

Q：桌面应用和CLI有什么区别？

桌面应用提供图形界面、可视Diff、多会话并行等额外功能。CLI更轻量、更灵活，适合终端用户和CI/CD场景。两者可以配合使用。

Q：安装后找不到 claude 命令？

确保 ~/.local/bin 在 PATH 中：export PATH="$HOME/.local/bin:$PATH"，添加到 ~/.bashrc 或 ~/.zshrc 永久生效。

📑 教程目录