OpenAI安装指南2026：Python SDK、CLI和本地模型逐步配置

OpenAI工具链的起步比该有的更折腾人：API密钥、SDK版本、CLI认证、本地模型混淆。干净安装路径如下。

💡 你将学到

OpenAI工具链的起步比该有的更折腾人：API密钥、SDK版本、CLI认证、本地模型混淆。干净安装路径如下。

OpenAI安装是什么意思（三件不同的事）

OpenAI install可以指三件事，混在一起是多数安装痛苦之源：装Python SDK（调API的库）、装CLI（终端工具）、装本地模型工具（Ollama之流 - 不是OpenAI，但搜OpenAI安装的人常想要本地模型）。本篇三个都讲。

1. Python SDK（openai-python，31,326星）

pip install openai

然后认证 - 2026年干净做法是环境变量，绝不硬编码密钥：

export OPENAI_API_KEY="sk-..."

快速测试：导入客户端、调模型、打印响应。报auth错=密钥错或缺失；报rate错=账号要加支付方式。两行代码验证：

from openai import OpenAI
client = OpenAI()
print(client.chat.completions.create(model="gpt-4o-mini", messages=[{"role":"user","content":"hi"}]).choices[0].message.content)

2. CLI

OpenAI CLI用于代码执行和agent工作流，不只是聊天。包管理器安装，然后跑一次登录流程（会开浏览器登录）：

npm install -g @openai/cli   # 或以当前文档为准的Python安装器
openai login

无头环境登录失败，改用API密钥跑CLI的认证命令。

3. 本地模型（很多人真正想要的）

搜OpenAI安装但想要本地/私密模型：装Ollama（178,131星） - 一个安装器，然后ollama run llama3.1或任意模型名，你就有本地聊天模型，自带OpenAI兼容API在localhost:11434。现有OpenAI SDK代码改base_url就能指向它 - 私密开发的好技巧。

经典坑

• 版本固定：SDK变得快；requirements里固定版本，教程才不会崩。
• 密钥安全：绝不提交密钥；用.env文件并gitignore。
• base_url错误：常见坑是指向代理或本地服务器然后得到费解的报错。莫名失败先查base_url。
• 模型名会变：废弃模型名返回404类错误；查文档当前模型列表。

验证清单

1. SDK导入成功。2. 测试调用返回文本。3. CLI登录显示你的账号。4.（本地）ollama run离线能跑。四项检查、五分钟，你的环境才算真的就绪 - 不只是装完。