🚀 Claude Code 保姆级教程：让 AI 直接接管你的终端

什么是 Claude Code？

Claude Code 是 Anthropic 官方推出的命令行工具（CLI）。与 Cursor 等 IDE 插件不同，它直接运行在你的终端（Terminal）里。

核心能力：它能直接读取你的本地文件、运行终端命令、修改代码、跑测试，甚至在你报错时自动分析 Log 并修复。
杀手锏：它不仅能“写”代码，还能“改”代码，是真正的 Agentic Workflow（代理工作流）。

Claude Code 的核心优势

强大的上下文理解能力：支持 200K token 的上下文窗口，能够同时理解和处理大型代码库的复杂结构
多语言与多框架支持：对 Python、JavaScript、TypeScript、Java、C++、Go、Rust 等主流编程语言提供原生支持，并能很好地与 React、Vue、Django、Spring Boot 等流行框架集成
智能代码理解与生成：基于项目上下文进行智能推理，提供全面的代码解决方案
自主编辑与重构能力：支持完全自主的代码编辑，能够独立完成复杂的代码重构任务

安装准备

系统要求

在开始安装之前，请确保您的系统满足以下要求：

操作系统：macOS 10.15+、Ubuntu 20.04+/Debian 10+，或通过 WSL 运行的 Windows
硬件要求：至少 4GB 内存
软件依赖：Node.js 18+

安装教程

安装 Node.js

Mac 用户：

# 使用 Homebrew 安装
brew install node

# 或从官网下载安装包
# 访问 https://nodejs.org/ 下载 LTS 版本

Windows 用户：
访问 Node.js 官网下载安装程序，选择 Windows Installer (.msi) 的 LTS 版本。

Linux 用户 (Ubuntu/Debian)：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

安装完成后，在所有系统中验证安装：

node --version
npm --version

安装 Claude Code

在所有操作系统上，安装 Claude Code 的命令都是一样的：

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

Mac/Linux 用户注意事项：
如果遇到权限问题，可能需要使用 sudo：

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

Windows 用户注意事项：
如果遇到 PowerShell 执行策略错误，可以运行以下命令解决：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

或者直接使用 CMD 代替 PowerShell。

验证安装是否成功：

claude --version

配置 GLM-4.6

由于 Claude 官方服务在国内访问受限，我们可以配置 Claude Code 使用智谱 AI 的 GLM-4.6 模型作为替代方案，这是一个性价比极高的选择。

获取 GLM-4.6 API Key

访问智谱 AI 开放平台
注册账号并完成认证
进入控制台，点击「API Keys」
创建新的 API Key 并妥善保存

配置环境变量

Mac 用户：

打开终端，编辑 shell 配置文件：

nano ~/.zshrc

添加以下环境变量（将 sk-xxxxxxxxxxxxxxxxxxxxxx 替换为你的实际 API Key）：

export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_MODEL="glm-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="glm-4.6"

使配置生效：

source ~/.zshrc

Windows 用户：

在搜索框中输入"环境变量"，选择"编辑系统环境变量"
在"用户变量"区域点击"新建"，依次添加以下变量：

变量名：ANTHROPIC_API_KEY
变量值：sk-xxxxxxxxxxxxxxxxxxxxxx

变量名：ANTHROPIC_AUTH_TOKEN
变量值：sk-xxxxxxxxxxxxxxxxxxxxxx

变量名：ANTHROPIC_BASE_URL
变量值：https://open.bigmodel.cn/api/anthropic

变量名：ANTHROPIC_MODEL
变量值：glm-4-6

变量名：ANTHROPIC_SMALL_FAST_MODEL
变量值：glm-4-6

Linux 用户：

步骤与 Mac 类似，但配置文件可能是 ~/.bashrc 或 ~/.profile，具体取决于你使用的 shell。

替代配置方法：使用配置文件

除了环境变量，你也可以通过 Claude Code 的配置文件进行设置：

mkdir -p ~/.claude
nano ~/.claude/settings.json

添加以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_MODEL": "glm-4-6",
    "ANTHROPIC_SMALL_FAST_MODEL": "glm-4-6",
    "API_TIMEOUT_MS": "3000000"
  }
}

使用 Claude Code

启动与初始化

cd /Users/yunnuo/Desktop/project/claude-demo

启动 Claude Code：

claude

首次启动时，会提示你是否使用配置的 API Key，选择"Yes"
接着会请求访问文件夹的权限，选择"Allow"或"Trust"

