为什么需要配置环境变量？
在使用 Codex 进行代码生成或与 GitHub 集成时，安全地管理 API 密钥和访问令牌是首要任务。直接将敏感信息硬编码在脚本中不仅风险极高，还可能导致账户被盗或产生意外的计费问题。通过配置环境变量，你可以将凭证与代码逻辑分离，确保在任何环境中都能安全、便捷地调用 Codex 服务。对于开发者而言，掌握这一基础设置是高效利用 AI 编程助手的前提。
第一步：获取必要的凭证
在开始配置之前，你需要从相关平台获取有效的凭证。首先，登录到你的 OpenAI 账户，进入 API 管理页面生成一个新的 API Key。这个密钥是你与 Codex 模型交互的身份证明。其次，如果你计划将生成的代码直接推送到 GitHub 仓库，你还需要一个 GitHub Personal Access Token (PAT)。请确保该 Token 拥有必要的权限，如 `repo`（仓库访问）和 `workflow`（工作流更新），以便 Codex 能够自动完成代码提交和版本控制操作。妥善保管这些字符串，切勿分享给他人。
第二步：本地环境配置
接下来，我们将凭证写入本地系统的环境变量中。这一步骤因操作系统而异，但核心逻辑一致。对于 macOS 和 Linux 用户，建议编辑家目录下的 `.bashrc`、`.zshrc` 或 `.profile` 文件。使用文本编辑器打开文件，并在末尾添加以下行：
export OPENAI_API_KEY="你的_OpenAI_API_Key"随后，执行 `source ~/.zshrc`（根据你的 shell 类型调整）使配置立即生效。对于 Windows 用户，可以通过“系统属性”->“高级”->“环境变量”界面手动添加，或者在 PowerShell 中使用 `$env:OPENAI_API_KEY="你的_Key"` 命令临时设置。为了确保长期有效，建议将其添加到系统的永久环境变量列表中。验证配置是否成功，可以在终端输入 `echo $OPENAI_API_KEY` (Linux/macOS) 或 `echo %OPENAI_API_KEY%` (Windows)，如果输出与你设置的密钥一致，则说明配置成功。
第三步：验证 Codex 集成
配置完成后，最后一步是测试 Codex 是否能正确读取这些环境变量并与 GitHub 协同工作。你可以编写一个简单的测试脚本，尝试调用 Codex API 并请求一段简单的代码片段。如果返回结果正常，说明 API 密钥有效。接着，尝试让 Codex 创建一个测试分支并提交更改到 GitHub。如果操作顺利，你将看到新的 commit 出现在你的仓库中。如果在过程中遇到权限错误或认证失败，请检查 Token 的有效期及权限范围，并确保环境变量名称拼写完全正确。一旦集成顺畅，你就可以放心地在日常开发中利用 Codex 提升效率，同时保持代码库的安全整洁。