如何轻松在 Windows 和 Mac 上安装 Claude Code

在 Windows 或 Mac 上快速安装 Claude Code,配置好环境,并与 Kimi API 搭配使用,实现更高级的 AI 工作流程。自动执行复杂任务、运行多步骤流程,借助更智能的 AI 集成提升编程体验。

阅读时长:10 分钟2026-08-12
在 Windows 和 Mac 上安装 Claude Code

对于希望更快、更高效完成工作的开发者来说,AI 编程工具正变得越来越受欢迎。许多用户选择安装 Claude Code,以简化编程流程、自动化重复性工作,并在同一环境中管理多步骤流程。在 Windows 或 Mac 上正确完成安装,有助于确保运行流畅,并更好地与高级 AI 服务集成。继续阅读,了解如何在 Windows 和 Mac 上安装 Claude Code。

如何在 Windows 上安装 Claude Code?

Windows 11 为运行现代 AI 开发工具提供了流畅的环境。只需完成几个简单的设置步骤,就能确保 Claude Code 正常运行,并与你计划使用的服务顺利连接。请按照以下说明完成安装过程,顺利使用其各项功能。

第 1 步:使用 PowerShell 安装 Claude Code

按 Win + S 组合键并搜索“PowerShell”将其打开。将下方的安装命令复制并粘贴到 PowerShell 中,然后按“Enter”键运行:

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

PowerShell 会自动下载并安装 Claude Code。请等待安装过程完成后再继续。如果你更倾向于使用 CMD 或 WinGet,Claude Code 的官方文档中也提供了其他安装方式。

使用 PowerShell 安装 Claude Code

第 2 步:安装 Git 并启动 Git Bash

下载并安装适用于 Windows 的 Git。保持默认安装设置,以确保 Claude Code 能够访问所需的命令行工具并正常运行。

安装 Git(必需依赖)

下载 Git 后,打开安装程序,使用默认设置完成安装过程。保持安装路径不变,如有提示,选择“Visual Studio Code”作为默认编辑器,并确保在 PATH 配置选项中选中“Git from the command line and 3rd-party software”。

运行 Git 安装程序

安装完成后,从“开始”菜单打开“Git Bash”,验证 Git 是否正常工作。Git Bash 提供了 Claude Code 在 Windows 上运行命令所需的终端环境。

启动 Git Bash

第 3 步:验证 Claude Code 安装

返回 PowerShell 或命令提示符,运行:

claude --version

如果显示出版本号,说明 Claude Code 已成功安装。如果没有显示,请继续进行 PATH 配置步骤。

验证 Claude Code 安装

第 4 步:安装完成

完成所有步骤后,登录 Claude Code 并完成设置流程。登录后,即可直接在 Windows 11 终端中使用该工具运行命令、管理 AI 辅助工作流程。

安装完成

如何在 Mac/macOS 上安装 Claude Code?

macOS 内置的终端支持,为开发者提供了一种简洁易用的方式来配置开发工具,安装过程流畅且稳定。设置 Claude Code 只需按照清晰的终端操作流程进行,整个过程条理清晰、易于管理。下面介绍如何在 Mac 上安装 Claude Code。

第一步:通过终端(curl 命令)安装 Claude Code

使用 Spotlight 搜索(按 Cmd + Space,输入“Terminal”)打开 Mac 上的“终端”。将下面的安装命令复制粘贴到终端中,然后按“Enter”键:

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

终端将自动下载并安装 Claude Code。请等待安装过程完成后再进行下一步。

通过终端(curl 命令)安装 Claude Code

第二步:确认 Claude Code 安装完成

等待安装过程完全结束。完成后会出现确认信息,表明 Claude Code 已成功安装。如果终端要求进行额外设置,请运行提示的命令,将 Claude Code 添加到 zshrc 配置文件中,以确保正常访问。

确认 Claude Code 安装完成

第三步:加载环境配置

安装完成后,运行提供的命令或重新加载你的 shell 配置文件。此步骤会更新环境变量,使 Claude Code 能够在终端中全局使用,避免路径问题。这样可以确保每次打开新的终端窗口时都能顺利访问。

加载环境配置

第四步:启动 Claude Code

在终端中输入:

claude

按 Enter 键启动 Claude Code CLI。此时会出现设置界面,你可以选择喜欢的主题和登录方式,完成最后的配置。

启动 Claude Code

如何将其他大模型 API 接入 Claude Code?

将 Claude Code 与外部 AI 模型配合使用,能让开发工作更加灵活。接入第三方大模型 API,可以让开发者在同一环境中运行不同的模型,更高效地管理任务。例如,具备强大长上下文理解能力和结构化输出能力的 API,能进一步提升编码工作流程。下面以 Kimi 为例,演示如何将外部大模型 API 接入 Claude Code。

第 1 步:在控制台获取 Kimi API Key

要获取 Kimi API Key,首先访问 Kimi 开放平台。注册账号,或者如果已有账号则直接登录。进入控制面板后,前往“API Keys”部分,创建一个新的 API Key。

在控制台获取 Kimi API Key

第 2 步:跳过登录(可选设置脚本)

安装完成后,先不要启动 Claude Code。在终端中运行以下脚本,以跳过默认的引导/登录流程:

node --eval " const homeDir = os.homedir(); const filePath = path.join(homeDir, '.claude.json'); if (fs.existsSync(filePath)) { const content = JSON.parse(fs.readFileSync(filePath, 'utf-8')); fs.writeFileSync(filePath, JSON.stringify({ ...content, hasCompletedOnboarding: true }, null, 2), 'utf-8'); } else { fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }), 'utf-8'); }"

第 3 步:设置环境变量并启动 Claude Code

设置所需的环境变量,将 Claude Code 连接到 Kimi API。

macOS / Linux

