Claude Code 教程 -01-快速上手

Lison<dreamlison@163.com>,v1.0.0,2026.06.21

Claude Code -01-快速上手

安装与配置

环境要求

• Node.js 18.0+
• npm 或 yarn 包管理器
• Git (可选，用于代码管理)

安装Claude Code

# 全局安装npminstall-g@anthropic-ai/claude-code@latest# 验证安装claude--version

配置API Key

# 方式1：环境变量exportANTHROPIC_API_KEY=your-api-key-here# 方式2：配置文件# 创建 ~/.config/claude/settings.json (Claude Code 2.1.81+ 新路径)# Windows: %APPDATA%\claude\settings.json# macOS/Linux: ~/.config/claude/settings.json{"env":{"ANTHROPIC_API_KEY":"your-api-key-here"}}

启动与基本操作

启动方式

# 方式1：在项目目录启动cd/path/to/your/project claude# 方式2：指定项目路径启动claude /path/to/your/project# 方式3：指定模型启动claude--modelclaude-sonnet-4-20250514

首次启动配置

首次启动时会询问： 1. 是否同意使用条款 → 输入 yes 2. API Key 设置（如未设置环境变量） 3. 项目初始化确认

基本界面

┌─────────────────────────────────────────────────┐ │ Claude Code v2.1.81 │ │ Project: /path/to/project │ │ Model: claude-sonnet-5 │ ├─────────────────────────────────────────────────┤ │ > 你的输入在这里 │ │ │ │ Claude: │ │ 这里是 AI 的回复内容 │ │ │ ├─────────────────────────────────────────────────┤ │ 命令: /help /status /clear /compact /exit │ └─────────────────────────────────────────────────┘

Claude Code 的多种使用形态

Claude Code 2.1.81+ 支持与 VSCode 深度集成，提供更便捷的编辑体验。

JetBrains IDEs

详情参考文档：https://code.claude.com/docs/en/jetbrains

Claude Code 插件支持大多数 JetBrains IDEs，包括：

• IntelliJ IDEA
• PyCharm
• Android Studio
• WebStorm
• PhpStorm
• GoLand

在 IDEA 中安装 Claude Code 非常简单，直接进入Settings → Plugins，搜索Claude Code并安装即可

VSCode扩展

详情参考文档：https://code.claude.com/docs/en/vs-code

# 方式1：通过 VSCode 扩展市场 # 在 VSCode 中按 Ctrl+Shift+X (Cmd+Shift+X on macOS) # 搜索 "Claude Code" # 点击安装 Anthropic 官方扩展 方式2：命令行安装 打开命令面板 Ctrl+Shift+P (Cmd+Shift+P) > code --install-extension anthropic.claude-code

启动Claude Code 面板

# 方式1：命令面板 Ctrl+Shift+P (Cmd+Shift+P) → 输入 "Claude Code: Open" # 方式2：快捷键 Ctrl+Shift+C (Cmd+Shift+C) - 打开 Claude Code 面板 # 方式3：侧边栏 点击左侧活动栏的 Claude Code 图标

VSCode 集成特性

VSCode 配置示例

// .vscode/settings.json{"claude-code.enabled":true,"claude-code.autoStart":false,"claude-code.defaultModel":"claude-sonnet-5","claude-code.editor":"vscode","claude-code.confirmDestructiveOperations":true}

基础命令

内置命令

文件操作命令

# 读取文件>读取 src/main.py 的内容# 查看目录>列出 src/ 目录下的所有文件# 文件搜索>搜索项目中所有使用 User 类的地方

代码操作命令

# 解释代码>解释 src/utils.py 中的 process_data 函数# 生成代码>在 src/models/ 下创建一个 User 类，包含 id, name, email 字段# 修改代码>将 src/main.py 中的 print 语句改为 logging

终端命令

# Claude Code 可以直接执行终端命令 > 运行 npm install > 执行 pytest > 查看 git status

斜杠命令详解（Claude Code 2.1.81 完整版）

Claude Code 的斜杠命令是效率神器，以下命令按使用频率和用途分类整理。

基础常用命令 - 日常开发高频使用

示例：

# 查看费用（使用 Opus 时特别重要）>/cost# 输出示例：# 当前会话 Token: 15,234 / 200,000# 预估费用: $0.023# 模型: claude-sonnet-5

模型与上下文管理-让AI代码不跑偏

示例：

# 切换模型>/model opus 已切换到 claude-opus-4-20250514# 压缩上下文>/compact 保留后端核心逻辑 对话已压缩。要点总结： - 项目：FastAPI Web 应用 - 当前任务：添加用户认证 - 下一步：JWT 集成# 回退错误>/rewind 已回退到上一步。请重新描述需求。

项目与代码核心命令 – 程序员必学

示例：

# 初始化项目>/init 已创建 CLAUDE.md 记忆文件 已配置项目结构 已记录技术栈偏好# 代码审查>/review src/auth.py 代码审查报告： ✓ 语法检查：通过 ⚠ 建议优化：第45行可简化 ✗ 问题发现：第78行缺少异常处理# 生成待办>/todo 实现用户注册功能 待办清单： ☐1. 设计 User 数据模型 ☐2. 实现注册 API 路由 ☐3. 添加邮箱验证逻辑 ☐4. 编写单元测试

