Claude Code 实战指南（一）：从零开始的完整安装配置教程

欢迎来到 Claude Code 实战指南系列！本系列将带你从零基础到熟练掌握这个强大的 AI 编程助手。

🎯 1. 为什么选择 Claude Code

Claude Code 不仅仅是一个命令行工具，它是你的 AI 编程伙伴：

✨ 核心优势

🚀 终端原生体验：无需切换界面，在熟悉的终端环境中工作
🧠 项目上下文理解：通过 CLAUDE.md 深度理解你的项目
🔌 MCP 生态系统：丰富的插件扩展能力
📋 智能任务规划：Plan Mode 让复杂任务井然有序
🤖 Sub Agents 协作：多个 AI 代理协同工作

🎯 适用场景

日常开发：代码生成、bug 修复、重构优化
项目分析：快速理解新项目结构和逻辑
文档编写：自动生成技术文档和注释
学习新技术：AI 导师式的技术指导

⚙️ 2. 环境要求

必备条件

Node.js 18+（推荐使用最新 LTS 版本）
稳定的网络连接

验证环境

1 2	node --version npm --version

🚀 3. 安装步骤

3.1 安装 Node.js

访问 Node.js 官网下载 LTS 版本
按照安装向导完成安装
重启终端验证安装

3.2 全局安装 Claude Code

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

💡 -g 参数确保可在任意目录使用

3.3 验证安装

1	claude --version

⚡ 4. 快速开始

基础启动

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

# 启动 Claude Code
claude

升级到最新版

1	npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com

🔄 建议定期升级获取最新功能

🔧 5. 环境变量配置

5.1 检查当前配置

# 查看环境变量
env | grep ANTHROPIC

# 检查配置文件
grep -r "ANTHROPIC" ~/.zshrc ~/.bash_profile ~/.bashrc ~/.zprofile 2>/dev/null

5.2 一键清理脚本

sed -i '' '/ANTHROPIC_/d' ~/.zshrc ~/.bash_profile ~/.bashrc ~/.zprofile 2>/dev/null && unset ANTHROPIC_AUTH_TOKEN ANTHROPIC_API_KEY ANTHROPIC_BASE_URL && source ~/.zshrc 2>/dev/null && source ~/.bash_profile 2>/dev/null && echo "✅ 清理完成" && (grep -r "ANTHROPIC" ~/.zshrc ~/.bash_profile ~/.bashrc ~/.zprofile 2>/dev/null && echo "❌ 仍有残留" || echo "🎉 清理成功")

5.3 一键配置脚本

{
  echo 'export ANTHROPIC_BASE_URL=https://api.aicodeditor.com'
  echo 'export ANTHROPIC_API_KEY=sk-xxx'
  echo 'export ANTHROPIC_AUTH_TOKEN=sk-xxx'
} | tee -a ~/.zshrc ~/.bash_profile && source ~/.zshrc

⚠️ 重要：记得替换 sk-xxx 为你的实际 API Key

🤖 6. 模型切换指南

方式一：交互式切换（推荐）

1 2	# 启动后输入 /model

从菜单中选择所需模型，立即生效。

方式二：启动参数切换

# 使用 Opus 4.1
claude --model claude-opus-4-1-20250805

# 使用 Sonnet 4
claude --model claude-sonnet-4-20241014

方式三：环境变量默认设置

1	export ANTHROPIC_MODEL="claude-sonnet-4-20241014"

💡 7. 核心功能详解

7.1 启动参数

1 2	claude --dangerously-skip-permissions # 跳过权限检查 claude --continue # 继续上次会话

7.2 核心交互指令

📝 记忆管理

1 2	/memory # 编辑记忆文件 # command # 追加内容到记忆

🧹 上下文管理

1
2
3

/compact   # 压缩上下文（95% 时自动触发）
/clean     # 清除上下文
/resume    # 查看历史记录

🔍 项目分析

1 2	/init # 扫描项目结构，生成 CLAUDE.md /status # 检查配置和模型状态

🔌 MCP 管理

1	/mcp # 查看 MCP 工作状态

7.3 关键路径说明

路径	用途
`~/.claude/settings.json`	用户全局设置
`.claude/settings.json`	项目专用设置
`.claude/commands/`	自定义斜杠命令
`.claude/agents/`	子代理配置

📋 8. CLAUDE.md 项目记忆文件

8.1 核心作用

