跳转到主要内容

Claude Code 安装教程:全平台完整设置指南(2026)

A
25 分钟阅读Claude AI 教程

Claude Code 可在 macOS、Windows 和 Linux 上通过原生安装器一条命令完成安装,无需 Node.js。使用 Claude Code 需要 Claude Pro 订阅($20/月)或更高方案。本指南涵盖所有安装方式、各平台步骤、假冒安装程序安全警告,以及最常见问题的解决方法。

Claude Code 安装教程:全平台完整设置指南(2026)

Claude Code 是 Anthropic 官方推出的命令行界面工具,可以将 AI 编程辅助直接带入你的终端。与基于浏览器的工具不同,它能读取你的整个代码库、执行命令,并通过自然语言处理复杂的多文件编辑——全程无需离开命令行。截至 2026 年 3 月,推荐使用原生安装器进行安装,该方式无需任何依赖且支持自动更新。你至少需要一个 Claude Pro 订阅($20/月)才能进行认证和使用 Claude Code,因为免费版不包含 CLI 访问权限。

要点速览

以下是关于安装 Claude Code 你需要了解的全部要点。在 macOS 或 Linux 上,打开终端运行 curl -fsSL https://claude.ai/install.sh | bash,整个过程不到两分钟即可完成。Windows 用户需要先安装 Git for Windows,然后在 PowerShell 中运行 irm https://claude.ai/install.ps1 | iex。原生安装器是官方推荐的安装方式,因为它无需 Node.js、支持自动更新,且能提供最稳定的使用体验。Homebrew(brew install --cask claude-code)和 WinGet(winget install Anthropic.ClaudeCode)是面向偏好使用包管理器的开发者的替代方案。旧的 npm 安装方式(npm install -g @anthropic-ai/claude-code)现已弃用——如果你仍在使用,Anthropic 建议迁移到原生安装器。Claude Code 需要付费的 Claude 账户:Pro 方案起价 $20/月(年付 $17/月),而 $100/月的 Max 方案可提供 20 倍的使用量。免费方案不包含 Claude Code 的访问权限。安装完成后,在任意项目目录中运行 claude 即可启动交互式编程会话,你可以通过对话让 Claude 读取、编辑和管理你的代码。

Claude Code 是什么?你真的需要它吗?

Claude Code 并不只是又一个 AI 代码补全工具——它是一个完全在终端中运行的智能体编程环境。由 Anthropic 推出并于 2025 年 5 月正式发布,Claude Code 能够理解你的整个项目结构,可以在文件之间导航、运行测试、提交代码变更,甚至同时调试跨多个代码库的复杂问题。它与 GitHub Copilot 或 Cursor 等工具的根本区别在于,Claude Code 以自主智能体的方式运行:你用自然语言描述你想要的效果,它会自动规划、执行并验证这些变更,无需你手动选择代码或在文件之间切换。它支持任何编程语言、任何框架、任何编辑器——因为它根本不需要编辑器。

你是否真正需要 Claude Code,取决于你的工作流以及你在终端中花费的时间。如果你是一个已经大量使用命令行工具的开发者,Claude Code 会非常自然地融入你现有的工作流程。它在需要同时触及多个文件的任务中表现尤为出色:在整个代码库中重构一个模块、实现一个跨越前端和后端的功能、或者调试一个需要在应用多个层级中追踪的问题。对于正在评估 AI 编程工具的开发者,你可以阅读我们的 ChatGPT 与 Claude 全面对比来了解 Claude 的底层模型与竞品相比有何优势。如果你的工作主要集中在单个文件上,传统的行内代码助手可能就足够了,但对于复杂的多文件工程任务,Claude Code 代表着开发者生产力的一次重大飞跃。这款工具在后端开发者、全栈工程师和 DevOps 专业人员中获得了尤其强劲的采用率,这些人群通常需要在多个服务和配置文件间频繁切换。Reddit 和开发者论坛上的早期使用者一致强调,Claude Code 理解项目上下文的能力——读取 README 文件、分析依赖关系图、理解测试模式——使其比那些只能看到单个文件的 AI 助手有效得多。它在终端中运行这一特点还意味着它能与涉及 git、docker、make 等命令行工具的现有开发工作流无缝集成,无需任何编辑器插件或配置。