辅助配置命令 - 用着更顺手

示例

# 临时提问>/btw Python 中 datetime 怎么转字符串？ （回答后自动回到主线任务）# 配置编辑器>/config editor vscode 已设置默认编辑器为 VSCode# 开启 Vim 模式>/vim 已启用 Vim 键位绑定

自定义命令 - 打造专属工具

Claude Code 支持自定义斜杠命令。将常用的代码规范写成.md文件，存到指定目录，输入/文件名即可一键调用

配置步骤：

# 1. 创建自定义命令目录mkdir-p~/.config/claude/commands/# 2. 创建自定义命令文件cat>~/.config/claude/commands/api.md<<'EOF' --- name: api --- # 生成标准 API 接口模板 按照以下规范生成代码： 1. 使用 RESTful 风格 2. 添加异常处理 3. 包含输入验证 4. 生成对应的测试用例 EOF# 3. 使用自定义命令>/api 创建一个用户管理接口

核心交互模式

自然语言交互

Claude Code 的核心优势是支持自然语言指令：

# 不需要记特定命令，直接用自然语言>帮我分析这个项目的主要功能>为所有 API 路由添加错误处理>重构 utils.py 使其更符合 PEP8 规范

上下文引用

# 引用文件>分析 @src/main.py 的结构# 引用多个文件>比较 @src/v1/api.py 和 @src/v2/api.py 的区别# 引用代码行>优化 @src/utils.py#45-60 这段代码的性能

多轮对话

# 第一轮>创建一个处理 CSV 数据的 Python 脚本# 第二轮（基于上一轮）>为这个脚本添加异常处理# 第三轮>再添加命令行参数支持

快速示例

示例1：初始话项目

>帮我创建一个 Python 项目结构，包含： - src/ 目录存放源代码 - tests/ 目录存放测试 - requirements.txt - README.md AI 会：1. 创建所有目录和文件2. 生成基础代码3. 创建 .gitignore

示例2：生产代码

>在 src/models.py 中创建一个 User 类： - 字段：id(int), username(str), email(str), created_at(datetime)- 方法：to_dict(), validate_email()- 使用 Pydantic BaseModel

# AI 生成的代码fromdatetimeimportdatetimefrompydanticimportBaseModel,EmailStr,FieldclassUser(BaseModel):id:int=Field(...,description="用户ID")username:str=Field(...,min_length=3,max_length=50)email:EmailStr created_at:datetime=Field(default_factory=datetime.now)defto_dict(self)->dict:returnself.model_dump()defvalidate_email(self)->bool:return"@"inself.emailand"."inself.email.split("@")[1]

示例3： 批量修改

>将项目中所有 Python 文件的 print 语句替换为 logging：1. 在文件顶部添加 logging 导入和初始化2. 将所有 print("xxx")改为 logger.info("xxx")3. 保持原有缩进

示例4： Git操作

> 查看当前有哪些未提交的更改 > 提交所有更改，消息是："添加用户认证功能" > 创建一个新分支 feature/auth，并切换过去

常用场景速查

场景1：代码理解

# 快速了解项目>这个项目的主要功能是什么？# 了解具体模块>解释 src/auth.py 的作用# 了解代码逻辑>src/utils.py 中的 validate_token 函数是如何工作的？

场景2：代码生成

# 生成基础代码>创建一个 FastAPI 的路由文件，包含 CRUD 操作# 生成测试>为 src/models/user.py 生成 pytest 测试# 生成文档>为 src/api/ 下的所有模块生成 API 文档

场景3 ：代码重构

# 单文件重构>重构 src/main.py，使用类来组织代码# 批量重构>将所有使用了旧 API 的文件更新到新 API# 性能优化>优化 src/processor.py 中数据处理函数的性能

场景4： 问题排查

# 查找问题>为什么 tests/test_api.py 会失败？# 分析错误>解释这个错误信息：ImportError: cannotimportname'User'# 修复 Bug>修复 src/calc.py 中的除零错误

配置与个性化

配置文件位置

常用配置项

{"env":{"ANTHROPIC_API_KEY":"your-api-key","ANTHROPIC_BASE_URL":"https://api.anthropic.com"},"preferences":{"auto_execute_commands":false,"confirm_destructive_operations":true,"editor":"cursor"}}

设置编辑器

# 配置默认编辑器（用于编辑文件）>设置编辑器为 cursor# 或 vim>设置编辑器为vim# 或 vscode>设置编辑器为 code

常见问题

Claude Code 启动失败

解决：

# 检查 Node.js 版本node--version# 需要 >= 18# 重新安装npmuninstall-g@anthropic-ai/claude-codenpminstall-g@anthropic-ai/claude-code

API Key 无效

解决:

• 检查环境变量ANTHROPIC_API_KEY是否设置
• 确认 API Key 有余额
• 检查网络连接

对话历史太长

解决:

>/compact# 压缩历史>/clear# 清除历史

如何切换模型

# 查看当前模型 > /status # 使用环境变量切换 export ANTHROPIC_MODEL=claude-opus-4-20250514