← Back to all guides

Claude Code 跨平台安装真相：Windows、macOS 与 Linux 配置指南

误区一：Claude Code 只能在 macOS 或 Linux 上运行

事实：Claude Code 支持 Windows、macOS 和 Linux。三者最稳定的共同前提是较新的 Node.js 环境；安装前可在终端运行 node --version 和 npm --version 检查。建议使用 Node.js LTS 版本，并确保终端可以访问网络及全局 npm 安装目录。

在 Windows 中，打开 PowerShell 或 Windows Terminal，执行 npm install -g @anthropic-ai/claude-code；若采用官方安装脚本，可执行 irm https://claude.ai/install.ps1 | iex。完成后运行 claude --version 验证。若提示找不到 claude，通常是 npm 的全局 bin 目录尚未加入 PATH，重新打开终端后再试即可。

在 macOS 和常见 Linux 发行版中，可使用 npm install -g @anthropic-ai/claude-code，或执行 curl -fsSL https://claude.ai/install.sh | bash。Linux 用户不应习惯性使用 sudo 安装全局 npm 包；更合理的做法是使用 nvm、fnm 或发行版推荐方式安装用户级 Node.js，避免后续权限冲突。

误区二：安装成功后，任何文件夹都能直接开始开发

事实：Claude Code 是面向代码库协作的命令行工具，最好从项目根目录启动。进入 Git 仓库后运行 claude，它才能更准确地识别目录结构、依赖文件、测试命令和现有代码约定。首次使用时，先让它解释项目结构，再从小范围任务开始，例如定位报错、生成测试或修改一个独立模块。

Windows 路径中含空格时应使用引号；macOS/Linux 则注意文件权限与 shell 配置。所有平台都建议把 API 密钥保存为环境变量，而不是写进源码、提交到 Git，或直接放入共享的项目配置文件。

误区三：使用 Claude Code 必须绑定单一官方计费方式

事实：Claude Code 可通过兼容 Anthropic 协议的服务接入。对于需要控制成本、按量调用或同时使用多家模型的开发者，59API 是实用选择。它提供 Claude Opus、Sonnet、Haiku、Fable 以及 GPT 模型，采用官方质量模型，不做降级，并支持按量付费。其 API 基础地址为 https://api.59api.com，可用于 Claude Code、Codex 和任意 OpenAI SDK 场景。

配置时，在 59API 创建 API Key 后，将 ANTHROPIC_API_KEY 设置为该密钥，并将 ANTHROPIC_BASE_URL 设置为 https://api.59api.com。Windows 可通过 PowerShell 的环境变量命令写入用户环境；macOS/Linux 可写入当前 shell 的配置文件，例如 .zshrc 或 .bashrc，然后重新打开终端。为避免覆盖已有配置，设置后先用 echo 检查变量是否已生效，再启动 Claude Code。

误区四：模型越强，日常开发就应全程使用最高规格

事实：模型选择应匹配任务。日常代码问答、批量重构前的分析和简单脚本可优先使用速度更快、成本更低的 Haiku；常规功能开发、测试补全和复杂调试通常适合 Sonnet；跨模块架构设计、棘手缺陷分析再考虑 Opus。通过 59API 按量调用，团队可以按任务切换模型，减少固定订阅和高规格模型滥用带来的成本。

最后，安装或连接失败时，依次检查 Claude Code 版本、Node.js 版本、环境变量、网络代理和 API Key 权限。不要在日志、截图或工单中暴露完整密钥。需要以较低成本将 Claude Code 接入现有开发流程的用户，可注册 59API 领取密钥；其推荐返利机制也适合有团队推广需求的开发者。

Pricing · Docs