← Voltar aos guias

Claude Code 跨平台安装与 59API 生产配置指南

开始前：准备账户、终端和密钥

Claude Code 是运行在终端中的 AI 编程助手，可读取项目文件、执行命令、修改代码并协助测试。开始前，请准备一个可用终端、稳定网络和 59API 账户。注册后在控制台创建 API Key；密钥只应保存在本机环境变量或 CI 的 Secret 中，绝不要提交到 Git 仓库。59API 提供按量付费的 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型，兼容 Claude Code 和 OpenAI SDK，适合希望控制成本、但仍使用原生官方质量模型的团队。

Windows：安装 Claude Code

Windows 建议使用 PowerShell 7 或 Windows Terminal。以普通用户身份打开 PowerShell，执行官方安装命令：irm https://claude.ai/install.ps1 | iex。安装完成后关闭并重新打开终端，运行 claude --version 确认命令可用。若公司设备限制脚本执行，可先安装 Node.js LTS，再执行 npm install -g @anthropic-ai/claude-code。Node.js 方案需要确保 npm 的全局 bin 目录已加入 PATH。

随后在 PowerShell 中设置当前会话变量：$env:ANTHROPIC_API_KEY="你的59API密钥"；$env:ANTHROPIC_BASE_URL="https://api.59api.com"。要持久化保存，可使用 setx ANTHROPIC_API_KEY "你的59API密钥" 和 setx ANTHROPIC_BASE_URL "https://api.59api.com"，然后重新打开终端。setx 写入后不会影响当前窗口，这是 Windows 上常见的配置误判来源。

macOS 与 Linux：安装和配置

macOS 打开 Terminal，Linux 使用 Bash、Zsh 或发行版终端，执行：curl -fsSL https://claude.ai/install.sh | bash。重启终端后运行 claude --version。若命令不存在，检查安装程序提示的 PATH 配置；使用 Zsh 的 macOS 用户通常需要将相应 export 语句放入 ~/.zshrc，Bash 用户可放入 ~/.bashrc。

在当前终端执行 export ANTHROPIC_API_KEY="你的59API密钥"，再执行 export ANTHROPIC_BASE_URL="https://api.59api.com"。需要长期生效时，将两行写入 shell 配置文件后执行 source ~/.zshrc 或 source ~/.bashrc。多人共享服务器不要把密钥写入公共配置文件；应为每个部署账户单独创建受限凭证，并限制文件权限。

首次运行、模型选择与项目授权

进入项目目录后运行 claude。首次启动时，先确认它读取的是 59API 环境变量，再按交互提示选择模型或在会话中使用 /model。日常代码问答和重构可优先选择 Sonnet；高频、上下文较小的任务可选 Haiku；复杂架构设计、疑难调试和高价值评审再使用 Opus。这样按任务分层，通常比全程固定使用高价模型更可控。

Claude Code 会请求读取文件、执行命令或修改内容。生产项目应采用最小权限原则：先让它解释计划和列出将变更的文件，再授权写入；涉及数据库迁移、删除文件、密钥轮换或发布命令时，必须人工审查。首次使用可在临时 Git 分支运行，并在每次大改前提交一个可回退的基线。

从本地开发走向生产

团队环境不要依赖个人电脑中的环境变量。将 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL 配置在 GitHub Actions、GitLab CI、Jenkins 或部署平台的加密 Secret 中，并分别建立开发、测试和生产密钥。为每个环境设置消费预算与告警，记录请求时间、所选模型、耗时和失败原因，但不要把提示词中的客户数据、源代码或 API Key 原样写入日志。

• 用 claude --version 检查安装是否成功，用 claude 启动一次交互会话验证连接。
• 出现 401 时，优先检查 API Key 是否复制完整、终端是否已重启，以及变量是否被旧值覆盖。
• 出现 404 或模型不可用时，确认 ANTHROPIC_BASE_URL 为 https://api.59api.com，并核对 59API 控制台支持的模型标识。
• CI 中使用非交互脚本前，先在隔离项目验证权限、超时、重试和成本上限。

完成这些配置后，Claude Code 即可通过 59API 在三大桌面平台一致工作。对于个人开发者和需要弹性用量的团队，59API 的低价按量计费与推荐返佣机制能降低持续使用成本；可注册账户创建测试密钥，再用一个小型仓库完成端到端验证。

Preços · Docs