Claude Code 是 Anthropic 公司推出的一款智能编程助手，它通过命令行界面（CLI）让你能用自然语言与 AI 交互，从而辅助代码编写、调试、重构、版本管理等开发任务。下面我会为你介绍它的主要使用方法。

🧭 目录

:::info

➀ 安装与配置 → 如何搭建环境

➁ 核心功能 → 它能做什么

➂ 基本使用 → 常用命令与操作

➃ 高级特性 → 提升效率的技巧

➄ 最佳实践 → 更高效的使用建议

:::

❶ 安装与配置

1. 环境要求：确保你的系统已安装 Node.js 18.0.0 或更高版本。对于 Windows 用户，建议使用 WSL2 (Windows Subsystem for Linux) 环境。

2. 安装：通过 npm 包管理器全局安装 Claude Code。

   npm install -g @anthropic-ai/claude-code
   # 或者使用官方推荐的命令
   # npm install -g @anthropic/claude-code
   

   安装后，可以通过 claude --version 验证是否成功。

3. 认证配置：使用 Claude Code 需要配置 Anthropic API 密钥。

   • 获取 API 密钥：访问 Anthropic Console 获取。

   • 设置环境变量：将获取的 API 密钥设置为系统环境变量 ANTHROPIC_API_KEY。

   # 在 ~/.bashrc, ~/.zshrc 或对应 shell 配置文件中添加
   export ANTHROPIC_API_KEY="你的API密钥"
   # 然后重启终端或运行 source ~/.zshrc (根据你的shell)
   

   你也可以直接通过命令 claude config 进行交互式配置。

💡 国内用户注意：由于网络限制，你可能需要配置镜像站来稳定访问。常见做法是设置 ANTHROPIC_BASE_URL 环境变量指向可靠的国内镜像地址。

❷ 核心功能

Claude Code 的核心能力在于其项目级的理解和操作能力：

❸ 基本使用

1. 启动会话：在终端中，进入你的项目目录，然后输入 claude 启动交互式会话。

   cd /path/to/your/project
   claude
   

   启动后，你会看到欢迎信息，进入 > 提示符状态。

2. 进行交互：在 > 提示符后，直接用自然语言描述你的需求。

   • 了解项目：你可以先让 Claude Code 熟悉你的项目：

     > what does this project do?

     > what technologies does this project use?

   • 代码操作：让 Claude Code 进行代码修改或生成：

     > add a hello world function to the main file

     Claude Code 会分析你的项目，找到合适的文件，显示建议的更改并在获得你的批准后进行实际编辑。

3. 常用命令：在 Claude Code 会话中，可以使用一些以斜杠 (/) 开头的命令：

   • /help：查看所有可用命令的帮助信息。

   • /clear：清除当前会话的聊天记录，节省Token。

   • /cost：查看当前会话的Token消耗统计。

   • /exit 或 Ctrl+C：退出会话。

   • /init：在当前项目目录初始化生成 CLAUDE.md 文件，用于存储项目规范、技术栈等长期记忆信息。

4. 单次查询：如果只是想快速问一个问题而不进入交互会话，可以使用 -p 参数：

   claude -p "请帮我优化这段代码的内存使用" < file.js
   

❹ 高级特性

• CLAUDE.md 项目记忆：这是 Claude Code 的一个核心概念。通过在项目根目录创建或使用 /init 命令生成 CLAUDE.md 文件，你可以记录项目的技术栈、开发规范、常用命令、设计决策等重要信息。Claude Code 在后续会话中会自动读取这些内容，使其生成的代码更符合项目要求。例如：

  # 项目说明
  ## 技术栈
  - Frontend: React 18, TypeScript, Tailwind CSS
  - Backend: Node.js, Express
  ## 开发规范
  - 使用函数式组件
  - API调用统一使用自定义hooks
  - 代码必须通过ESLint检查
  ## 常用命令
  - `npm run dev`: 启动开发服务器
  - `npm run build`: 构建生产版本
  

• MCP (Model Context Protocol) 集成：MCP 允许 Claude Code 与外部工具和数据源（如数据库、API、浏览器自动化工具）连接，极大扩展其能力。例如，可以集成 MySQL 数据库或 Playwright 进行网页自动化测试。

  # 示例：添加MySQL数据库连接（命令较长，通常需按提示配置）
  claude mcp add mcp_server_mysql npx @benborla29/mcp-server-mysql -e MYSQL_HOST="主机" -e MYSQL_USER="用户" -e MYSQL_PASS="密码" -e MYSQL_DB="数据库名"
  

• 图像识别功能：Claude Code 支持粘贴图片。你可以将 UI 截图、设计稿或错误日志截图粘贴到会话中，让 Claude Code 根据图像内容提供代码建议或问题排查思路。例如：

  > 根据这张UI截图，生成对应的HTML和CSS代码

  > 分析这个错误弹窗截图可能的原因

• 深度思考模式：对于复杂问题，可以在指令中加入特定关键词（如 think hard, ultrathink），要求 Claude 进行更深入、更全面的分析和思考。

  > 这个并发问题很复杂，请深入思考 (think hard) 并提出解决方案。

❺ 最佳实践和建议

1. 指令清晰明确：提供尽可能具体的上下文、约束条件和预期输出。

   • 不佳示例：“修复这个bug。”

   • 良好示例：“我的React组件在用户快速点击按钮时会重复提交数据。请添加防抖逻辑，设置300毫秒延迟，并在提交过程中禁用按钮。”

2. 权限管理：Claude Code 在执行可能修改文件或运行系统命令的操作前，默认会请求你的许可。出于安全考虑，应审慎授予权限，尤其是不熟悉的操作。你可以通过 /permissions 命令管理工具权限。

3. Token 优化：Claude Code 的使用消耗 Token，对于长会话，定期使用 /clear 或 /compact 清理历史记录，有助于控制 Token 消耗和成本。

4. 结合版本控制：虽然 Claude Code 能高效处理 Git 操作，但重要代码的提交和合并前，建议人工复查，确保变更符合预期。

5. 探索集成：如果你使用 VS Code 或 JetBrains 等 IDE，可以探索其内置终端中运行 Claude Code 的体验，有些插件还能提供更直观的 diff 视图。

❻ 简单入门步骤总结

如果你刚刚安装好 Claude Code，可以按以下步骤快速体验：

1. 打开终端，进入你的一个项目目录。

2. 输入 claude 并按回车，启动交互会话。

3. 首先尝试让 Claude Code 了解你的项目，输入：> 请简单解释一下这个项目是做什么的？用了哪些主要技术？

4. 接着可以提出一个具体的编码请求，例如：> 请帮我检查并修复这个文件中的语法错误。 （替换为你的实际文件名）

5. 根据 Claude 的回应和建议，批准或拒绝其提出的修改。

6. 完成后，输入 /exit 退出会话。

Claude Code 的设计理念是成为你的AI编程伙伴。多尝试用自然语言与其交流，就像和一位经验丰富的同事讨论一样，你会发现它能显著提升你的开发效率。

希望以上信息能帮助你开始使用 Claude Code。祝你编码愉快！