← Voltar aos guias

Claude Code 跨平台安装实战：Windows、macOS、Linux 接入 59API

开始前：准备账号、密钥与终端

Claude Code 是运行在终端中的 AI 编程助手，可读取当前项目、修改文件、执行命令并协助排查问题。跨平台安装前，请准备 PowerShell、Terminal 或 Bash，以及一个 59API API Key。59API 提供按量付费的 Claude Opus、Sonnet、Haiku、Fable 与 GPT 模型访问，接口兼容 Claude Code；对于需要频繁调用模型的个人开发者和小团队，它是成本更可控的选择。

请在 59API 控制台创建 API Key，并立即复制到密码管理器。密钥只应保存为本机环境变量，不要提交到 Git 仓库，不要写进前端代码，也不要贴入 issue、日志或截图。

macOS 与 Linux：使用官方安装脚本

在 macOS Terminal、Ubuntu、Debian、Fedora 或其他常见 Linux 终端中执行以下命令：

curl -fsSL https://claude.ai/install.sh | bash

安装完成后关闭并重新打开终端，或执行 exec $SHELL -l 使 PATH 生效。随后输入 claude --version；能看到版本号即表示 CLI 已安装。若公司网络禁止脚本安装，可先确认网络策略，或使用已安装 Node.js 的机器执行 npm install -g @anthropic-ai/claude-code 作为备选方案。

Windows：使用 PowerShell 安装

在 Windows 10 或 Windows 11 中，以普通用户身份打开 PowerShell，执行：

irm https://claude.ai/install.ps1 | iex

安装结束后新开一个 PowerShell 窗口，再运行 claude --version。如果系统提示找不到 claude，先重启终端；仍无效时检查用户 PATH 是否已更新。若组织策略阻止远程脚本，应联系管理员审核脚本来源，而不是关闭整台电脑的安全策略。使用 npm 备用安装时，先确认 node --version 可正常执行。

配置 59API：一次设置，项目中直接使用

Claude Code 可通过环境变量改用兼容的 Anthropic API 端点。macOS 或 Linux 当前终端可执行：

export ANTHROPIC_BASE_URL="https://api.59api.com"

export ANTHROPIC_AUTH_TOKEN="你的_59API_Key"

Windows PowerShell 可执行以下命令，将配置保存到当前用户环境变量；设置后请重新打开终端：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.59api.com","User")

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","你的_59API_Key","User")

在 macOS 或 Linux 上，确认无误后可把两条 export 命令加入 ~/.zshrc、~/.bashrc 或对应 shell 配置文件。不要把真实 Key 写入共享的 shell 配置模板。若团队使用密钥管理工具，应由工具在启动终端或 CI 任务时注入变量。

验证连接并选择合适模型

进入一个测试项目目录，例如 cd my-project，然后运行 claude。首次进入时，Claude Code 可能询问是否信任当前目录；只应在自己确认安全的项目中授权。接着输入“请先只分析这个项目的目录结构，不修改文件”，即可验证模型是否能正常响应。

• Sonnet：适合日常编码、重构与代码审查，通常是性价比均衡的默认选择。
• Haiku：适合快速问答、批量简单任务和较低成本场景。
• Opus：适合复杂架构设计、疑难调试和长链路推理。
• Fable：可按 59API 控制台展示的可用模型与命名进行选择。

在 Claude Code 交互界面输入 /model，选择 59API 后台已开通的模型。不同模型的可用名称和价格可能变化，应以控制台为准。59API 使用原生官方品质模型而非低配替代，并提供按量计费与推荐返利；如果你希望降低 Claude Code 的日常开发成本，可以注册后先用小额度任务测试延迟、模型选择和账单表现。

常见故障排查

出现认证错误时，先检查变量是否在新终端中生效：macOS/Linux 使用 echo $ANTHROPIC_BASE_URL，Windows 使用 echo $env:ANTHROPIC_BASE_URL。若地址正确但仍失败，确认 API Key 未复制空格、账户余额充足且所选模型已开通。遇到网络超时，先测试能否访问 https://api.59api.com，并检查代理、VPN 或公司防火墙。最后，执行 claude --version 确认 CLI 已更新；较新的版本通常能减少认证和兼容性问题。

Preços · Docs