export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/ export ANTHROPIC_API_KEY=Your API Key export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144 claude

Windows

在 PowerShell 或系统设置中设置相同的环境变量,然后运行:

$env:ANTHROPIC_BASE_URL="https://api.kimi.com/coding/" $env:ANTHROPIC_API_KEY="Your API Key" $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144" claude

如果系统提示是否使用该 API Key,确认继续即可。之后按照提示选择受信任的项目文件夹,完成授权。

使用新配置运行 Claude Code

第 4 步:验证集成状态

启动后,运行:

/status

如果 Base URL 显示为:

https://api.kimi.com/coding/

那么集成就成功了。即使界面仍显示 Claude 模型,所有请求实际上都已通过 Kimi Code API 转发。

验证集成状态

使用 Kimi API 的优势

在开发中使用先进的 AI 工具,已成为提升工作效率和整体代码质量的实用方法。Kimi API 为实际项目中的理解、自动化和团队协作流程提供了有力支持。以下介绍它如何帮助开发者更高效地构建和管理系统。

  • 面向开发任务的多模态上下文理解

Kimi API 能够理解文本、设计稿、架构图、流程图甚至视频等多种类型的输入,并将这些信息转化为开发者可以直接使用的清晰技术方案。这有助于在减少人工规划的情况下,将想法转化为可运行的代码。

  • 利用上下文复用,降低成本

Kimi API 支持上下文复用,开发者可以在已有的对话和项目上下文基础上继续开发,而不必反复发送相同的信息。这有助于减少不必要的 token 消耗、降低 API 成本,并让长期开发流程更加高效。

  • 自动化重复性的工程流程

常规且重复的编码任务可以通过脚本或 AI 驱动的工作流程实现自动化。这些任务只需简单的命令即可运行,不必每次都手动操作。这样可以节省时间,减少日常开发过程中出现人为失误的可能性。

  • 通过技能和工具打造可定制的开发流程

Kimi API 支持针对不同开发需求的自定义技能和工具集成。团队可以将自己的内部工具、脚本和系统直接接入工作流程,让开发过程更灵活,也更贴合具体项目。

  • 多智能体协作,提升质量与效率

不同的 AI 智能体分别承担编码、测试、架构设计和文档编写等不同角色。这些智能体可以按顺序或并行协作,更快完成任务,从而同时提升开发速度和整体产出质量。

安装 Claude Code 的故障排查

在 Windows 或 Mac 上安装 Claude Code 时,用户有时会因为环境配置、Node.js 版本或网络状况而遇到一些小的技术问题。这些问题在基于 CLI 的工具中很常见,通常都能解决。以下是最常见的问题及其成因说明。

  • “command not found: claude”

这个错误通常意味着 Claude Code 没有被添加到系统的 PATH 中,终端无法找到已安装的可执行文件。重启终端或修正 PATH 设置,在大多数情况下都能快速可靠地解决这个问题。

  • 身份验证失败,或浏览器无法打开

当登录流程无法自动触发浏览器时会出现这种情况,常见于受限系统或远程环境。在这种情况下,可能需要使用 API key 手动完成身份验证。配置完成后,登录流程就能正常运行,不会再出现问题。

  • 安装过程中出现“网络错误”或超时

这通常是由网络速度慢、防火墙限制或 npm 访问被阻止导致的。安装程序在安装过程中可能无法连接到所需的服务器。调整网络设置、代理配置,或更换网络连接,通常能有效解决这个问题。

  • Claude Code 运行缓慢

性能问题通常不是工具本身造成的,而是网络延迟所致。由于 Claude Code 依赖云端 API 请求,不稳定的网络或使用 VPN 都可能拖慢速度。使用稳定的网络连接通常能显著且持续地提升速度。

结语

学会如何在 Windows 或 Mac 上安装 Claude Code,能帮助你更顺利地开启 AI 辅助开发流程。设置完成后,你可以更高效地管理编码任务,在一个更集成的环境中简化日常开发工作。如果需要更高级或更灵活的使用场景,可以尝试使用 Kimi API 来扩展这些能力,改善实际开发流程。

常见问题

安装完成后如何运行 Claude Code?
启动 Claude Code 的方法是打开终端或 PowerShell,输入命令 claude。按 Enter 键即可启动 CLI 界面。如果安装正确,会出现设置界面,引导你完成登录或选择项目。之后就可以直接在终端中使用各种命令了。
使用 Claude Code 需要付费订阅 Claude 吗?
并非所有情况都需要付费订阅,但某些功能可能取决于你的套餐或访问权限。基础的使用和设置通常可以在标准权限下完成,具体取决于配置情况。更高级的功能或更高的限额可能需要订阅才能使用。建议查阅 Claude 官方套餐详情以确认具体情况。
Kimi API 如何提升你在 Claude Code 中的工作流程?
Kimi API 为 Claude Code 增加了对高级上下文处理、自动化和多步骤工作流程的支持。它能更高效地处理长输入、结构化任务和复杂的开发指令,从而提升速度、减少手动操作。总体而言,这让整个工作流程变得更灵活、更高效。
相关推荐
Claude Code API 集成:快速连接外部模型
Claude Code API 集成:快速连接外部模型
2026-08-12
Hermes API 集成指南:搭建方法与工作原理
Hermes API 集成指南:搭建方法与工作原理
2026-08-12
如何将外部 API 连接到 Roo Code
如何将外部 API 连接到 Roo Code
2026-08-12
Droid API 集成:如何接入外部 AI 模型
Droid API 集成:如何接入外部 AI 模型
2026-08-12
2026 年 10 款用于自动化工作流的无代码 AI 智能体
2026 年 10 款用于自动化工作流的无代码 AI 智能体
2026-08-12
安装 Claude Code:Windows 与 Mac 完整指南