1Install

Requires Node.js 18 or later. Skip this if Claude Code is already installed.

Terminal

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

2Configure access

YOUR_API_KEY in the examples is a placeholder and will not work as copied. Sign in to pick one of your keys and fill it into every example on this page.

Sign in to fill in key

Save the URL and key in Claude Code’s own configuration file for persistent access without changing system environment variables. Replace YOUR_API_KEY with your API key, or choose a key at the top of the page to fill it in automatically.

Manual setup: merge the following into ~/.claude/settings.json (preserve other existing settings)

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.keyvia.cc",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

Or run this in your terminal to merge and back up settings.json.bak. Nothing is downloaded.

node - <<'EOF'
const fs = require("fs"), path = require("path")
const file = path.join(require("os").homedir(), ".claude", "settings.json")
fs.mkdirSync(path.dirname(file), { recursive: true })
let config = {}
if (fs.existsSync(file)) {
  fs.copyFileSync(file, file + ".bak")  // Back up the existing file
  try { config = JSON.parse(fs.readFileSync(file, "utf8") || "{}") }
  catch { console.error("Invalid existing settings.json; no changes were made"); process.exit(1) }
}
config.env = { ...config.env,  // Update only these fields; preserve other settings
  ANTHROPIC_BASE_URL: "https://api.keyvia.cc",
  ANTHROPIC_AUTH_TOKEN: "YOUR_API_KEY",
}
fs.writeFileSync(file, JSON.stringify(config, null, 2) + "\n")
console.log("Merged into " + file + " (original backed up as settings.json.bak)")
console.log("Setup complete. Go to your project directory and run claude to start.")
EOF

Why settings.json instead of system environment variables?

This affects only Claude Code, not other projects using the Anthropic SDK. New terminals load it automatically without running source.

3Verify

Open your project directory and run claude, then enter /status and confirm the displayed Base URL is https://api.keyvia.cc. If Claude Code can read the project and respond, setup is complete.

Existing sessions do not reload configuration. Fully exit and restart the tool after making changes.
For 401 / 403 / 429 errors, see Error codes.
If a model is unavailable, check the Model catalog for its exact name, then confirm the key’s group supports Anthropic.