Claude Code 教程 -01-快速上手

Lisondreamlison163.com,v1.0.0,2026.06.21Claude Code -01-快速上手文章目录Claude Code -01-快速上手安装与配置环境要求安装Claude Code配置API Key启动与基本操作启动方式首次启动配置基本界面Claude Code 的多种使用形态JetBrains IDEsVSCode扩展启动Claude Code 面板VSCode 集成特性VSCode 配置示例基础命令内置命令文件操作命令代码操作命令终端命令斜杠命令详解Claude Code 2.1.81 完整版基础常用命令 - 日常开发高频使用模型与上下文管理-让AI代码不跑偏项目与代码核心命令 -- 程序员必学辅助配置命令 - 用着更顺手自定义命令 - 打造专属工具核心交互模式自然语言交互上下文引用多轮对话快速示例常用场景速查配置与个性化配置文件位置常用配置项设置编辑器常见问题Claude Code 启动失败API Key 无效对话历史太长如何切换模型安装与配置环境要求Node.js 18.0npm 或 yarn 包管理器Git (可选用于代码管理)安装Claude Code# 全局安装npminstall-ganthropic-ai/claude-codelatest# 验证安装claude--version配置API Key# 方式1环境变量exportANTHROPIC_API_KEYyour-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/jetbrainsClaude Code 插件支持大多数 JetBrains IDEs包括IntelliJ IDEAPyCharmAndroid StudioWebStormPhpStormGoLand在 IDEA 中安装 Claude Code 非常简单直接进入Settings → Plugins搜索Claude Code并安装即可VSCode扩展详情参考文档https://code.claude.com/docs/en/vs-code# 方式1通过 VSCode 扩展市场 # 在 VSCode 中按 CtrlShiftX (CmdShiftX on macOS) # 搜索 Claude Code # 点击安装 Anthropic 官方扩展 方式2命令行安装 打开命令面板 CtrlShiftP (CmdShiftP) code --install-extension anthropic.claude-code启动Claude Code 面板# 方式1命令面板 CtrlShiftP (CmdShiftP) → 输入 Claude Code: Open # 方式2快捷键 CtrlShiftC (CmdShiftC) - 打开 Claude Code 面板 # 方式3侧边栏 点击左侧活动栏的 Claude Code 图标VSCode 集成特性特性说明快捷键内联编辑直接在编辑器中接收 AI 建议AltC文件引用使用 引用当前工作区文件文件名代码选择选中代码后右键发送到 Claude右键菜单终端集成在 VSCode 终端中运行 ClaudeCtrldiff 查看自动显示代码修改对比自动弹出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}基础命令内置命令命令功能示例/help显示帮助信息/help/status查看当前配置/status/clear清除对话历史/clear/compact压缩对话历史/compact/model切换模型/model/exit退出 Claude Code/exit或CtrlC文件操作命令# 读取文件读取 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 的斜杠命令是效率神器以下命令按使用频率和用途分类整理。基础常用命令 - 日常开发高频使用命令功能使用场景/help查看所有命令用法新手入门、忘记命令时/clear一键清空对话历史切换项目、清理杂乱对话/cost查看 Token 消耗和预估费用使用 Opus 等高阶模型时把控成本/status查会话状态、模型、上下文长度排查卡顿、忘需求问题示例# 查看费用使用 Opus 时特别重要/cost# 输出示例# 当前会话 Token: 15,234 / 200,000# 预估费用: $0.023# 模型: claude-sonnet-5模型与上下文管理-让AI代码不跑偏命令功能使用场景/model [名称]按任务选模型复杂架构用 Opus简单任务用 Sonnet/compact [说明]压缩上下文保留核心内容对话太长、AI 卡顿/context查看 AI 记住的需求防止遗漏关键要求/rewind回退上一步撤销回答代码出错、逻辑不对/forget删除无关测试代码、无效对话避免干扰当前开发示例# 切换模型/model opus 已切换到 claude-opus-4-20250514# 压缩上下文/compact 保留后端核心逻辑 对话已压缩。要点总结 - 项目FastAPI Web 应用 - 当前任务添加用户认证 - 下一步JWT 集成# 回退错误/rewind 已回退到上一步。请重新描述需求。项目与代码核心命令 – 程序员必学命令功能使用场景/init初始化项目结构生成记忆文件新建项目第一步/memory更新记忆文件中的项目需求、技术栈需求变更时同步/diff查看代码修改差异确认改动是否合规/review自动审查代码找语法错误、逻辑漏洞代码审查阶段/simplify一键精简代码剔除无用代码代码冗余、嵌套复杂/test自动生成测试用例并运行验证功能是否正常/todo生成项目待办清单梳理开发任务/doctor自动诊断项目问题环境报错、依赖缺失示例# 初始化项目/init 已创建 CLAUDE.md 记忆文件 已配置项目结构 已记录技术栈偏好# 代码审查/review src/auth.py 代码审查报告 ✓ 语法检查通过 ⚠ 建议优化第45行可简化 ✗ 问题发现第78行缺少异常处理# 生成待办/todo 实现用户注册功能 待办清单 ☐1. 设计 User 数据模型 ☐2. 实现注册 API 路由 ☐3. 添加邮箱验证逻辑 ☐4. 编写单元测试辅助配置命令 - 用着更顺手命令功能使用场景/btw [问题]开发中途问小问题不打断主线任务临时查询/break暂停任务回来直接接续中途有事、开会/config自定义代码缩进、字体、默认模型个性化设置/vim开启 Vim 键位Vim 用户适用示例# 临时提问/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.mdEOF --- 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:intField(...,description用户ID)username:strField(...,min_length3,max_length50)email:EmailStr created_at:datetimeField(default_factorydatetime.now)defto_dict(self)-dict:returnself.model_dump()defvalidate_email(self)-bool:returninself.emailand.inself.email.split()[1]示例3 批量修改将项目中所有 Python 文件的 print 语句替换为 logging1. 在文件顶部添加 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: cannotimportnameUser# 修复 Bug修复 src/calc.py 中的除零错误配置与个性化配置文件位置平台路径 (Claude Code 2.1.81)Windows%APPDATA%\claude\settings.jsonmacOS~/.config/claude/settings.jsonLinux~/.config/claude/settings.json常用配置项{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-ganthropic-ai/claude-codenpminstall-ganthropic-ai/claude-codeAPI Key 无效解决:检查环境变量ANTHROPIC_API_KEY是否设置确认 API Key 有余额检查网络连接对话历史太长解决:/compact# 压缩历史/clear# 清除历史如何切换模型# 查看当前模型 /status # 使用环境变量切换 export ANTHROPIC_MODELclaude-opus-4-20250514