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

详细介绍了AI编程助手Claude Code的安装与配置。内容涵盖其终端原生体验、项目上下文理解等优势，Node.js环境要求，通过npm安装步骤，环境变量配置，模型切换，以及CLAUDE.md项目记忆文件、Plan Mode、MCP、Sub Agents等核心功能。教程还提供了IDE集成和实用技巧，助你从零开始高效使用Claude Code。

晨启AI

422人浏览 · 2025-09-11 17:26:28

晨启AI · 2025-09-11 17:26:28 发布

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 版本）
稳定的网络连接

验证环境

node --version
npm --version

🚀 3. 安装步骤

3.1 安装 Node.js

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

3.2 全局安装 Claude Code

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

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

3.3 验证安装

claude --version

⚡ 4. 快速开始

基础启动

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

# 启动 Claude Code
claude

升级到最新版

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. 模型切换指南

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

# 启动后输入
/model

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

方式二：启动参数切换

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

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

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

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

💡 7. 核心功能详解

7.1 启动参数

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

7.2 核心交互指令

📝 记忆管理

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

🧹 上下文管理

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

🔍 项目分析

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

🔌 MCP 管理

/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

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

10.3 查看 MCP 状态

/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"