Exploring Claude Code: 5 Key Features Reveal the Potential of Anthropics New AI Programming Assistant

Claude Code 入门指南

系统要求

在深入之前，让我们确保您的系统能够处理 Claude Code。该工具支持多种操作系统，包括 macOS 10.15 或更高版本、Ubuntu 20.04+ 或 Debian 10+，以及通过适用于 Linux 的 Windows 子系统 (WSL) 的 Windows。在硬件方面，您至少需要 4GB 的 RAM 才能高效运行它。由于 Claude Code 连接到 Anthropic 的 API 进行处理，因此需要互联网连接才能进行身份验证和持续使用。

安装过程

安装 Claude Code 很容易，尽管目前它已达到容量上限，您需要在 Anthropic 的网站上加入候补名单。一旦您获得访问权限，安装过程就很简单：

1. 打开您的终端
2. 运行命令 npm install -g @anthropic-ai/claude-code
3. 使用 cd your-project-directory 导航到您的项目目录
4. 通过键入 claude 启动 Claude Code

这将在您的系统上全局安装 Claude Code，允许您在您选择的任何项目目录中使用它。

身份验证设置

第一次运行 Claude Code 时，您需要使用您的 Anthropic Console 帐户完成一次性 OAuth 身份验证过程。这确保了对 API 的安全访问，并将您的使用与您的帐户关联起来。为此，您需要在 console.anthropic.com 上设置有效的账单。

身份验证过程旨在安全且用户友好。在初始设置后，Claude Code 会维护您的身份验证，因此您无需每次使用该工具时都登录。

Claude Code 的核心功能

很酷的是，Claude Code 正在尽最大努力引导您，而无需先阅读大量文档。我喜欢从一开始您就在终端 REPL 应用程序中拥有一个关于您的站点构建的指南：

由于我们处于 REPL 环境中，我注意到我必须适应它。我经常直接键入 bash 命令，而不是在它们前面加上“!”，所以我最终启动了 claude 而不是执行我的命令。

每个 Claude Code 命令都需要以“/”开头，如果它不是提示。

了解你的代码库

当你开始一个新项目时，你可以简单地要求 Claude 给你一个代码库结构的概述，解释主要的架构模式，或者描述关键的数据模型。

例如，在导航到你的项目根目录并启动 Claude Code 之后，你可能会问：

> give me an overview of this codebase
> explain the main architecture patterns used here
> what are the key data models?

这些简单的问题可以为你节省数小时手动梳理文件夹和文件来理解所有内容是如何组合在一起的时间。

我最近为一个类似于老虎机的网络应用编写了一个程序，供我的团队使用，以选择谁将被分配任务，作为将游戏化引入我们计划的一种有趣的方式。

我问 Claude Code：

> analyze what the code actually does

输出结果出乎意料地好。干得好，Claude Code。 首先，分析是准确的，并且在高层次上描述了应用程序，没有遗漏关键的功能部分。 最重要的是，没有添加不存在的功能。😅

SpinThatWheel is a React and TypeScript-based web application that simulates a slot machine or
  wheel spinning game. Here's what it does:

1. Name Input Phase:
    - Users start by entering multiple names using the NameInput component
    - Names can be added one by one and appear as "name tags" below the input field
    - At least 2 names are required to proceed to the game phase
    - The component tracks names in state and passes them to the parent App when "Done" is clicked
  2. Game Phase (Slot Machine):
    - The app transitions to showing a slot machine interface with multiple wheels
    - Each wheel contains the same set of names that were entered
    - The SlotMachine component manages the state of all wheels
  3. Spinning Mechanism:
    - When the user clicks "Spin", all wheels start spinning simultaneously
    - Each wheel appears as a vertical strip of names that animates rapidly upward
    - The Wheel component uses CSS animations based on the current timestamp to create the
  spinning effect
    - Each wheel has a "Stop" button that can be clicked independently
  4. Winner Determination:
    - When a user clicks "Stop" on a wheel, it gradually slows down and stops at a random name
    - The SlotMachine component tracks which wheels have stopped
    - Once all wheels have stopped, it calculates the winner based on which name appears most
  frequently
    - The winning name is displayed with a "We Have A Winner!" message
  5. Game Flow:
    - Users can spin again after a winner is determined
    - They can also start a completely new game with different names
    - The app maintains separate states for game phase, spinning status, and the winner
  6. Visual Design:
    - The slot machine has visual elements like overlays and center indicators
    - When a wheel stops, the centered name is highlighted
    - The UI mimics the look of a physical slot machine with animation effects

The project uses React hooks (useState, useEffect) for state management and follows a
  component-based architecture with TypeScript for type safety. It's bundled with Vite for fast
  development and optimized production builds.

提出关于你的代码的问题

与可能过时或不完整的传统文档不同，Claude Code 可以实时回答有关你的代码的特定问题。你可以询问某些组件如何协同工作，特定函数的作用是什么，或者数据如何在你的应用程序中流动。

探索项目架构

