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 canonical Rootnull ids 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 credits: buy credits first. API and connector usage cannot spend free daily credits.

Anthropic-compatible Claude Code routing reference

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"
}

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.

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

Insufficient credits: buy credits first. API and connector usage cannot spend free daily credits.