Claude Code 是 Anthropic 的基于终端的 AI 编码代理。您用纯英文输入想要的内容，它会读取您的代码库、编写代码、运行命令、修复错误并提交更改——全部在您的终端中进行。无需 IDE 插件。无需浏览器标签。只需您和 AI 在终端窗口中即可。

与 Cursor（在 IDE 内工作）或 Codex（在云端工作）不同，Claude Code 在您实际的开发环境中本地运行。它能看到您的文件、git 历史记录和终端输出。这使得它在许多工作流程中更快，因为无需在 AI 和代码之间切换上下文。

本指南涵盖安装、您的第一个项目、关键命令，以及让 Claude Code 发挥作用的工作流程。

Tool Best For Where it runs Workflow
Claude Code交互式代理编码本地终端您引导 + 它实时执行步骤
Cursor日常编码 + 内联编辑IDE 内可见差异 + 自动补全
Codex异步委托任务云端沙箱提交任务 → 稍后审查 PR

如何安装 Claude Code

你需要 Node.js 18+ 和一个 Claude 账户（Pro 或 API）。

步骤 1： 通过 npm 全局安装：

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

步骤 2： 进入你的项目目录：

cd your-project

步骤 3： 运行 Claude Code：

claude

首次运行时，它会要求你使用 Anthropic 账户进行身份验证。如果你使用 Claude Pro（$20/月），你将获得丰沛的令牌额度。如果你使用 API，则按令牌付费（查看当前费率，请参考我们的费率限制指南）。

费用估算（避免意外）

如果你使用 API 计费，在中等规模仓库上进行典型的 30–60 分钟会话，通常费用为 $2–$10，具体取决于模型 + 迭代次数。定期使用 /cost，并使用 Vibe Coding Cost Calculator 检查长时间会话。

与 Claude Code 的前 5 分钟

Claude Code 运行后，你就进入了一个交互式会话。AI 可以访问你的整个项目目录。从简单开始：

让它探索： 输入“What is this project? Give me a high-level overview.” Claude 会读取你的关键文件（package.json、README、主入口点）并总结发现的内容。这是验证它理解项目结构的好方法。

让它查找： “Where is the authentication logic?” Claude 会搜索你的代码库并指向相关文件。它理解代码结构，而不仅仅是文本匹配。

让它修改： “Add input validation to the signup form. Email must be a valid format, password minimum 8 characters.” Claude 会识别表单组件、编写验证逻辑，并在应用前向你显示差异。

关键洞见：Claude Code 操作的是你的实际文件。当它进行更改时，更改是真实的——你的文件会在磁盘上被修改。你可以在编辑器中查看更改、运行测试，并正常提交。

核心命令

Claude Code 有几个斜杠命令来控制其行为：

命令 功能 使用时机
/init在项目根目录创建 CLAUDE.md 文件在仓库上进行首次重要任务之前
/compact在接近上下文限制时压缩对话历史长时间会话；质量下降之前
/cost显示已用 token + 估算费用API 计费、预算跟踪
/clear重置对话同时保留上下文在不相关任务间切换

从中获得价值了吗？ 我们每周发布 AI 编码工具和工作流指南。收到它们到你的收件箱 →

CLAUDE.md 文件 — 你项目的 AI 上下文

CLAUDE.md 文件是你 Claude Code 工作流程中最重要的一部分。它是项目根目录下的一个 markdown 文件，Claude 在每个会话开始时读取。可以将其视为代码库的自定义指令。

一个好的 CLAUDE.md 包括：

项目概述： 项目功能、技术栈和架构，用 3-5 句描述。

代码规范： 你的格式偏好、命名规范和要遵循的模式。“使用带 hooks 的函数组件。优先使用命名导出。使用 Tailwind 进行样式。”

关键文件： 指向 Claude 应理解的最重要文件。“主要数据模型在 lib/models/。API 路由在 app/api/。”

避免事项： “不要修改数据库迁移文件。不要更改 vendor/ 中的任何内容。修改 api/ 文件后始终运行测试。”

没有 CLAUDE.md，Claude Code 会生成通用代码，可能不符合你项目的风格。有它后，输出感觉像是团队成员工作数月后写的代码。这是 上下文工程 的实际应用。

真实工作流程：构建功能

这是我使用 Claude Code 进行典型功能开发会话的方式：