在使用复杂项目时，了解架构至关重要。Claude Code 可以通过跟踪执行流程和解释设计模式来帮助你可视化不同组件的交互方式。

例如，你可能会要求 Claude：

> trace the login process from front-end to database
> how do these authentication files work together?
> explain the relationship between services in our microservice architecture

这些见解可以帮助你比逐行阅读代码更快地构建项目的心理模型。

使用 Claude Code 进行实际编码任务

修复错误和调试

当你遇到错误消息时，Claude Code 可以成为你的调试伙伴。与 Claude 分享错误，它可以帮助诊断问题并提出修复建议。更令人印象深刻的是，在你批准后，Claude 实际上可以为你实现修复。

例如，如果你在运行测试时看到错误，你可以像这样与 Claude 交互：

> I'm seeing an error when I run npm test
[Claude analyzes the error]
> suggest a few ways to fix the @ts-ignore in user.ts
[Claude provides suggestions]
> update user.ts to add the null check you suggested

就这样，Claude 直接修复了你的代码库中的错误，为你节省了时间和精力。

高效地重构代码

将旧代码重构为使用现代模式和实践可能很繁琐，但 Claude Code 使其更容易。你可以要求 Claude 识别已弃用的 API 使用，建议现代替代方案，甚至在保持相同行为的同时执行重构。

一个典型的重构工作流程可能如下所示：

> find deprecated API usage in our codebase
> suggest how to refactor utils.js to use modern JavaScript features
> refactor utils.js to use ES2024 features while maintaining the same behavior
> run tests for the refactored code

能够通过直接从 Claude 界面运行测试来验证更改，确保你的重构不会破坏现有功能。

使用测试

向未经测试的代码添加测试覆盖是 Claude Code 擅长的另一个领域。它可以识别未经测试的函数，生成测试脚手架，并添加涵盖边缘情况的有意义的测试用例。

例如：

> find functions in NotificationsService.swift that are not covered by tests
> add tests for the notification service
> add test cases for edge conditions in the notification service
> run the new tests and fix any failures

这种全面的测试方法有助于提高代码质量，并在项目发展时防止回归。

高级功能

Git 集成和工作流程

Claude Code 的 git 集成特别令人印象深刻。你可以使用简单的自然语言命令执行复杂的 git 操作，而无需记住特定的 git 语法。

你可以使用 Claude Code 执行的一些 git 操作示例：

> commit my changes
> create a pr
> which commit added tests for markdown back in December?
> rebase on main and resolve any merge conflicts

这些命令使版本控制更容易访问，特别是对于不是 git 专家的开发人员。

创建 Pull Requests

创建全面的 pull requests 常常是一个耗时的过程，但 Claude Code 可以为你生成文档完善的 PR。它可以总结你的更改，创建一个带有适当描述的 PR，甚至添加有关如何测试更改的详细信息。

生成 PR 的工作流程可能如下所示：

> summarize the changes I've made to the authentication module
> create a pr
> enhance the PR description with more context about the security improvements
> add information about how these changes were tested

这确保你的 PR 信息丰富，并为审阅者提供他们所需的所有上下文。

文档生成

保持文档的最新状态可能具有挑战性，但 Claude Code 可以为你的代码生成和更新文档。它可以识别未文档化的函数，添加适当的注释（例如 JavaScript 的 JSDoc），并确保文档遵循你的项目标准。

例如：

> find functions without proper JSDoc comments in the auth module
> add JSDoc comments to the undocumented functions in auth.js
> improve the generated documentation with more context and examples

这有助于维护与你的代码同步的高质量文档。

掌握 Claude Code 命令

基本 CLI 命令

Claude Code 提供了几个 CLI 命令来控制其行为。最基本的是简单的 claude 命令，用于启动交互式 REPL（读取-求值-打印循环）。你还可以：

• 运行 claude "query" 以从初始提示开始
• 使用 claude -p "query" 进行一次性查询，完成后退出
• 使用 cat file | claude -p "query" 处理管道内容
• 使用 claude config 配置设置
• 使用 claude update 更新到最新版本

这些命令让你在使用 Claude Code 时具有灵活性，具体取决于你的特定需求。

强大的斜杠命令

在 Claude Code 会话中，你可以使用斜杠命令来控制行为的各个方面：

• /bug 报告错误（将对话发送给 Anthropic）
• /clear 清除对话历史记录
• /compact 保存上下文空间
• /config 查看或修改配置
• /cost 显示令牌使用统计信息

• /help 获取使用帮助
• /init 使用 CLAUDE.md 指南初始化项目

这些命令可帮助你更有效地管理你的 Claude Code 会话，并解决出现的任何问题。时不时地检查你的花费，以免过度使用。

小型教程：真实的 Claude Code 示例

理解新的代码库

让我们逐步了解如何使用 Claude Code 来理解新的代码库：

1. 导航到你的项目目录：cd /path/to/new/project
2. 启动 Claude Code：claude
3. 请求一个高级概述：give me an overview of this codebase
4. 探索架构：explain the main architectural patterns used here
5. 理解关键组件：what are the most important modules and how do they interact?
6. 确定入口点：where should I start looking to understand the user authentication flow?

