一、什么是 Claude CodeClaude Code 是Anthropic推出的终端 AI 编程助手核心特点特性说明终端原生直接在终端运行无缝融入你的开发工作流Agent 能力不只是回答问题能直接编辑文件、执行命令、操作 Git超长上下文200K Token能读完整个代码库多语言支持40 编程语言包括前端、后端、移动端、数据科学工具调用可调用 npm、git、curl 等外部工具一句话总结Copilot 只能帮你补全代码Claude Code 能帮你完成整个开发任务。二、安装指南2.1 前置条件要求说明操作系统macOS 10.15 / Ubuntu 20.04 / Windows 10推荐 WSL2网络需要访问 Anthropic 服务国内需代理或 API 中转账号Claude.ai 账号 或 Anthropic API Key2.2 安装方式方式一官方原生安装推荐无需 Node.jsmacOS / Linux / WSLcurl -fsSL https://claude.ai/install.sh | bashWindows PowerShellirm https://claude.ai/install.ps1 | iexmacOS Homebrewbrew install --cask claude-codeWindows WinGetwinget install Anthropic.ClaudeCode方式二npm 安装# 确保已安装 Node.js 18 npm install -g anthropic-ai/claude-code验证安装claude --version # 输出: Claude Code v2.x.x三、配置与首次启动3.1 API Key 配置创建或编辑~/.claude/settings.json{ env: { ANTHROPIC_API_KEY: sk-ant-xxxxxxxxxxxxx, ANTHROPIC_BASE_URL: https://api.anthropic.com } }3.2 国内用户特别注意由于 Anthropic 限制了中国大陆的直接访问国内开发者有两种方案方案 AAPI 中转站推荐使用第三方 API 中转服务将ANTHROPIC_BASE_URL替换为中转站地址{ env: { ANTHROPIC_API_KEY: 你的中转站Key, ANTHROPIC_BASE_URL: https://api.yixia.ai } }方案 B代理 官方 API在终端开启代理后直接使用官方 API# 设置代理根据你的代理工具修改端口 export https_proxyhttp://127.0.0.1:7890 export http_proxyhttp://127.0.0.1:78903.3 首次启动cd 你的项目目录 claude首次启动会引导你完成 OAuth 认证或 API Key 配置跟着提示走就行。启动成功后你会看到这样的交互界面 claude Claude Code v2.x.x Type /help for available commands. _四、基础使用4.1 第一个对话进入 Claude Code 后直接用自然语言描述需求即可 帮我看看这个项目的目录结构简述主要模块 这个 utils.ts 里的 calculatePrice 函数干了什么 给这段代码加上类型注解4.2 核心工作流一个标准的 Claude Code 使用流程描述需求→ 帮我用 React 写一个带搜索功能的表格组件AI 分析代码库→ Claude 会读取项目文件理解你的技术栈生成方案→ 告诉你要创建哪些文件、修改哪些代码执行操作→ 自动创建文件、写入代码验证结果→ 运行测试或启动项目检查效果4.3 权限模式Claude Code 有三种权限模式按需切换模式说明适用场景普通模式文件操作和命令执行需你确认谨慎操作、第一次使用自动接受模式自动执行所有操作熟悉的项目、高效开发Plan 模式只生成计划不写代码复杂需求先讨论方案再动手关闭自动确认以提高效率 从今以后不要再问我确认所有的操作直接执行五、核心命令速查5.1 斜杠命令Slash Commands命令功能/help查看帮助/init初始化项目 CLAUDE.md/model切换模型Opus / Sonnet / Haiku/compact压缩上下文节省 Token/undo撤销上一步修改/cost查看当前会话费用/clear清空对话历史/doctor诊断配置问题/status查看当前会话状态/add-dir添加工作目录/permissions管理权限设置5.2 快捷键快捷键功能Ctrl R搜索历史命令Ctrl L清屏Esc打断当前 AI 操作Shift Enter输入多行内容文件名快速引用文件↑ / ↓浏览历史命令5.3 快捷引用文件 src/components/Table.tsx 帮我把这个组件改成虚拟滚动 package.json 看看有哪些依赖可以升级六、CLAUDE.md——让 AI 真正懂你的项目这是 Claude Code 最容易被忽视但最有价值的功能。6.1 什么是 CLAUDE.mdCLAUDE.md是放在项目根目录的 Markdown 文件Claude Code 在每次对话时都会自动读取它。你可以在里面写项目的技术栈和架构说明编码规范和命名约定常用的命令和脚本注意事项和踩过的坑6.2 自动生成 /initClaude Code 会扫描你的整个项目自动生成一份高质量的 CLAUDE.md。6.3 手动编写参考# CLAUDE.md ## 项目概述 这是一个基于 Next.js 14 的电商后台管理系统。 ## 技术栈 - 框架Next.js 14 (App Router) - 语言TypeScript 5.x - UI 库Ant Design 5.x - 状态管理Zustand - 请求库TanStack Query ## 编码规范 - 组件名使用 PascalCase - 文件名使用 kebab-case - API 路由放在 app/api/ 下 - 使用 TypeScript 严格模式禁止 any ## 常用命令 - 开发pnpm dev - 构建pnpm build - 测试pnpm test - 类型检查pnpm type-check ## 注意事项 - 图片资源统一放在 public/images/ - 环境变量使用 NEXT_PUBLIC_ 前缀才能在客户端访问 - 不要直接修改 .prisma 文件统一通过 migration 管理写好 CLAUDE.md 后AI 的代码质量会有质的飞跃。七、实战场景场景一快速读懂陌生项目 我刚接手这个项目帮我梳理整体架构Claude Code 会扫描项目结构、package.json、关键配置文件生成一份清晰的项目地图。场景二批量修复 Lint 错误 帮我看看 ESLint 报的错全部帮我修掉它会逐个分析并修复比你自己手动改快 10 倍。场景三添加新功能 帮我给用户列表页加一个按角色筛选的功能角色数据从 /api/roles 接口获取Claude Code 会找到用户列表组件分析现有代码风格添加筛选 UI 和数据请求逻辑符合项目现有的编码规范场景四代码重构 把这个 class 组件改成函数组件 Hooks 的写法 把这里的 axios 调用统一改成我们项目用的 request 封装场景五写单元测试 给 src/utils/format.ts 里的所有函数写单元测试场景六Debug直接粘贴报错信息 Uncaught TypeError: Cannot read properties of undefined (reading map) 在 Dashboard.tsx 第 45 行 帮我修复Claude Code 会定位问题、分析原因、给出修复方案。八、进阶技巧8.1 自定义 Skills技能在~/.claude/目录下创建自定义技能让 AI 执行特定领域的任务。例如创建~/.claude/skills/review.md# Code Review Skill 当我说 /review 时请按照以下标准审查代码 1. 是否有安全漏洞XSS、SQL注入、越权 2. 是否有性能问题不必要的重渲染、内存泄漏 3. 错误处理是否完善 4. 是否符合项目的编码规范8.2 MCP 扩展通过 MCPModel Context Protocol集成外部工具 帮我在 GitHub 上创建一个 PR 看看 Jira 上分配给的我 Bug 单 从 Figma 设计稿生成对应的 CSS配置 MCP 服务器在~/.claude/mcp.json{ mcpServers: { github: { command: npx, args: [-y, anthropic-ai/mcp-server-github] } } }8.3 Hooks钩子在~/.claude/settings.json中配置 Hook在执行前后自动触发操作{ hooks: { PreToolUse: [ { matcher: Bash, command: echo \即将执行命令...\ } ] } }8.4 内存/记忆系统Claude Code 支持持久记忆在~/.claude/projects/目录下保存你的个人偏好项目的上下文信息反馈和修正记录AI 会在后续对话中自动读取这些记忆越来越懂你。8.5 多模型切换 /model # 选择 Opus最强推理复杂任务 # 选择 Sonnet平衡速度和质量日常使用 # 选择 Haiku最快速度简单任务建议写代码、改 Bug用Sonnet架构设计、复杂重构用Opus简单查询、格式化用Haiku九、费用说明方案价格适用人群Claude Pro$20/月个人开发者日常轻度使用Claude Max 5x$100/月重度使用每天大量交互Claude Max 20x$200/月专业团队极限使用量API 按量按 Token 计费灵活使用按需付费白嫖党小技巧用/compact压缩上下文节省 Token简单任务切到 Haiku 模型善用 CLAUDE.md 减少重复解释十、常见问题FAQQ1和 GitHub Copilot 有什么区别Copilot 是代码补全写下一行Claude Code 是任务执行完成整个需求。两者可以互补使用。Q2支持哪些 IDEClaude Code 是终端工具可以在 VS Code、JetBrains 等 IDE 的终端中使用。Anthropic 也提供了 VS Code 和 JetBrains 插件。Q3代码会上传到哪里安全吗代码通过加密传输到 Anthropic 服务器处理。对于敏感项目建议使用 API 方式并确认数据使用政策或关注企业版方案。Q4Windows 上能用吗可以。推荐通过WSL2使用或直接安装 Windows 原生版本winget。Q5国内怎么用个人用户代理 官方 API或使用 API 中转站企业用户联系 Anthropic 企业方案Q6能离线使用吗不能Claude Code 需要联网调用云端模型。十一、总结Claude Code 代表了 AI 编程工具从辅助到代理的转变。它不能替代程序员的思考和判断但能大幅减少重复劳动让你把精力花在真正重要的事情上。推荐学习路线第 1 天安装 首次对话 /init生成 CLAUDE.md第 1 周在日常开发中逐步使用从小任务开始第 2 周尝试让它处理完整的功能开发第 1 月配置 MCP 扩展、自定义 Skills、完善 CLAUDE.md用好 Claude Code 的关键不在工具本身而在于你如何描述需求和提供上下文。最后送一句话AI 不会取代程序员但会用 AI 的程序员会取代不会用的。参考资源Claude Code 官方文档awesome-claude-code-tutorial — 中文系统教程claude-code-chinese/claude-code-guide — 国内使用指南Claude Code 阿里云社区全攻略本文写于 2026 年 6 月Claude Code 版本 2.x如有更新请以官方文档为准。
【AI工具】Claude Code 终极教程：从入门到精通，让 AI 帮你写代码（2026 最新版）
发布时间：2026/6/8 8:15:09
一、什么是 Claude CodeClaude Code 是Anthropic推出的终端 AI 编程助手核心特点特性说明终端原生直接在终端运行无缝融入你的开发工作流Agent 能力不只是回答问题能直接编辑文件、执行命令、操作 Git超长上下文200K Token能读完整个代码库多语言支持40 编程语言包括前端、后端、移动端、数据科学工具调用可调用 npm、git、curl 等外部工具一句话总结Copilot 只能帮你补全代码Claude Code 能帮你完成整个开发任务。二、安装指南2.1 前置条件要求说明操作系统macOS 10.15 / Ubuntu 20.04 / Windows 10推荐 WSL2网络需要访问 Anthropic 服务国内需代理或 API 中转账号Claude.ai 账号 或 Anthropic API Key2.2 安装方式方式一官方原生安装推荐无需 Node.jsmacOS / Linux / WSLcurl -fsSL https://claude.ai/install.sh | bashWindows PowerShellirm https://claude.ai/install.ps1 | iexmacOS Homebrewbrew install --cask claude-codeWindows WinGetwinget install Anthropic.ClaudeCode方式二npm 安装# 确保已安装 Node.js 18 npm install -g anthropic-ai/claude-code验证安装claude --version # 输出: Claude Code v2.x.x三、配置与首次启动3.1 API Key 配置创建或编辑~/.claude/settings.json{ env: { ANTHROPIC_API_KEY: sk-ant-xxxxxxxxxxxxx, ANTHROPIC_BASE_URL: https://api.anthropic.com } }3.2 国内用户特别注意由于 Anthropic 限制了中国大陆的直接访问国内开发者有两种方案方案 AAPI 中转站推荐使用第三方 API 中转服务将ANTHROPIC_BASE_URL替换为中转站地址{ env: { ANTHROPIC_API_KEY: 你的中转站Key, ANTHROPIC_BASE_URL: https://api.yixia.ai } }方案 B代理 官方 API在终端开启代理后直接使用官方 API# 设置代理根据你的代理工具修改端口 export https_proxyhttp://127.0.0.1:7890 export http_proxyhttp://127.0.0.1:78903.3 首次启动cd 你的项目目录 claude首次启动会引导你完成 OAuth 认证或 API Key 配置跟着提示走就行。启动成功后你会看到这样的交互界面 claude Claude Code v2.x.x Type /help for available commands. _四、基础使用4.1 第一个对话进入 Claude Code 后直接用自然语言描述需求即可 帮我看看这个项目的目录结构简述主要模块 这个 utils.ts 里的 calculatePrice 函数干了什么 给这段代码加上类型注解4.2 核心工作流一个标准的 Claude Code 使用流程描述需求→ 帮我用 React 写一个带搜索功能的表格组件AI 分析代码库→ Claude 会读取项目文件理解你的技术栈生成方案→ 告诉你要创建哪些文件、修改哪些代码执行操作→ 自动创建文件、写入代码验证结果→ 运行测试或启动项目检查效果4.3 权限模式Claude Code 有三种权限模式按需切换模式说明适用场景普通模式文件操作和命令执行需你确认谨慎操作、第一次使用自动接受模式自动执行所有操作熟悉的项目、高效开发Plan 模式只生成计划不写代码复杂需求先讨论方案再动手关闭自动确认以提高效率 从今以后不要再问我确认所有的操作直接执行五、核心命令速查5.1 斜杠命令Slash Commands命令功能/help查看帮助/init初始化项目 CLAUDE.md/model切换模型Opus / Sonnet / Haiku/compact压缩上下文节省 Token/undo撤销上一步修改/cost查看当前会话费用/clear清空对话历史/doctor诊断配置问题/status查看当前会话状态/add-dir添加工作目录/permissions管理权限设置5.2 快捷键快捷键功能Ctrl R搜索历史命令Ctrl L清屏Esc打断当前 AI 操作Shift Enter输入多行内容文件名快速引用文件↑ / ↓浏览历史命令5.3 快捷引用文件 src/components/Table.tsx 帮我把这个组件改成虚拟滚动 package.json 看看有哪些依赖可以升级六、CLAUDE.md——让 AI 真正懂你的项目这是 Claude Code 最容易被忽视但最有价值的功能。6.1 什么是 CLAUDE.mdCLAUDE.md是放在项目根目录的 Markdown 文件Claude Code 在每次对话时都会自动读取它。你可以在里面写项目的技术栈和架构说明编码规范和命名约定常用的命令和脚本注意事项和踩过的坑6.2 自动生成 /initClaude Code 会扫描你的整个项目自动生成一份高质量的 CLAUDE.md。6.3 手动编写参考# CLAUDE.md ## 项目概述 这是一个基于 Next.js 14 的电商后台管理系统。 ## 技术栈 - 框架Next.js 14 (App Router) - 语言TypeScript 5.x - UI 库Ant Design 5.x - 状态管理Zustand - 请求库TanStack Query ## 编码规范 - 组件名使用 PascalCase - 文件名使用 kebab-case - API 路由放在 app/api/ 下 - 使用 TypeScript 严格模式禁止 any ## 常用命令 - 开发pnpm dev - 构建pnpm build - 测试pnpm test - 类型检查pnpm type-check ## 注意事项 - 图片资源统一放在 public/images/ - 环境变量使用 NEXT_PUBLIC_ 前缀才能在客户端访问 - 不要直接修改 .prisma 文件统一通过 migration 管理写好 CLAUDE.md 后AI 的代码质量会有质的飞跃。七、实战场景场景一快速读懂陌生项目 我刚接手这个项目帮我梳理整体架构Claude Code 会扫描项目结构、package.json、关键配置文件生成一份清晰的项目地图。场景二批量修复 Lint 错误 帮我看看 ESLint 报的错全部帮我修掉它会逐个分析并修复比你自己手动改快 10 倍。场景三添加新功能 帮我给用户列表页加一个按角色筛选的功能角色数据从 /api/roles 接口获取Claude Code 会找到用户列表组件分析现有代码风格添加筛选 UI 和数据请求逻辑符合项目现有的编码规范场景四代码重构 把这个 class 组件改成函数组件 Hooks 的写法 把这里的 axios 调用统一改成我们项目用的 request 封装场景五写单元测试 给 src/utils/format.ts 里的所有函数写单元测试场景六Debug直接粘贴报错信息 Uncaught TypeError: Cannot read properties of undefined (reading map) 在 Dashboard.tsx 第 45 行 帮我修复Claude Code 会定位问题、分析原因、给出修复方案。八、进阶技巧8.1 自定义 Skills技能在~/.claude/目录下创建自定义技能让 AI 执行特定领域的任务。例如创建~/.claude/skills/review.md# Code Review Skill 当我说 /review 时请按照以下标准审查代码 1. 是否有安全漏洞XSS、SQL注入、越权 2. 是否有性能问题不必要的重渲染、内存泄漏 3. 错误处理是否完善 4. 是否符合项目的编码规范8.2 MCP 扩展通过 MCPModel Context Protocol集成外部工具 帮我在 GitHub 上创建一个 PR 看看 Jira 上分配给的我 Bug 单 从 Figma 设计稿生成对应的 CSS配置 MCP 服务器在~/.claude/mcp.json{ mcpServers: { github: { command: npx, args: [-y, anthropic-ai/mcp-server-github] } } }8.3 Hooks钩子在~/.claude/settings.json中配置 Hook在执行前后自动触发操作{ hooks: { PreToolUse: [ { matcher: Bash, command: echo \即将执行命令...\ } ] } }8.4 内存/记忆系统Claude Code 支持持久记忆在~/.claude/projects/目录下保存你的个人偏好项目的上下文信息反馈和修正记录AI 会在后续对话中自动读取这些记忆越来越懂你。8.5 多模型切换 /model # 选择 Opus最强推理复杂任务 # 选择 Sonnet平衡速度和质量日常使用 # 选择 Haiku最快速度简单任务建议写代码、改 Bug用Sonnet架构设计、复杂重构用Opus简单查询、格式化用Haiku九、费用说明方案价格适用人群Claude Pro$20/月个人开发者日常轻度使用Claude Max 5x$100/月重度使用每天大量交互Claude Max 20x$200/月专业团队极限使用量API 按量按 Token 计费灵活使用按需付费白嫖党小技巧用/compact压缩上下文节省 Token简单任务切到 Haiku 模型善用 CLAUDE.md 减少重复解释十、常见问题FAQQ1和 GitHub Copilot 有什么区别Copilot 是代码补全写下一行Claude Code 是任务执行完成整个需求。两者可以互补使用。Q2支持哪些 IDEClaude Code 是终端工具可以在 VS Code、JetBrains 等 IDE 的终端中使用。Anthropic 也提供了 VS Code 和 JetBrains 插件。Q3代码会上传到哪里安全吗代码通过加密传输到 Anthropic 服务器处理。对于敏感项目建议使用 API 方式并确认数据使用政策或关注企业版方案。Q4Windows 上能用吗可以。推荐通过WSL2使用或直接安装 Windows 原生版本winget。Q5国内怎么用个人用户代理 官方 API或使用 API 中转站企业用户联系 Anthropic 企业方案Q6能离线使用吗不能Claude Code 需要联网调用云端模型。十一、总结Claude Code 代表了 AI 编程工具从辅助到代理的转变。它不能替代程序员的思考和判断但能大幅减少重复劳动让你把精力花在真正重要的事情上。推荐学习路线第 1 天安装 首次对话 /init生成 CLAUDE.md第 1 周在日常开发中逐步使用从小任务开始第 2 周尝试让它处理完整的功能开发第 1 月配置 MCP 扩展、自定义 Skills、完善 CLAUDE.md用好 Claude Code 的关键不在工具本身而在于你如何描述需求和提供上下文。最后送一句话AI 不会取代程序员但会用 AI 的程序员会取代不会用的。参考资源Claude Code 官方文档awesome-claude-code-tutorial — 中文系统教程claude-code-chinese/claude-code-guide — 国内使用指南Claude Code 阿里云社区全攻略本文写于 2026 年 6 月Claude Code 版本 2.x如有更新请以官方文档为准。