安装 Claude Code 之前你需要准备什么

Claude Code 定价方案对比图,展示免费版、Pro、Max 和团队版各档位

在运行安装命令之前,你需要确认两件事:系统要求和 Claude 订阅。提前搞定这两项可以避免你安装完 Claude Code 后才发现无法认证或操作系统不受支持的挫败感。这是大多数安装指南会跳过的步骤,也正是许多开发者在安装后立即碰壁的原因。

系统要求非常简单,但因平台而异。在 macOS 上,你需要 13.0(Ventura)或更高版本——旧版 macOS 不受原生安装器支持(code.claude.com/docs/en/setup,2026 年 3 月验证)。Windows 用户需要 Windows 10 1809 版本或更高版本,或 Windows Server 2019+,而且最关键的一点是,你必须在运行 Claude Code 安装器之前安装好 Git for Windows。这个 Git 依赖是 Windows 上安装失败最常见的原因,所以请在尝试其他操作之前先从 git-scm.com 下载安装它。Linux 用户需要 Ubuntu 20.04+、Debian 10+ 或 Alpine 3.19+(Alpine 需要额外依赖项)。所有平台都要求至少 4GB 内存,但建议 8GB 或更多以便处理大型代码库。支持的 Shell 包括 Bash、Zsh、PowerShell 和 CMD。

定价是最容易让人措手不及的部分。 Claude Code 本身是免费安装的——二进制文件不收取任何费用。然而,要实际使用它,你必须用一个包含 Claude Code 访问权限的 Claude 账户进行认证。免费的 Claude 方案($0/月)完全不包含 Claude Code(claude.com/pricing,2026 年 3 月)。$20/月的 Pro 方案(年付 $17/月)是包含 Claude Code 的最低档,也是大多数个人开发者应该选择的方案。如果你需要更多的使用量,$100/月的 Max 方案(或 $200/月的 5x 档)提供 20 倍的容量以及扩展思考和研究功能等额外特性。对于团队用户,$150/用户/月的 Teams Premium 方案包含 Claude Code,但大约 $25/用户/月的标准 Teams 方案不包含。你可以了解 Claude Pro 免费试用选项在承诺付费前先体验服务,或查看我们的详细 Claude 订阅定价完全指南进行全面对比。偏好按量付费的开发者也可以使用 Anthropic API 密钥(而非订阅)来认证 Claude Code,按实际 token 消耗收费。对于已经在使用 AI API 的开发者,laozhang.ai 等平台提供跨多个模型的聚合 API 访问,对于编程场景可以是一种更经济的替代方案。

如何安装 Claude Code(分步教程)

Claude Code 在 macOS、Windows 和 Linux 各平台的分步安装指南

这是本指南的核心部分——你需要运行的实际命令,按平台分类整理。原生安装器是所有平台的推荐方式,因为它打包了 Claude Code 所需的一切,无需你安装 Node.js 或管理 npm 包。以下每种方法均已对照 code.claude.com 的官方文档验证,截至 2026 年 3 月。

macOS 和 Linux(包括 WSL)

在 macOS 或 Linux 上安装 Claude Code 真正只需一条命令,从开始到结束大约两分钟。打开你的终端——在 macOS 上你可以按 Cmd+Space,输入"Terminal"然后按回车,在 Linux 上你可以使用 Ctrl+Alt+T 或你喜欢的终端模拟器。然后运行以下命令:

bash
curl -fsSL https://claude.ai/install.sh | bash

这会下载并运行官方安装脚本,脚本会自动检测你的操作系统和架构,下载对应的二进制文件,并将其放置在系统 PATH 中。安装完成后,你会看到一条成功消息。运行 claude --version 来验证安装,它应该会显示当前版本号(类似 claude v1.0.33 (stable))。如果你使用的是 WSL(Windows 子系统 Linux),过程完全一样——打开 WSL 终端并运行相同的 curl 命令。安装器会将 WSL 视为 Linux 环境,因此不需要任何特殊步骤。验证完成后,只需在任意项目目录中输入 claude 即可启动交互式会话,开始使用 AI 驱动的编程辅助。

Windows 安装

