Codex met Azure OpenAI in Microsoft Foundry-modellen

De Codex CLI van OpenAI is dezelfde code-assistent die ChatGPT's Codex aandrijft. U kunt deze coderingsagent volledig uitvoeren op Azure infrastructuur terwijl u uw gegevens binnen uw nalevingsgrens houdt. U krijgt de toegevoegde voordelen van beveiliging op ondernemingsniveau, privénetwerken, op rollen gebaseerd toegangsbeheer en voorspelbaar kostenbeheer. Codex is meer dan een chat met uw codeagent. Het is een asynchrone coderingsagent die u kunt activeren vanuit uw terminal, VS Code of vanuit een GitHub Actions-runner. Met Codex kunt u automatisch pull-aanvragen openen, bestanden herstructureren en tests schrijven met behulp van de referenties van uw Foundry-project en Azure OpenAI-implementaties.

Voorwaarden

• Een Azure-abonnement - Maak er gratis een
• Inzendermachtigingen in Microsoft Foundry.
• homebrew (macOS) of Node.js met npm om de Codex CLI te installeren. Zie Node.js en npm downloaden en installeren.
• Installeer en configureer WSL2 voor Windows. Zie WSL installeren.

Een model implementeren in Foundry

1. Ga naar Foundry en maak een nieuw project.
2. Selecteer in de modelcatalogus een redeneringsmodel zoals gpt-5.3-codex, gpt-5.2-codex, , gpt-5.1-codex-maxgpt-5.1-codex, gpt-5.1-codex-mini, gpt-5-codex, gpt-5, , of gpt-5-minigpt-5-nano.
3. Als u het model wilt implementeren in de modelcatalogus, selecteert u Dit model gebruiken. Als u het deelvenster Azure OpenAI Deployments gebruikt, selecteert u deploy-model.
4. Kopieer de eindpunt-URL en de API-sleutel.

De Codex CLI installeren

Voer vanuit de terminal de volgende opdrachten uit om Codex CLI te installeren

npm install -g @openai/codex
codex --version # verify installation

brew install --cask codex
codex --version # verify installation

config.toml maken en configureren

1. Als u Codex CLI wilt gebruiken met Azure, maakt en stelt u een config.toml-bestand in.

   Sla het config.toml bestand op in de ~/.codex map. Maak een config.toml bestand in deze map of bewerk het bestaande bestand als het al bestaat:

   cd ~/.codex
   nano config.toml
   

