轻松在 Windows 和 Mac 上安装 Claude Code

在 Windows 或 Mac 上快速安装 Claude Code，配置开发环境，并连接 Kimi API 以实现高级 AI 工作流。自动处理复杂任务、运行多步骤流程，并通过更智能的 AI 集成提升编程体验。

阅读时长：10 分钟更新于：2026-09-28

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.将以下安装命令复制并粘贴到 PowerShell 中，然后按“Enter”运行：

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

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

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

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

下载 Git 后，打开安装程序并使用默认设置完成安装.请勿更改安装路径；如果出现提示，请选择“Visual Studio Code”作为默认编辑器，并确保在 PATH 配置选项中选中“Git from the command line and 3rd-party software”\。

安装完成后，从开始菜单打开“Git Bash”，确认 Git 是否正常运行.Git Bash 提供了 Claude Code 在 Windows 上运行命令所需的终端环境\。

第 3 步：验证 Claude Code 安装

返回 PowerShell 或命令提示符，然后运行：

claude --version

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

第 4 步：安装完成

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

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

macOS 借助内置终端，为开发者提供了简洁的开发工具配置方式，安装过程顺畅且一致. Claude Code 的配置只需遵循清晰的终端操作流程，便于保持整洁和管理. 以下是在 Mac 上安装 Claude Code 的方法。

第 1 步：通过终端安装 Claude Code (curl 命令)

通过 Spotlight 搜索在 Mac 上打开“终端”(Cmd + Space → 输入“Terminal”). 将以下安装命令复制并粘贴到终端中，然后按“Enter”：

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

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

第 2 步：确认 Claude Code 已安装

等待安装过程完全结束. 完成后，会显示确认消息，表明 Claude Code 已成功安装. 如果终端要求进行额外配置，请运行建议的命令，将 Claude Code 添加到 zshrc 配置文件中，以便正常访问。

第 3 步：加载环境配置

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

第 4 步：启动 Claude Code

在终端中输入：

claude

按 Enter 启动 Claude Code CLI. 随后会显示设置界面，你可以选择偏好的主题和登录方式，完成最终配置。

如何将其他 LLM API 集成到 Claude Code 中？

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

第 1 步：获取 Kimi Code API 密钥

注意：本指南使用的 api.kimi.ai/coding/ 端点属于 Kimi Code 会员权益。创建密钥前，请确保你的 Kimi 会员资格处于有效状态，且已激活 Kimi Code 权益——免费账户的密钥将在启动时被拒绝。

前往 Kimi Code 控制台，点击 创建 API 密钥，输入名称并确认，然后立即复制密钥——完整密钥仅显示一次。可用模型和上下文窗口取决于你的会员套餐（例如，旧版 Andante 套餐使用具有 1M 上下文的 kimi-for-coding；Plus/Moderato 套餐可使用 k3-256k；Pro/Allegretto 及以上套餐可使用具有 1M 上下文的 k3 或高速版）。

将 Claude Code 连接至 Kimi API

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

安装完成后，暂时不要启动 Claude Code. 在终端中运行以下脚本，以跳过默认的新手引导/登录流程并清理历史配置. 该脚本会启用第三方模型支持和快速模式，并从 ~/.claude/settings.json 中删除过时的端点、凭据和模型条目（其中残留的配置会覆盖终端中导出的环境变量）：

node --eval " // enable third party model support and fast mode const claudeJsonFilePath = path.join(os.homedir(), '.claude.json'); if (fs.existsSync(claudeJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeJsonFilePath, 'utf-8')); fs.writeFileSync(claudeJsonFilePath, JSON.stringify(Object.assign({}, content, { penguinModeOrgEnabled: true, hasCompletedOnboarding: true }), null, 2), 'utf-8'); } else { fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ penguinModeOrgEnabled: true, hasCompletedOnboarding: true }, null, 2), 'utf-8'); } // delete old endpoint, credential and model id const claudeSettingsJsonFilePath = path.join(os.homedir(), '.claude', 'settings.json'); if (fs.existsSync(claudeSettingsJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeSettingsJsonFilePath, 'utf-8')); if (typeof content === 'object' && typeof content.env === 'object') { for (const element of [ 'ANTHROPIC_BASE_URL', 'ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_MODEL', 'ANTHROPIC_SMALL_FAST_MODEL', 'CLAUDE_CODE_SUBAGENT_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME', 'ANTHROPIC_DEFAULT_OPUS_MODEL', 'ANTHROPIC_DEFAULT_OPUS_MODEL_NAME', 'ANTHROPIC_DEFAULT_SONNET_MODEL', 'ANTHROPIC_DEFAULT_SONNET_MODEL_NAME', 'ANTHROPIC_DEFAULT_HAIKU_MODEL', 'ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME', 'ENABLE_TOOL_SEARCH', 'CLAUDE_CODE_AUTO_COMPACT_WINDOW', 'CLAUDE_CODE_EFFORT_LEVEL', ]) { delete content.env[element]; } fs.writeFileSync(claudeSettingsJsonFilePath, JSON.stringify(content, null, 2), 'utf-8'); } }"

此脚本需要 Node.js（使用 node --version 检查；如果找不到该命令，请先从 nodejs.org 安装 LTS 版本）。脚本成功时不会输出任何内容——这是正常现象。还应检查 ~/.zshrc、~/.bashrc 等 shell 配置文件中是否存在过时的 ANTHROPIC_* 导出项（Windows 用户请检查用户环境变量），并将其删除，否则会干扰新配置。

第 3 步：配置 API 访问并启动 Claude Code

