快速入门指南
欢迎使用 Claude Code!本指南将在几分钟内让你上手 AI 驱动的编程辅助。
开始之前
确保你已准备好:
第一步:安装 Claude Code
选择适合你的安装方式:
原生安装(推荐)
macOS / Linux / WSL:
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell:
irm https://claude.ai/install.ps1 | iexHomebrew
brew install --cask claude-codeNPM(需要 Node.js 18+)
npm install -g @anthropic-ai/claude-code第二步:登录账户
Claude Code 需要账户才能使用。首次使用时需要登录:
claude# 首次使用时会提示登录
/login# 按提示登录你的账户
支持的账户类型:
提示:登录后,你的凭证会保存在系统中,无需再次登录。首次使用 Claude Console 账户认证时, 会自动创建名为"Claude Code"的工作区,用于集中管理和追踪使用成本。
第三步:启动第一次会话
在任何项目目录中打开终端并启动 Claude Code:
cd /path/to/your/projectclaude你会看到 Claude Code 欢迎屏幕,显示会话信息、最近的对话和最新更新。 输入 /help 查看可用命令, 或输入 /resume 继续之前的对话。
第四步:提出第一个问题
让我们从了解你的代码库开始。尝试以下命令:
> 这个项目是做什么的?Claude 会分析文件并提供摘要
> 这个项目使用了哪些技术?获取技术栈信息
> 主入口点在哪里?找到应用的入口文件
> 解释一下文件夹结构了解项目组织方式
你也可以询问 Claude 关于它自己的能力:
> Claude Code 能做什么?> 如何在 Claude Code 中使用斜杠命令?> Claude Code 可以和 Docker 一起工作吗?第五步:做出第一次代码变更
现在让 Claude Code 做一些实际的编程工作。尝试一个简单任务:
> 在主文件中添加 hello world 函数Claude Code 会:
注意:Claude Code 在修改文件前总是会请求许可。你可以批准单个变更,或者为会话启用"全部接受"模式。
第六步:使用 Git 操作
Claude Code 让 Git 操作变得像对话一样简单:
> 我修改了哪些文件?查看当前变更
> 提交我的变更并写一个描述性的提交信息创建 Git 提交
> 创建一个名为 feature/quickstart 的新分支创建并切换分支
> 显示最近 5 次提交查看提交历史
> 帮我解决合并冲突处理冲突
第七步:修复 Bug 或添加功能
Claude 擅长调试和功能实现。用自然语言描述你想要的:
添加功能
> 为用户注册表单添加输入验证修复 Bug
> 有一个 bug,用户可以提交空表单 - 修复它Claude Code 会:
第八步:尝试其他常见工作流程
有很多与 Claude 一起工作的方式:
重构代码
> 将认证模块重构为使用 async/await 而不是回调编写测试
> 为计算器函数编写单元测试更新文档
> 更新 README 添加安装说明代码审查
> 审查我的变更并提出改进建议记住:Claude Code 是你的 AI 结对程序员。像和有用的同事交流一样与它对话 - 描述你想要实现的目标,它会帮你达成。
常用命令
| 命令 | 作用 | 示例 |
|---|---|---|
claude | 启动交互模式 | claude |
claude "task" | 运行一次性任务 | claude "修复构建错误" |
claude -p "query" | 运行一次性查询后退出 | claude -p "解释这个函数" |
claude -c | 继续当前目录最近的对话 | claude -c |
claude -r | 恢复之前的对话 | claude -r |
claude commit | 创建 Git 提交 | claude commit |
/clear | 清除对话历史 | > /clear |
/help | 显示可用命令 | > /help |
exit 或 Ctrl+C | 退出 Claude Code | > exit |
新手专业技巧
具体明确你的请求
❌ 不要这样
修复这个 bug
✓ 试试这样
修复登录 bug,用户输入错误凭证后看到空白屏幕
使用分步指示
让 Claude 先探索
使用快捷键节省时间
下一步
现在你已经掌握了基础知识,探索更多高级功能:
常见工作流程
常见任务的分步指南
CLI 参考
掌握所有命令和选项
配置
自定义 Claude Code 工作流
Web 版 Claude Code
在云端异步运行任务