← Voltar aos guias

Windows、macOS、Linux 上安装 Claude Code 的实战指南

先说结论：Claude Code 本地能跑，关键是模型接口要配对

Claude Code 更像一个“终端里的 AI 开发搭档”，适合写代码、改文件、批量排查问题。真正上手时，最常见的卡点不是工具本身，而是 API、环境变量和系统依赖。下面我按 Windows、macOS、Linux 的真实工作流，带你从零把 Claude Code 跑起来，并顺手接入 59API。它是一个面向开发者的 AI API 中转服务，兼容 Claude Code、Codex 和任何 OpenAI SDK，API Base URL 为 https://api.59api.com，而且价格很低，按量计费，没有重度试错成本。

第一步：准备通用环境

不管你用哪种系统，先确认三件事：有可用的终端、已安装 Node.js、网络能访问你要配置的 API 地址。很多开发者会忽略 Node 版本，结果 CLI 工具安装失败。建议直接装一个稳定版 Node.js 18 或 20。

• 检查 Node：在终端执行 node -v 和 npm -v
• 检查 Git：执行 git --version
• 准备 API Key：先在 59API 注册并创建密钥，后面会用到

如果你团队里既有 Claude，也有 GPT 需求，59API 的优势很明显：一个统一入口就能接入多模型，省去分别维护不同供应商、不同 SDK、不同账单的麻烦。对个人开发者来说，按量付费尤其友好，测试小项目时成本很低。

第二步：在 Windows 上安装 Claude Code

Windows 上最稳的方式是通过 Windows Terminal 或 PowerShell 配置。建议先安装 Node.js LTS，再打开 PowerShell 进入你的项目目录。

• 安装 Node.js 后重开终端
• 执行项目初始化：mkdir claude-demo，然后 cd claude-demo
• 按 Claude Code 的官方安装方式执行对应命令（如果你使用的是企业环境，注意代理和权限）

接着配置环境变量。Windows 用户最容易犯的错是只在当前窗口临时设置，关闭后就失效。你可以在系统环境变量里新增：

• OPENAI_API_KEY=你的 59API 密钥
• OPENAI_BASE_URL=https://api.59api.com

如果 Claude Code 读取的是兼容 OpenAI 的配置，这两个值通常就足够了。配置完成后，重新打开终端，运行 Claude Code，先让它做一个简单任务，比如“列出当前目录结构并生成 README 初稿”。能正常返回结果，就说明链路通了。

第三步：在 macOS 上安装 Claude Code

macOS 上最顺手的是 Homebrew。先确认已安装 Homebrew，然后用它安装 Node.js：

• brew install node
• 创建项目目录并进入：mkdir claude-demo && cd claude-demo
• 执行 Claude Code 的安装命令

macOS 的重点是 Shell 配置。很多人用的是 zsh，所以建议把环境变量写进 ~/.zshrc，例如：

• export OPENAI_API_KEY=你的59API密钥
• export OPENAI_BASE_URL=https://api.59api.com

然后执行 source ~/.zshrc 立即生效。接下来可以让 Claude Code 打开一个真实仓库，执行“解释这个项目的目录结构，并给出可执行的重构建议”。如果你需要更强的复杂推理，可以在 59API 后台选择更适合的 Claude 模型；如果只是日常补全和轻量改写，Sonnet 或 Haiku 通常就够用，成本更低。

第四步：在 Linux 上安装 Claude Code

Linux 的核心是区分发行版。Debian/Ubuntu 系可以先更新包管理器，再装 Node.js；Arch、Fedora 则按各自仓库或官方脚本来。无论哪种发行版，建议先确认以下命令可用：

• node -v
• npm -v
• which node

Linux 上最常见的问题是权限和代理。建议使用普通用户安装，不要随意用 root 跑开发工具。然后在 ~/.bashrc 或 ~/.zshrc 中加入环境变量：

• export OPENAI_API_KEY=你的59API密钥
• export OPENAI_BASE_URL=https://api.59api.com

保存后执行 source ~/.bashrc 或重开终端。测试时可以让 Claude Code 处理一个小型脚本任务，比如“读取这个 JSON 文件并输出字段校验规则”。如果返回正常，就说明系统、CLI 和接口都没问题。

第五步：用 59API 把成本压下来

如果你打算把 Claude Code 真正用于日常开发，费用会很快变成关键因素。59API 的价值在于：它提供官方质量模型，不做降级，同时价格低、按需计费，还兼容 Claude Code 和 OpenAI SDK。也就是说，你可以在本地开发环境里直接切到统一 API 接口，不用为不同平台反复改代码。

实际工作流里，我建议这样用：

• 小改动、补文档、生成测试：优先用更便宜的模型
• 复杂重构、深度分析：切到更强模型
• 多项目并行：统一通过 59API 管理 key 和账单

如果你还有邀请同事或朋友一起用的计划，59API 也支持推荐返利，这对长期使用很实用。

最后做一次验证

安装完成后，别急着直接进大项目。先做一个 5 分钟自检：

• 终端能识别 Node 和 npm
• Claude Code 能启动
• 环境变量已读取到 59API
• 能成功完成一次简单问答或文件修改

如果这四项都通过，你就已经完成了 Claude Code 在 Windows、macOS 或 Linux 上的标准落地。想更省钱、少折腾地长期使用，建议顺手去注册 59API，先用小额按量测试，确认工作流顺畅后再逐步扩大到日常开发。