Codex dictation troubleshooting

Codex dictation not working? Check the surface, the sign-in, then the microphone.

OpenAI documents Codex dictation as a ChatGPT desktop app feature: one shortcut that turns speech into prompt text you can edit before sending. It is separate from live ChatGPT Voice, and the Codex CLI offers voice conversations rather than dictation. This is the troubleshooting companion to our Codex voice input guide.

Source-reviewed

1. Confirm you are on a surface that has dictation

OpenAI’s shortcut reference for the ChatGPT desktop app, where Codex now lives, lists Start dictation as ⌃⇧D on macOS and Ctrl+Shift+D on Windows and Linux, each marked “when dictation is available”. Click into the composer first, press the shortcut, and speak; the transcript arrives as editable text that you send yourself.

The terminal is a different product surface. As of October 2026, OpenAI’s Codex CLI references describe no dictation mode. Codex CLI 0.156.0, released September 22, 2026, turned voice conversations on by default instead, with an F8 toggle, a /voice settings picker, and bundled audio runtimes for Linux and Windows. That is a spoken back-and-forth with the agent, not speech typed into your prompt.

We also found no dictation command documented for the Codex IDE extension. If the editor or terminal is where you type, dictate there with an operating-system or third-party tool.

  • Desktop app: click the composer, then press Control-Shift-D (Mac) or Ctrl+Shift+D.
  • Codex CLI: press F8 for a voice conversation; use outside dictation for typed prompts.
  • IDE extension: no dictation documented, so use an OS-level tool.

2. Check your plan, sign-in method and admin settings

OpenAI’s Codex feature table lists voice dictation as available on ChatGPT Plus, Pro, Business and Enterprise/Edu, and unavailable when you use an API key. The same table does not list the Free or Go plans. If you signed in to Codex with an API key, the shortcut has nothing to start.

Managed workspaces can turn it off. OpenAI’s configuration reference describes features.in_app_dictation in the admin-enforced requirements.toml: false disables in-app dictation in the desktop app, and true does not bypass other availability checks. A separate key, features.realtime_conversation, disables the experimental /voice command in the Codex CLI. If dictation is missing on a work machine but present at home, ask whoever manages your Codex configuration before looking for a workaround.

3. The “Codex dictation usage limit reached” message

OpenAI’s documentation reviewed for this page publishes no dictation quota and does not explain this message. The only first-hand record we found is a September 16, 2026 bug report in OpenAI’s developer community: macOS ChatGPT app version 26.908.70816 showed “Codex dictation usage limit reached” on a Free account, while dictation still worked in ChatGPT on the web and in the iPad app for the same account.

Two documented facts help you reason about it. Free is not a plan in the Codex dictation row, and OpenAI says live ChatGPT Voice in the desktop app draws on your Codex usage budget at $0.05 a minute and shares your plan’s usage limits. Dictation pricing itself is not documented, so treat any claim about a dictation-specific allowance as unverified, including ours.

  • Compare your plan with the Codex feature table.
  • Open your Codex usage dashboard for current limits and reset times; Plus and Pro can buy extra credits.
  • Try dictation in ChatGPT on the web to separate an account limit from an app bug.
  • Update the desktop app and report the version number if the message persists.

4. The shortcut does nothing, or no text appears

Start with the operating system. The ChatGPT app needs microphone permission: on a Mac, enable it under System Settings → Privacy & Security → Microphone; on Windows, check Settings → Privacy & security → Microphone. A microphone that works in a browser proves the hardware, not the app’s permission.

Then rule out the other voice feature. Control-Shift-V starts a live voice chat and Control-Shift-D starts dictation, so a mistyped shortcut opens the wrong mode. Shortcuts can be reassigned under Settings > Keyboard Shortcuts, so check there that Start dictation still has the binding you expect.

5. Where your dictation audio goes

OpenAI’s Voice Dictation FAQ, written for ChatGPT’s microphone dictation, says recorded audio is sent to OpenAI’s models to be transcribed and returned as text you can edit before sending. Dictation is not processed on your computer.

The same FAQ says dictation audio is kept for as long as the chat is in your history. When you delete the chat, the audio is deleted within 30 days unless OpenAI must keep it for security or legal reasons, or it was previously shared for training and disassociated from your account. Consumer users can stop sharing dictation audio for model training by turning off “Include your audio recordings” in data controls; OpenAI says it does not train on business users’ inputs by default.

