Connect a CLI

Command-line AI tools — Claude Code, Codex, opencode, aider and similar — connect to the gateway with three settings: a base URL, a key, and a model name. This page explains the two protocol families those tools speak, and how to pick the right one. If you are connecting a library or an app rather than a CLI, see Configure your agent.

Every CLI needs the same three things

Setting	What it is
Base URL	Where the CLI sends requests. Either `https://api.hjc925.cloud/v1` (OpenAI-style) or `https://api.hjc925.cloud` (Anthropic-style).
API key / token	The gateway key you were given.
Model name	Which model to call, for example `deepseek-v4.1-flash`.

OpenAI-compatible CLIs

Most CLIs speak the OpenAI protocol. This includes opencode, aider, Codex and others.

export OPENAI_BASE_URL="https://api.hjc925.cloud/v1"
export OPENAI_API_KEY="your-gateway-key"

The CLI sends requests to /v1/chat/completions and receives OpenAI-format answers.

Anthropic-protocol CLIs (Claude Code)

Claude Code speaks the Anthropic protocol. Point it at the gateway the same way:

export ANTHROPIC_BASE_URL="https://api.hjc925.cloud"
export ANTHROPIC_AUTH_TOKEN="your-gateway-key"

Use ANTHROPIC_AUTH_TOKEN, not ANTHROPIC_API_KEY. The gateway reads the token variable.

The gateway answers Anthropic-format requests at /v1/messages. The model behind the gateway does not need to be made by Anthropic — the gateway translates. Claude Code can authenticate two ways, and the two are easy to confuse.

Auth method	What it costs	When to use it
Your own Anthropic subscription	Your existing flat subscription fee	You run Claude Code alone and pay for your own subscription anyway
A gateway key	Metered through the gateway, with a budget	You want one key across tools, or someone needs access without their own subscription

Both are legitimate. Which fits depends on your situation:

If you already pay for a Claude subscription and only use Claude Code, connecting it to the gateway adds a metered hop for no benefit — use your subscription login directly.
If you want all your AI tools behind one door, or you are giving someone access without sharing a subscription login, use a gateway key as shown above.

There is no single “right” answer baked into the gateway. The gateway supports both paths; the choice is about cost and convenience for you.

Model names

Give the full name of the model.

deepseek-v4.1-flash
minimax/MiniMax-M3
minimax/MiniMax-M2.7-highspeed
glm/glm-5.3-flash
anthropic/claude-sonnet-5
chatgpt/gpt-5.4

The gateway will list every name it accepts:

curl -s https://api.hjc925.cloud/v1/models -H "Authorization: Bearer your-gateway-key"

A name with openrouter/ in front routes through OpenRouter, which charges per request. Access to OpenRouter models may be restricted per team.

To see which models your key may call, ask the gateway:

curl https://api.hjc925.cloud/v1/models \
  -H "Authorization: Bearer your-gateway-key"

Test your setup

Send one request to confirm the key and model work before debugging a tool’s config:

curl https://api.hjc925.cloud/v1/chat/completions \
  -H "Authorization: Bearer your-gateway-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Say hello in one word."}]
  }'

Result	Meaning
A JSON answer	Key and model work
`401`	Key is wrong or revoked
Model error	The model name is not one your key may call

Configure your agent — the full guide for any client, with Python examples
Models, pools and fallbacks — what happens after your CLI sends the request

Start here

Access Manager

LLM gateway — For users

LLM gateway — For the admin

Public tools

Hermes

Every CLI needs the same three things

OpenAI-compatible CLIs

Anthropic-protocol CLIs (Claude Code)

Model names

Test your setup

​Every CLI needs the same three things

​OpenAI-compatible CLIs

​Anthropic-protocol CLIs (Claude Code)

​Claude Code: subscription login vs gateway key

​Model names

​Test your setup

​Related

Every CLI needs the same three things

OpenAI-compatible CLIs

Anthropic-protocol CLIs (Claude Code)

Claude Code: subscription login vs gateway key

Model names

Test your setup

Related