本指南将带你快速上手 Claude Code，一个 AI 驱动的编程助手，让你在几分钟内体验其强大的代码辅助功能。读完本指南，你将学会如何使用 Claude Code 来处理常见的开发任务。

准备工作

在开始之前，请确保你已准备好以下环境：

  • 一个终端或命令行工具。
  • 一个需要处理的代码项目。
  • 一个 Claude.ai 账户（推荐）或 Anthropic Console 账户。

安装与登录

步骤 1：安装 Claude Code

你可以选择以下任意一种方式进行安装。

使用 NPM 安装

如果你的环境中已安装 Node.js 18 或更高版本，执行以下命令：

npm install -g @anthropic-ai/claude-code

原生安装（Beta）

你也可以尝试使用新的原生安装方式。

  • macOS / Linux / WSL: 
    curl -fsSL claude.ai/install.sh | bash
  • Windows PowerShell: 
    irm  | iex

步骤 2：登录账户

安装完成后，你需要登录账户才能使用 Claude Code。在终端中输入 claude 启动交互式会话时，系统会引导你登录：

claude /login

你可以使用以下两种账户类型之一登录：

  • Claude.ai 账户：订阅制计划，推荐日常使用。
  • Anthropic Console 账户：通过预付费点数使用 API。

登录成功后，你的凭据将被保存在本地，无需重复登录。如果你需要切换账户，可以再次使用 /login 命令。

注意：当你首次使用 Anthropic Console 账户登录时，系统会自动为你创建一个名为 “Claude Code” 的工作区，用于集中追踪和管理你组织内所有 Claude Code 的使用成本。

核心用法

步骤 3：启动第一个会话

进入你的项目目录，然后启动 Claude Code：

cd /path/to/your/project
claude

你将看到 Claude Code 的交互式提示符，代表会话已成功启动：

✻ Welcome to Claude Code!
...
> Try "create a util logging.py that..."

步骤 4：提出你的第一个问题

让 Claude Code 从理解你的代码库开始。你可以尝试以下问题：

  • > 这个项目是做什么的？
  • > 这个项目使用了哪些技术？
  • > 项目的主入口文件在哪里？
  • > 解释一下项目的目录结构。

Claude Code 会自动读取并分析你的项目文件，无需你手动提供上下文。你也可以向它提问关于其自身功能的问题：

  • > Claude Code 能做什么？
  • > 如何在 Claude Code 中使用斜杠命令？
  • > Claude Code 可以和 Docker 一起工作吗？

步骤 5：进行第一次代码修改

现在，我们来让 Claude Code 编写一些实际代码。尝试一个简单的任务：

> 在主文件中添加一个 hello world 函数

Claude Code 将执行以下操作：

  1. 定位 合适的文件。
  2. 展示 建议的代码变更。
  3. 请求 你的批准。
  4. 执行 文件修改。

重要提示：Claude Code 在修改任何文件前，总会征求你的许可。你可以逐一批准变更，也可以为当前会话启用“全部接受”模式。

常见开发工作流

步骤 6：与 Git 集成

Claude Code 让 Git 操作变得像对话一样简单：

  • > 我修改了哪些文件？
  • > 用一条清晰的描述提交我的变更

你还可以让它执行更复杂的 Git 操作：

  • > 创建一个名为 feature/quickstart 的新分支
  • > 显示最近 5 次的提交记录
  • > 帮我解决合并冲突

步骤 7：修复 Bug 与实现新功能

Claude 擅长调试代码和实现新功能。你可以用自然语言描述你的需求。

  • 实现新功能： > 为用户注册表单添加入参校验

  • 修复现有问题： > 有一个 Bug，用户可以提交空表单，请修复它

Claude Code 将自动定位相关代码、理解上下文并给出解决方案。如果项目中有测试，它还会尝试运行测试来验证修复。

步骤 8：探索更多场景

你可以通过多种方式与 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，用户输入错误凭据后会看到白屏”。
  • 使用分步指令：将复杂任务分解成多个步骤，例如：“1. 为用户资料创建一个新的数据库表；2. 创建一个用于获取和更新用户资料的 API 端点；3. 构建一个允许用户查看和编辑其信息的网页”。
  • 先让 Claude 探索：在进行代码修改前，先让 Claude 熟悉你的项目，例如：“分析数据库结构”或“构建一个仪表盘，展示英国客户最常退货的商品”。
  • 善用快捷键：
    • 使用 Tab 键进行命令自动补全。
    • 按 ↑ 键查看历史命令。
    • 输入 / 查看所有可用的斜杠命令。

后续步骤

掌握基础用法后，你可以进一步探索更高级的功能，例如查阅 CLI 参考手册以掌握所有命令和选项，或根据你的工作流自定义 Claude Code 配置。

获取帮助

  • 在 Claude Code 中：输入 /help 或直接提问 “如何…”
  • 官方文档：浏览其他指南和参考资料。
  • 社区支持：加入官方 Discord 社区，获取使用技巧和支持。

👉 如果你需要 ChatGPT 代充 / Claude / Claude Code / 镜像 / 中转 API：