1. 从目标开始： “Add a rate limiter to the API. Use Redis. Apply to the /api/submit endpoint with a limit of 10 requests per minute per IP.”

2. 让 Claude 规划： 它读取现有 API 代码，检查 Redis 是否已配置，并提出方法。在它开始编码前审阅计划。

3. 观看它工作： Claude 创建限流模块，将其集成到 API 路由中，添加 Redis 连接的环境变量，并编写测试。

4. 测试： Claude 运行测试。如果失败，它读取错误、调整代码并重试。这个迭代循环是代理闪耀的地方——它处理通常需要多轮手动工作的调试周期。

5. 审阅并提交： 检查差异。进行任何调整。提交。如果你要求，Claude 也可以编写提交消息。

对于这样的功能，Claude Code 通常比手动编写节省 60-70% 的时间。真正的节省在于样板代码、集成代码和测试编写——这些部分繁琐但不具智力挑战。

Try it yourself

Paste any prompt and get a better version in seconds.

Open Prompt Optimizer — Free →

管理 Token 使用

Claude Code 在每次交互中使用 token。在大型代码库上的长时间会话在 API 计费下可能很昂贵。以下习惯能保持合理成本：

定期使用 /compact。 不要等到上下文满再压缩。每个独立任务完成后压缩。

具体描述。 “Fix the bug in the login form” 比 “Look at the entire application and find any bugs.” 更便宜。具体请求意味着更少的代码读取。

在无关任务间使用 /clear。 如果你一直在前端工作然后切换到数据库迁移，清除上下文。旧上下文浪费 token 并可能混淆模型。

频繁检查 /cost。 为每个会话设定心理预算并对照检查。典型的 30 分钟功能会话在 API 计费下花费 $2-8。

有关 Claude Code 和 Cursor 的详细成本比较，请参阅我们的 30 天真实成本比较。

Claude Code vs Cursor vs Codex

快速决策指南：

选项 最适合时... 权衡
Claude Code你想要交互式、仓库范围的本地更改需要仔细审查（它会编辑真实文件）
Cursor你想要 IDE 内嵌的 AI + 紧密编辑循环比终端代理少一些免手动干预的自主性
Codex你想要异步、基于 PR 的委托交互性较少；上下文可能漂移

Claude Code：最适合想要完整项目上下文和终端原生工作流的开发者。交互式、实时，在你的实际文件上工作。最适合复杂功能、重构和调试。

Cursor：最适合想要 IDE 内嵌 AI 的开发者。实时查看更改，带内联差异。最适合日常编码和 AI 建议。完整比较请看这里。

Codex：最适合想要异步、批量编码任务的团队。提交任务，稍后审查 PR。最适合你想完全委托的明确定义任务。完整比较请看这里。

许多开发者使用两种或更多工具。Claude Code 用于复杂功能，Cursor 用于日常编辑，Codex 用于批量任务。

想要提升任何 AI 编码工具的提示吗？The Prompt Optimizer 帮助你构建请求，获得更清晰、更具体的输出。

想要更多类似内容？ 我们每周发布关于 AI 编码工具和开发者工作流的文章。免费订阅 →

常见问题

Claude Code 支持 Windows 吗？

是的，通过 WSL（Windows Subsystem for Linux）、PowerShell 或命令提示符。WSL 提供最佳体验，因为许多开发工具是 Linux 原生的。

Claude Code 可以访问互联网吗？

Claude Code 本身不浏览网页，但它可以运行能访问互联网的命令——curl、npm install、git clone。它还可以使用 MCP 服务器访问外部服务，如 GitHub、数据库和 API。

Claude Code 如何处理大型代码库？

Claude 的 200K token 上下文窗口意味着它可以同时加载和处理数千个源文件。对于非常大的单仓库，它会选择性读取相关文件而不是加载全部。CLAUDE.md 文件帮助它知道代码库的哪些部分对每个任务重要。

我的代码会被发送到 Anthropic 的服务器吗？

是的，你的代码会被发送到 Anthropic 的 API 进行处理。Anthropic 默认不使用 API 输入进行训练，但如果你处理敏感或专有代码，请检查当前条款。考虑使用禁用数据保留的 API 以获得最大隐私。

披露：本文中一些链接是联盟链接。我们仅推荐我们亲自测试并定期使用的工具。查看我们的 完整披露政策。