6. Dictate into Codex anywhere with IraVoice

Codex’s own dictation is the right first choice in the desktop app on an eligible plan. When Codex runs in a terminal, the IDE or over SSH, when you sign in with an API key, or when dictation is capped, a dictation app on your own computer can type the prompt instead. That is the gap IraVoice fills; it is not a live voice conversation and does not replace ChatGPT Voice.

IraVoice 1.2.2 runs on macOS 13+ on Apple silicon, Windows 10 or 11 (64-bit), and Linux (beta) and recognizes speech on-device with NVIDIA Parakeet. On IraVoice Local no audio or text leaves the computer and nothing is metered per minute: it is $79 once for one computer. Hold Right Command on a Mac, Right Ctrl on Windows or Ctrl+Space on Linux, speak, and release; the text lands at the cursor and Enter is not pressed by default.

When Codex runs in a terminal or editor on a Mac or Windows PC, IraVoice also reads names from the Git project that session is working in, so “pipeline dot swift” arrives as Pipeline.swift. It keeps only names, never source text. Code names are not available on Linux, and over SSH they come only from a project on your local computer.

Decision guide

Which fix or tool fits your Codex setup?

Start from where you run Codex and how you sign in.

If you needChooseWhy
Codex in the ChatGPT desktop app on Plus, Pro, Business or EnterpriseBuilt-in dictation (Ctrl+Shift+D)Native to the composer, with the transcript editable before you send.
Signed in to Codex with an API keyOS or third-party dictationOpenAI lists dictation as unavailable for API-key use.
Codex CLI in a terminalF8 for a voice conversation, or local dictation for typed promptsThe CLI ships voice conversations; no dictation mode is documented.
Dictation blocked on a managed workspaceAsk your administrator firstfeatures.in_app_dictation is an admin-enforced switch; follow your policy.
Speech that never leaves the computerIraVoice LocalOpenAI documents server-side transcription for dictation.

Primary sources

Use the current documentation.

This guide was reviewed October 2, 2026. Product versions, settings, policies, and availability can change.

  1. OpenAI: ChatGPT desktop app commands ↗

    Start dictation and Start voice chat shortcuts for macOS, Windows and Linux, and reassigning shortcuts in settings.

  2. OpenAI: Codex pricing and feature availability ↗

    Voice dictation availability by plan and API key, Voice billing at $0.05 per minute, shared usage limits, usage dashboard and credits.

  3. OpenAI: Codex configuration reference ↗

    The requirements.toml keys features.in_app_dictation and features.realtime_conversation.

  4. OpenAI: ChatGPT and Codex changelog ↗

    Codex CLI 0.156.0 (September 22, 2026): voice conversations on by default, F8 toggle and /voice settings picker.

  5. OpenAI Help Center: Voice Dictation FAQ ↗

    Server-side transcription, audio retention after chat deletion, and the audio-sharing control.

  6. OpenAI Developer Community: “Codex dictation usage limit reached” report ↗

    A September 2026 user bug report with the exact message, app version and plan; not an OpenAI statement.

Questions

What readers usually ask next.

What is the Codex dictation shortcut?

In the ChatGPT desktop app, Control-Shift-D on a Mac and Ctrl+Shift+D on Windows and Linux, when dictation is available. Control-Shift-V starts a live voice chat instead.

Does the Codex CLI have voice input?

It has voice conversations: Codex CLI 0.156.0 enabled them by default with an F8 toggle and a /voice settings picker. OpenAI does not document a mode that types your speech into the CLI prompt.

Why does Codex say “Codex dictation usage limit reached”?

OpenAI has not documented the trigger. A September 2026 community report shows it on a Free account in the macOS app, and Free is not listed for Codex dictation in OpenAI’s feature table.

Can I use Codex dictation with an API key?

No. OpenAI’s feature table lists voice dictation and ChatGPT Voice as unavailable for API-key use. Sign in with a ChatGPT account on an eligible plan, or dictate with another tool.

Is Codex dictation processed on my computer?

No. OpenAI’s Voice Dictation FAQ says recorded audio is sent to its models for transcription and kept as long as the chat remains in your history.

Mac, Windows, and Linux

Try private, on-device dictation for yourself.

Hold one key, speak, and the words are typed where your cursor is. The 3-day free trial starts with your first dictation.