Windows 安装相比 macOS 和 Linux 需要多一个额外步骤:你必须在运行 Claude Code 安装器之前先安装 Git for Windows。这不是可选的——没有它安装器会失败,而且这个要求经常出乎许多用户的意料,因为并非每个指南都会重点提及它。从 git-scm.com/download/win 下载 Git for Windows,使用默认设置运行安装程序,安装完成后务必重启你的终端,以确保 Git 在 PATH 中可用。

Git 安装好之后,你有两种方式在 Windows 上安装 Claude Code。推荐方式是使用 PowerShell——打开 PowerShell(你可以右键点击开始按钮并选择"Windows PowerShell"或"终端"),然后运行:

powershell
irm https://claude.ai/install.ps1 | iex

如果你更习惯使用传统的命令提示符(CMD),可以使用这个替代命令:

cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

两条命令达到的效果相同:下载官方安装器、解压 Claude Code 二进制文件并配置 PATH。PowerShell 方式稍微更简洁,因为它不会留下临时文件。安装后,在新的终端窗口中使用 claude --version 进行验证。如果命令未被识别,你可能需要关闭并重新打开终端以刷新 PATH 环境变量。Windows 上一个常见的坑是,一些开发者会尝试使用 Git Bash(Git for Windows 自带的 Bash 模拟器)来运行基于 curl 的 macOS/Linux 安装命令——虽然这有时可行,但并不是推荐的做法。请坚持使用 PowerShell 或 CMD 方式以获得最可靠的 Windows 安装体验。如果你在 Windows 上使用 WSL,你应该在 WSL 环境内使用 Linux 的 curl 命令进行安装,而不是使用 Windows 的 PowerShell 安装器,因为 WSL 维护着自己独立的文件系统和 PATH 配置。

包管理器替代方案(Homebrew 和 WinGet)

对于偏好通过包管理器管理所有工具的开发者,Claude Code 可通过 macOS 上的 Homebrew 和 Windows 上的 WinGet 获取。在 macOS 上,只需运行 brew install --cask claude-code——这会将 Claude Code 安装为 Homebrew cask,意味着更新通过 brew upgrade 管理而非内置自动更新器。在 Windows 上,你可以使用 winget install Anthropic.ClaudeCode 通过 Windows 包管理器进行安装。两种包管理器方式提供与原生安装器相同的 Claude Code 二进制文件,并自动处理 PATH 配置。代价是你需要通过包管理器来管理更新,而非使用 Claude Code 的内置更新机制。部分开发者更喜欢这种方式以保持工具链的一致性,而另一些人则觉得不如自动更新方便。

原生安装器 vs Homebrew vs npm:你应该选择哪个?

Claude Code 安装方式对比图,展示原生安装器、Homebrew 和 npm 三种方法

三种不同的安装方式(加上 Windows 的 WinGet)可能让选择变得困惑。但实际上比看起来简单得多:对于绝大多数用户,原生安装器是正确的选择,Anthropic 自己的文档也明确推荐它。原生安装器不需要 Node.js 这样的运行时依赖,包含自动更新功能让你始终使用最新版本,并提供最稳定的体验,因为它是 Anthropic 主要测试和支持的方式。它适用于所有平台——macOS、Windows、Linux 和 WSL——每个操作系统只需一条特定的安装命令。

Homebrew 和 WinGet 是不错的替代方案,适合那些强烈偏好通过统一包管理器管理所有开发工具的用户。许多资深开发者通过 brewwinget 命令维护整个工具链,对 Claude Code 使用同样的方式可以保持工作流的一致性。代价是更新不是自动的——你需要显式运行 brew upgradewinget upgrade 来获取新版本,这意味着你可能会落后于最新的功能和错误修复。对于需要控制更新节奏的企业环境,这反而可以是一个优势,因为你可以选择何时更新,而不是被自动推送更新。

理解为什么原生安装器被如此强烈推荐,有助于你正确看待其他选项。Anthropic 将原生安装器设计为完全自包含的:它不依赖任何系统级包管理器或运行时环境,从而消除了一整类与依赖冲突、版本不匹配和 PATH 污染相关的安装问题。它安装的二进制文件针对你的特定平台和架构静态编译,这意味着它比需要 Node.js 运行时来执行的 npm 版本启动更快、运行更可靠。自动更新机制会在你每次启动 Claude Code 时检查新版本,并在后台无缝应用更新,确保你始终能够访问最新的模型改进和错误修复,无需任何手动干预。

