• ISH API
    api.ish.chat
Platform
  • Dashboard
  • Keys
  • Usage
Setup
  • Docs
    • Claude
      Claude Code
    • OpenCodeOpenCode
    • OpenAI
      Codex CLI
    • Cursor
      Cursor IDE
Coding CLI setup

Use ISH API with Codex CLI

Codex CLI should use the OpenAI Responses-compatible ISH endpoint:https://api.ish.chat/v1. Tool calls, streaming responses, and follow-up tool results are supported.

1. Create an API key

Go to API keys, create a key, and copy it once. Codex requests will appear in API usage.

2. Add Codex provider

Add this provider to ~/.codex/config.toml. The important part is wire_api = "responses".

Example
model = "claude-sonnet-4.6"
model_provider = "ish"
model_context_window = 200000
model_auto_compact_token_limit = 120000

[model_providers.ish]
name = "ISH API"
base_url = "https://api.ish.chat/v1"
wire_api = "responses"
env_key = "ISH_API_KEY"

3. Export your key

Export the key in the same shell before starting Codex, or keep it in your shell profile.

Example
export ISH_API_KEY="ish_live_..."
codex

4. Verify tools

Run a small text test first, then a file-read test to confirm the Codex tool-call loop works end to end.

Example
codex exec --skip-git-repo-check "Reply exactly: ISH_OK"

Troubleshooting

Empty response: confirm wire_api = "responses" is set for the ISH provider.

401 error: check that ISH_API_KEY is an activeish_live_ key.

Insufficient credits: API calls only spend purchased credits, not daily/free credits.

Codex custom provider reference
Docs tree
OverviewAPI quickstart
Claude
Claude CodeAnthropic-compatible setup
OpenCodeOpenCodeOpenAI-compatible setup
OpenAI
Codex CLIResponses API setup
Cursor
Cursor IDECursor alias setup
ModelsGET /v1/modelsChat completionsPOST /v1/chat/completionsMessagesPOST /v1/messagesStreamingSSE responsesVisionImage inputsBillingPurchased credits only