Claude Code 学习笔记

简介

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。它可以直接在终端中使用，帮助开发者完成代码编写、调试、重构等任务。

安装

系统要求

• Node.js 18.0 或更高版本
• 支持的操作系统：macOS、Linux、Windows（通过 WSL）

安装 Node.js

macOS

# 使用 Homebrew 安装（推荐）
brew install node

# 或使用 nvm（Node Version Manager）管理多个版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

Linux (Ubuntu/Debian)

# 使用 nvm 安装（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

# 或使用 apt 直接安装
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Windows

• 下载 Node.js 官方安装包
• 或使用 WSL 在 Linux 子系统中安装

验证安装

node --version
npm --version

安装步骤

# 使用 npm 安装
npm install -g @anthropic-ai/claude-code

# 使用 pip 安装
pip install claude-code

# 验证安装
claude --version

首次配置

# 登录 Claude 账户
claude login

基础使用

启动 Claude Code

# 在当前目录启动
claude

# 打开特定文件
claude app.py

# 打开多个文件
claude app.py utils.py

常用命令

命令	说明
claude	启动 Claude Code
claude --help	显示帮助信息
claude --version	显示版本号
claude login	登录账户
claude logout	登出账户

核心功能

1. 代码编写

# 直接让 Claude 写代码
> 请帮我创建一个 Flask 应用，包含用户认证

# 让 Claude 重构代码
> 重构这个函数，提高可读性

# 让 Claude 添加注释
> 为这个文件添加详细的中文注释

2. 代码调试

# 解释错误
> 为什么这个代码会报错？

# 修复 bug
> 帮我修复这个 bug

# 性能优化
> 优化这段代码的性能

3. 项目理解

# 分析项目结构
> 这个项目的架构是什么？

# 解释代码功能
> 解释这个函数是做什么的？

# 查找特定功能
> 找出所有处理用户输入的地方

斜杠命令 (Slash Commands)

Claude Code 提供了便捷的斜杠命令：

命令	功能
/help	显示帮助信息
/clear	清空对话历史
/save <name>	保存当前对话
/load <name>	加载保存的对话
/run <command>	运行 shell 命令
/test	运行测试
/lint	运行代码检查
/format	格式化代码

高级功能

Skills (技能系统)

Skills 是可扩展的能力模块，可以为 Claude Code 添加特定领域的专业知识。

# 查看已安装的 skills
claude skills list

# 安装 skill
npx skills add <owner/repo@skill>

# 查找 skills
npx skills find <query>

常用 Skills

• review-pr - 代码审查辅助
• commit - 智能提交消息生成
• pdf - PDF 文件处理
• explain-code - 代码可视化解释

CLAUDE.md 配置

在项目根目录创建 CLAUDE.md 文件，可以为 Claude 提供项目特定的指导：

# CLAUDE.md

## 项目概述
这是一个 Flask Web 应用...

## 代码风格
- 使用 4 空格缩进
- 遵循 PEP 8 规范

## 特殊说明
- 所有数据库操作都通过 ORM
- 不要直接修改数据库模式

工作树 (Worktree)

创建隔离的 git 工作环境：

# 创建新工作树
/worktree

# 在工作树中工作，不影响主分支

最佳实践

1. 提供清晰的上下文

# ❌ 不好
> 修复这个 bug

# ✅ 好
> 登录接口返回 500 错误，错误信息是 "Database connection failed"，
> 请帮我检查 auth.py 中的数据库连接代码

2. 分步骤处理复杂任务

# 先让 Claude 分析
> 分析这个文件的结构和主要功能

# 再让 Claude 修改
> 根据分析结果，重构用户认证模块

3. 验证 Claude 的输出

# 让 Claude 运行测试
> 运行测试验证修改是否正确

# 或者手动验证
> 给出测试步骤，我来运行验证

4. 使用合适的权限模式

Claude Code 支持不同的权限模式，平衡安全性和效率：

• Full access - 完全访问权限（适合个人项目）
• Ask first - 敏感操作需确认（推荐默认）
• Read-only - 只读模式

常见问题

Q: 如何在多个项目间切换？

A: 直接在不同目录下运行 claude 即可，每个项目有独立的上下文。

Q: Claude 能访问我的代码吗？

A: Claude Code 会将你的代码发送到 Anthropic 的 API 进行处理，但不会存储你的代码。

Q: 如何提高 Claude 的理解能力？

A:

1. 提供 CLAUDE.md 文件说明项目结构
2. 使用清晰的问题描述
3. 提供相关的代码上下文

Q: 支持 Git 操作吗？

A: 支持，Claude 可以执行 git 命令，如提交、分支管理等。

参考资源

• Claude Code 官方文档
• Claude Code GitHub
• Skills 生态
• Skills 生态2