Claude Code
Manual Claude Code setup: folder, settings.json, key and model on Windows and macOS/Linux.
On this page
1. Open the configuration folder
Claude Code must already be installed. Fully quit it before editing. If configuration exists, make a backup first. The examples below are for a new setup; in an existing file merge only the required Etage fields without removing other connections, security settings or sign-in data.
Windows: press Win + R and open %USERPROFILE%\.claude. If the folder is missing, create it with the PowerShell command below (not CMD), then edit the file in Notepad. On macOS open Terminal; on Linux use your terminal. The second tab creates the folder and opens the file in nano; another text editor also works. Examples use the standard home directory; if you changed the client configuration location, use your own path.
New-Item -ItemType Directory -Force -Path "$HOME\.claude" | Out-Null
notepad "$HOME\.claude\settings.json"2. Write settings.json
Create settings.json and paste the JSON below. ANTHROPIC_BASE_URL is https://api.etage.one without /v1: Claude Code adds the Messages path itself. In an existing settings.json merge env fields rather than creating a duplicate env. The example does not change client permissions.
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.etage.one",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "YOUR_MODEL",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL"
}
}3. Set your key and model
Replace YOUR_API_KEY with your Etage key, and every YOUR_MODEL with one exact Model ID compatible with Messages and allowed by your key. The Claude Code client name does not mean you must choose a Claude model. Never send settings.json to chat or support. Check that old authorization variables or apiKeyHelper do not override this connection; do not combine conflicting credentials by guesswork.
4. Save and restart the client
Save as plain UTF-8 text. In Notepad choose All files, press Ctrl + S and check that .txt was not added to the filename. In nano: Ctrl + O → Enter → Ctrl + X. On macOS/Linux restrict access to key-containing files with the command below; do not publish them or their backups.
Fully quit and reopen Claude Code, including quitting its tray process if it stays running there. In a terminal use claude. Select the configured model. A first request requires available credits and a model allowed by your key; requests spend credits. Successful configuration does not make every model compatible with every client feature.
chmod 600 "$HOME/.claude/settings.json"