Claude Code

Claude Code is Anthropic's official CLI agent, which also has a VS Code extension. By pointing it at a running Tresor instance, you can keep the Anthropic client experience while hot-switching the underlying model between Anthropic, DeepSeek, MiniMax, a local llama.cpp server, or any other configured downstream — all from the web UI.

No need to worry about the different API format underlying model is using, Tresor will auto-translate between the Anthropic API (Claude Code) to other API formats (e.g., gpt-5.5 using OpenAI Responses).

This page shows how to wire Claude Code CLI or VS Code extension to Tresor. For Claude Code inside Claude Desktop, follow Claude Desktop guide instead.

✅ Prerequisites

• Installed Tresor following installation guide.
• Claude Code CLI or VS Code extension installed.

1. Configure Tresor

There are two ways to prepare Tresor:

Web UI

Web UI is more intuitive, but require more manual operations.

1. In "Downstreams" tab

   • Click + Add Provider to add the LLM provider you are about to use.

2. In "Aliases" tab

   • Click + New Alias Group
     • Input Model ID: claude-opus.*
     • Checked "Regex Pattern"
     • Select the Downstream and Output Model IDs you added previously.
   • Repeat the above add new alias group process to add claude-sonnet.* and claude-haiku.*

3. In "Settings" tab

   • Click + Add API Key under "Proxy Authentication" section (e.g, sk-proxy-123). Copy it, and we are about to fill it into ANTHROPIC_AUTH_TOKEN in the following section.

config.yaml

Editing yaml is less intuitive, but require less manual operations.

The following example config.yaml uses 3 downstream providers. Replace them based on your actual providers.

~/.config/tresor/config.yaml

bind_addr: 127.0.0.1:11510
proxy_api_keys:
- sk-proxy-123
... # Omitted showing other settings here
downstreams:
  - id: llama-cpp
    name: llama.cpp
    base_url: http://127.0.0.1:3000 # change to your actual llama.cpp listening port
    api_formats:
        - openai
        - anthropic
    output_model_ids:
        - qwen3.8:27b-coder
        - qwen3.8:27b:instruct
  - id: deepseek
    name: DeepSeek
    base_url: https://api.deepseek.com
    api_formats:
        - openai
        - openai_responses
        - anthropic
    output_model_ids:
        - deepseek-flash
        - deepseek-v4-pro
    is_enabled: true
    auth:
        type: api_key
        api_key: sk-YOUR-DEEPSEEK-API-KEY
    format_urls:
        anthropic: https://api.deepseek.com/anthropic
  - id: minimax
    name: MiniMax
    base_url: https://api.minimaxi.com/anthropic
    api_formats:
        - anthropic
    output_model_ids:
        - MiniMax-M2.5
        - MiniMax-M2.7
        - MiniMax-M3
aliases:
  - input_model_id: claude-opus.*
    is_regex: true
    announced_names:
        - claude-opus
        - claude-opus-5
    options:
      - id: alias-minimax-m3
        downstream_id: minimax
        output_model_id: MiniMax-M3
      - id: alias-deepseek-pro
        downstream_id: deepseek
        output_model_id: deepseek-v4-pro
  - input_model_id: claude-sonnet.*
    is_regex: true
    announced_names:
        - claude-sonnet
        - claude-sonnet-5
    options:
      - id: alias-llama-cpp-qwen-instruct
        downstream_id: llama-cpp
        output_model_id: qwen3.8:27b:instruct
      - id: alias-deepseek-flash
        downstream_id: deepseek
        output_model_id: deepseek-flash
      - id: alias-minimax-m2-7
        downstream_id: minimax
        output_model_id: MiniMax-M2.7
  - input_model_id: claude-haiku.*
    is_regex: true
    announced_names:
        - claude-haiku
        - claude-haiku-4-5
    options:
      - id: alias-minimax-m2-5
        downstream_id: minimax
        output_model_id: MiniMax-M2.5

Restart Tresor to apply the changes in yaml.

If a not-announced name like claude-opus-4-8 requests Tresor, the most precisely matched alias will still handle it (in this case, claude-opus.*). Optional announced names does not limit the capability of regex alias group's model name matching.

2. Configure Claude Code

Claude Code CLI

Linux / macOS