CLAUDE.md 是项目的”大脑”，存储 AI 必须了解的关键信息。

8.2 推荐内容结构

## 项目背景
这是一个基于 Next.js 的电商前端项目，使用 TypeScript + Tailwind CSS

## 技术栈
- 前端：Next.js 14 + TypeScript
- 样式：Tailwind CSS
- 状态管理：Zustand
- API：Axios + SWR

## 工作流程
- 数据处理优先使用 pandas
- API 调用统一使用 axios，配置在 /lib/api.ts
- 组件开发遵循 Atomic Design 原则

## 代码规范
- 使用简体中文回答问题
- 优先使用 ESM (import/export)
- 组件名使用 PascalCase
- 文件名使用 kebab-case
- 所有 API 接口需要错误处理

8.3 分层存储策略

project-root/
├── CLAUDE.md              # 项目总体信息
├── frontend/
│   └── CLAUDE.md         # 前端专用规则
└── backend/
    └── CLAUDE.md         # 后端专用规则

📊 9. Plan Mode 使用指南

9.1 激活方式

按 Shift + Tab 切换到计划模式

9.2 使用场景

复杂项目建议采用”计划先行“模式：

🎯 分析阶段：让 AI 分析修改点，制定详细计划
👀 人工审查：Review 计划，确认或调整方案
⚡ 执行阶段：执行具体编码工作
🔄 避免返工：减少代码难以 review、方案错误难以回滚的问题

9.3 Plan Mode 优势

✅ 纠正保守倾向：AI 不敢删除代码时，人工可以判断
✅ 避免信息片面：提供更全面的决策视角
✅ 提高效率：规划后发现简单修改可由人工直接完成

🔌 10. MCP 服务器简介（基础篇）

10.1 什么是 MCP

MCP (Model Context Protocol) 是 Claude Code 的插件系统，让 AI 能够：

🔍 访问外部数据源
🛠️ 调用第三方工具
📊 处理特定格式文件
🌐 连接各种服务

10.2 快速添加 MCP

1 2	# 告诉 Claude 你想要什么功能即可帮我添加一个处理 Excel 文件的 MCP 工具

10.3 查看 MCP 状态

1	/mcp # 查看当前已安装的 MCP 服务器

📖 深入学习：MCP 的详细配置和推荐服务器将在本系列第二篇文章中详细介绍。

🤖 11. Sub Agents 子代理系统

11.1 概述

Claude Code 支持创建专用的 Sub Agents，每个 Agent 专注特定开发任务：

📋 需求分析
🏗️ 架构设计
💻 代码生成
🧪 质量保证

11.2 使用步骤

整理需求：明确开发内容和目标
开启 Plan 模式：结合 Agent 制定执行计划
确认执行：按计划逐步实施

11.3 实战示例

"Develop article comment system:
Phase 1 - Analysis (parallel):
- @requirements-analyst: Define detailed requirements
- @uiux-designer: Design comment interface

Phase 2 - Architecture:
- @solution-architect: Design API and data model

Phase 3 - Implementation:
- @code-generator: Implement feature
- @quality-assurance: Comprehensive testing"

11.4 参考资源

🔗 Agent 示例库
📖 官方 Sub Agents 文档

🔧 12. IDE 集成

12.1 支持的 IDE

VS Code：安装 Claude Code 插件
IntelliJ IDEA：安装 Claude Code 插件

12.2 优势

🔄 无缝切换：终端和 IDE 间自由切换
📝 代码同步：实时同步代码修改
🎯 上下文保持：保持项目上下文连续性

🎯 13. 实用技巧总结

13.1 效率提升

🚀 使用 --dangerously-skip-permissions 跳过权限检查
🔄 根据任务复杂度选择合适模型，平衡性能和成本
📁 使用 @ 符号快速引用项目文件
💻 结合 Bash 模式（!）执行系统命令

13.2 最佳实践

📋 项目初始化：先运行 /init 让 AI 了解项目结构
🧠 维护 CLAUDE.md：及时更新项目记忆文件
🎯 善用 Plan Mode：复杂任务先规划再执行
🔌 合理配置 MCP：根据项目需求选择合适的服务器

🎉 结语

通过本教程，你已经掌握了 Claude Code 的完整安装配置流程和核心功能使用方法。

开启你的 Claude Code AI 编程之旅吧！🚀

💡 小贴士：在使用过程中遇到任何问题，记得先运行 /status 检查配置状态，大多数问题都能快速定位解决。