这种提问的进展方式可以帮助你快速构建代码库的心理模型，从高级结构到具体的实现细节。

逐步修复错误

现在，让我们看看 Claude Code 如何帮助修复错误：

1. 在你的项目目录中启动 Claude Code
2. 描述错误：I'm getting a "TypeError: Cannot read property 'id' of undefined" when users try to update their profile
3. 让 Claude 查找相关代码：where in our codebase is user profile updating handled?
4. 请求分析：analyze the profile update function for potential null reference issues
5. 获取修复建议：how should we fix the null reference in the profile update function?
6. 实现修复：update the profile update function to add null checking as you suggested
7. 测试修复：run tests for the user profile module

此工作流程演示了 Claude Code 如何帮助诊断、修复和验证代码库中的错误解决方案。

创建项目文档

最后，让我们看看如何为项目生成文档：

1. 启动 Claude Code 并请求评估：what parts of our codebase need better documentation?
2. 创建文档计划：suggest a structure for our project documentation
3. 生成 README：create a comprehensive README.md for this project
4. 记录关键函数：add JSDoc comments to the key functions in our API service
5. 创建使用示例：write example code snippets for our API endpoints

此过程有助于确保你的项目有完善的文档，并且其他开发人员可以访问。

安全和隐私注意事项

权限系统说明

Claude Code 实施了分层权限系统，以平衡权力和安全性。该系统将操作分为三种类型：

1. 只读操作（如文件读取、LS、Grep），不需要批准。
2. Bash 命令，需要批准，可以选择永久记住特定命令的选择。
3. 文件修改，需要批准，权限持续到会话结束。

这种权限结构确保了 Claude Code 无法在未经你明确批准的情况下对你的文件进行不必要的更改或执行潜在有害的命令。

优化你的 Claude Code 体验

终端设置建议

为了充分利用 Claude Code，优化你的终端设置至关重要。Claude Code 适用于 Bash 和 Zsh shell（尽管目前不支持 Fish shell）。你可以通过以下方式配置终端以获得最佳使用体验：

1. 设置适当的换行符处理（使用 Option+Enter 或 /terminal-setup 命令以方便输入）
2. 配置通知，以便在任务完成时提醒你
3. 设置对大输入的适当处理

这些优化使使用 Claude Code 更加高效和愉快，尤其是在较长的编码会话期间。

常见问题解答

1. 使用 Claude Code 的费用是多少？

Claude Code 的费用基于令牌使用量，典型成本约为每位开发人员每天 5–10 美元。然而，在密集使用期间，成本可能超过每小时 100 美元。你可以使用 /cost 命令跟踪你的成本，并通过 Anthropic Console1 设置支出限制。

2. Claude Code 可以与任何编程语言一起使用吗？

是的，Claude Code 与语言无关，几乎可以与任何编程语言一起使用。它理解不同语言的代码结构和模式，使其适用于各种开发环境。无论你使用的是 JavaScript、Python、Swift 还是其他语言，Claude Code 都可以帮助你理解、修改和改进你的代码。

3. Claude Code 是否需要互联网访问才能运行？

是的，Claude Code 正常运行需要互联网连接。它连接到 Anthropic 的 API 进行身份验证和 AI 处理。具体来说，它需要访问 api.anthropic.com、statsig.anthropic.com 和 sentry.io。如果您在容器化环境中使用 Claude Code，则需要将这些 URL 加入白名单。

4. Claude Code 如何保护我的代码的安全性和隐私？

Claude Code 在设计时就考虑了安全性。它直接连接到 Anthropic 的 API，没有中间服务器。此外，分层权限系统确保 Claude 无法在未经您批准的情况下进行更改。根据 Anthropic 的隐私政策，他们不会使用您从 Claude Code 提供的反馈来训练生成模型，并且反馈记录仅存储 30 天。

5. 我可以使用 Claude Code 与 Amazon Bedrock 或 Google Vertex AI 等第三方 API 吗？

是的，Claude Code 可以连接到第三方 API，例如 Amazon Bedrock 和 Google Vertex AI。对于 Amazon Bedrock，您需要设置环境变量，如 CLAUDE_CODE_USE_BEDROCK=1 和 ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'。对于 Google Vertex AI，您需要设置诸如 CLAUDE_CODE_USE_VERTEX=1、CLOUD_ML_REGION=us-east5 和 ANTHROPIC_VERTEX_PROJECT_ID=your-project-id 之类的变量。

我对 Claude Code 的看法

我目前使用 Github Copilot (来自 windsurf) 作为我在 VSCode 中首选的编码助手。我对 Claude 3.7 Sonnet 以及它在 Github Copilot 中的工作方式感到满意。看来我们目前很合拍。 我发现 Claude Code 非常适合我的用例，但我也必须体验到使用 API 是有成本的。因此，如果您进行测试，请经常在终端中检查您的 API 费用。（只需在终端中输入 /cost）

因此，目前我将坚持使用 Github Copilot，并看看 Claude Code 将来如何发展。