TOOL INTEGRATION

Codex

OpenAI's coding agent for the terminal and VS Code. Register HashBid as a custom provider that speaks the Responses API.

Official docs

Before you start

API Key: <YOUR_API_KEY>
Create one on the API Keys page. Paste the raw key, without Bearer.
Base URL: https://hashbidx.ai/v1
Must include /v1.
Model: gpt-5
Example only — use a model ID from the Models page.

Setup

01Install Codex CLI

Requires Node.js 18 or later.

Check Node.js

node --version

npm

npm install -g @openai/codex

02Add HashBid as a provider

Create or edit config.toml in ~/.codex (Windows: %USERPROFILE%\.codex). model_provider must match the table name under model_providers.

~/.codex/config.toml

model_provider = "hashbid"
model = "<MODEL_ID>"

[model_providers.hashbid]
name = "HashBid"
base_url = "https://hashbidx.ai/v1"
env_key = "HASHBID_API_KEY"
wire_api = "responses"

03Set the API key

Codex reads the key from the environment variable named in env_key, so it never sits in the config file.

macOS / Linux

export HASHBID_API_KEY="<YOUR_API_KEY>"

Windows (PowerShell, current window)

$env:HASHBID_API_KEY="<YOUR_API_KEY>"

Windows (PowerShell, permanent)

[System.Environment]::SetEnvironmentVariable("HASHBID_API_KEY", "<YOUR_API_KEY>", "User")

After setting a permanent variable on Windows, close and reopen the terminal. The VS Code extension uses the same config.toml and environment variable — restart VS Code after changing them.

04Start Codex

Run it from a project directory.

Terminal

cd your-project
codex

Verify it works

Ask a read-only question first, e.g. Summarize the module structure of this repository.
The request shows up on the Logs page of this console.

FAQ

Authentication failed / 401

Check echo $HASHBID_API_KEY prints the key in the terminal that runs Codex.

Paste the raw key only — no Bearer prefix.

“Model provider not found”

model_provider = "hashbid" must match [model_providers.hashbid] exactly, including case.

Connects, but requests keep failing

Codex only speaks the Responses API. Keep wire_api = "responses" and pick a model that supports it.

All developer tools

BUILD WITH HASHBIDX

Find your model. Make your first call.

Models & pricing