📅 2026-2-1
Claude Code 最近推出了原生安装（Native Installation）方式，这是一个重要的更新。新的安装方式彻底改变了 Claude Code 的部署体验，将其从基于 Node.js 的应用转变为单一的自包含可执行文件。
在原生安装推出之前，Claude Code 依赖于 Node.js 运行环境，这是有一些问题的：
- 环境依赖复杂：用户需要先安装 Node.js 和 npm，增加了入门门槛
- 版本兼容问题：不同的 Node.js 版本可能导致兼容性问题
- 更新机制不稳定：基于 npm 的更新流程偶尔会出现问题
原生安装的推出解决了这些痛点。
技术实现：从 TypeScript 到原生二进制
你可能会好奇：Claude Code 不是用 TypeScript 开发的吗？它是如何做到”无 Node.js 依赖”的？
答案是 Bun。
Bun 是一个现代的 JavaScript 运行时（类似 Node.js 和 Deno），但它有一个独特的能力——通过 --compile 标志可以将 TypeScript/JavaScript 代码编译成单一的原生可执行文件。这个过程：
- 转译 TypeScript：首先将 TypeScript 代码转译（transpile）成 JavaScript
- 可选的字节码编译：使用
--bytecode标志时，会将 JavaScript 预编译成 JavaScriptCore 字节码，这样可以跳过运行时的解析步骤，显著提升启动速度 - 打包所有依赖：将转译后的代码和所有 npm 包打包进来
- 嵌入 Bun 运行时：将完整的 Bun 运行时（基于 JavaScriptCore 引擎）一起打包
- 生成平台原生二进制：输出一个自包含的可执行文件，无需任何外部依赖
这类似于 Go 或 Rust 编译出来的单一可执行文件，但本质上它是一个”捆绑了运行时的 JavaScript 应用”。
根据 Anthropic 工程师 Boris Cherny 的说法：
“We’ve been cooking up the new native executable for Claude Code (no more Node.js/NPM dependency!) for a few months now. A HUGE thank you to the Bun team for being amazing partners in making this happen.”
新方案使用 Bun 替代 Node.js，并将 Bun 运行时直接打包进可执行文件中，用户无需单独安装任何运行环境。同时，Bun 的启动速度比 Node.js 快约 4 倍，这主要得益于：
- JavaScriptCore 引擎：Bun 使用 Apple 的 JavaScriptCore（Safari 的 JS 引擎），而 Node.js 使用 V8（Chrome 的 JS 引擎）。JavaScriptCore 优先优化启动时间和内存占用，特别适合 CLI 工具这种短生命周期的应用
- Zig 语言实现：Bun 用 Zig 编写，这是一个低级语言，提供了更好的内存控制和更接近硬件的性能
系统要求
在安装之前，确保系统满足以下要求：
操作系统：
- macOS 10.15 或更高版本
- Ubuntu 20.04+ / Debian 10+ 或其他主流 Linux 发行版
- Windows 10 或更高版本（支持 WSL 1、WSL 2 或 Git for Windows）
硬件：
- 至少 4GB RAM（推荐 8GB 以上）
网络：
- 需要互联网连接用于 API 调用和更新
Shell 环境：
- 在 Bash、Zsh 或 Fish 中运行效果最佳
从旧版本迁移
如果你之前已经通过 npm 安装了 Claude Code，迁移到原生安装非常简单：
claude install
这个命令会自动检测当前安装，并将其迁移到原生二进制版本。迁移过程会保留你的所有配置和设置，包括：
- API Keys
- 自定义配置
- Subagents 定义
- Slash Commands
全新安装
原生安装支持多种平台和安装方式，可以根据具体的系统环境选择最合适的方法。
macOS、Linux 和 WSL
对于 Unix-like 系统，推荐使用 curl 一键安装：
curl -fsSL https://claude.ai/install.sh | bash
这个脚本会自动检测系统架构，下载对应的二进制文件，并配置好环境变量。
如果需要安装特定版本，可以使用：
curl -fsSL https://claude.ai/install.sh | bash -s latest # 最新版本
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58 # 指定版本
macOS上使用Homebrew
对于Homebrew 用户，可以通过 cask 安装：
brew install --cask claude-code
这种方式的优势是可以通过 brew upgrade 统一管理所有应用的更新。
Windows PowerShell
在 Windows PowerShell 中，使用以下命令：
irm https://claude.ai/install.ps1 | iex
Windows CMD
如果使用传统的 Windows 命令提示符：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
验证安装
安装完成后，可以通过以下命令验证：
claude --version
这会显示当前安装的 Claude Code 版本号。如果看到版本信息，说明安装成功。
还可以运行一个简单的测试：
claude "Hello, Claude!"
如果一切正常，Claude Code 会响应你的消息。
自动更新
原生安装内置了改进的自动更新机制。默认情况下，Claude Code 会：
- 定期检查新版本
- 在后台下载更新
- 提示你重启以应用更新
也可以手动触发更新检查：
claude update
如果想完全控制更新时机，可以在配置中禁用自动更新。