基本使用

成功启动后，你会看到 Claude Code 的命令行界面，可以直接输入自然语言指令：

> 帮我创建一个 Express 服务器

Claude Code 会自动分析你的项目结构，理解需求，并生成相应的代码。

常用命令和技巧

1. 文件操作

> 读取 config.json 文件的内容
> 创建新的 React 组件文件
> 修改 app.js 中的错误处理逻辑

2. 代码理解

> 解释这个函数的用途
> 这个代码库的结构是怎样的
> 帮我找出这个 bug 的原因

3. Git 操作

Claude Code 可以智能地处理 Git 相关任务：

> 帮我提交当前的更改
> 解决这个合并冲突
> 创建 Pull Request

4. 测试与调试

> 为这个模块编写单元测试
> 运行测试并修复失败的地方
> 检查代码风格问题并修复

高级命令

Claude Code 提供了一系列斜杠命令用于高级操作：

交互式命令

/clear - 清除对话历史
/compact - 压缩上下文以节省 token
/config - 查看和修改配置
/status - 显示当前状态和模型信息

任务执行命令

claude "创建一个 React 组件" - 直接执行任务而不进入交互模式
claude edit src/app.js "添加错误处理逻辑" - 编辑特定文件
claude generate "为 utils.js 生成单元测试" - 生成测试文件

高级功能与扩展

MCP (模型上下文协议) 服务器

GLM Coding Plan 专属的 MCP 服务器可以进一步增强 Claude Code 的能力：

视觉 MCP 服务器：让 Claude Code 能够理解和处理图像内容
搜索 MCP 服务器：集成网络搜索能力
网页读取 MCP 服务器：直接读取和分析网页内容

自定义钩子和代理

Claude Code 支持通过钩子和代理扩展功能：

Hook（钩子）：在关键节点的自定义行为
Agent/Subagent（代理/子代理）：通过插件系统安装，提供特定领域的辅助功能

最佳实践

1. 项目配置

在每个项目根目录创建 .claude 目录和 settings.json 文件，可以设置项目特定的配置。

2. 上下文管理

使用 /clear 和 /compact 命令管理上下文长度
在复杂任务中，将大任务拆分成多个小任务
使用 claude.md 文件提供项目背景和注意事项

3. 权限控制

只授予 Claude Code 访问必要目录的权限
在敏感项目中谨慎使用文件写入功能

4. 提示词技巧

提供清晰、具体的需求描述
分步骤处理复杂任务
提供足够的上下文信息

故障排除

常见问题及解决方案

API 连接失败
- 检查 API Key 是否正确
- 验证环境变量设置
- 确认网络连接正常
权限错误
- Mac/Linux：确保对目标目录有读写权限
- Windows：以管理员身份运行命令行
版本兼容性问题
- 更新到最新版本：claude update
- 检查 Node.js 版本是否符合要求
配置不生效
- 关闭所有 Claude Code 窗口重新打开
- 删除 ~/.claude/settings.json 文件重新配置
- 检查 JSON 格式是否正确

总结

Claude Code 是一款强大的 AI 编程助手，通过本文的保姆级教程，你应该已经掌握了从安装配置到高级使用的全部技巧。无论是 Mac、Windows 还是 Linux 用户，都能通过配置 GLM-4.6 模型享受到高效的 AI 编程体验。

记住，熟练使用 Claude Code 需要实践和探索，不要害怕尝试新功能和命令，随着使用经验的积累，你会发现它能够极大地提升你的编程效率。

目录CONTENT

🚀 Claude Code 保姆级教程：让 AI 直接接管你的终端

🚀 Claude Code 保姆级教程：让 AI 直接接管你的终端

什么是 Claude Code？

Claude Code 的核心优势

安装准备

系统要求

安装教程

安装 Node.js

安装 Claude Code

配置 GLM-4.6

获取 GLM-4.6 API Key

配置环境变量

替代配置方法：使用配置文件

使用 Claude Code

启动与初始化

基本使用

常用命令和技巧

1. 文件操作

2. 代码理解

3. Git 操作

4. 测试与调试

高级命令

交互式命令

任务执行命令

高级功能与扩展

MCP (模型上下文协议) 服务器

自定义钩子和代理

最佳实践

1. 项目配置

2. 上下文管理

3. 权限控制

4. 提示词技巧

故障排除

常见问题及解决方案

总结

评论区