Considerations for Using the Azure OpenAI Services Provider

[doggy8088]

For the latest Node.js version, I was getting source code to build codex-cli folder. Here are some notes:

1. ~/.codex/config.json

   The model must be your deployment name. It's not a "Model name".

   {
     "model": "codex-mini",
     "provider": "azure"
   }

2. ~/.profile

   # Codex CLI
   export AZURE_OPENAI_API_KEY='your-api-key'
   export AZURE_BASE_URL="https://your-resource-name.openai.azure.com/openai"

Only o4-mini and codex-mini models able to use Responses API.

If I get codex v0.5.0 by npm install -g @openai/codex, I still can't run with Azure OpenAI. I tried everything. It just can't run.

[kingdomseed]

For the Rust version, this is my toml configuration. It works with all the models listed here from my Azure deployment:

# --------------  ~/.codex/config.toml  --------------
approval_policy = "on-failure"
sandbox_mode = "workspace-write"
model_reasoning_effort = "high"
model_reasoning_summary = "detailed"

# Default settings ── used when you run plain `codex`
model_provider = "azure"
model          = "codex-mini"            # pick whatever you want as your day-to-day default

[model_providers.azure]
name         = "Azure OpenAI"
# NOTE: leave **only** the part up to /openai
base_url     = "https://YOUR_ENDPOINT.cognitiveservices.azure.com/openai"
env_key      = "AZURE_OPENAI_API_KEY"        # export this in ~/.zshrc
wire_api     = "responses"                   
query_params = { api-version = "2025-04-01-preview" }

# ----------  one profile per model  ----------
[profiles.o3]
model_provider = "azure"
model          = "o3"

[profiles.o3-pro]
model_provider = "azure"
model          = "o3-pro"

[profiles.o4-mini]
model_provider = "azure"
model          = "o4-mini"

[profiles.codex-mini]
model_provider = "azure"
model          = "codex-mini-latest"

[profiles.gpt-4.1]
model_provider = "azure"
model          = "gpt-4.1"

[profiles.model-router]
model_provider = "azure"
model          = "model-router"
# ---------------------------------------------------------------

[mcp_servers.sentry]
command = "npx"
args    = ["@sentry/mcp-server@latest"]
env     = { SENTRY_ACCESS_TOKEN = "AUTH", SENTRY_HOST       = "sentry.io" }

[mcp_servers.context7]
command = "npx"
args    = ["-y", "@upstash/context7-mcp@latest"]
# No env vars needed

[mcp_servers.sequential-thinking]
command = "npx"
args    = ["-y", "@modelcontextprotocol/server-sequential-thinking"]

[mcp_servers.filesystem]
command = "npx"
args    = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/jholt/development"]

[mcp_servers.linear]
command = "npx"
args    = ["-y", "mcp-remote", "https://mcp.linear.app/sse"]
# mcp-remote turns the remote SSE feed into local stdio, which Codex supports

[mcp_servers.fetch]
command = "uvx"
args    = ["mcp-server-fetch"]

[mcp_servers.structured-workflow]
command = "npx"
args    = ["structured-workflow-mcp@latest"]

[doggy8088]

@kingdomseed The only different seems only the base_url.

My: https://YOUR_ENDPOINT.openai.azure.com/openai

Yours: https://YOUR_ENDPOINT.cognitiveservices.azure.com/openai

I tried both. All failed. Still the same error.

Are you install codex 0.5.0 by npm install -g @openai/codex?

[doggy8088]

@kingdomseed I successfully compiled the Rust source, and it runs smoothly with Azure OpenAI. Thanks. The published @openai/codex package is buggy on Azure OpenAI.

[doggy8088]

I've just realized that the npm install -g @openai/codex command is actually install the Rust version.

The 0.5.0 still broken for Azure OpenAI Service. If I build from Source, everything will be all right.

[kingdomseed]

I've just realized that the npm install -g @openai/codex command is actually install the Rust version.

The 0.5.0 still broken for Azure OpenAI Service. If I build from Source, everything will be all right.

I installed using homebrew (I'm running on macOS)--I'm on 0.5.0. I'm using .cognitiveservices.azure.com/openai and the wire_api=responses. Do you know if the openai.azure.com supports responses on the wire_api or only chat/compeltions?

[doggy8088]

I know. It is supported Responses API.

@kingdomseed I'm using Linux. Do you know why I can only access Azure OpenAI by building it from Rust source code?

[kingdomseed]

I know. It is supported Responses API.

@kingdomseed I'm using Linux. Do you know why I can only access Azure OpenAI by building it from Rust source code?

I don't--I know they had some issues with NPM for Rust version but I thought it was corrected in 0.5.0. Maybe someone else can chime in on this.

[doggy8088]

I upgraded to codex-cli 0.6.0.

npm install -g @openai/codex

It still failed with Azure OpenAI Service setup.

[doggy8088]

If I download the Linux binary, it works! 😅

cd /tmp
curl -o- -sL https://github.com/openai/codex/releases/download/rust-v0.6.0/codex-x86_64-unknown-linux-gnu.tar.gz | tar -xzf - --transform='s/codex-x86_64-unknown-linux-gnu/codex/'
./codex exec --skip-git-repo-check hi

It must be something wrong with the npm package! 🔥🔥🔥

Also, the DotSlash version still has the same issue. I suspect it might be related to a Environment Variables problem.

[doggy8088]

I checked the DotSlash cache and the file directly download from GitHub Release for 0.6.0 version.

# Download Linux binary
curl -sSLO https://github.com/openai/codex/releases/download/$(curl -s "https://api.github.com/repos/openai/codex/releases/latest" | jq -r .tag_name)/codex-x86_64-unknown-linux-gnu.tar.gz

# Download DotSlash
curl -sSLO https://github.com/openai/codex/releases/download/$(curl -s "https://api.github.com/repos/openai/codex/releases/latest" | jq -r .tag_name)/codex

Check for .tar.gz file

Unzip it:

tar zxvf codex-x86_64-unknown-linux-gnu.tar.gz
ls -l codex-x86_64-unknown-linux-gnu

The file size is 17235880.

This version works!

./codex-x86_64-unknown-linux-gnu exec --skip-git-repo-check hi

Check for DotSlash

Find linux-x86_64 and get the url: https://github.com/openai/codex/releases/download/rust-v0.6.0/codex-x86_64-unknown-linux-musl.zst

Download it:

wget https://github.com/openai/codex/releases/download/rust-v0.6.0/codex-x86_64-unknown-linux-musl.zst

Unzip it:

zstd -d codex-x86_64-unknown-linux-musl.zst
chmod +x codex-x86_64-unknown-linux-musl
ls -l codex-x86_64-unknown-linux-musl

The file size is 22904768.

This version not works!

./codex-x86_64-unknown-linux-musl exec --skip-git-repo-check hi

The result

I think musl version have some issues. The gnu version is correct.

[doggy8088]

If the npm package include the gnu version, I think the problem will be solved as well. Please consider fix the bug or change another target.

By the way, can I choose which target I can use for npm package?

[doggy8088]

The @openai/codex v0.6.0 do packed with codex-x86_64-unknown-linux-musl for linux.

Can the team switch to the GNU version?

[nesdeq]

please for the love of god, include basic automated testing for azure so it does not break every other update.

[doggy8088]

Azure OpenAI is always a second-class citizen. 😑

[bolinfest]

There was a known issue with 0.5.0 only if you used the npm version: #1568.