ClaudeCode快速入门（详细版）

1.1 ClaudeCode是什么？

核心定位

Claude Code（CC） 是由 Anthropic 开发的系统级 AI Agent，它不仅仅是一个代码编写工具，更是一个可以通过自然语言指令完成各种电脑任务的智能助手。

核心能力

Claude Code 拥有三大核心能力，使其区别于传统的开发工具：

能力	说明	实际应用
全功能访问	拥有系统级权限，可执行文件操作、运行命令、管理进程	自动化部署、批量处理文件、系统维护
超大上下文	支持 200K token 上下文窗口，可处理大型项目	分析整个代码库、理解复杂架构、跨文件重构
高度可扩展	支持 Skills、MCP、Hooks 等多种扩展方式	连接外部服务、自定义工作流、团队协作

核心价值

传统开发方式 vs Claude Code

传统开发工具：
- IDE：只能写代码
- ChatGPT：只能对话问答
- 脚本：需要手动编写和调试
- 需要切换多个工具完成复杂任务

Claude Code：
- 代码编写 ✓
- 对话问答 ✓
- 文件管理 ✓
- 网页自动化 ✓
- 数据分析 ✓
- 文档处理 ✓
- 通过自然语言统一完成所有任务

实际应用场景：

• 程序员：从需求分析到代码实现再到部署，一个会话完成
• UI 设计师：从设计规范到界面实现到测试验证，AI 全程辅助
• 测试人员：从测试用例生成到自动化测试到缺陷报告，一体化流程

---

1.2 安装与配置

前置准备

在安装 Claude Code 之前，需要准备以下工具：

工具	用途	必需	获取方式
Node.js	运行环境	✅ 必需	https://nodejs.org (推荐 v18+)
Git	版本控制	✅ 必需	https://git-scm.com
API Key	模型服务	✅ 必需	智谱GLM/Kimi/通义千问等

验证前置工具：

# 检查 Node.js 版本
node -v
# 输出示例：v20.11.0

# 检查 Git 版本
git --version
# 输出示例：git version 2.43.0

快速安装 Claude Code

方式一：全局安装（推荐）

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

验证安装：

claude --version
# 输出示例：claude 2.0.64

常见安装问题与解决方案：

问题	原因	解决方案
command not found	npm 全局路径未配置	重启终端或添加 npm 全局路径到环境变量
权限错误	需要管理员权限	使用 sudo（Mac/Linux）或管理员权限（Windows）
网络超时	npm 源慢	使用国内镜像：npm config set registry https://registry.npmmirror.com

模型配置

Claude Code 支持多种模型配置方式，选择适合你的模型：

推荐模型对比

模型	提供商	代码能力	价格	优势	适用场景
GLM-4.7	智谱AI	⭐⭐⭐⭐⭐	中等	中文理解强，有 Coding 套餐	中文项目为主
Kimi K2	月之暗面	⭐⭐⭐⭐⭐	较低	超长上下文，MoE 架构	大型项目重构
Qwen-Coder-Plus	阿里云	⭐⭐⭐⭐⭐	低	开源，性能优秀	Python/JS 项目
DeepSeek-Coder	深度求索	⭐⭐⭐⭐	极低	价格优势	预算有限的场景

配置示例（以智谱 GLM 为例）

智谱 AI 官方提供了三种配置方式，自动化助手（推荐） 是最简单的配置方式：

方式一：自动化助手 Coding Tool Helper（最推荐）

Coding Tool Helper 是智谱 AI 官方提供的编码工具助手，可以快速将 GLM 编码套餐加载到 Claude Code 中。

使用方法：

# 在命令行中执行
npx @z_ai/coding-helper

功能特点：

• ✅ 自动完成工具安装
• ✅ 自动配置 GLM 编码套餐
• ✅ 自动管理 MCP 服务器
• ✅ 交互式界面，操作简单

按照界面提示操作即可完成配置，无需手动修改配置文件。

详细说明请参考 Coding Tool Helper 文档。

---

方式二：自动化脚本（仅支持 macOS/Linux）

# 下载并运行自动配置脚本
curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh

---

方式三：手动配置环境变量

Windows：

# 打开 PowerShell 或 CMD
setx ANTHROPIC_BASE_URL "https://open.bigmodel.cn/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "你的API密钥"
setx ANTHROPIC_MODEL "GLM-4.7"
# 重启终端使配置生效

macOS/Linux：

# 临时配置（当前终端有效）
export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=你的API密钥
export ANTHROPIC_MODEL=GLM-4.7

# 永久配置（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=你的API密钥' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL=GLM-4.7' >> ~/.bashrc

# 重新加载配置
source ~/.bashrc

注意：

• 配置环境变量后需要重启终端或运行 source ~/.bashrc 使配置生效
• API 密钥需要从对应平台获取：智谱AI / Kimi / 通义千问

方式四：通过配置文件设置模型

智谱 AI 官方推荐通过修改 ~/.claude/settings.json 文件来配置 GLM 模型：

步骤 1：创建或编辑配置文件

# 创建配置目录（如果不存在）
mkdir -p ~/.claude

# 编辑配置文件
# macOS/Linux: 使用 vim/nano 等编辑器
# Windows: 使用记事本或 VS Code
vim ~/.claude/settings.json

步骤 2：添加以下配置内容

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

步骤 3：验证配置

# 关闭所有 Claude Code 窗口，重新打开一个新的命令行窗口
# 启动 Claude Code
claude

# 在 Claude Code 中输入以下命令确认模型状态
/status

配置说明：

