macOS 上使用 Sub2API 的完整指南

在 macOS 上配置 Python 环境、设置环境变量并验证 Sub2API 连接的完整操作指南。

本教程面向 macOS 用户，介绍如何配置 Python 环境、通过 Shell 配置文件持久化 Sub2API 环境变量，并运行第一次 API 调用验证连通性。

1. 确认 Python 已安装

   macOS 通常预装了 Python。打开终端（Terminal.app 或 iTerm2），运行：

   zsh（默认）

   python3 --version
   

   若未安装，可通过 Homebrew 安装：

   brew install python
   
2. 设置环境变量

   根据你使用的 Shell，编辑对应的配置文件：

   zsh（macOS 默认）

   打开 ~/.zshrc 并添加以下两行：

   export OPENAI_API_KEY="YOUR_API_KEY"
   export OPENAI_BASE_URL="https://sub2api.ruilinlu.com"
   

   保存后执行：

   source ~/.zshrc
   

   bash

   打开 ~/.bashrc 或 ~/.bash_profile 并添加：

   export OPENAI_API_KEY="YOUR_API_KEY"
   export OPENAI_BASE_URL="https://sub2api.ruilinlu.com"
   

   保存后执行：

   source ~/.bashrc
   

   用 echo $OPENAI_API_KEY 验证变量是否加载成功。

3. 安装 openai SDK

   推荐使用 pip3 安装：

   pip3 install openai
   

   建议为每个项目创建独立的虚拟环境，避免依赖冲突：

   python3 -m venv venv
   source venv/bin/activate
   pip install openai
   
4. 运行第一次调用

   创建 test.py 并运行：

   import os
   from openai import OpenAI
   
   client = OpenAI(
       api_key=os.getenv("OPENAI_API_KEY"),
       base_url=os.getenv("OPENAI_BASE_URL")
   )
   
   response = client.chat.completions.create(
       model="gpt-4o-mini",
       messages=[{"role": "user", "content": "Hello from macOS!"}]
   )
   
   print(response.choices[0].message.content)
   

   执行：

   python3 test.py
   

常见问题排查

zsh: command not found: python3

macOS 某些旧版本或精简安装可能未自带 Python。请通过 Homebrew 安装：brew install python。

pip3 install 提示 Permission denied

不要对系统级 Python 使用 sudo pip3 install。推荐创建虚拟环境后安装，或使用 pip3 install --user openai。

环境变量重启终端后丢失

请确认你将 export 写入了正确的配置文件（zsh 用 ~/.zshrc，bash 用 ~/.bashrc），并执行了 source 命令。

调用返回 401 Unauthorized

请检查 OPENAI_API_KEY 是否已正确导出，且 Key 未被撤销。可参考 API Key 无效排查。