Mac安装ChatGPT全攻略：从环境配置到终端集成

共计 1988 个字符，预计需要花费 5 分钟才能阅读完成。

环境准备

1. Homebrew 安装
   Mac 上最便捷的包管理工具，只需在终端执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，将 Homebrew 添加到 PATH 环境变量（M1/M2 芯片需额外配置）：

echo 'eval"$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

1. Python3 环境配置
   推荐使用 pyenv 管理多版本 Python：

brew install pyenv
pyenv install 3.9.6  # 选择稳定版本
pyenv global 3.9.6

验证安装：

python --version  # 应显示 Python 3.9.6
pip --version

API 密钥获取与存储

1. 获取 OpenAI API 密钥
2. 登录OpenAI 账户

3. 创建新密钥并立即复制（密钥只显示一次）

4. 安全存储方案
   推荐使用环境变量 + 密钥管理工具：

# 临时设置（仅当前终端会话有效）export OPENAI_API_KEY='你的实际密钥'

# 永久保存到.zshrc 或.bash_profile
echo 'export OPENAI_API_KEY=" 你的实际密钥 "' >> ~/.zshrc

更安全的方式是使用 pass 或1password等工具管理密钥。

命令行工具配置

1. 基础请求示例
   使用 curl 测试 API 连通性：

curl https://api.openai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{"model":"gpt-3.5-turbo","messages": [{"role":"user","content":"Hello!"}]}'

1. httpie 工具（更友好的 CLI）

   brew install httpie
   http POST https://api.openai.com/v1/chat/completions \
     Authorization:"Bearer $OPENAI_API_KEY" \
     model="gpt-3.5-turbo" \
     messages:='[{"role":"user","content":"Explain quantum computing"}]'

常见错误排查

1. SSL 证书问题
   如果遇到证书验证失败：

# 临时跳过验证（不推荐生产环境）curl -k https://api.openai.com/v1/...

# 永久解决方案
brew install openssl
pip install certifi

1. 代理配置
   国内用户可能需要设置代理：

export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890

1. 速率限制处理
   API 默认有每分钟请求限制，建议：
2. 实现请求间隔（如time.sleep(20)）
3. 监控用量头信息：

   x-ratelimit-limit-requests: 3
   x-ratelimit-remaining-requests: 2

终端集成最佳实践

创建永久 alias 简化调用：

# 添加到~/.zshrc
alias gpt='http POST https://api.openai.com/v1/chat/completions \
  Authorization:"Bearer $OPENAI_API_KEY" \
  model="gpt-3.5-turbo" \
  messages:='\''[{"role":"user","content":"'"$1"'"}]'\''
'

# 使用示例
gpt "用 Python 写一个快速排序"

安全性增强

1. 环境变量管理
2. 使用 direnv 实现目录级环境变量

3. 敏感项目建议使用 .env 文件 +python-dotenv

4. API 用量监控
   定期检查账单和用量：

   curl https://api.openai.com/v1/usage \
     -H "Authorization: Bearer $OPENAI_API_KEY"

避坑指南

1. 错误：Invalid API Key
2. 检查密钥是否完整复制

3. 确保环境变量生效：echo $OPENAI_API_KEY

4. 错误：ModuleNotFoundError

5. 确认 Python 版本：which python

6. 重新安装依赖：pip install --upgrade openai

7. 错误：Request timed out

8. 检查网络连接
9. 测试基础连通性：ping api.openai.com

延伸实践

1. 官方文档精读：OpenAI API Reference
2. 尝试用 Python SDK 实现对话历史保持功能
3. 挑战：开发一个 CLI 聊天机器人，支持上下文记忆