快速摘要：Claude Code 是一款基于终端的 AI 编码助手，原生支持 macOS 和 Linux，或通过 WSL2 在 Windows 上运行。设置过程包括创建 Anthropic API 密钥、运行特定平台的安装程序、使用密钥进行身份验证，并通过测试命令验证安装。
Claude Code 是 Anthropic 官方推出的基于终端的编码助手。它直接集成在命令行中，可以通过自然语言指令处理从代码生成到 Bug 修复的各种任务。
但是，设置过程并非总是那么简单。Windows 用户需要 WSL2。API 身份验证可能会让初学者感到困惑。版本冲突也可能发生。
本指南将引导您完成所有平台的完整设置过程，从系统要求到您的首次编码会话。
Claude Code 到底是什么
Claude Code 是一款智能终端应用程序，可与开发环境集成。它通过对话式命令理解代码库、执行日常任务并管理 git 工作流。
与基于浏览器的工具不同，Claude Code 在终端中本地运行。它可以直接访问项目文件，跨会话保持上下文，并集成到现有的开发工作流中。根据 Claude Code 官方文档，该工具连接到 Anthropic 的 API，并支持与 Amazon Bedrock、Google Cloud Vertex AI 和 Azure AI 的集成。
该工具的运行方式与传统编码助手不同。说实话：它更像是您的终端中有一个结对编程员，而不是一个代码补全工具。
Claude Code 的系统要求
安装前，系统需要满足特定要求。各平台的要求如下：
| 平台 | 要求 | 备注 |
|---|---|---|
| macOS | macOS 13.0 或更高版本 | 原生支持，安装简单 |
| Linux | 支持 glibc 2.28+ 的 64 位发行版 | 大多数现代发行版均支持原生 |
| Windows | Windows 10 Build 19041+ 或 Windows 11 | 需要先安装 WSL2 |
所有平台都需要稳定的互联网连接来进行 API 调用。Claude Code 下载通常需要约 50MB，Windows 上的 WSL2 会额外增加约 500MB 用于 Linux 子系统。
存储方面，预计至少需要 4GB 的可用空间。应用程序本身很小，但需要为依赖项和项目文件留出空间。
Windows 特定要求
如果安装了 Node.js，Claude Code 可以通过 PowerShell 或命令提示符在 Windows 上运行。该工具需要 Windows Subsystem for Linux 2 来创建 Linux 环境。
根据 claude.ai 的安装指南，Windows 10 系统需要版本 1903 或更高版本，Build 19041 或更高版本。Windows 11 用户已内置 WSL2 支持。初始 WSL2 设置需要管理员权限。
该过程涉及在 BIOS 中启用虚拟化、激活 Windows 功能以及安装 Linux 发行版。Ubuntu 22.04 LTS 是推荐的兼容性发行版。
安装 Claude Code：分步流程
安装过程因平台而异。以下是如何在每个操作系统上运行 Claude Code。
在 macOS 和 Linux 上安装
macOS 和 Linux 的安装遵循相同的模式。两个平台都支持原生安装，无需额外设置。
过程从下载安装程序开始。打开终端并运行：
curl -fsSL claude.ai/install.sh | sh
脚本会自动检测操作系统、下载相应的二进制文件，并将 Claude Code 安装到本地 bin 目录。在连接稳定的情况下，安装通常在两分钟内完成。
对于没有 curl 的系统，可以使用 wget 作为替代。安装程序会自动将 Claude Code 添加到系统 PATH。
通过 WSL2 在 Windows 上安装
Windows 安装需要先设置 WSL2。以下是完整过程：
以管理员身份打开 PowerShell 并启用 WSL：
wsl –install
此命令将启用所需的 Windows 功能、下载 WSL2 内核，并默认安装 Ubuntu。系统会提示您重启。重启后，Ubuntu 将自动启动以完成用户设置。
在提示时创建用户名和密码。这些凭据用于 Linux 环境，与 Windows 登录详细信息分开。
一旦 WSL2 运行起来，Linux 安装过程就适用。在 Ubuntu 终端中，运行上面 macOS/Linux 部分的 curl 命令。
安装程序将处理其余部分。Claude Code 将安装在 WSL2 环境中，并通过 Ubuntu 终端运行。
获取 Anthropic API 密钥
Claude Code 需要 Anthropic API 密钥进行身份验证。该密钥将本地安装连接到 Anthropic 的服务器。
访问 Anthropic Console，地址为 console.anthropic.com。创建账户或使用现有凭据登录。在账户设置中导航到 API Keys。
点击“Create Key”生成新的 API 密钥。该密钥仅显示一次——请立即复制。离开页面后，Anthropic 不会再次显示完整的密钥。
安全地存储密钥。它提供了对 Anthropic API 和任何相关计费的完全访问权限。
了解 API 费用
Claude Code 通过 Anthropic API 采用按使用量付费的模式。根据 claude.ai 安装指南的数据，费用因模型而异：
| 模型 | 输入成本 | 输出成本 |
|---|---|---|
| Claude Opus 4.6 | 每百万 tokens 5 美元 | 每百万 tokens 25 美元 |
| Claude Sonnet 4.6 | 每百万 tokens 3 美元 | 每百万 tokens 15 美元 |
激活计费的最低购买金额为 5 美元，尽管社区讨论表明 20-30 美元提供了更好的测试空间。其他订阅选项包括每月 20 美元的 Claude Pro 或每月 100 美元的 Claude Max，适合重度用户。
默认行为是使用 Opus 直到达到使用限制的 50%，然后切换到 Sonnet 以提高成本效益。
身份验证和首次启动
安装完成后，Claude Code 在首次使用前需要进行身份验证。运行以下命令启动 Claude Code：
claude
首次启动时会提示输入 API 密钥。粘贴来自 Anthropic Console 的密钥并按 Enter。Claude Code 会验证密钥并将其安全地存储在本地配置文件中。
身份验证会在会话之间保持。除非明确删除或切换账户，否则无需重新输入 API 密钥。
为了验证身份验证是否成功，Claude Code 会显示欢迎消息和命令提示符。界面会显示可用命令并确认与 Anthropic API 的连接。
配置模型偏好
Claude Code 默认自动选择模型，但可以手动配置。根据官方文档，用户可以通过 /model 命令或设置 CLAUDE_CODE_EFFORT_LEVEL 环境变量来调整模型选择。
努力程度级别控制 Opus 4.6 和 Sonnet 4.6 模型的思考深度：低、中或高。更高的努力程度会增加推理深度，但也会增加成本和响应时间。
对于需要深度分析的项目，在提示中包含“ultrathink”可以暂时将此次交互的努力程度设置为高。
验证安装成功
身份验证后，请验证 Claude Code 是否正常工作。运行以下基本测试：
claude –help
claude –version
help 命令显示可用选项和命令。Version 输出确认已安装的版本。这两个命令都应该无错误地执行。
接下来，在项目目录中测试 Claude Code。创建一个测试文件夹：
mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude
在 Claude Code 会话中，尝试基本交互：
- 输入“help”查看可用命令
- 询问“explain what you can do”（解释你能做什么）
- 请求“summarize this project”（总结这个项目）
- 测试 /help 命令
这些交互可以确认 Claude Code 可以读取项目文件并响应提示。成功响应意味着安装正常运行。
为项目配置 Claude Code
Claude Code 在配置文件中存储项目特定设置。这些文件可以自定义行为、定义内存并建立工作流。
主要的配置文件是项目根目录下的 CLAUDE.md。此文件包含 Claude Code 在会话期间引用的指令、上下文和项目特定指南。
创建一个基本的 CLAUDE.md 文件：
# Project Context
This is a [project type] built with [technologies].
## Key Guidelines
– [Important rule 1]
– [Important rule 2]
## Project Structure
[Brief explanation of folder organization]
该文件支持 Markdown 格式。Claude Code 在会话开始时读取此上下文，并在整个对话过程中保持它。
高级配置选项
除了基本上下文之外，Claude Code 还通过 .claude 目录支持高级配置。此目录可以包含：
- Skills：定义在 .claude/skills/SKILL.md 中的专用功能
- Commands：.claude/commands/*.md 中的自定义斜杠命令
- Hooks：由事件触发的自动化工作流
- Plugins：通过编程集成扩展功能
根据官方 Agent SDK 文档，这些功能支持复杂的自定义。Skills 定义可重用的功能。Commands 为常见任务创建快捷方式。Hooks 会自动响应文件更改或工具使用。
使用 Claude Code：基本工作流
安装完成后，Claude Code 通过自然语言处理常见的开发任务。
通过导航到项目目录并运行以下命令来启动会话：
claude
提示符接受纯语言请求。一些常见工作流：
- 代码生成：“创建一个 Python 函数来验证电子邮件地址，并进行适当的错误处理。”
- Bug 修复：“此函数抛出空指针异常。你能识别并修复这个问题吗？”
- 重构：“将此组件重构为使用依赖注入而不是直接实例化。”
- Git 操作：“创建一个新分支，提交这些更改并附带描述性消息，然后推送到 origin。”
Claude Code 会在会话中保持上下文。它会记住之前的交互，跟踪文件修改，并理解更广泛的项目结构。
了解 Plan Mode
对于复杂的更改，Claude Code 提供 Plan Mode。此模式在进行修改之前会创建详细的执行计划。
通过在请求前加上“plan:”或使用 /plan 命令来激活 Plan Mode。然后，Claude Code 将概述建议的更改，解释原因，并在执行前等待批准。
Plan Mode 对于重构、架构更改或影响多个文件的修改特别有用。它在提交更改之前提供了 Claude Code 意图的可见性。
与 VS Code 和 IDE 集成
虽然 Claude Code 在终端中运行，但与代码编辑器的集成可以增强工作流。官方 VS Code 扩展将 Claude Code 的功能直接引入编辑器。
从 VS Code marketplace 安装扩展。搜索“Claude Code”并点击 Install。该扩展在侧边栏添加了一个 Claude Code 面板。
根据 VS Code 官方文档，该扩展支持：
| 功能 | 快捷键 | 描述 |
|---|---|---|
| Focus Input | Cmd+Esc / Ctrl+Esc | 在编辑器和 Claude 之间切换 |
| Open in New Tab | Cmd+Shift+Esc / Ctrl+Shift+Esc | 以新标签页启动新对话 |
| Open in Terminal | – | 从 VS Code 启动终端模式 |
该扩展在保持与终端版本相同的功能的同时，还增加了 IDE 特有的便利功能，例如内联 diff 和 @提及文件引用。
更新和管理 Claude Code
Claude Code 默认自动更新。该应用程序会定期检查新版本并在后台安装更新。
要手动更新，请运行：
claude –update
这将强制立即检查并安装最新版本。更新过程会保留配置文件和身份验证凭据。
对于需要版本控制的组织，可以禁用自动更新。将 CLAUDE_CODE_AUTO_UPDATE 环境变量设置为 false 或通过服务器管理设置进行配置。
要安装特定版本，请使用：
curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z
将 X.Y.Z 替换为目标版本号。
常见的设置问题及解决方案
设置过程中通常会遇到一些问题。以下是如何解决这些问题：
- API 密钥被拒绝：如果 Claude Code 拒绝 API 密钥，请验证其没有多余的空格或字符。从 Anthropic Console 重新复制密钥。检查计费是否已激活——如果没有绑定付款方式，密钥将无法使用。
- WSL2 安装失败：Windows 系统有时会因虚拟化设置而导致 WSL2 安装失败。进入 BIOS 并启用虚拟化（Intel VT-x 或 AMD-V）。确保 Windows 版本符合最低要求。
- Command Not Found（命令未找到）：如果终端无法识别 claude 命令，则 PATH 未正确更新。关闭并重新打开终端。对于持久性问题，请手动将安装目录添加到 PATH。
- Connection Timeouts（连接超时）：网络限制或防火墙可能会阻止 API 调用。Claude Code 需要 HTTPS 访问 api.anthropic.com。公司网络可能需要代理配置。
- Permission Errors（权限错误）：Linux 和 macOS 安装有时会遇到权限问题。使用适当的权限运行安装程序，或将安装到用户目录而不是系统范围的位置。
在设置 Claude Code 之前检查可用的 AI 积分
设置 Claude Code 通常意味着进行实验——运行提示、测试集成以及在生产环境部署任何内容之前构建小型原型。这个早期阶段通常会导致大量的 API 使用。许多开发人员不是立即为每次请求付费，而是首先寻找可用的积分或入门计划，以帮助减少最初的成本。
Get AI Perks 在一个地方收集了这些机会。该平台列出了来自 AI 提供商、云平台和开发人员工具的 AI 积分、折扣和合作伙伴计划，并提供分步指南解释如何领取它们。总而言之，该数据库包含来自 200 多个工具的优惠以及数百万美元的可用积分，供初创公司和构建者申请。
在完成 Claude Code 的设置之前，请访问 Get AI Perks 并领取可以涵盖您首次实验的 AI 积分。
常见问题解答
我需要为 Claude Code 付费吗？
Claude Code 本身是免费软件，但它需要一个按使用量付费的 Anthropic API 密钥。最低账户激活费用为 5 美元，但实际使用通常需要 20-30 美元的积分。替代订阅计划，如 Claude Pro（每月 20 美元）或 Claude Max（每月 100 美元），为重度用户提供不同的定价结构。
Claude Code 能完全离线运行吗？
不能。Claude Code 需要有效的互联网连接才能与 Anthropic 的 API 服务器通信。该应用程序在本地处理请求，但会将提示发送到 Anthropic 基础架构上运行的 Claude 模型。没有离线模式或本地模型选项。
Claude Code 和 Claude.ai 有什么区别？
Claude.ai 是一个基于网络的聊天界面，用于一般性的 Claude 交互。Claude Code 是一款专为软件开发设计的专用终端应用程序。Claude Code 集成了 git，直接读取项目文件，保持更长的开发上下文，并包含 Plan Mode 和文件编辑功能等编码专用功能。
如何切换 Claude 模型？
在 Claude Code 会话中使用 /model 命令可在可用模型之间切换。默认配置使用 Opus 直到达到 50% 的使用量，然后切换到 Sonnet。手动选择允许根据任务需求选择特定模型——Opus 用于复杂推理，Sonnet 用于更快、更经济高效的响应。
我可以在 VS Code 中使用 Claude Code 吗？
是的。官方 VS Code 扩展将 Claude Code 的功能引入编辑器。从 VS Code marketplace 安装它。该扩展提供了与终端版本相同的功能，并增加了 IDE 集成，如内联 diff、侧边栏面板和用于快速访问的键盘快捷键。
Claude Code 会存储我的代码或对话吗？
根据 Anthropic 的数据使用政策，API 交互不会用于训练模型。组织可以通过企业设置配置零数据保留策略。代码和提示会被传输到 Anthropic 的服务器进行处理，但处理方式取决于账户配置和数据保留设置。
如果 Claude Code 出错了怎么办？
Claude Code 包含像 git 集成和 Plan Mode 这样的安全功能，以最大限度地减少错误。对于确实发生的错误，适用标准的版本控制实践——git 历史记录提供了回滚能力。权限系统需要批准敏感操作。一些社区讨论表明，对于常规任务，成功率在 80-90% 之间，但对于关键更改建议进行监督。
继续使用 Claude Code
Claude Code 通过将 AI 助手直接集成到命令行中，转变了基于终端的开发。设置需要特定平台的安装、API 身份验证和基本配置，但遵循正确步骤后，过程会很简单。
该工具在处理例行开发任务、代码生成和 git 工作流管理方面表现出色。Plan Mode 为复杂操作提供了安全性。IDE 集成将功能扩展到了终端之外。
从简单的任务开始，了解 Claude Code 如何解释请求。随着熟悉度的提高，逐渐构建更复杂的工作流。使用 /clear 命令在不同的任务之间进行切换以保持清晰的上下文。配置 CLAUDE.md 文件以获得项目特定的指导。
团队可以探索服务器管理设置和插件市场。个人开发者可以受益于针对常用模式量身定制的 Skills 和自定义命令。
GitHub 仓库 anthropics/claude-code 包含更多示例、社区插件和故障排除资源。官方文档 docs.anthropic.com 提供了全面的技术参考。
现在是时候开始编码了。导航到项目，启动 Claude Code，看看 AI 辅助开发如何改变您的工作流。