npm 方式(npm install -g @anthropic-ai/claude-code)仍然可用,但根据当前文档已被官方弃用(code.claude.com,2026 年 3 月)。如果你之前通过 npm 安装了 Claude Code,它会继续工作,但 Anthropic 建议迁移到原生安装器以获得更好的性能、稳定性和自动更新。npm 方式还要求系统上安装 Node.js 18 或更高版本,这对于一个实际上不需要 Node.js 来运行的工具来说是不必要的依赖。如果你目前正在使用 npm 安装版本,迁移过程很简单:先用 npm uninstall -g @anthropic-ai/claude-code 卸载 npm 包,然后使用你所在平台对应的 curl 或 PowerShell 命令安装原生版本。你的配置和设置会被保留,因为它们存储在你的主目录中,而不在 npm 包位置中。

安装后的前 5 分钟

安装完成后,从"已安装"到"高效使用"应该是无缝衔接的,而这正是 Claude Code 的设计目标。你第一次在终端中运行 claude 时,会被引导完成一个认证流程,将 CLI 连接到你的 Claude 账户。系统会提示你通过浏览器登录,在那里你可以授权 Claude Code 使用你的 Pro、Max 或 API 凭证。这是一次性设置——后续启动会使用已保存的认证信息。

完成认证后,最重要的一点是理解 Claude Code 是基于你当前工作目录感知上下文的。在启动 Claude 之前,先用 cd /path/to/your/project 导航到你的项目文件夹,它会自动扫描并理解你的代码库结构。只需输入 claude(不带任何参数)即可启动交互式会话。然后你就可以用自然语言与 Claude 对话:请它解释某个函数的工作原理、要求它实现一个新功能、让它查找并修复一个 bug,或指示它重构一个模块。Claude Code 会读取你的文件、进行编辑、创建新文件,甚至可以代你运行终端命令(需要你的许可)。一些特别实用的首次使用命令包括 claude "explain the architecture of this project"(用于熟悉一个不了解的代码库),或 claude "run the tests and fix any failures"(立即获得实际价值)。你还可以使用单次执行模式,直接将请求作为参数传入——例如 claude "add input validation to the user registration form"——它会执行任务后退出而不启动交互式会话,非常适合快速修复或脚本化工作流。

理解 Claude Code 如何管理权限对于信任它处理你的代码库至关重要。默认情况下,Claude Code 在进行任何文件更改或运行 Shell 命令前都会请求你的批准,它会准确显示它打算做什么并等待你的确认。你可以通过权限模式调整这一行为:默认模式要求对每个操作进行批准,"acceptEdits"模式会自动批准文件编辑但仍会询问 Shell 命令,还有更宽松的模式供希望更快执行的资深用户使用。这个权限系统意味着你永远不必担心 Claude Code 做出意外更改——每一项修改在执行前都是可见且经过批准的,让你获得与手动修改相同的控制力,同时享受 AI 辅助带来的速度和准确性优势。

除了交互式会话,Claude Code 还支持多种资深用户日常依赖的工作流模式。你可以通过管道将内容直接传给 Claude,例如用 git diff | claude "review this code change" 进行快速代码审查,或用 cat error.log | claude "diagnose the root cause of these errors" 进行快速调试。/init 命令会在你的项目根目录创建一个 CLAUDE.md 文件,为 Claude 提供关于你项目的约定、编码规范和重要架构决策的持久上下文——可以把它看作一份简报文档,让每次后续交互都更加高效。资深用户通常会在这个文件中填入技术栈信息、测试要求和编码风格偏好,这会显著提高 Claude 在各次会话中建议的质量和一致性。

你还可以通过设置来配置 Claude Code 的行为,包括选择关注的发布渠道(稳定版 vs 测试版)、设置 MCP(模型上下文协议)服务器以扩展工具访问能力,以及为你偏好的终端环境自定义键盘快捷键。MCP 集成功能特别强大,因为它允许 Claude Code 与外部工具和服务交互——数据库、问题追踪器、文档系统——赋予它远超简单代码编辑的能力。对于已经在项目中使用 AI API 的开发者,laozhang.ai 等服务通过单一 API 端点提供对多个 AI 模型的聚合访问,当你需要将 AI 功能直接集成到应用中时,可以作为 Claude Code 能力的补充。

