Azure AI Foundry 正式上线 GPT-5 Codex，手把手教你部署使用
2025-09-30
News and information
9月24日，微软宣布在 Azure AI Foundry（国际版）中正式推出 GPT-5 Codex，并同步在 Visual Studio Code 的 GitHub Copilot 副驾驶® 中开启公共预览。本文将引导你完成从环境准备到模型部署与使用的完整流程。
01
先决条件
在开始之前，请确保你已具备以下条件：
02
在 Azure AI Foundry 中部署模型
2、选择模型
从模型目录中选择支持 Responses API 的模型，例如 GPT-5 Codex。
3、获取 Endpoint 与 API Key
记录生成的 Endpoint 和 API Key，格式如下：
Endpoint:
https://xxxx.openai.azure.com
API Key:
xxxxxxxxxxxxxxxxxxxxxxxxx
03
安装与配置 Codex CLI
bash 复制 npm install -g @openai/codex codex --version # 验证安装
bash 复制 brew install codex codex --version # 验证安装
a. 创建或编辑 ~/.codex/config.toml：
bash 复制 cd ~/.codex nano config.toml
b. 写入以下配置（替换YOUR_RESOURCE_NAME 和实际模型部署名称）：
toml 复制 model = "gpt-5-codex" model_provider = "azure" model_reasoning_effort = "high" [model_providers.azure] name = "Azure OpenAI" base_url = "https://YOUR_RESOURCE_NAME.openai.azure.com/openai/v1" env_key = "AZURE_OPENAI_API_KEY" wire_api = "responses"
c. 设置环境变量：
bash 复制 export AZURE_OPENAI_API_KEY="<your-api-key>"
d. 运行测试命令验证配置是否成功：
04
在 VS Code 中使用 Codex 扩展
05
使用 AGENTS.md 进行行为引导
你可以在以下位置创建 AGENTS.md 文件，为 Codex 提供项目上下文与行为指导：
~/.codex/AGENTS.md：全局个人偏好；
项目根目录 / AGENTS.md：项目级指引；
子目录中的 AGENTS.md：任务级说明。
示例内容（摘自 Azure AI Agents SDK 文档）:
markdown 复制 # Instructions for working with Azure AI Foundry Agents You are an expert in the Azure AI Agents client library for Python. ## Key Concepts - **Client Initialization**: Use `AIProjectClient` or `AgentsClient` with `DefaultAzureCredential`. - **Agent Creation**: Call `agents_client.create_agent()` with `model`, `name`, and `instructions`. - **Tools**: Support for File Search, Code Interpreter, and Function tools.
06
在 GitHub Actions 中集成 Codex
以下示例演示如何在 CI 流水线中使用 Codex 自动更新项目日志：
yaml
复制
jobs:
update_changelog:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Update changelog via Codex
run: |
npm install -g @openai/codex
export AZURE_OPENAI_API_KEY="${{ secrets.AZURE_OPENAI_KEY }}"
codex -p azure exec --full-auto "update CHANGELOG for next release"07
总结
1、在 Azure AI Foundry 中部署 GPT-5 Codex 模型；
2、安装并配置 Codex CLI；
3、在 VS Code 中集成 Codex 扩展；
4、使用 AGENTS.md 引导模型行为；
5、在 GitHub Actions 中自动化 Codex 任务。
现在你可以开始高效使用 GPT-5 Codex 加速开发流程了！
