Skip to content

Claude Code (using non-Anthropic Models)

You can follow these instructions to use your AI-VERDE API key after installing Claude Code. More information on using Claude Code can be found here, https://code.claude.com/docs/en/overview.

Note

These instructions assume your course or team is connected to non-Anthropic models. Claude Code still sends Anthropic-style requests; AI-VERDE translates them for the non-Anthropic model.

Prerequisites

  1. Your AI-VERDE course or team must have access to at least one non-Anthropic model. Coding agents work best with models that support tool use; see the "Supports Tools" column in Current CyVerse Models.
  2. Obtain your AI-VERDE API key. Instructions can be found here.
  3. Note the model name(s) you want to use. Instructions for listing available models can be found here.
  4. Install Claude Code. Instructions can be found here, https://code.claude.com/docs/en/setup.
  5. The remaining instructions assume a terminal on macOS or Linux with bash and Claude Code installed. On Windows, Option 1 below works the same way, with the file at %USERPROFILE%\.claude\settings.json.

1. Configure Claude Code

You can use the same model for all tiers (Opus/Sonnet/Haiku) or you can use different models for each tier. Use the exact model names as returned by your model list.

Add the following env section to ~/.claude/settings.json (create the file if it does not exist). Settings in this file apply every time you run Claude Code, in any terminal.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm-api.cyverse.ai",
    "ANTHROPIC_API_KEY": "<your-ai-verde-api-key>",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "<model name for opus-tier model>",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "<model name for sonnet-tier model>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<model name for haiku-tier model>",
    "ANTHROPIC_MODEL": "<model name for primary model>"
  }
}

For example:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm-api.cyverse.ai",
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemma-4-26b-it",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemma-4-26b-it",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemma-4-26b-it",
    "ANTHROPIC_MODEL": "gemma-4-26b-it"
  }
}

If the file already has other settings, add the env section alongside them rather than replacing the file.

Warning

~/.claude/settings.json holds your API key. Keep the key in this user-level file, not in a project's .claude/settings.json, and don't commit or share it.

Option 2: Shell environment variables

Alternatively, export the same variables in your terminal before launching Claude Code:

export ANTHROPIC_BASE_URL="https://llm-api.cyverse.ai"
export ANTHROPIC_API_KEY="<your-ai-verde-api-key>"
export ANTHROPIC_DEFAULT_OPUS_MODEL="<model name for opus-tier model>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="<model name for sonnet-tier model>"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="<model name for haiku-tier model>"
export ANTHROPIC_MODEL="<model name for primary model>"

Exported variables only last for the current terminal session. To avoid re-entering them each session, add the lines to your shell profile (e.g. ~/.bashrc or ~/.zshrc), then source your shell profile.

Note

To obtain the AI-VERDE Anthropic Base URL, simply remove /v1 (e.g. https://llm-api.cyverse.ai/v1 => https://llm-api.cyverse.ai). If both ~/.claude/settings.json and your shell set the same variable, the value in ~/.claude/settings.json is used.

2. Start Claude Code

You can then run Claude Code.

claude

The first time Claude Code detects ANTHROPIC_API_KEY, it asks whether to use the custom API key. Select Yes. You can run /status inside Claude Code to confirm the base URL and API key it is using.

If you need to change your ANTHROPIC_API_KEY

If for some reason you need to change your AI-VERDE API key, update ANTHROPIC_API_KEY wherever you set it in step 1 (~/.claude/settings.json or your shell profile), then restart Claude Code. If you previously declined the key prompt, Claude Code ignores the key without asking again; re-enable it with the Use custom API key option under /config.