2. Kopieer de volgende tekst om de api voor v1-antwoorden te gebruiken. Met de v1-API hoeft u api-version niet meer mee te geven, maar u moet /v1 opnemen in het base_url-pad. U kunt uw API-sleutel niet rechtstreeks als een tekenreeks doorgeven aan env_key. env_key moet verwijzen naar een omgevingsvariabele. Werk uw base_url bij met de resourcenaam:

   model = "gpt-5-codex"  # Replace with your actual Azure model deployment name
   model_provider = "azure"
   model_reasoning_effort = "medium"
   
   [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"
   

3. Nadat u de updates in uw config.toml bestand hebt opgeslagen, gaat u terug naar de terminal en maakt u een exemplaar van de omgevingsvariabele waarnaar het configuratiebestand verwijst.

   # Linux, macOS, or WSL 
   export AZURE_OPENAI_API_KEY="<your-api-key>"
   

4. Voer een van de volgende opdrachten uit in de terminal om te testen of uw Codex CLI-configuratie is geslaagd:

   Opdracht	Purpose
   Codex	Interactieve Terminal User Interface (TUI) starten
   codex "Eerste prompt"	Start TUI met een eerste prompt
   codex exec "Initiële prompt"	Start TUI in de niet-interactieve "automatiseringsmodus"

Codex gebruiken in Visual Studio Code

U kunt Codex ook rechtstreeks in Visual Studio Code gebruiken wanneer u de extensie OpenAI Codex gebruikt.

1. Als u nog geen Visual Studio Code hebt, installeert u deze voor macOS en Linux.

2. Installeer de OpenAI Codex-extensie. De extensie is afhankelijk van uw config.toml bestand dat u hebt geconfigureerd voor Codex CLI.

3. Als u zich in een nieuwe terminalsessie bevindt, stelt u de omgevingsvariabele in voor AZURE_OPENAI_API_KEY:

   export OPENAI_API_KEY="<your-azure-api-key-here>"
   

   Opmerking

   Als u WSL gebruikt, stelt u ook dezelfde omgevingsvariabele in op de Windows host, zodat de extensie deze zo nodig kan lezen.

4. Start VS Code vanuit dezelfde terminalsessie. (Wanneer u een app-launcher start, kan dit ertoe leiden dat de omgevingsvariabele van uw API-sleutel niet beschikbaar is voor de Codex-extensie.)

   code .
   

5. U kunt Nu Codex in Visual Studio Code gebruiken om te chatten, bewerken en preview-wijzigingen te bekijken terwijl u tussen drie goedkeuringsmodi schakelt.

Goedkeuringsmodi

Goedkeuringsmodi bepalen hoeveel autonomie en interactie u wilt hebben met Codex.

Doorlopende begeleiding met AGENTS.md

U kunt Codex extra instructies en richtlijnen geven met behulp van AGENTS.md bestanden. Codex zoekt naar AGENTS.md bestanden op de volgende plaatsen en voegt ze bovenaan samen, zodat deze context krijgt over uw persoonlijke voorkeuren, projectspecifieke details en de huidige taak:

• ~/.codex/AGENTS.md – persoonlijke globale richtlijnen.
• AGENTS.md in de root van uw opslagplaats: gedeelde projectnotities.
• AGENTS.md in de huidige werkmap : submap of functiedetails.

Als u Codex bijvoorbeeld wilt helpen begrijpen hoe u code schrijft voor Foundry-agents, kunt u een AGENTS.md maken in de hoofdmap van uw project met de volgende inhoud, afgeleid van de Azure AI Agents SDK-documentatie:

# Instructions for working with Foundry Agents

You are an expert in the Azure AI Agents client library for Python.

## Key Concepts

- **Client Initialization**: Always start by creating an `AIProjectClient` or `AgentsClient`. The recommended way is via `AIProjectClient`.
- **Authentication**: Use `DefaultAzureCredential` from `azure.identity`.
- **Agent Creation**: Use `agents_client.create_agent()`. Key parameters are `model`, `name`, and `instructions`.
- **Tools**: Agents use tools to perform actions like file search, code interpretation, or function calls.
  - To use tools, they must be passed to `create_agent` via the `tools` and `tool_resources` parameters or a `toolset`.
  - Example: `file_search_tool = FileSearchTool(vector_store_ids=[...])`
  - Example: `code_interpreter = CodeInterpreterTool(file_ids=[...])`
  - Example: `functions = FunctionTool(user_functions)`

## Example: Creating a basic agent

\`\`\`python
import os
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# 1. Create Project Client
project_client = AIProjectClient(
    endpoint=os.environ["PROJECT_ENDPOINT"],
    credential=DefaultAzureCredential(),
)

# 2. Get Agents Client
with project_client:
    agents_client = project_client.agents

    # 3. Create Agent
    agent = agents_client.create_agent(
        model=os.environ["MODEL_DEPLOYMENT_NAME"],
        name="my-helpful-agent",
        instructions="You are a helpful agent that can answer questions.",
    )
    print(f"Created agent with ID: {agent.id}")
\`\`\`

In het vorige voorbeeld zijn backticks in het Python-codeblok ge-escaped om een correcte weergave mogelijk te maken. U kunt de \ tekens verwijderen.

Experimenteren met Codex CLI

Start codex met de volgende eerste prompt:

codex "write a python script to create an Azure AI Agent with file search capabilities"

Andere voorgestelde tests:

# generate a unit test for src/utils/date.ts

# refactor this agent to use the Code Interpreter tool instead

Codex binnen GitHub Actions

Codex kan worden uitgevoerd als onderdeel van uw CI-pijplijn (continuous integration). Sla uw API-sleutel op in het geheime archief van de opslagplaats als AZURE_OPENAI_KEY en voeg een taak als volgt toe om uw wijzigingslogboek automatisch bij te werken vóór een release:

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"

Probleemoplossing