Claude Code-入门篇-Claude-Code基础与环境配置
第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 Code | Cursor | GitHub Copilot | OpenAI 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 | 局部替换代码块 | 修改方法实现、修复 Bug |
Bash | 执行终端命令 | 运行测试、编译、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 LTS，Claude Code 基于 Node 构建）
- Git（用于代码版本管理和上下文加载）
- API Key：Anthropic 官方 API Key，或其他兼容供应商的 Key
2.2 安装 Claude Code
# 全局安装（推荐）npminstall-g@anthropic-ai/claude-code# 验证安装claude--version# 输出类似：claude 1.x.x# 首次启动，按提示配置 API Keyclaude2.3 模型供应商配置
Claude Code 默认调用 Anthropic 官方 API，但支持灵活配置其他供应商。这对国内用户尤为重要。
配置方式
配置文件位置：
- Windows：
C:\Users\<用户名>\.claude\settings.json - macOS / Linux：
~/.claude/settings.json
方案 A：Anthropic 官方（直接访问）
{"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"}}方案 C：AWS 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-app&&cdtodo-appStep 2：启动 Claude Code
claudeStep 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-project&&cdmy-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 分钟。
六、常见问题速查
Q1：Claude Code 收费吗？
Claude Code 本身免费下载使用，但调用 API 需要付费。费用按 Token 计算，通常比订阅制更灵活。一个简单的 CRUD 模块开发，成本约 ¥0.5-2 元。
Q2：代码安全吗？会不会泄露？
- Anthropic 承诺不会用你通过 API 发送的代码训练模型
- 但敏感项目建议配置本地模型或私有部署
- 绝不要在提示词中放入密码、密钥、Token
Q3：可以离线使用吗？
不可以。Claude Code 需要联网调用大模型 API。如果需要离线，考虑本地部署 CodeLlama 或 Qwen-Coder，但能力会弱很多。
Q4：Windows 上能用吗？
完全可以。Claude Code 基于 Node.js，跨平台支持。Windows 用户使用 PowerShell 或 Git Bash 均可。
七、本篇小结
通过本篇，你应该已经：
- ✅ 理解了 Claude Code 的定位和能力边界
- ✅ 完成了安装和 API Key 配置
- ✅ 掌握了 Session、Context Window、模型选择等核心概念
- ✅ 成功用 Claude Code 创建了一个 Todo 应用
- ✅ 体验了 AI 驱动项目初始化的效率