配置项	说明	推荐值
ANTHROPIC_DEFAULT_HAIKU_MODEL	快速响应模型	glm-4.5-air
ANTHROPIC_DEFAULT_SONNET_MODEL	均衡性能模型	glm-4.7
ANTHROPIC_DEFAULT_OPUS_MODEL	最强性能模型	glm-4.7

常见配置问题排查：

问题	解决方案
配置不生效	关闭所有 Claude Code 窗口，重新打开新终端
JSON 格式错误	使用在线 JSON 校验工具检查格式
变量名错误	确认变量名拼写正确，不要多逗号或少逗号

启动 Claude Code

基本启动方式：

模式	命令	说明	使用场景
常规模式	claude	正常启动，需要确认权限	日常开发
危险模式	claude --dangerously-skip-permissions	跳过权限确认	自动化脚本、CI/CD
无头模式	claude -p "prompt"	非交互式运行	脚本集成、批量处理

启动验证：

# 创建测试目录
mkdir claude-demo
cd claude-demo

# 启动 Claude Code
claude

# 看到以下提示说明启动成功

成功启动的界面示例：

Claude Code CLI v2.0.64
Type /help for available commands
Model: GLM-4.7
Context: 0/200K tokens
user@claude-demo:~$

---

1.3 核心概念速览

Claude Code 有多个核心概念，这里快速介绍最重要的几个，后续章节会详细讲解：

Skills（技能包）

概念： Skills 是预封装的工作流，就像游戏中的"技能包"，把专业知识、工具使用方法、模板材料打包成一个完整的能力扩展包。

价值：

• 用完即走，不占用上下文
• 别人已经编写好的，可直接使用
• 官方 Skills 库 32k+ Stars，有大量现成技能

示例：

• frontend-design：前端设计技能
• pdf：PDF 处理技能
• doc-coauthoring：文档协同技能

MCP Servers（模型上下文协议服务器）

概念： MCP 是 AI 的扩展接口标准，通过添加 MCP 服务器可以连接外部工具、资源、服务。

价值：

• 连接 GitHub、数据库、浏览器等外部服务
• 统一的外部服务接入标准
• 避免手动复制粘贴

示例：

• chrome-devtools-mcp：浏览器自动化（26 个工具）
• github：GitHub API 集成
• postgres：PostgreSQL 数据库操作

CLAUDE.md（项目记忆文件）

概念： Claude Code 启动时会自动读取的项目记忆文件，记录项目结构、构建命令、代码规范、架构决策等信息。

价值：

• 项目知识库：记录项目架构、技术栈
• 快速启动：自动读取，无需重复解释
• 团队协作：共享项目规范
• 持续迭代：随项目演进自动更新

其他扩展

Hooks（钩子）

概念： 在特定事件触发时自动执行的脚本

典型用途：

• 自动格式化代码
• 拦截危险命令
• 发送通知

Plugins（插件）

概念： 打包在一起的扩展集合（5 个 Skills、10 个斜杠命令等）

与 Skills 的区别：

• Plugins 是完整功能套件
• Skills 是单一技能

子代理（Subagents）

概念： 并行处理任务的独立 AI 代理，每个有独立上下文

典型用途：

• 代码审查、测试编写、文档生成并行执行

---

本章重点回顾

核心要点

1. Claude Code 的定位：系统级 AI Agent，不只是代码编写工具
2. 三大核心能力：全功能访问、超大上下文、高度可扩展
3. 安装配置三步：安装 Node.js → 安装 Claude Code → 配置模型
4. 核心概念：Skills、MCP、CLAUDE.md 是三大核心功能

常见问题

Q：必须使用 Claude 模型吗？

A：不是，支持多种兼容 Anthropic API 的模型，包括国产模型（GLM、Kimi、通义千问等）

Q：Claude Code 只适合编程吗？

A：不是，可以通过自然语言完成文件管理、网页自动化、数据分析、文档处理等各种任务

Q：学习难度大吗？

A：不需要编程知识，会用自然语言交流就能使用，非技术人员也能快速上手

Q：如何切换使用不同的模型？

A：可通过修改 ~/.claude/settings.json 配置文件来切换模型。例如切换到 GLM 模型：

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

修改后重启 Claude Code，使用 /status 命令确认模型状态。

Q：手动修改配置后不生效怎么办？

A：按以下步骤排查：

1. 关闭所有 Claude Code 窗口，重新打开新终端启动
2. 检查 JSON 格式是否正确（无多余逗号、变量名拼写正确）
3. 如问题仍存在，删除配置文件后重新配置

Q：如何升级 Claude Code 到最新版本？

A：使用以下命令：

# 检查当前版本
claude --version

# 升级到最新版本
claude update

推荐使用 Claude Code 2.0.14 或更高版本（智谱 AI 已验证兼容）。

Q：如何配置视觉和搜索 MCP 服务器？

A：参考智谱 AI 官方文档配置视觉 MCP 服务器、搜索 MCP 服务器和网页读取 MCP 服务器，配置完成后即可在 Claude Code 中使用。

下一步

• 程序员：重点学习第二章 Skills 和第三章程序员最佳实践
• UI 设计师：重点学习第二章 MCP 和第三章 UI 设计师最佳实践
• 测试人员：重点学习第二章 CLAUDE.md 和第三章测试人员最佳实践

---

实践练习（可选）

练习 1：验证安装（1 分钟）

# 1. 验证 Claude Code 版本
claude --version

# 2. 验证模型配置
echo $ANTHROPIC_MODEL # macOS/Linux
echo %ANTHROPIC_MODEL% # Windows

# 3. 启动 Claude Code
claude
# 输入 /help 查看帮助

练习 2：首次对话（1 分钟）

# 在 Claude Code 中
你好，请简单介绍一下你自己

练习 3：查看帮助命令（1 分钟）

# 在 Claude Code 中
/help