export ANTHROPIC_BASE_URL="http://127.0.0.1:11510"
export ANTHROPIC_AUTH_TOKEN="sk-proxy-123"
export ANTHROPIC_MODEL="claude-sonnet" # can be omitted, since we have used wildcard alias in Tresor
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus" # can be omitted, since we have used wildcard alias in Tresor
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet" # can be omitted, since we have used wildcard alias in Tresor
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku" # can be omitted, since we have used wildcard alias in Tresor
export CLAUDE_CODE_SUBAGENT_MODEL="claude-haiku" # can be omitted, since we have used wildcard alias in Tresor

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "http://127.0.0.1:11510"
$env:ANTHROPIC_AUTH_TOKEN = "sk-proxy-123"
$env:ANTHROPIC_MODEL = "claude-sonnet" # can be omitted, since we have used wildcard alias in Tresor
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus" # can be omitted, since we have used wildcard alias in Tresor
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet" # can be omitted, since we have used wildcard alias in Tresor
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku" # can be omitted, since we have used wildcard alias in Tresor
$env:CLAUDE_CODE_SUBAGENT_MODEL = "claude-haiku" # can be omitted, since we have used wildcard alias in Tresor

Persist the variables

Drop the export lines into your shell profile (~/.bashrc, ~/.zshrc, or $PROFILE on PowerShell) so every new shell inherits them. Claude Code only reads the variables at launch — restart the CLI after editing your profile.

VS Code extension

In VS Code's setting page:

1. Enable "Claude Code: Disable Login Prompt"

2. Enable "Claude Code: Hide Onboarding"

3. In "Claude Code: Environment Variables", click "Edit in settings.json", and add the following lines:

   "claudeCode.environmentVariables": [
       {
           "name": "ANTHROPIC_BASE_URL",
           "value": "http://127.0.0.1:11510"
       },
       {
           "name": "ANTHROPIC_AUTH_TOKEN",
           "value": "sk-proxy-123"
       },
       {
           "name": "ANTHROPIC_MODEL",
           "value": "claude-sonnet"
       },
       {
           "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
           "value": "claude-opus"
       },
       {
           "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
           "value": "claude-sonnet"
       },
       {
           "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
           "value": "claude-haiku"
       },
       {
           "name": "CLAUDE_CODE_SUBAGENT_MODEL",
           "value": "claude-haiku"
       }
   ],

warning

For remote connections, if you set "ANTHROPIC_BASE_URL" to "http://127.0.0.1:11510", then Claude Code extension will try to connect port 11510 of remote server. In this case, you can either:

• Map your PC's port 11510 to remote server's port 11510 using SSH RemoteForward (-R 11510:localhost:11510).
• host a single Tresor instance on a public server, set Tresor's bind_addr to "0.0.0.0:11510", then set "ANTHROPIC_BASE_URL" to "http://YOUR_PUBLIC_SERVER_IP:11510". If you need encrypted connection to this remote Tresor instance instead, consider using Zerotier/Tailscale, or Nginx+certbot to enable HTTPS connections.
• install Tresor also on that remote server (two Tresor instances).

3. Launch Claude Code

Claude Code CLI

cd /path/to/my-project
claude

VS Code extension

Just restart VS Code and start using.

Claude Code will send the model name you set in ANTHROPIC_MODEL to Tresor, which will resolve it through the matching aliases entry and forward the request to the active downstream for that alias.

You can even switch the model in Claude Code to Opus, Sonnet, or Haiku via /model command: they will be matched by the regex wildcard alias claue-opus.*, claude-sonnet.*, and claue-haiku.*, and mapped to the model you specify in the Aliases tab.

4. Hot-switch from the web UI

Open http://127.0.0.1:11510 in a browser, go to the Aliases tab, and click any sibling option card to make it active. Claude Code's next request will be routed to the new downstream — no restart of either Tresor or Claude Code is required. 🎉

For example, flip claude-sonnet from deepseek-flash to MiniMax-M2.7 with a single click, and the agent immediately starts using MiniMax on the following turn.

5. Using Web Search in Claude Code

Tresor is fully API-compatible with the Anthropic Messages endpoint, so the Web Search tool works the same way it does with the official Anthropic API: when Claude Code's model decides a question needs fresh information, it invokes the Web Search tool and the search runs through the active downstream provider.

If the active downstream is DeepSeek, the search and the summarising LLM call both go through DeepSeek, so each search may incur extra token cost (one extra LLM call to summarise the retrieved pages).

If the active downstream is a local llama.cpp server, Web Search is not available unless that backend exposes the tool itself.

🔧 Troubleshooting

Symptom	Likely cause	Fix
401 Unauthorized from Tresor	proxy_api_keys is set but ANTHROPIC_AUTH_TOKEN doesn't match	Set ANTHROPIC_AUTH_TOKEN to one of the keys in proxy_api_keys, or empty the list in config.yaml
404 model not found from Tresor	Alias exists but the chosen downstream isn't reachable	Open Logs, click the failing row, check the downstream error. Confirm base_url and that the local llama-server is up
Responses come back from the wrong model	An alias is missing or matched a different regex	In the Aliases tab, verify the active card for the input model; regex aliases need is_regex: true

📚 See also

• DeepSeek guide for Claude Code