Claude Code 是 Anthropic 推出的 AI 编程助手，直接在你的终端里运行，能读写文件、执行命令、理解整个代码库。本文带你从零开始，30 分钟真正上手。
前提条件
- 电脑上有终端（macOS/Linux 自带，Windows 用 PowerShell 或 WSL2）
- 有一个代码项目（没有也可以，让 Claude Code 帮你新建）
- claude.com 账号（免费注册，Pro $20/月解锁完整功能）
第一步：安装
macOS / Linux：
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell（管理员）：
irm https://claude.ai/install.ps1 | iexHomebrew（macOS）：
brew install --cask claude-code安装完成后验证：
claude --version
# 输出类似：Claude Code 1.x.x第二步：登录
claude /login浏览器会自动打开 claude.com 的授权页面，点击「允许」即可。登录后终端显示「Logged in as your@email.com」。
也可以用 API Key 登录（适合服务器环境）：
export ANTHROPIC_API_KEY=sk-ant-你的key
# 从 console.anthropic.com 生成 API Key第三步：进入项目目录，启动 Claude Code
cd /path/to/your/project
claude你会看到交互界面：
Claude Code (claude-sonnet-4-5)
Type your message, or /help for commands
>
第四步：第一次对话
先让 Claude Code 了解你的项目：
介绍一下这个项目的结构和主要功能
Claude Code 会自动读取文件，给你一个概览。不需要你手动告诉它哪些文件在哪里。
第五步：修改代码
试试让它做一个简单的改动：
在 README.md 的开头加一行：「本项目使用 Claude Code 辅助开发」
Claude Code 会：
- 读取 README.md
- 显示要做的改动（差异预览）
- 询问你是否确认
- 执行修改
第一次会弹出权限确认，选择「Allow」或「Always allow for this session」。
第六步：执行命令
运行项目的单元测试，告诉我哪些通过了，哪些失败了
Claude Code 会自动执行 npm test 或 pytest 等命令，读取输出，给你分析结果。
第七步：Git 操作
把刚才的修改提交到 git，写一个规范的 commit message
Claude Code 会执行 git add、git commit，并自动根据改动内容生成 commit message。
第八步：设置 CLAUDE.md（让它记住项目规范）
在项目根目录创建 CLAUDE.md：
# 让 Claude Code 自动生成为这个项目创建一个 CLAUDE.md 文件，记录：
1. 项目的主要技术栈
2. 常用命令（启动、测试、构建）
3. 代码风格规范
4. 注意事项
以后每次启动 Claude Code，它都会自动读取这个文件，了解项目背景。
常用斜杠命令速查
/help # 查看所有命令
/status # 查看当前会话状态（上下文用量）
/compact # 压缩上下文（对话变长时用）
/clear # 清空对话历史，重新开始
/model # 切换 AI 模型（sonnet/opus/haiku）
/memory # 查看和编辑长期记忆
/ide # 连接 VS Code 或 JetBrains IDE
/login # 重新登录快捷键
Ctrl+C # 中断当前操作
Shift+Tab # 切换到 Plan Mode（规划模式，不执行只规划）
方向键上/下 # 浏览历史命令
三个新手最常犯的错误
1. 任务描述太模糊
差：优化代码
好：优化 src/api/users.py 里的数据库查询，减少不必要的 SQL 请求
2. 上下文超限不处理
对话很长后响应质量下降，这时要用 /compact 压缩或 /clear 重开。
3. 不确认就让它直接执行
大改动前先让 Claude 给你一个计划：先告诉我你打算怎么做，不要直接改。
下一步学什么
- CLAUDE.md 深度配置：让 Claude Code 真正了解你的项目
- Hooks 自动化：每次保存自动格式化、测试
- Sub-Agents 并行：同时处理多个任务
- GitHub Actions 集成：在 CI/CD 里用 Claude Code
来源：Claude Code Quickstart - Anthropic 官方文档