Client guides

Claude Code

Prepare a Claude Code settings file for Inferway.

Direct access not announcedConfiguration checked: 2026-09-06

The configuration template is available below. Inferway's /v1/messages returned 404 in the September 6, 2026 check; direct inference requires the service to enable Anthropic Messages.

Use the existing API

Before you start

Install the named client using its official instructions. Pi here means the pi-mono coding agent; Hermes means Nous Research's Hermes Agent.

Once your Inferway account is activated, get an API key from Console → API keys. Use a dedicated key for this client and review its model access and spending limits. Both live and test prefixes use the same inference and billing path; test is an environment label, not a free or simulated inference mode.

Use an Inferway key for Inferway's endpoint. An OpenRouter key belongs to OpenRouter and cannot authenticate to this address.

Keep the key in the client's credential store or your local environment. Do not paste it into a prompt, screenshot, or committed configuration. These examples use bash/zsh on macOS or Linux.

Make the key available to this terminal

The prompt below hides your input and keeps the key out of shell history. Start the client from this same terminal; a separately opened app may not inherit this variable.

INFERWAY_API_KEYbash
printf 'Inferway API key: '
IFS= read -r -s INFERWAY_API_KEY
printf '\n'
export INFERWAY_API_KEY

Save the settings template

Save this as inferway.claude.json. ANTHROPIC_BASE_URL omits the final /v1 because the client appends /v1/messages. The file contains no credential; the launch command below reads it from the environment.

inferway.claude.jsonjson
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.inferway.ai"
  },
  "model": "inferway/qwen3.8-27b"
}

Launch with this settings file

The --settings flag applies this file to the session. ANTHROPIC_AUTH_TOKEN sends the Inferway key as a bearer token. Do not put the literal text $INFERWAY_API_KEY in JSON; the shell expands it in this command. Existing settings or managed policy may affect the effective configuration; check /status and the selected model.

Claude Code CLIbash
ANTHROPIC_AUTH_TOKEN="$INFERWAY_API_KEY" claude --settings ./inferway.claude.json

Verify after Messages is available