Claude Code 自定义模型配置

Overview

Configures Claude Code (CLI v2.1.146+) to use a custom Anthropic-compatible API endpoint with non-Anthropic models. The key fix: placing "model" in settings.json bypasses Claude Code's local model name validation.

Quick Start

1. Copy assets/settings.json to ~/.claude/settings.json
2. Edit baseUrl to your endpoint, model to your model name
3. Set the API key:

```bash

export ANTHROPIC_API_KEY="sk-your-key-here"

```

1. Run claude

Key Configuration

Endpoint

Use the Anthropic-compatible address without /v1 suffix. Claude Code appends /v1/messages and /v1/models automatically.

Model Name — Critical Fix

Place "model" directly in settings.json to bypass Claude Code's local model name validation:

{
    "baseUrl": "https://<YOUR_ENDPOINT>",
    "model": "<YOUR_MODEL>"
}

Setting the model via ANTHROPIC_MODEL environment variable or --model CLI flag triggers validation and will be rejected for non-Anthropic models. Only the settings.json model field bypasses this check.

API Key

Store in ANTHROPIC_API_KEY environment variable (not in settings.json):

export ANTHROPIC_API_KEY="sk-your-key"

Troubleshooting