有两种配置方法——二选一，切勿混用。方法 1 会写入 ~/.claude/settings.json，永久生效；方法 2 仅在当前终端中导出变量，仅对本次会话有效。以下示例使用 k3-256k（256K 上下文）；如果你的套餐包含 1M 上下文的 k3，请将所有模型值替换为 k3[1m]，并将两个上下文值均设为 1048576。

方法 1：写入 settings.json（推荐，持久生效）

将以下内容写入 ~/.claude/settings.json 的 env 字段中（Windows：%USERPROFILE%\.claude\settings.json；如果文件不存在，请创建），然后重启 Claude Code 使其生效：

{ "env": { "ANTHROPIC_BASE_URL": "https://api.kimi.ai/coding/", "ANTHROPIC_API_KEY": "Your API Key", "ANTHROPIC_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3-256k", "CLAUDE_CODE_SUBAGENT_MODEL": "k3-256k", "CLAUDE_CODE_EFFORT_LEVEL": "high", "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144", "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144" } }

将 Your API Key 替换为你在第 1 步复制的密钥。该文件会以明文存储密钥——请勿将其提交到 git。请注意，settings.json 中的 env 块会覆盖终端中导出的同名变量。

方法 2：终端环境变量（仅当前会话）

macOS / Linux

export ANTHROPIC_BASE_URL=https://api.kimi.ai/coding/ export ANTHROPIC_API_KEY="Your API Key" export ANTHROPIC_MODEL="k3-256k" export ANTHROPIC_DEFAULT_FABLE_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_OPUS_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_SONNET_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_HAIKU_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_SUBAGENT_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_EFFORT_LEVEL=high export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144 export CLAUDE_CODE_MAX_CONTEXT_TOKENS=262144 claude

Windows

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

$env:ANTHROPIC_BASE_URL="https://api.kimi.ai/coding/" $env:ANTHROPIC_API_KEY="Your API Key" $env:ANTHROPIC_MODEL="k3-256k" $env:ANTHROPIC_DEFAULT_FABLE_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_OPUS_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_SONNET_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_HAIKU_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_SUBAGENT_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_EFFORT_LEVEL="high" $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144" $env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="262144" claude

将 Your API Key 替换为你在第 1 步复制的密钥。如果只配置部分模型变量，对应场景（主对话、后台摘要、子智能体）会静默失败，因此请保留完整配置。

如果系统提示是否使用此 API 密钥，请确认继续. 之后，按照提示选择你信任的项目文件夹，以完成授权。

第 4 步：验证集成状态

启动后，运行：

/status

如果 Base URL 显示：

https://api.kimi.ai/coding/

则说明集成成功。即使界面仍显示 Claude 模型，所有请求也都会通过 Kimi Code API 路由。

使用 Kimi API 的优势

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

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

Kimi API 能够理解文本、设计稿、架构图、流程图，甚至视频等不同类型的输入。它可以将这些信息转化为开发者可直接使用的清晰技术方案，减少手动规划工作，更快将想法转化为可运行的代码。

通过上下文复用降低成本

Kimi API 支持上下文复用，开发者无需反复发送相同信息，即可基于已有对话和项目上下文继续工作。这有助于减少不必要的 token 用量、降低 API 成本，并提升长期开发工作流的效率。

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

日常且重复的编码任务可以通过脚本或基于人工智能的工作流实现自动化。这些任务只需简单命令即可运行，无需每次手动操作，从而节省时间并减少日常开发流程中人为出错的可能性。

通过技能和工具自定义开发工作流

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

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

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

Claude Code 安装故障排除

在 Windows 或 Mac 上安装 Claude Code 时，用户有时会因环境配置、Node.js 版本或网络状况而遇到一些小问题。这类问题在基于 CLI 的工具中很常见，通常可以解决。以下列出了最常见的问题及其实用的判断方法。

“command not found: claude”

此错误通常表示 Claude Code 尚未添加到系统 PATH，终端无法找到已安装的二进制文件。重启终端或修正 PATH 设置，通常就能快速可靠地解决这一问题。

身份验证失败，或浏览器未打开

当登录流程无法自动唤起浏览器时会出现这种情况，常见于受限系统或远程环境。此时可能需要使用 API 密钥手动完成身份验证。配置完成后，登录流程即可正常运行，无需再做其他处理。

安装期间出现“Network Error”或超时

通常由网络缓慢、防火墙限制或 npm 访问受阻导致。安装程序在配置过程中可能无法连接到所需服务器。调整网络设置、代理配置或切换网络连接，通常能有效解决问题。

Claude Code 运行缓慢

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

结语

了解如何在 Windows 或 Mac 上安装 Claude Code，有助于你更顺畅地开始使用 AI 辅助开发工作流。完成设置后，你可以更高效地管理编码任务，并在更集成的环境中简化日常开发工作。如需满足更高级或更灵活的使用场景，可以试用 Kimi API 来扩展这些能力，改进实际开发工作流。

将 Claude Code 连接至 Kimi API

常见问题

打开终端或 PowerShell，输入命令 claude，即可启动 Claude Code。按 Enter 键启动 CLI 界面。如果安装正确，将显示设置界面，引导你登录或选择项目。之后，你可以直接在终端中使用命令。

不一定需要付费订阅，但部分功能可能取决于你的套餐或访问权限。根据配置情况，基本使用和设置通常可通过标准访问权限完成。高级功能或更高限额可能需要订阅。建议查看 Claude 官方套餐详情以确认。

Kimi API 为 Claude Code 提供高级上下文处理、自动化和多步骤工作流支持。它能更高效地处理长输入、结构化任务和复杂的开发指令，从而提高编程速度并减少手动操作，让工作流更灵活、更高效。