Numman AliandHanzo Dev
0a9834c6fc
This PR standardizes all documentation and configuration on GPT 5.1 model identifiers, removes deprecated GPT 5.0 models, and enforces full-opencode.json as the only officially supported configuration. The changes address GPT 5 model temperamental behavior and ensure users have the proper setup for reliable operation with OpenCode. Co-authored-by: Hanzo Dev <[email protected]>
Configuration
This directory contains the official opencode configuration for the OpenAI Codex OAuth plugin.
⚠️ REQUIRED Configuration File
full-opencode.json (REQUIRED - USE THIS ONLY)
YOU MUST use this configuration file - it is the ONLY officially supported setup:
cp config/full-opencode.json ~/.config/opencode/opencode.json
Why this is required:
- GPT 5 models can be temperamental and need proper configuration
- Contains 8 verified GPT 5.1 model variants (Codex, Codex Mini, and general GPT 5.1)
- Includes all required metadata for OpenCode features
- Guaranteed to work reliably
- Global options for all models + per-model configuration overrides
What's included:
- All supported GPT 5.1 variants: gpt-5.1, gpt-5.1-codex, gpt-5.1-codex-mini
- Proper reasoning effort settings for each variant
- Context limits (272k context / 128k output)
- Required options:
store: false,include: ["reasoning.encrypted_content"]
❌ Other Configurations (NOT SUPPORTED)
DO NOT use:
minimal-opencode.json- NOT supported, will fail unpredictablyfull-opencode-gpt5.json- DEPRECATED, GPT 5.0 models are being phased out by OpenAI- Custom configurations - NOT recommended, may not work reliably
Why other configs don't work:
- GPT 5 models need specific configurations
- Missing metadata breaks OpenCode features
- No support for usage limits or context compaction
- Cannot guarantee stable operation
Usage
ONLY ONE OPTION - use the full configuration:
-
Copy
full-opencode.jsonto your opencode config directory:- Global:
~/.config/opencode/opencode.json - Project:
<project>/.opencode.json
- Global:
-
DO NOT modify the configuration unless you know exactly what you're doing. The provided settings have been tested and verified to work.
-
Run opencode:
opencode run "your prompt" --model=openai/gpt-5.1-codex-medium
⚠️ Critical: GPT 5 models require this exact configuration. Do not use minimal configs or create custom variants - they are not supported and will fail unpredictably.
Configuration Options
See the main README.md for detailed documentation of all configuration options.
Remember: Use full-opencode.json as-is for guaranteed compatibility. Custom configurations are not officially supported.