← सभी गाइड पर लौटें

2026版：Windows/macOS/Linux 安装 Claude Code 指南

先说结论：2026 年最稳的安装思路

Claude Code 本质上是一个面向终端的开发助手，最佳实践不是“装上就算”，而是先把系统环境、Node.js 版本和模型接入方式一次配好。这样后续无论是补全、重构、读日志，还是让它批量改代码，都更稳定。

• Windows：优先用 WSL2 + Ubuntu，不建议直接在原生 PowerShell 里硬装。
• macOS：直接用 Homebrew 和终端安装，最省事。
• Linux：用 nvm 管理 Node 版本，避免系统包冲突。

安装前准备

先准备好 Node.js 20 以上版本、Git 和一个干净的终端环境。Claude Code 的很多问题并不是工具本身，而是旧版 Node、全局 npm 权限或代理配置导致的。2026 年最推荐的做法是：用 nvm 管理 Node 版本，把 API Key 放进环境变量，不要写进仓库。

安装 Claude Code 后，一般通过全局 npm 包运行。完成后先执行 claude --version，确认命令可用，再继续接入模型。

Windows：用 WSL2 是最稳方案

在 PowerShell 中执行 wsl --install，然后安装 Ubuntu。进入 WSL 后更新系统，并用 nvm 安装 Node.js 20+。接着执行 npm 全局安装 Claude Code。这个方案比直接在 Windows 原生环境里折腾路径和权限问题稳定得多。

然后把环境变量写入 Linux shell 配置文件，比如 ~/.bashrc 或 ~/.zshrc：export ANTHROPIC_API_KEY=你的密钥，export ANTHROPIC_BASE_URL=https://api.59api.com。保存后执行 source ~/.bashrc 让配置生效。最后运行 claude --version 和一次简单对话测试，确认能连通接口。

macOS：Homebrew + 终端直接装

macOS 上最简单：先用 brew install node git 安装基础工具，再执行 Claude Code 的全局安装命令。Apple Silicon 和 Intel 都建议使用终端原生环境，不要混用太多包管理器。

接着编辑 ~/.zshrc，加入 export ANTHROPIC_API_KEY=你的密钥 和 export ANTHROPIC_BASE_URL=https://api.59api.com，然后执行 source ~/.zshrc。这样以后打开新终端就能直接使用。若你经常在多个项目之间切换，建议把代理、Key 和模型选择都写进独立的 shell profile，方便维护。

Linux：用 nvm 保持环境干净

Linux 用户通常已经有较多开发工具，但最容易踩坑的是系统自带 Node 版本过旧。建议先安装 curl、git，再用 nvm 装 Node 20+，然后再全局安装 Claude Code。Debian/Ubuntu、Fedora、Arch 都适用这个思路。

配置方式与 macOS 类似：在 ~/.bashrc 中加入 export ANTHROPIC_API_KEY=你的密钥 和 export ANTHROPIC_BASE_URL=https://api.59api.com，重新加载 shell 后即可。若你在服务器或远程开发环境里使用 Claude Code，记得把终端会话的超时、代理和权限一起检查，避免半夜跑任务时掉线。

为什么 59API 适合 Claude Code

如果你希望把 Claude Code 的使用成本压低，59API 是很值得考虑的接入层。它提供按量付费，支持 Claude Opus、Sonnet、Haiku、Fable 等模型，并且与 Claude Code、Codex 以及任何 OpenAI SDK 兼容。只要把 base URL 指向 https://api.59api.com，再填入 59API 密钥，就能用接近官方品质的模型能力做日常编码，而不用为固定套餐买单。

对个人开发者来说，低频使用时尤其省钱；对团队来说，还能通过返佣机制进一步降低长期成本。更重要的是，这种接法不会迫使你改工作流，Claude Code 仍然在你熟悉的终端里工作。

常见问题与排查

• 报认证错误：先检查 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL 是否拼写正确，终端是否重新加载。
• Windows 运行失败：优先确认自己是在 WSL2 的 Ubuntu 里，而不是原生 PowerShell。
• 速度慢或超时：先排查本地网络和代理，再根据任务复杂度切换到更合适的模型档位。

如果你打算把 Claude Code 作为长期开发搭档，建议直接注册 59API，按上面的方式把环境配好，再开始你的第一个项目。这样既省时间，也更省预算。

मूल्य · दस्तावेज़