第1篇入门篇 —— Claude Code 基础与环境配置系列导读这是「Claude Code 全栈开发实战教程」的第一篇。本系列的目标只有一个让你用自然语言驱动 AI完成从需求到交付的完整软件工程流程。学完本篇你将完成 Claude Code 的安装配置并跑通第一个 AI 驱动项目。一、Claude Code 到底是什么Claude Code 是 Anthropic 于 2025 年推出的命令行 AI 编程助手。它和 ChatGPT、Copilot 最大的区别在于它不只是生成代码片段而是直接操作你的代码库——读取文件、修改代码、运行测试、执行命令全流程自动化。你可以把它理解为一个永远在线、不知疲倦、执行精准的全栈工程师队友。你负责说做什么它负责怎么做。1.1 为什么选 Claude Code市面上的 AI 编程工具不少我们来做个 honest 的对比维度Claude CodeCursorGitHub CopilotOpenAI Codex CLI交互方式终端对话式IDE 内嵌 对话IDE 内嵌补全终端对话式代码库理解✅ 完整项目上下文✅ 完整项目❌ 当前文件/窗口⚠️ 有限文件操作✅ 读写、批量修改、创建目录✅ 支持❌ 仅补全✅ 支持命令执行✅ 运行测试、构建、部署✅ 支持❌ 不支持✅ 支持多 Agent 协作✅ Subagents / Teams / SDK⚠️ Agent 模式❌ 不支持⚠️ 有限上下文长度✅ 200K tokens✅ 200K❌ 8K-32K✅ 200K价格按 Token 计费$20/月订阅$10-19/月订阅按 Token 计费最佳场景复杂项目全流程开发日常编码、快速修改代码补全、单行提示简单脚本任务一句话总结Copilot 帮你写下一行代码Cursor 帮你改这段代码Claude Code 帮你做完这个项目。1.2 Claude Code 的底层能力Claude Code 不是简单的聊天代码生成它有一套完整的工具链内置工具作用使用场景Read读取文件内容分析现有代码、学习项目结构Write创建或覆盖文件生成新代码文件、写配置Edit局部替换代码块修改方法实现、修复 BugBash执行终端命令运行测试、编译、Git 操作Glob按通配符搜索文件批量操作同类文件Grep文本搜索查找方法定义、变量使用LS列出目录内容探索项目结构关键洞察这些工具不是你要手动调用的——你把需求用自然语言描述清楚Claude 会自动判断该用什么工具、按什么顺序执行。这才是真正的Agent能力。1.3 适用场景与不适用场景Claude Code 特别适合从零搭建一个新项目脚手架、目录结构、依赖配置为现有项目新增完整功能模块Entity → Mapper → Service → Controller → 前端页面代码重构批量重命名、提取方法、升级框架版本Bug 排查运行测试 → 分析日志 → 定位问题 → 修复 → 验证代码审查静态分析 安全审计 性能检查Claude Code 不太适合需要强创意和设计的 UI 工作需要配合 Frontend Design Skill涉及敏感数据的代码虽有安全机制但关键业务仍需人工 review极度复杂的算法实现Claude 可能自信地犯错需要人工验证二、安装与环境配置2.1 前置要求Node.js 18推荐 20 LTSClaude Code 基于 Node 构建Git用于代码版本管理和上下文加载API KeyAnthropic 官方 API Key或其他兼容供应商的 Key2.2 安装 Claude Code# 全局安装推荐npminstall-ganthropic-ai/claude-code# 验证安装claude--version# 输出类似claude 1.x.x# 首次启动按提示配置 API Keyclaude2.3 模型供应商配置Claude Code 默认调用 Anthropic 官方 API但支持灵活配置其他供应商。这对国内用户尤为重要。配置方式配置文件位置WindowsC:\Users\用户名\.claude\settings.jsonmacOS / Linux~/.claude/settings.json方案 AAnthropic 官方直接访问{env:{ANTHROPIC_AUTH_TOKEN:sk-ant-api-xx-xxxx}}方案 B火山引擎国内推荐{env:{ANTHROPIC_AUTH_TOKEN:your-ark-api-key,ANTHROPIC_BASE_URL:https://ark.cn-beijing.volces.com/api/coding,ANTHROPIC_DEFAULT_HAIKU_MODEL:doubao-seed-2.0-lite,ANTHROPIC_DEFAULT_SONNET_MODEL:minimax-m2.5,ANTHROPIC_DEFAULT_OPUS_MODEL:doubao-seed-2.0-pro}}方案 CAWS Bedrock企业场景{env:{ANTHROPIC_AUTH_TOKEN:your-aws-access-key,ANTHROPIC_BASE_URL:https://bedrock-runtime.us-east-1.amazonaws.com}}2.4 VS Code 扩展可选但推荐Claude Code 有 VS Code 扩展可以在 IDE 中快速启动多个实例# 在 VS Code 扩展商店搜索 Claude Code 安装安装后你可以在 VS Code 的不同面板中同时运行多个 Claude Code 实例一个写后端、一个写前端、一个跑测试——并行开发效率翻倍。三、核心概念详解3.1 Session会话每次执行claude命令就开启一个新的 Session。Session 是 Claude Code 工作的基本单元。关键特性Session 之间的对话历史不共享除非通过 Memory 系统一个 Session 可以持续很长时间但上下文有长度限制可以用/clear清屏开始新话题保留 Session常用命令# 清屏开始新话题历史仍在但 Claude 会忽略之前的上下文/clear# 查看当前加载的所有配置Memory Rules/memory# 退出当前 Session/exit# 查看历史对话按上箭头键↑3.2 Context Window上下文窗口Claude Code 会把你的代码库结构、已读取的文件、对话历史、配置文件等全部加载到上下文中。但这个工作记忆有上限——通常是 200K tokens约 15-20 万汉字。当上下文接近上限时Claude 会自动压缩旧的历史对话压缩可能导致细节丢失最老的文件内容可能被移出上下文最佳实践# 1. 一个 Session 只做一件事# ❌ 错误在一个 Session 里先写用户模块再写订单模块再改前端# ✅ 正确写完用户模块就 /exit新开 Session 写订单模块# 2. 及时 /clear# 每完成一个独立子任务如写好 UserService就 /clear 开始下一个# 3. 大项目只加载需要的子目录# 在大型单体仓库中cd 到具体子项目再启动 claude3.3 模型选择策略Claude Code 支持多种模型默认策略是先用强模型Opus理解需求再自动降级到效率模型Sonnet执行具体任务。模型定位适用场景成本Opus最强推理架构设计、复杂 Bug 排查、需求分析高Sonnet日常主力编码实现、代码审查、常规重构中Haiku轻量快速简单查询、格式化、文档整理低配置自定义模型映射{env:{ANTHROPIC_DEFAULT_OPUS_MODEL:claude-opus-4-20250514,ANTHROPIC_DEFAULT_SONNET_MODEL:claude-sonnet-4-20250514,ANTHROPIC_DEFAULT_HAIKU_MODEL:claude-haiku-4-20250514}}四、第一个实战5 分钟完成一个 Todo 应用光说不练假把式。让我们用 Claude Code 从零创建一个功能完整的 Todo 应用。Step 1创建项目目录mkdirtodo-appcdtodo-appStep 2启动 Claude CodeclaudeStep 3给出你的第一条指令请帮我创建一个极简的 Todo 应用要求 1. 纯 HTML CSS JavaScript单文件实现index.html 2. 支持添加任务、标记完成、删除任务 3. 数据保存在 localStorage刷新页面不丢失 4. UI 要简洁美观使用 Tailwind CSS CDN 5. 要有筛选功能全部 / 进行中 / 已完成 6. 显示待办数量统计 请直接创建 index.html 文件。Step 4观察 Claude 的自动执行过程你会看到 Claude 在终端中一步步执行思考分析需求确认技术方案Write创建index.html文件Bash运行ls确认文件已创建Read读取文件内容自我检查Step 5验证成果在另一个终端中cdtodo-app# 方式1使用 npx servenpx serve.# 方式2使用 Python 临时服务器python-mhttp.server8080# 方式3使用 Node 的 http-servernpx http-server-p8080打开浏览器访问http://localhost:8080你应该能看到一个漂亮的输入框和添加按钮任务列表每个任务有复选框和删除按钮底部筛选标签和待办数量统计刷新页面后数据依然保留Step 6继续迭代别急着退出试着给 Claude 更多指令很好现在请增加以下功能 1. 任务支持编辑双击文字可以修改 2. 添加任务优先级高/中/低用不同颜色标识 3. 支持拖拽排序Claude 会直接在现有文件上进行修改保留已有功能的同时增加新特性。五、进阶让 Claude 管理整个项目刚才的单文件应用只是开胃菜。让我们看看 Claude Code 在真实项目中的表现。场景创建一个 Spring Boot 项目骨架mkdirmy-spring-projectcdmy-spring-project claude请帮我初始化一个 Spring Boot 3.2 多模块 Maven 项目要求 1. 父 POM 管理依赖版本 2. 包含三个子模块common通用工具、user用户模块、order订单模块 3. 技术栈Spring Boot 3.2 MyBatis-Plus MySQL Driver Lombok 4. JDK 版本 17 5. 统一依赖版本管理 6. 每个子模块都要有独立的 application.yml 请创建完整的目录结构和配置文件。Claude 会自动生成父pom.xml含dependencyManagement三个子模块的目录和pom.xml每个模块的src/main/java和src/main/resources基础的application.yml.gitignore耗时约 2-3 分钟而手动搭建至少需要 15-20 分钟。六、常见问题速查Q1Claude Code 收费吗Claude Code 本身免费下载使用但调用 API 需要付费。费用按 Token 计算通常比订阅制更灵活。一个简单的 CRUD 模块开发成本约 ¥0.5-2 元。Q2代码安全吗会不会泄露Anthropic 承诺不会用你通过 API 发送的代码训练模型但敏感项目建议配置本地模型或私有部署绝不要在提示词中放入密码、密钥、TokenQ3可以离线使用吗不可以。Claude Code 需要联网调用大模型 API。如果需要离线考虑本地部署 CodeLlama 或 Qwen-Coder但能力会弱很多。Q4Windows 上能用吗完全可以。Claude Code 基于 Node.js跨平台支持。Windows 用户使用 PowerShell 或 Git Bash 均可。七、本篇小结通过本篇你应该已经✅ 理解了 Claude Code 的定位和能力边界✅ 完成了安装和 API Key 配置✅ 掌握了 Session、Context Window、模型选择等核心概念✅ 成功用 Claude Code 创建了一个 Todo 应用✅ 体验了 AI 驱动项目初始化的效率
Claude Code-入门篇-Claude-Code基础与环境配置
发布时间:2026/5/24 6:02:43
第1篇入门篇 —— Claude Code 基础与环境配置系列导读这是「Claude Code 全栈开发实战教程」的第一篇。本系列的目标只有一个让你用自然语言驱动 AI完成从需求到交付的完整软件工程流程。学完本篇你将完成 Claude Code 的安装配置并跑通第一个 AI 驱动项目。一、Claude Code 到底是什么Claude Code 是 Anthropic 于 2025 年推出的命令行 AI 编程助手。它和 ChatGPT、Copilot 最大的区别在于它不只是生成代码片段而是直接操作你的代码库——读取文件、修改代码、运行测试、执行命令全流程自动化。你可以把它理解为一个永远在线、不知疲倦、执行精准的全栈工程师队友。你负责说做什么它负责怎么做。1.1 为什么选 Claude Code市面上的 AI 编程工具不少我们来做个 honest 的对比维度Claude CodeCursorGitHub CopilotOpenAI Codex CLI交互方式终端对话式IDE 内嵌 对话IDE 内嵌补全终端对话式代码库理解✅ 完整项目上下文✅ 完整项目❌ 当前文件/窗口⚠️ 有限文件操作✅ 读写、批量修改、创建目录✅ 支持❌ 仅补全✅ 支持命令执行✅ 运行测试、构建、部署✅ 支持❌ 不支持✅ 支持多 Agent 协作✅ Subagents / Teams / SDK⚠️ Agent 模式❌ 不支持⚠️ 有限上下文长度✅ 200K tokens✅ 200K❌ 8K-32K✅ 200K价格按 Token 计费$20/月订阅$10-19/月订阅按 Token 计费最佳场景复杂项目全流程开发日常编码、快速修改代码补全、单行提示简单脚本任务一句话总结Copilot 帮你写下一行代码Cursor 帮你改这段代码Claude Code 帮你做完这个项目。1.2 Claude Code 的底层能力Claude Code 不是简单的聊天代码生成它有一套完整的工具链内置工具作用使用场景Read读取文件内容分析现有代码、学习项目结构Write创建或覆盖文件生成新代码文件、写配置Edit局部替换代码块修改方法实现、修复 BugBash执行终端命令运行测试、编译、Git 操作Glob按通配符搜索文件批量操作同类文件Grep文本搜索查找方法定义、变量使用LS列出目录内容探索项目结构关键洞察这些工具不是你要手动调用的——你把需求用自然语言描述清楚Claude 会自动判断该用什么工具、按什么顺序执行。这才是真正的Agent能力。1.3 适用场景与不适用场景Claude Code 特别适合从零搭建一个新项目脚手架、目录结构、依赖配置为现有项目新增完整功能模块Entity → Mapper → Service → Controller → 前端页面代码重构批量重命名、提取方法、升级框架版本Bug 排查运行测试 → 分析日志 → 定位问题 → 修复 → 验证代码审查静态分析 安全审计 性能检查Claude Code 不太适合需要强创意和设计的 UI 工作需要配合 Frontend Design Skill涉及敏感数据的代码虽有安全机制但关键业务仍需人工 review极度复杂的算法实现Claude 可能自信地犯错需要人工验证二、安装与环境配置2.1 前置要求Node.js 18推荐 20 LTSClaude Code 基于 Node 构建Git用于代码版本管理和上下文加载API KeyAnthropic 官方 API Key或其他兼容供应商的 Key2.2 安装 Claude Code# 全局安装推荐npminstall-ganthropic-ai/claude-code# 验证安装claude--version# 输出类似claude 1.x.x# 首次启动按提示配置 API Keyclaude2.3 模型供应商配置Claude Code 默认调用 Anthropic 官方 API但支持灵活配置其他供应商。这对国内用户尤为重要。配置方式配置文件位置WindowsC:\Users\用户名\.claude\settings.jsonmacOS / Linux~/.claude/settings.json方案 AAnthropic 官方直接访问{env:{ANTHROPIC_AUTH_TOKEN:sk-ant-api-xx-xxxx}}方案 B火山引擎国内推荐{env:{ANTHROPIC_AUTH_TOKEN:your-ark-api-key,ANTHROPIC_BASE_URL:https://ark.cn-beijing.volces.com/api/coding,ANTHROPIC_DEFAULT_HAIKU_MODEL:doubao-seed-2.0-lite,ANTHROPIC_DEFAULT_SONNET_MODEL:minimax-m2.5,ANTHROPIC_DEFAULT_OPUS_MODEL:doubao-seed-2.0-pro}}方案 CAWS Bedrock企业场景{env:{ANTHROPIC_AUTH_TOKEN:your-aws-access-key,ANTHROPIC_BASE_URL:https://bedrock-runtime.us-east-1.amazonaws.com}}2.4 VS Code 扩展可选但推荐Claude Code 有 VS Code 扩展可以在 IDE 中快速启动多个实例# 在 VS Code 扩展商店搜索 Claude Code 安装安装后你可以在 VS Code 的不同面板中同时运行多个 Claude Code 实例一个写后端、一个写前端、一个跑测试——并行开发效率翻倍。三、核心概念详解3.1 Session会话每次执行claude命令就开启一个新的 Session。Session 是 Claude Code 工作的基本单元。关键特性Session 之间的对话历史不共享除非通过 Memory 系统一个 Session 可以持续很长时间但上下文有长度限制可以用/clear清屏开始新话题保留 Session常用命令# 清屏开始新话题历史仍在但 Claude 会忽略之前的上下文/clear# 查看当前加载的所有配置Memory Rules/memory# 退出当前 Session/exit# 查看历史对话按上箭头键↑3.2 Context Window上下文窗口Claude Code 会把你的代码库结构、已读取的文件、对话历史、配置文件等全部加载到上下文中。但这个工作记忆有上限——通常是 200K tokens约 15-20 万汉字。当上下文接近上限时Claude 会自动压缩旧的历史对话压缩可能导致细节丢失最老的文件内容可能被移出上下文最佳实践# 1. 一个 Session 只做一件事# ❌ 错误在一个 Session 里先写用户模块再写订单模块再改前端# ✅ 正确写完用户模块就 /exit新开 Session 写订单模块# 2. 及时 /clear# 每完成一个独立子任务如写好 UserService就 /clear 开始下一个# 3. 大项目只加载需要的子目录# 在大型单体仓库中cd 到具体子项目再启动 claude3.3 模型选择策略Claude Code 支持多种模型默认策略是先用强模型Opus理解需求再自动降级到效率模型Sonnet执行具体任务。模型定位适用场景成本Opus最强推理架构设计、复杂 Bug 排查、需求分析高Sonnet日常主力编码实现、代码审查、常规重构中Haiku轻量快速简单查询、格式化、文档整理低配置自定义模型映射{env:{ANTHROPIC_DEFAULT_OPUS_MODEL:claude-opus-4-20250514,ANTHROPIC_DEFAULT_SONNET_MODEL:claude-sonnet-4-20250514,ANTHROPIC_DEFAULT_HAIKU_MODEL:claude-haiku-4-20250514}}四、第一个实战5 分钟完成一个 Todo 应用光说不练假把式。让我们用 Claude Code 从零创建一个功能完整的 Todo 应用。Step 1创建项目目录mkdirtodo-appcdtodo-appStep 2启动 Claude CodeclaudeStep 3给出你的第一条指令请帮我创建一个极简的 Todo 应用要求 1. 纯 HTML CSS JavaScript单文件实现index.html 2. 支持添加任务、标记完成、删除任务 3. 数据保存在 localStorage刷新页面不丢失 4. UI 要简洁美观使用 Tailwind CSS CDN 5. 要有筛选功能全部 / 进行中 / 已完成 6. 显示待办数量统计 请直接创建 index.html 文件。Step 4观察 Claude 的自动执行过程你会看到 Claude 在终端中一步步执行思考分析需求确认技术方案Write创建index.html文件Bash运行ls确认文件已创建Read读取文件内容自我检查Step 5验证成果在另一个终端中cdtodo-app# 方式1使用 npx servenpx serve.# 方式2使用 Python 临时服务器python-mhttp.server8080# 方式3使用 Node 的 http-servernpx http-server-p8080打开浏览器访问http://localhost:8080你应该能看到一个漂亮的输入框和添加按钮任务列表每个任务有复选框和删除按钮底部筛选标签和待办数量统计刷新页面后数据依然保留Step 6继续迭代别急着退出试着给 Claude 更多指令很好现在请增加以下功能 1. 任务支持编辑双击文字可以修改 2. 添加任务优先级高/中/低用不同颜色标识 3. 支持拖拽排序Claude 会直接在现有文件上进行修改保留已有功能的同时增加新特性。五、进阶让 Claude 管理整个项目刚才的单文件应用只是开胃菜。让我们看看 Claude Code 在真实项目中的表现。场景创建一个 Spring Boot 项目骨架mkdirmy-spring-projectcdmy-spring-project claude请帮我初始化一个 Spring Boot 3.2 多模块 Maven 项目要求 1. 父 POM 管理依赖版本 2. 包含三个子模块common通用工具、user用户模块、order订单模块 3. 技术栈Spring Boot 3.2 MyBatis-Plus MySQL Driver Lombok 4. JDK 版本 17 5. 统一依赖版本管理 6. 每个子模块都要有独立的 application.yml 请创建完整的目录结构和配置文件。Claude 会自动生成父pom.xml含dependencyManagement三个子模块的目录和pom.xml每个模块的src/main/java和src/main/resources基础的application.yml.gitignore耗时约 2-3 分钟而手动搭建至少需要 15-20 分钟。六、常见问题速查Q1Claude Code 收费吗Claude Code 本身免费下载使用但调用 API 需要付费。费用按 Token 计算通常比订阅制更灵活。一个简单的 CRUD 模块开发成本约 ¥0.5-2 元。Q2代码安全吗会不会泄露Anthropic 承诺不会用你通过 API 发送的代码训练模型但敏感项目建议配置本地模型或私有部署绝不要在提示词中放入密码、密钥、TokenQ3可以离线使用吗不可以。Claude Code 需要联网调用大模型 API。如果需要离线考虑本地部署 CodeLlama 或 Qwen-Coder但能力会弱很多。Q4Windows 上能用吗完全可以。Claude Code 基于 Node.js跨平台支持。Windows 用户使用 PowerShell 或 Git Bash 均可。七、本篇小结通过本篇你应该已经✅ 理解了 Claude Code 的定位和能力边界✅ 完成了安装和 API Key 配置✅ 掌握了 Session、Context Window、模型选择等核心概念✅ 成功用 Claude Code 创建了一个 Todo 应用✅ 体验了 AI 驱动项目初始化的效率