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

Use ISH API with Claude Code

Claude Code should use the Anthropic-compatible ISH endpoint:https://api.ish.chat. Do not add/v1 for Claude Code.

1. Create an API key

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

2. Export environment

Add these exports to your shell profile or run them in the same terminal before starting Claude Code.

Example
export ANTHROPIC_BASE_URL="https://api.ish.chat"
export ANTHROPIC_API_KEY="ish_live_..."
export ANTHROPIC_MODEL="claude-sonnet-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4.5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4.5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4.8"

3. Optional persistent settings

If you prefer a config file, place the same values in your Claude Code settings. Use a user-level or project-level settings file depending on how you manage coding projects.

Example
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ish.chat",
    "ANTHROPIC_API_KEY": "ish_live_...",
    "ANTHROPIC_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8"
  },
  "model": "claude-sonnet-4.6"
}

4. Verify

Start Claude Code, check the selected model, then send a tiny test prompt. The curl test confirms the same key works against the Anthropic-compatible endpoint.

Example
claude

# Inside Claude Code:
/model

# Then send:
Reply exactly: ISH_OK

Troubleshooting

Invalid role or message error: update Claude Code and use the latest ISH API deployment. ISH normalizes tool results and system messages for Claude Code.

Unsupported model: use an available model id such asclaude-sonnet-4.6. ISH also accepts connector-style variants such asclaude-sonnet-4-6,claude-sonnet-4-6-latest, and provider-prefixed ids.

401 error: check that ANTHROPIC_API_KEY is an active ish_live_ key.

Insufficient balance: add balance first. API and connector usage cannot spend free daily web usage.

Anthropic-compatible Claude Code routing reference
Docs tree
OverviewAPI quickstart
Claude
Claude CodeAnthropic-compatible setup
On this page
Create an API keyExport environmentPersistent settingsVerify the setupTroubleshooting
OpenCodeOpenCodeOpenAI-compatible setup
OpenAI
Codex CLIResponses API setup
Cursor
Cursor IDECursor alias setup