修复 5 个最常见的安装问题

即使安装过程非常简单,事情也可能出错——而且在安装阶段出错尤其令人沮丧,因为你甚至无法开始使用这个工具。以下是社区讨论和支持渠道中出现频率最高的五个问题及其解决方案。

**安装后提示"command not found"**是最常见的问题,几乎总是因为你的 Shell PATH 没有更新。安装器会将 Claude Code 添加到 PATH 中,但你当前的终端会话可能没有接收到这个变更。最简单的解决方法是完全关闭终端并打开一个新的。如果这不起作用,检查安装是否在你的 Shell 配置文件中添加了条目,运行 cat ~/.bashrc | grep claude(Zsh 用户检查 ~/.zshrc)。在 Windows 上,打开一个新的 PowerShell 窗口——不要重复使用运行安装器的那个窗口。如果 PATH 条目完全缺失,你可以手动将 Claude Code 二进制文件的位置添加到 PATH,它通常位于 macOS/Linux 的 ~/.claude/bin

**Windows 上提示"Git not found"**是第二常见的问题,而且完全可以预防。Windows 上的 Claude Code 安装器依赖于 Git for Windows 在系统 PATH 中可用。如果你已经安装了 Git 但安装器仍然找不到它,最可能的原因是你在安装 Git 时没有勾选"Add Git to PATH"选项,或者你在安装 Git 后没有重启终端。重新安装 Git for Windows,确保选择将 Git 添加到系统 PATH 的选项,然后在重新尝试 Claude Code 安装之前重启你的终端。你可以在新的终端窗口中运行 git --version 来验证 Git 是否正确配置。

认证失败通常发生在你的 Claude 账户没有所需的订阅档位时。请记住,免费方案不包含 Claude Code 访问权限——你至少需要 Pro 订阅($20/月)。如果你有 Pro 订阅但仍然无法认证,尝试先运行 claude logout 然后运行 claude login 清除缓存凭证并重新发起认证流程。网络问题,特别是阻止 Anthropic 认证端点的企业防火墙或 VPN,也可能导致认证失败。在这种情况下,检查你是否能在同一网络下通过浏览器访问 claude.ai。

安装过程中的权限错误发生在安装器无法写入目标目录或执行下载的二进制文件时。在 macOS 和 Linux 上,这通常意味着你需要调整 ~/.claude 目录的权限或使用适当的用户权限运行安装器。重要的是,除非绝对必要,否则不要使用 sudo 进行安装,因为以 root 身份运行安装器会在你的主目录中创建 root 拥有的文件,这会在你之后尝试以普通用户身份运行 Claude Code 时导致不同的权限问题。如果你之前使用了 sudo 运行安装器,请用 sudo chown -R $(whoami) ~/.claude 修复所有权,然后不使用 sudo 重新尝试。在 Windows 上,以管理员身份运行 PowerShell 可以解决大多数与权限相关的安装失败——右键点击 PowerShell 图标并选择"以管理员身份运行",然后再运行安装命令。如果你处于写入访问受限、有终端保护软件或应用白名单策略的企业环境中,你可能需要请求 IT 团队将 Claude Code 的安装目录和二进制文件加入白名单。

旧 npm 安装版本的冲突可能会导致令人困惑的行为,如果你之前通过 npm 安装了 Claude Code 然后又安装了原生版本。两个版本可能同时存在于你的 PATH 中,你的 Shell 可能会找到错误的那一个。运行 which claude(macOS/Linux)或 where claude(Windows)来查看正在执行的是哪个二进制文件。如果它指向 npm 安装(通常类似 /usr/local/bin/claude 或 Node.js 安装路径中的某个位置),请先用 npm uninstall -g @anthropic-ai/claude-code 卸载 npm 版本,然后验证原生安装版本是否被正确找到。原生安装器在大多数系统上将二进制文件放在 ~/.claude/bin/claude。移除 npm 版本后,打开一个新终端并再次运行 which claude 确认你现在使用的是原生二进制文件。如果两个版本都安装过,还值得检查你是否看到了过时的缓存版本信息,运行 claude --version 来验证你是否在使用最新的原生发行版。

