Codex Configuration

Universal Configuration (Applies to Windows / macOS / Linux)

1. Create Configuration Directory

Create a .codex folder in your user home directory:

• macOS / Linux: ~/.codex
• Windows: C:\Users\YourUserName\.codex

As long as the directory exists, you don't need to recreate it.

2. Create config.toml

Create a new config.toml in the .codex directory and paste the following content:

Copy
1
model_provider = "codebyai"
2
model = "gpt-5.1"
3
model_reasoning_effort = "high"
4
disable_response_storage = true
5
 
6
[model_providers.codebyai]
7
name = "codebyai"
8
base_url = "https://www.codebyai.net/api/agent"
9
wire_api = "responses"
10
requires_openai_auth = true
11
 
12
[features]
13
web_search_request = true

If you need to change the model, just adjust the model field.

3. Create auth.json

Still in the .codex directory, create auth.json:

Copy
1
{
2
  "OPENAI_API_KEY": "sk-proj-xxxx"
3
}

4. Start Codex CLI

Enter your project directory and run codex:

Copy
1
cd your-project
2
codex

You will see results similar to this:

5. Using in VS Code

Install the official Codex extension from the VS Code Marketplace (make sure to choose the version with the official badge):

VS Code will automatically read config.toml and auth.json, so no extra configuration is required. If the extension prompts for missing configuration, please check if the steps above are completed.