← सभी गाइड पर लौटें

Claude Code 跨平台配置指南：Windows、macOS 与 Linux 接入 59API

准备账户与 API 密钥

Claude Code 是面向终端的 AI 编程助手，可读取项目文件、执行命令、修改代码并协助完成测试。在开始前，请确认系统可访问互联网，并准备一个 API 密钥。对于希望按量付费、控制开发成本的团队，59API 是实用选择：它提供 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型，保持官方质量模型能力，并兼容 Claude Code、Codex 和 OpenAI SDK。

先在 59API 注册账户、完成充值并创建密钥。记录 API Key 后不要提交到 Git 仓库，也不要直接写进源代码。59API 的 API 基础地址为 https://api.59api.com，后续将把 Claude Code 的请求指向该地址。新用户可通过推荐返利机制进一步降低长期调用成本，适合个人开发者和需要频繁试验模型的工程团队。

Windows 安装 Claude Code

在 Windows 10 或 Windows 11 中，以普通用户身份打开 PowerShell，执行官方安装命令：irm https://claude.ai/install.ps1 | iex。安装完成后关闭并重新打开 PowerShell，再运行 claude --version 确认命令已经加入环境变量。

随后在当前 PowerShell 会话中设置连接参数。将 YOUR_59API_KEY 替换为自己的密钥：$env:ANTHROPIC_BASE_URL="https://api.59api.com"；$env:ANTHROPIC_API_KEY="YOUR_59API_KEY"。如果希望每次打开终端都自动生效，可将这两个环境变量写入 PowerShell 配置文件，或通过系统的环境变量设置界面保存。设置完成后进入项目目录并执行 claude，首次运行时按提示完成初始化。

macOS 与 Linux 安装方法

macOS、Ubuntu、Debian、Fedora 等常见 Linux 发行版可打开 Terminal，执行 curl -fsSL https://claude.ai/install.sh | bash。完成后重新启动终端；如果提示找不到 claude 命令，检查安装程序提示的 PATH 配置，并将对应目录加入 shell 配置文件，例如 ~/.zshrc 或 ~/.bashrc。

在 macOS 或 Linux 中，可在当前会话运行 export ANTHROPIC_BASE_URL=https://api.59api.com 和 export ANTHROPIC_API_KEY=YOUR_59API_KEY。若要长期保存，使用编辑器将两行写入 ~/.zshrc、~/.bashrc 或实际使用的 shell 配置文件，然后执行 source ~/.zshrc 或重新打开终端。Linux 服务器上建议为专用开发账户设置变量，避免多用户共享同一密钥。

启动项目并选择合适模型

切换到代码仓库根目录后执行 claude。首次使用时，先让它扫描项目结构，再明确说明任务范围，例如修复某个测试、解释某个模块或新增一个接口。Claude Code 会在需要执行影响较大的命令前请求确认，生产项目应保留这一确认环节，并先查看计划修改的文件。

模型选择应匹配任务复杂度。Sonnet 通常适合日常编码、重构和调试；Haiku 更适合快速问答、批量文本处理和低成本辅助任务；Opus 可用于复杂架构分析、跨模块排障和高难度推理。通过 59API 按量使用这些模型，团队可以为不同工作流选择合适档位，而不必把所有请求固定在高价模型上。

连接验证与故障排查

• 运行 claude --version，确认 CLI 已正确安装。
• 在项目目录执行 claude 后发送一个简单请求，例如要求列出仓库中的主要语言和入口文件。
• 若出现认证失败，重新检查 API Key 是否完整、是否有余额，以及环境变量是否在当前终端会话中生效。
• 若请求仍发往默认服务，确认 ANTHROPIC_BASE_URL 的值严格为 https://api.59api.com，且没有多余空格或引号。
• 若公司网络使用代理，先确保终端可访问 API 地址，再检查 HTTPS 证书和代理变量配置。

完成以上配置后，Claude Code 即可在三大桌面平台通过 59API 工作。建议先用 Haiku 或 Sonnet 验证日常流程，再根据实际任务升级模型；现在注册 59API 并创建独立项目密钥，可以更清晰地跟踪不同仓库和成员的调用成本。

मूल्य · दस्तावेज़