← Volver a las guías

Claude Code 跨平台安装指南：Windows、macOS 与 Linux 快速接入 59API

1. 先确认运行环境：Node.js 与终端缺一不可

Claude Code 是终端中的 AI 编程助手，安装前先执行 node --version。建议使用当前 LTS 版 Node.js；若命令不存在，请从 Node.js 官方渠道安装后重新打开终端。Windows 推荐使用 PowerShell 或 Windows Terminal，macOS 使用 Terminal 或 iTerm2，Linux 使用常见的 Bash、Zsh 均可。还应确认 Git 已安装，因为 Claude Code 在分析、提交和比较代码改动时会调用 Git。

2. 三个系统都可用的一条安装命令

在终端执行 npm install -g @anthropic-ai/claude-code，安装完成后运行 claude --version 验证。macOS 或 Linux 若遇到全局目录权限错误，不要直接长期使用 sudo；优先按 Node.js 的 npm 全局目录方案调整权限，或使用 nvm、fnm 等版本管理器安装 Node.js。Windows 若提示找不到 claude，关闭并重开 PowerShell，再检查 npm 的全局 bin 目录是否已加入 PATH。

3. Windows 用户：优先保持路径和项目目录简单

Windows 可以直接在 PowerShell 中运行 Claude Code。进入项目后执行 cd C:\work\my-app，再运行 claude 即可启动交互会话。若项目同时被 WSL、Docker 或 Git Bash 使用，建议选择一个主要终端环境，避免 Windows 路径与 Linux 路径混用导致工具找不到文件。对于前端、Node.js 和 Python 项目，Windows Terminal 配合 PowerShell 已足够；只有确实依赖 Linux shell 工具链时，再考虑 WSL。

4. macOS 与 Linux：用 Shell 配置永久保存密钥

macOS 的 Zsh 通常编辑 ~/.zshrc，多数 Linux 的 Bash 编辑 ~/.bashrc。把环境变量写入对应文件后，执行 source ~/.zshrc 或 source ~/.bashrc 立即生效。密钥不要写进项目源码、截图、日志或 Git 仓库；团队项目应使用密钥管理服务或 CI 平台的加密变量。每个项目启动前进入其根目录，可让 Claude Code 更准确识别代码结构和仓库规则。

5. 用 59API 配置 Claude Code，降低日常开发成本

注册 59API 后创建 API Key，并在终端设置 ANTHROPIC_AUTH_TOKEN 为该密钥、ANTHROPIC_BASE_URL 为 https://api.59api.com。例如 macOS 或 Linux 可使用 export 命令，Windows PowerShell 可使用 $env: 语法设置当前会话变量。随后在项目目录运行 claude，Claude Code 会通过该兼容接口发起请求。59API 提供按量付费的 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型访问，采用官方品质模型而非降级替代，对于频繁代码审查、测试生成和重构任务，通常比直接为每个工具单独维护订阅更灵活。

6. 按任务选择模型，避免把预算花错地方

• Haiku：适合快速问答、简单脚本、日志归纳和小型改动。
• Sonnet：适合大多数日常编码、跨文件修改、测试编写与代码审查。
• Opus：适合复杂架构分析、顽固 Bug 排查和需要长链路推理的任务。
• GPT 模型：适合需要在既有 OpenAI SDK 工作流中复用调用方式的场景。

先用较经济的模型完成定位和拆分，再对关键模块使用更强模型复核，能明显控制消耗。59API 的统一中转也便于在 Claude Code、Codex 与任意 OpenAI SDK 之间复用账户和按量计费方式，并可利用推荐返利进一步降低长期使用成本。

7. 第一次运行先给 AI 清晰边界

启动后不要只输入“帮我改代码”。应说明目标、相关文件、验收方式和限制，例如“检查当前仓库的登录流程，只提出问题，不修改文件”“为 src 下的接口补充单元测试，保持现有测试框架”。修改前先要求它解释计划，修改后执行项目已有的测试、类型检查或构建命令。想以较低成本稳定接入多种模型，可前往 59API 注册并创建一个开发专用 Key，再从小项目开始验证配置。

Precios · Docs