如果你遇到上述未涵盖的问题,code.claude.com 上的官方 Claude Code 故障排除指南提供了更多解决方案,而 claude doctor 命令会执行诊断检查,自动识别常见的配置问题。运行 claude doctor 会输出关于你的系统配置、认证状态和检测到的问题的详细报告,是安装出问题时最好的起点。

保持安全和保持更新

安全性通常不是你安装开发者工具时首先想到的事情,但 Claude Code 呈现了一个值得关注的特殊情况。2026 年,安全研究人员发现了一场通过 Google 广告推广假冒 Claude Code 安装页面、传播名为"InstallFix"攻击的恶意软件的运动(由 BleepingComputer 和 TechRepublic 报道)。这些恶意页面看起来与 Anthropic 的官方下载页面惊人地相似,并以付费广告的形式出现在搜索结果的顶部。结论简单但至关重要:只从官方来源安装 Claude Code。合法的安装 URL 包括 macOS/Linux 的 claude.ai/install.sh、Windows PowerShell 的 claude.ai/install.ps1、官方 Homebrew cask、WinGet 包 Anthropic.ClaudeCode,或官方 npm 注册表中的 npm 包 @anthropic-ai/claude-code。如果你是通过 Google 广告或不熟悉的网站到达安装页面的,在运行任何命令之前请仔细验证 URL。

要在安装后验证安装的完整性,请使用 claude --version 检查版本输出——合法安装会显示类似 claude v1.0.33 (stable) 这样干净的版本字符串。如果你看到任何异常、意外的品牌信息,或二进制文件位于意外的目录中(在 macOS/Linux 上使用 which claude 检查),请立即删除它并从官方来源重新安装。另外值得注意的是,Claude Code 仅与 Anthropic 的服务器通信进行 AI 处理——它不会将你的代码发送到任何第三方服务,你可以通过工具的透明度功能查看确切传输了什么数据。

使用原生安装器保持 Claude Code 更新非常简单,它会在你启动工具时自动检查并应用更新。你可以用 claude --version 手动检查当前版本,用 claude update 触发更新检查。如果你通过 Homebrew 安装的,定期运行 brew upgrade claude-code 来保持最新。对于 WinGet 安装,使用 winget upgrade Anthropic.ClaudeCode。保持最新版本不仅是为了新功能,还关系到安全补丁和稳定性改进。Claude Code 团队频繁发布更新,通常每周多次,因此原生安装器的自动更新机制确实很有价值,能确保你始终拥有最新的修复和功能,无需任何手动干预。你还可以通过 Claude Code 的设置在稳定版和测试版发布渠道之间选择——稳定版推荐用于生产工作,而测试版可以让你提前访问新功能。

常见问题解答

Claude Code 是免费的吗?

Claude Code 本身是免费安装的——二进制文件无需付费下载。但是,你需要一个付费的 Claude 账户来进行认证和实际使用。最低要求是 $20/月(年付 $17/月)的 Claude Pro 订阅。免费的 Claude 方案不包含 Claude Code 访问权限。另外,你也可以使用 Anthropic API 密钥进行按量付费,按编程会话中消耗的 token 收费,而非固定的月费。

Claude Code 可以离线使用吗?

不可以,Claude Code 需要互联网连接才能工作。它通过云端与 Anthropic 的 Claude 模型通信来处理你的请求,因此使用时需要稳定的互联网连接。你的代码本身会在本地处理以提供上下文,但 AI 推理发生在 Anthropic 的服务器上。工具确实会在本地缓存一些配置,因此启动和基本导航在没有网络的情况下也能工作,但任何实际的 AI 驱动辅助都需要在线。

Claude Code 可以和 VS Code 或 JetBrains 一起使用吗?

Claude Code 是一个独立的终端工具,不需要任何 IDE。但是,由于它在终端中运行,可以与任何编辑器或 IDE 并行工作。许多开发者在 VS Code 的集成终端中以分屏布局运行 Claude Code,或在 JetBrains IDE 旁边打开一个单独的终端标签页。也有社区构建的扩展可以将 Claude Code 更深入地集成到特定编辑器中,但原生终端体验是主要支持的工作流。

