Claude Code

Claude Code reads Anthropic-related configuration. When connecting to 4096bytes, do not paste an OpenAI compatible URL into unrelated fields and do not manually append /v1/messages. Use the Claude Code settings shown in the dashboard.

Prefer managing the Claude Code Provider with CC Switch. It lets you switch between 4096bytes, official Claude, and other Providers without repeatedly editing environment variables.

Prerequisites

You have completed Create an account.
You have completed Get an API Key.
Claude Code is installed and claude can start.
You have copied the Claude Code configuration from the dashboard.

If you use both an official Claude subscription and a 4096bytes API Key, keep them in separate terminal profiles or CC Switch profiles to avoid environment variable conflicts.

Install

If Claude Code is not installed, follow the official Claude Code setup documentation. macOS, Linux, or WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows with WinGet:

winget install Anthropic.ClaudeCode

If you use npm for global CLI tools:

npm install -g @anthropic-ai/claude-code

After installation, reopen the terminal and verify:

claude --version

Copy config from the dashboard

Open API Keys

Open the dashboard and go to API Keys.

Find the target key

Create a dedicated key for Claude Code, such as claude-code-work or claude-code-mac.

Open Use key

Click Use key in that key row. If the dashboard offers client options, choose Claude Code.

Choose your system

Select macOS / Linux, Windows PowerShell, or Windows CMD, then copy the command shown in the dashboard.

The dashboard command includes the current API Key. The examples below use YOUR_4096BYTES_API_KEY as a placeholder.

Temporary environment variables

Use this method for a quick test. The variables disappear when you close the terminal.

macOS or Linux

export ANTHROPIC_BASE_URL="https://api.4096bytes.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_4096BYTES_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

If your Claude Code version requires ANTHROPIC_API_KEY, use this instead:

export ANTHROPIC_BASE_URL="https://api.4096bytes.com"
export ANTHROPIC_API_KEY="YOUR_4096BYTES_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

Do not set both ANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEY. Prefer the variable name shown in the dashboard.

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.4096bytes.com"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_4096BYTES_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
claude

If the dashboard uses ANTHROPIC_API_KEY, replace the second line with:

$env:ANTHROPIC_API_KEY = "YOUR_4096BYTES_API_KEY"

Windows CMD

set ANTHROPIC_BASE_URL=https://api.4096bytes.com
set ANTHROPIC_AUTH_TOKEN=YOUR_4096BYTES_API_KEY
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

If the dashboard uses ANTHROPIC_API_KEY, replace the second line with:

set ANTHROPIC_API_KEY=YOUR_4096BYTES_API_KEY

Persist in Claude Code settings

For long-term use, write the environment variables into the Claude Code settings file.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.4096bytes.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_4096BYTES_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

A common path is ~/.claude/settings.json. Save the file and restart Claude Code.

Do not put API Keys in project .env files, README files, screenshots, or shared documents. Claude Code reads the current terminal environment, so also avoid exposing keys in logs and screenshots.

Persist in shell config

You can also write the variables into ~/.zshrc or ~/.bashrc.

export ANTHROPIC_BASE_URL="https://api.4096bytes.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_4096BYTES_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Then reload the shell:

source ~/.zshrc

For Bash:

source ~/.bashrc

Run:

claude

Specify a model

If Claude Code needs an explicit model, use the model name shown for Claude Code or Claude compatible access in the dashboard.

claude --model PASTE_MODEL_NAME_FROM_DASHBOARD

The model name must match the dashboard exactly.

Notes

Use the root Base URL shown in the dashboard, for example https://api.4096bytes.com. Do not append /v1/messages.
After switching Providers, reopen the terminal or confirm the environment variables are updated.
If you use CC Switch, confirm the active profile is 4096bytes.
If you run Claude Code inside VS Code Terminal, reopen VS Code after changing environment variables.

Troubleshooting

Issue	What to do
Authentication failed	Confirm the API Key is complete and only one of `ANTHROPIC_AUTH_TOKEN` or `ANTHROPIC_API_KEY` is enabled.
Wrong address	Use the root address shown in the dashboard. Do not append the full request path.
Still using official service	Reopen the terminal and check whether old Claude environment variables still exist.
Model unavailable	Use a Claude Code or Claude compatible model name shown in the dashboard.
Not working in VS Code	Close and reopen VS Code so the terminal reads the updated environment.

Quickstart

Clients

SDKs

Prerequisites

Install

Copy config from the dashboard

Temporary environment variables

macOS or Linux

Windows PowerShell

Windows CMD

Persist in Claude Code settings

Persist in shell config

Specify a model

Notes

Troubleshooting

​Prerequisites

​Install

​Copy config from the dashboard

​Temporary environment variables

​macOS or Linux

​Windows PowerShell

​Windows CMD

​Persist in Claude Code settings

​Persist in shell config

​Specify a model

​Notes

​Troubleshooting

Prerequisites

Install

Copy config from the dashboard

Temporary environment variables

macOS or Linux

Windows PowerShell

Windows CMD

Persist in Claude Code settings

Persist in shell config

Specify a model

Notes

Troubleshooting