Claude Code 入门教程——从零安装到独立完成项目2026最新版作者导读Claude Code 是 Anthropic 推出的终端级 AI 编程助手它能直接在你的项目目录中通过自然语言完成代码编写、重构、调试和测试。本文面向零基础开发者从安装配置到独立完成项目手把手带你掌握这个AI 结对编程神器。预计阅读时间 30 分钟建议配合实操练习。一、Claude Code 是什么Claude Code 是Anthropic开发的终端 AI 编程工具它把 Claude 大模型的能力直接嵌入到你的开发工作流中。核心特点特性说明终端原生直接在命令行中运行无需切换窗口项目感知自动读取项目结构、配置文件、依赖关系代码操作可以创建、修改、删除文件运行测试自然语言用中文/英文描述需求AI 自动实现安全可控所有文件修改都需要你确认不会擅自破坏代码适用场景代码重构、Bug 修复、新功能开发、代码审查、自动化测试、文档生成等。Claude Code 的终端界面示意二、环境准备与安装2.1 前置要求在开始之前请确保你的环境满足以下条件要求说明Claude 订阅至少需要Claude Pro订阅操作系统macOS、Linux 或 Windows 11WSL2Node.js版本 18npm 安装方式需要终端Terminal.appmacOS、Windows Terminal 或 Linux 终端2.2 安装 Claude Code打开终端执行以下命令# 方式一通过 npm 全局安装推荐npminstall-ganthropic-ai/claude-code# 方式二通过官方脚本安装curl-fsSLhttps://claude.ai/install.sh|sh2.3 验证安装claude--version如果看到版本号输出如2.1.169说明安装成功。如果出现command not found请检查 Node.js 的 bin 目录是否已添加到 PATH 中。2.4 首次登录claude首次运行会提示你登录 Anthropic 账号按提示完成授权即可。三、三种使用模式详解Claude Code 提供三种使用模式适合不同场景模式启动方式特点适用场景生活类比交互模式claude连续对话保持上下文日常开发、复杂任务打电话聊天单次执行claude prompt执行一次就退出脚本自动化、快速查询发短信问问题打印模式claude -p prompt只输出纯文本结果管道处理、数据转换只要答案不要废话选择决策树你要做什么 │ ├── 需要多轮对话 │ ├── 是 → 交互模式 (claude) │ └── 否 ↓ │ ├── 需要在脚本中使用 │ ├── 是 → 单次执行 (claude prompt) │ └── 否 ↓ │ └── 需要把输出传给其他命令 ├── 是 → 打印模式 (claude -p prompt) └── 否 → 交互模式 (claude)3.1 交互模式实战进入项目目录启动 Claude Codecd~/projects/my-app claude第一次对话测试You: 你好介绍一下你自己 Claude: 你好我是 Claude CodeAnthropic 开发的 AI 编程助手。 我可以帮你 - 编写和修改代码 - 解释代码逻辑 - 修复 Bug - 重构项目 - 搜索文件 - 运行命令 ... 有什么我可以帮助你的吗创建第一个文件You: 创建一个 hello.py 文件内容是打印 Hello Claude CodeClaude 会请求你确认创建文件按回车确认后文件创建成功。验证cathello.py# 输出: print(Hello Claude Code)3.2 退出交互模式You: /exit或使用快捷键macOS/LinuxCtrl DWindowsCtrl Z然后回车四、核心命令大全30 个 Slash 命令Claude Code 的所有内置命令都以/开头在交互模式下输入。4.1 基础控制命令命令作用示例/help显示所有可用命令/help/exit退出交互模式/exit/clear清空对话历史保留 CLAUDE.md/clear/compact压缩对话节省 Token/compact4.2 上下文管理命令命令作用示例/model切换 AI 模型/model claude-opus-4-6/effort调整推理深度/effort xhigh/voice语音模式按住空格说话/voice/context查看当前 Token 使用量/context三种模型对比模型速度能力成本上下文窗口适用场景Haiku最快基础最低200K简单任务、快速查询Sonnet中等强大中等200K日常开发推荐Opus较慢最强最高1M复杂任务、关键决策推荐日常开发用Sonnet关键架构决策用Opus简单查询用Haiku省钱。4.3 会话管理命令命令作用示例/resume恢复之前的会话/resume/export导出对话为文本文件/export ./notes.md/rename重命名当前会话/rename auth-module4.4 项目配置命令命令作用示例/init初始化项目配置创建 CLAUDE.md/init/memory编辑项目记忆文件/memory/config打开统一设置界面/config4.5 开发辅助命令命令作用示例/security-review安全审查当前代码改动/security-review/agents管理子代理/agents/plan规划模式复杂任务分解/plan4.6 诊断命令命令作用示例/doctor系统健康检查/doctor/status查看完整状态信息/status/usage查看使用量统计/usage五、高效输入技巧5.1 快捷输入符号前缀作用示例文件路径自动补全分析 src/app.js 的代码结构!直接执行 bash 命令! git status#快速添加项目规范到记忆# 本项目使用 pnpm 而不是 npm5.2 多行输入方法方法快捷键兼容性反斜杠换行\ Enter所有终端macOS 默认Option EntermacOS配置后Shift Enter需运行/terminal-setup控制序列Ctrl J所有终端5.3 快捷键速查表快捷键作用Ctrl C取消当前输入或生成Ctrl D退出 Claude CodeCtrl L清除终端屏幕Ctrl O切换详细输出Ctrl R反向搜索历史命令Esc Esc打开 Rewind 回退菜单Tab切换 Extended ThinkingOption P/Alt P切换 AI 模型六、项目实战从零搭建一个 Todo List CLI 工具6.1 第一步创建项目并初始化mkdir~/projects/todo-clicd~/projects/todo-cli claude6.2 第二步初始化项目配置You: /initClaude 会分析项目结构并创建CLAUDE.md这是项目的说明书告诉 Claude 项目规则。6.3 第三步用自然语言实现功能You: 帮我创建一个 Todo List CLI 工具要求 1. 使用 Python 编写 2. 支持添加、删除、列出、标记完成待办事项 3. 数据存储在本地 JSON 文件 4. 有命令行参数解析 5. 包含基本的错误处理Claude 会列出变更计划创建文件如todo.py询问你是否确认按回车确认后代码自动生成。6.4 第四步运行和测试You: ! python todo.py --help You: ! python todo.py add 学习 Claude Code You: ! python todo.py list6.5 第五步Bug 修复如果运行报错直接让 Claude 修复You: 运行测试如果有失败的用例请分析原因并修复Claude 会自动调用测试脚本读取错误栈定位 Bug 并修复。6.6 第六步代码审查You: /security-reviewClaude 会围绕认证、注入、越权、敏感信息暴露等问题审查代码。6.7 第七步导出会话记录You: /export ./docs/development-log.md七、日常开发工作流推荐的每日流程# 1. 早上恢复昨天的会话$ claude-c# 2. 检查状态You: /status# 3. 开始工作You: 我今天要完成用户认证模块# 4. 工作过程中定期检查 Token 使用You: /context# 5. Token 使用超过 60% 时压缩You: /compact# 6. 完成重要功能后导出对话You: /export ~/docs/auth-implementation.md# 7. 下班前重命名会话You: /rename auth-module-day2八、省钱技巧技巧节省比例简单问题不用 Extended Thinking~70%定期使用/compact40-60%完成任务后用/clear100%重置上下文使用 Sonnet 而非 Opus~80%简洁描述需求~30%模型选择策略# 简单任务用 Haiku最便宜You: /model claude-haiku-4-5-20251001 You: 这个函数是什么意思# 日常开发用 Sonnet性价比最高You: /model claude-sonnet-4-6 You: 帮我重构这个模块# 关键决策用 Opus最强You: /model claude-opus-4-6 You: 设计这个系统的架构九、配置别名提高效率macOS/Linux添加到~/.bashrc或~/.zshrc# 快速启动跳过权限确认aliasccclaude --dangerously-skip-permissions# 恢复最近会话aliascrclaude -c# 调试模式aliasccvclaude --verbose# 使用 Opusaliasccoclaude --model claude-opus-4-6Windows PowerShell添加到$PROFILEfunctioncc{claude--dangerously-skip-permissions}functioncr{claude-c}functionccv{claude--verbose}十、常见问题 FAQQ1: 会话突然中断怎么办会话自动保存直接恢复claude-cQ2: 怎么看 Claude 在做什么启用详细输出# 启动时启用claude--verbose# 运行时切换Ctrl OQ3: 怎么取消正在执行的操作按Ctrl C中断。Q4: 怎么更新 Claude Code# 在终端运行claude update# 或使用 npm 更新npmupdate-ganthropic-ai/claude-codeQ5: 配置文件在哪里文件位置作用CLAUDE.md项目根目录项目配置.mcp.json项目根目录MCP 服务器配置~/.claude/用户目录全局配置~/.claude/commands/用户目录个人 Slash 命令十一、从零到独立项目学习路线图阶段内容预计时间1. 环境搭建安装 Node.js、Claude Code、配置 API Key30 分钟2. 基础交互启动交互模式、第一次对话、三种模式实践1 小时3. 核心命令掌握 10 个 Slash 命令、文件引用、模型切换2 小时4. 项目实战创建 CLAUDE.md、自然语言实现功能、代码审查3 小时5. 效率提升配置别名、Rewind 回退、Hooks 自动化、MCP 集成2 小时6. 独立项目从零搭建完整项目、多文件协作、自动化测试2 小时推荐练手项目Todo List CLI 工具简易博客系统API 接口文档生成器代码统计工具自动化部署脚本十二、总结通过本文你已经掌握了Claude Code 的安装与配置三种使用模式的区别与选择30 个 Slash 命令的使用高效快捷键操作完整的项目实战流程日常开发工作流与省钱技巧记住最好的学习方式是实践打开 Claude Code从一个小项目开始逐步熟悉它的工作方式。参考资源Claude Code 官方文档GitHub 仓库老金的 Claude Code 基础使用完整指南标签Claude CodeAI编程终端工具Anthropic代码助手入门教程零基础版本信息本文基于 Claude Code v2.1.1692026年6月编写
Claude Code 入门教程——从零安装到独立完成项目（2026最新版）
Claude Code 入门教程——从零安装到独立完成项目2026最新版作者导读Claude Code 是 Anthropic 推出的终端级 AI 编程助手它能直接在你的项目目录中通过自然语言完成代码编写、重构、调试和测试。本文面向零基础开发者从安装配置到独立完成项目手把手带你掌握这个AI 结对编程神器。预计阅读时间 30 分钟建议配合实操练习。一、Claude Code 是什么Claude Code 是Anthropic开发的终端 AI 编程工具它把 Claude 大模型的能力直接嵌入到你的开发工作流中。核心特点特性说明终端原生直接在命令行中运行无需切换窗口项目感知自动读取项目结构、配置文件、依赖关系代码操作可以创建、修改、删除文件运行测试自然语言用中文/英文描述需求AI 自动实现安全可控所有文件修改都需要你确认不会擅自破坏代码适用场景代码重构、Bug 修复、新功能开发、代码审查、自动化测试、文档生成等。Claude Code 的终端界面示意二、环境准备与安装2.1 前置要求在开始之前请确保你的环境满足以下条件要求说明Claude 订阅至少需要Claude Pro订阅操作系统macOS、Linux 或 Windows 11WSL2Node.js版本 18npm 安装方式需要终端Terminal.appmacOS、Windows Terminal 或 Linux 终端2.2 安装 Claude Code打开终端执行以下命令# 方式一通过 npm 全局安装推荐npminstall-ganthropic-ai/claude-code# 方式二通过官方脚本安装curl-fsSLhttps://claude.ai/install.sh|sh2.3 验证安装claude--version如果看到版本号输出如2.1.169说明安装成功。如果出现command not found请检查 Node.js 的 bin 目录是否已添加到 PATH 中。2.4 首次登录claude首次运行会提示你登录 Anthropic 账号按提示完成授权即可。三、三种使用模式详解Claude Code 提供三种使用模式适合不同场景模式启动方式特点适用场景生活类比交互模式claude连续对话保持上下文日常开发、复杂任务打电话聊天单次执行claude prompt执行一次就退出脚本自动化、快速查询发短信问问题打印模式claude -p prompt只输出纯文本结果管道处理、数据转换只要答案不要废话选择决策树你要做什么 │ ├── 需要多轮对话 │ ├── 是 → 交互模式 (claude) │ └── 否 ↓ │ ├── 需要在脚本中使用 │ ├── 是 → 单次执行 (claude prompt) │ └── 否 ↓ │ └── 需要把输出传给其他命令 ├── 是 → 打印模式 (claude -p prompt) └── 否 → 交互模式 (claude)3.1 交互模式实战进入项目目录启动 Claude Codecd~/projects/my-app claude第一次对话测试You: 你好介绍一下你自己 Claude: 你好我是 Claude CodeAnthropic 开发的 AI 编程助手。 我可以帮你 - 编写和修改代码 - 解释代码逻辑 - 修复 Bug - 重构项目 - 搜索文件 - 运行命令 ... 有什么我可以帮助你的吗创建第一个文件You: 创建一个 hello.py 文件内容是打印 Hello Claude CodeClaude 会请求你确认创建文件按回车确认后文件创建成功。验证cathello.py# 输出: print(Hello Claude Code)3.2 退出交互模式You: /exit或使用快捷键macOS/LinuxCtrl DWindowsCtrl Z然后回车四、核心命令大全30 个 Slash 命令Claude Code 的所有内置命令都以/开头在交互模式下输入。4.1 基础控制命令命令作用示例/help显示所有可用命令/help/exit退出交互模式/exit/clear清空对话历史保留 CLAUDE.md/clear/compact压缩对话节省 Token/compact4.2 上下文管理命令命令作用示例/model切换 AI 模型/model claude-opus-4-6/effort调整推理深度/effort xhigh/voice语音模式按住空格说话/voice/context查看当前 Token 使用量/context三种模型对比模型速度能力成本上下文窗口适用场景Haiku最快基础最低200K简单任务、快速查询Sonnet中等强大中等200K日常开发推荐Opus较慢最强最高1M复杂任务、关键决策推荐日常开发用Sonnet关键架构决策用Opus简单查询用Haiku省钱。4.3 会话管理命令命令作用示例/resume恢复之前的会话/resume/export导出对话为文本文件/export ./notes.md/rename重命名当前会话/rename auth-module4.4 项目配置命令命令作用示例/init初始化项目配置创建 CLAUDE.md/init/memory编辑项目记忆文件/memory/config打开统一设置界面/config4.5 开发辅助命令命令作用示例/security-review安全审查当前代码改动/security-review/agents管理子代理/agents/plan规划模式复杂任务分解/plan4.6 诊断命令命令作用示例/doctor系统健康检查/doctor/status查看完整状态信息/status/usage查看使用量统计/usage五、高效输入技巧5.1 快捷输入符号前缀作用示例文件路径自动补全分析 src/app.js 的代码结构!直接执行 bash 命令! git status#快速添加项目规范到记忆# 本项目使用 pnpm 而不是 npm5.2 多行输入方法方法快捷键兼容性反斜杠换行\ Enter所有终端macOS 默认Option EntermacOS配置后Shift Enter需运行/terminal-setup控制序列Ctrl J所有终端5.3 快捷键速查表快捷键作用Ctrl C取消当前输入或生成Ctrl D退出 Claude CodeCtrl L清除终端屏幕Ctrl O切换详细输出Ctrl R反向搜索历史命令Esc Esc打开 Rewind 回退菜单Tab切换 Extended ThinkingOption P/Alt P切换 AI 模型六、项目实战从零搭建一个 Todo List CLI 工具6.1 第一步创建项目并初始化mkdir~/projects/todo-clicd~/projects/todo-cli claude6.2 第二步初始化项目配置You: /initClaude 会分析项目结构并创建CLAUDE.md这是项目的说明书告诉 Claude 项目规则。6.3 第三步用自然语言实现功能You: 帮我创建一个 Todo List CLI 工具要求 1. 使用 Python 编写 2. 支持添加、删除、列出、标记完成待办事项 3. 数据存储在本地 JSON 文件 4. 有命令行参数解析 5. 包含基本的错误处理Claude 会列出变更计划创建文件如todo.py询问你是否确认按回车确认后代码自动生成。6.4 第四步运行和测试You: ! python todo.py --help You: ! python todo.py add 学习 Claude Code You: ! python todo.py list6.5 第五步Bug 修复如果运行报错直接让 Claude 修复You: 运行测试如果有失败的用例请分析原因并修复Claude 会自动调用测试脚本读取错误栈定位 Bug 并修复。6.6 第六步代码审查You: /security-reviewClaude 会围绕认证、注入、越权、敏感信息暴露等问题审查代码。6.7 第七步导出会话记录You: /export ./docs/development-log.md七、日常开发工作流推荐的每日流程# 1. 早上恢复昨天的会话$ claude-c# 2. 检查状态You: /status# 3. 开始工作You: 我今天要完成用户认证模块# 4. 工作过程中定期检查 Token 使用You: /context# 5. Token 使用超过 60% 时压缩You: /compact# 6. 完成重要功能后导出对话You: /export ~/docs/auth-implementation.md# 7. 下班前重命名会话You: /rename auth-module-day2八、省钱技巧技巧节省比例简单问题不用 Extended Thinking~70%定期使用/compact40-60%完成任务后用/clear100%重置上下文使用 Sonnet 而非 Opus~80%简洁描述需求~30%模型选择策略# 简单任务用 Haiku最便宜You: /model claude-haiku-4-5-20251001 You: 这个函数是什么意思# 日常开发用 Sonnet性价比最高You: /model claude-sonnet-4-6 You: 帮我重构这个模块# 关键决策用 Opus最强You: /model claude-opus-4-6 You: 设计这个系统的架构九、配置别名提高效率macOS/Linux添加到~/.bashrc或~/.zshrc# 快速启动跳过权限确认aliasccclaude --dangerously-skip-permissions# 恢复最近会话aliascrclaude -c# 调试模式aliasccvclaude --verbose# 使用 Opusaliasccoclaude --model claude-opus-4-6Windows PowerShell添加到$PROFILEfunctioncc{claude--dangerously-skip-permissions}functioncr{claude-c}functionccv{claude--verbose}十、常见问题 FAQQ1: 会话突然中断怎么办会话自动保存直接恢复claude-cQ2: 怎么看 Claude 在做什么启用详细输出# 启动时启用claude--verbose# 运行时切换Ctrl OQ3: 怎么取消正在执行的操作按Ctrl C中断。Q4: 怎么更新 Claude Code# 在终端运行claude update# 或使用 npm 更新npmupdate-ganthropic-ai/claude-codeQ5: 配置文件在哪里文件位置作用CLAUDE.md项目根目录项目配置.mcp.json项目根目录MCP 服务器配置~/.claude/用户目录全局配置~/.claude/commands/用户目录个人 Slash 命令十一、从零到独立项目学习路线图阶段内容预计时间1. 环境搭建安装 Node.js、Claude Code、配置 API Key30 分钟2. 基础交互启动交互模式、第一次对话、三种模式实践1 小时3. 核心命令掌握 10 个 Slash 命令、文件引用、模型切换2 小时4. 项目实战创建 CLAUDE.md、自然语言实现功能、代码审查3 小时5. 效率提升配置别名、Rewind 回退、Hooks 自动化、MCP 集成2 小时6. 独立项目从零搭建完整项目、多文件协作、自动化测试2 小时推荐练手项目Todo List CLI 工具简易博客系统API 接口文档生成器代码统计工具自动化部署脚本十二、总结通过本文你已经掌握了Claude Code 的安装与配置三种使用模式的区别与选择30 个 Slash 命令的使用高效快捷键操作完整的项目实战流程日常开发工作流与省钱技巧记住最好的学习方式是实践打开 Claude Code从一个小项目开始逐步熟悉它的工作方式。参考资源Claude Code 官方文档GitHub 仓库老金的 Claude Code 基础使用完整指南标签Claude CodeAI编程终端工具Anthropic代码助手入门教程零基础版本信息本文基于 Claude Code v2.1.1692026年6月编写
