Claude Code 全方位使用教程
Claude Code 是 Anthropic 推出的基于终端的 AI 编程助手工具，它允许开发者直接在命令行界面与 Claude AI 互动。与其他编辑器内的 AI 插件不同，Claude Code 能够直接读取项目文件、运行终端命令并为你编写代码，为开发者带来了全新的“Agentic Coding”体验。
本文将手把手带你完成 Claude Code 的安装、配置，并介绍其基础使用和常见的工作流。
1. 准备工作：环境要求
在安装 Claude Code 之前，请确保你的系统满足以下基本要求：
系统支持
- macOS: 10.15 (Catalina) 或更高版本
- Windows: Windows 10 或更高版本（推荐使用 WSL2）
- Linux: Ubuntu 18.04+, CentOS 7+ 等主流发行版
硬件建议
- 内存: 至少 4GB RAM（强烈推荐 16GB 以获得流畅体验和大型项目支持）
- 磁盘: 至少 500MB 可用空间
软件依赖
- Node.js: 需要
v18.0或更高版本。验证方法：在终端中运行
node --version。如果未安装或版本过低，请前往 Node.js 官网 下载更新。 - Anthropic 账号: 需要在 console.anthropic.com 注册账号以进行授权。
2. 安装 Claude Code
Claude Code 的官方推荐安装方式是通过 npm（Node Package Manager）全局安装。
打开你的终端（Terminal、iTerm2 或 Windows PowerShell），运行以下命令：
npm install -g @anthropic-ai/claude-code
注意： 在 macOS 或 Linux 上，如果遇到权限问题，可能需要加上
sudo，即sudo npm install -g @anthropic-ai/claude-code。
安装完成后，可以通过以下命令验证是否安装成功：
claude --version
如果终端打印出版本号，说明安装成功！
3. 登录与账号配置
要使用 Claude Code，你需要授权它连接到你的 Anthropic 账户。
在终端中输入：
claude config
或者直接运行启动命令：
claude
这会在终端中启动一个一次性的 OAuth 授权流程：
- 工具会提供一个链接并尝试自动在浏览器中打开。
- 登录你的 Anthropic Console 账户（或者使用关联的 Claude Max 账户）。
- 在网页上点击授权。
- 终端会自动接收到认证令牌（Token），并安全地存储在本地配置中。
API 计费说明：
由于 Claude Code 是通过 Anthropic API 调用模型进行工作的，因此它采用 API 按量计费（Pay-as-you-go）的模式，而非 Claude Pro 订阅。请确保你的 Anthropic Console 账号内绑定了支付方式或有足够的余额。
4. 基础使用：唤起与交互
配置完成后，你可以直接在你的项目目录中使用它。
启动对话
使用终端进入你的代码项目文件夹，然后输入：
claude
这将启动交互式的 Claude 提示符。在这里，你可以像在网页端一样向它提问。
示例指令：
- “帮我解释一下这个项目里的
main.py是做什么的？” - “在这个目录下帮我创建一个 React 组件，包含一个简单的计数器。”
- “帮我找一下最近运行报错的那个 TypeError 是在哪行代码产生的，并修复它。”
常用内置命令
在 Claude 提示符内，以 / 开头的命令可以执行特定的操作：
/help：查看所有可用命令的帮助文档。/clear：清除当前会话的上下文，让你重新开始一个新的对话任务。/compact：压缩当前对话的上下文。当你觉得 API 消耗变大或者提示词过长时非常有用。/config：打开配置菜单，可以修改默认模型、设置自定义提示词（Custom System Prompt）等。/exit(或快捷键Ctrl+C)：退出 Claude Code。
5. 日常工作流体验：Agentic Coding
与网页版 ChatGPT 或常规 Copilot 不同，Claude Code 是一个具备“行动力”的 Agent。
流程一：代码审查与分析
进入一个新项目，直接让 Claude 分析：
“帮我分析一下整个项目的架构，并找找看有没有潜在的安全漏洞或者性能瓶颈。”
Claude 会自动使用它的内置工具去读取你的项目结构和相关源代码，然后给你一份综合报告。
流程二：端到端的 Bug 修复
遇到报错时：
“帮我跑一下
npm run test，如果有报错就直接把报错的代码修复掉。”
Claude Code 会自动执行测试命令，读取终端抛出的错误堆栈，定位到相关文件，修改代码，然后再跑一次测试确认修复成功。这就是 Agent 编码的强大之处。
流程三：重构与批量修改
“帮我把项目中所有组件的 CSS Modules 替换成 Tailwind CSS 类名。”
它会遍历你的文件系统，逐个修改文件并给出修改对比。
6. 注意事项与安全建议
- API 成本控制：由于它会自动读取文件并可能发起多次对话，处理大型项目时 Token 消耗可能较快。请在后台留意你的 API 账单，适时使用
/compact清理上下文。 - 操作确认：在执行破坏性命令（如
rm -rf、执行未知的脚本）之前，Claude Code 通常会请求你的确认。请务必仔细看清楚它要执行什么命令。 - 安全存储：API Token 存储在本地。请不要随意执行来源不明的脚本，防止 Token 泄露。
结语
Claude Code 是下一代终端原生 AI 开发工具的代表。它将 Claude 强大的代码理解能力与终端的执行力完美结合，真正做到了“帮我写代码并帮我跑通”。赶紧在你的终端里装上试试吧！