如何卸载 Claude Code?

原生安装器包含一个干净的卸载选项。运行 claude uninstall 即可删除二进制文件及其关联文件。如果你通过 Homebrew 安装的,使用 brew uninstall claude-code。对于 WinGet,使用 winget uninstall Anthropic.ClaudeCode。如果通过 npm 安装的,使用 npm uninstall -g @anthropic-ai/claude-code。默认情况下,卸载时会保留 ~/.claude/ 中的配置文件,因此你可以在之后重新安装而不会丢失设置。

Claude Code 和 Claude 桌面应用有什么区别?

Claude 桌面应用提供类似 claude.ai 的图形化聊天界面,但作为你电脑上的原生应用运行。另一方面,Claude Code 是专为软件开发设计的命令行工具。Claude Code 可以读取和修改你项目中的文件、运行终端命令、与 git 交互,以及执行多文件编辑——这些是桌面应用所不具备的能力。你可以把桌面应用看作通用型 AI 助手,而 Claude Code 是一个专业的编程伙伴,驻留在你的终端中。

Claude Code 的使用量如何计入我的订阅限额?

Claude Code 的使用量确实会计入你的订阅使用限额。在 Pro 方案中,你每天有一个可观但有限的使用量,而繁重的 Claude Code 会话(特别是涉及大型代码库或大量连续操作的会话)可能会快速消耗这个配额。$100/月的 Max 方案提供大约 Pro 20 倍的使用容量,这就是为什么 Anthropic 推荐在工作日中大量使用 Claude Code 的开发者选择它。如果你达到使用限额,Claude Code 会通知你,你需要等待限额重置(通常基于滚动窗口)或升级到更高的档位。使用 API 密钥代替订阅可以获得按量付费的定价模式,没有硬性的每日限额,但密集使用时成本可能会累积。

Claude Code 可以在 CI/CD 流水线或自动化脚本中使用吗?

可以,Claude Code 支持非交互式使用,能在自动化环境中良好运行。你可以直接将命令作为参数传入,例如 claude -p "generate unit tests for src/utils.ts",它会执行任务并输出结果,无需任何交互提示。对于 CI/CD 集成,你通常会使用存储为环境变量的 API 密钥进行认证,而非交互式浏览器登录。这使得在构建流水线中使用 Claude Code 进行自动化代码审查、测试生成或文档更新成为可能。--output-format json 标志在脚本场景中特别有用,因为它返回结构化输出,其他工具可以通过编程方式解析。

立即开始使用 Claude Code

在任何平台上安装 Claude Code 都不到五分钟,而原生安装器使这个过程简单到只需运行一条命令。首先确认你的系统满足要求(macOS 13+、Windows 10 1809+ 或 Linux Ubuntu 20.04+),确保你有一个 Claude Pro 订阅(最低 $20/月)或 Anthropic API 密钥,然后运行适合你平台的安装命令。原生安装器是大多数用户的推荐选择——它自动处理依赖项、无需手动干预即可保持更新,并提供 Anthropic 积极测试和支持的最可靠体验。

请记住只从官方来源下载(claude.ai、code.claude.com 或 GitHub anthropics/claude-code),以保护自己免受通过假冒 Google 广告针对 Claude Code 用户的恶意软件攻击。如果在安装过程中遇到问题,上面的故障排除部分涵盖了五个最常见的问题及其解决方案,claude doctor 命令始终可以作为诊断的起点。安装完成后,导航到你的项目目录,输入 claude,然后开始构建——无论是实现新功能、重构旧代码,还是调试跨越整个代码库的棘手问题。你的终端刚刚成为了你最强大的编程工具,而你现在已经掌握了在任何平台上安全有效地安装、配置和维护 Claude Code 所需的一切知识。

分享文章:

laozhang.ai

一个 API,所有 AI 模型

AI 图片

Gemini 3 Pro Image

$0.05/张
官方2折
AI 视频

Sora 2 · Veo 3.1

$0.15/个
异步API
AI 对话

GPT · Claude · Gemini

200+ 模型
同官方价
已服务 10万+ 开发者
|@laozhang_cn|送$0.1