为Cursor、Claude Code、Codex配置LLM API

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) message = client.messages.create( model="claude-opus-5", max_tokens=1024, messages=[ {"role": "user", "content": "Write a fizzbuzz in Python."} ], ) print(message.content)

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) with client.messages.stream( model="claude-opus-5", max_tokens=1024, messages=[ {"role": "user", "content": "Tell me a short story."} ], ) as stream: for text in stream.text_stream: print(text, end="", flush=True) print()

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) response = client.chat.completions.create( model="gpt-5.4", messages=[ {"role": "user", "content": "Hello from CKEY"} ], ) print(response.choices[0].message.content)

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) stream = client.chat.completions.create( model="gpt-5.4", stream=True, messages=[ {"role": "user", "content": "Write a short poem."} ], ) for chunk in stream: delta = chunk.choices[0].delta.content or "" if delta: print(delta, end="", flush=True) print()

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const message = await client.messages.create({ model: "claude-opus-5", max_tokens: 1024, messages: [{ role: "user", content: "Write a fizzbuzz in Python." }], }); console.log(message.content);

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const stream = client.messages .stream({ model: "claude-opus-5", max_tokens: 1024, messages: [{ role: "user", content: "Tell me a short story." }], }) .on("text", (text) => { process.stdout.write(text); }); await stream.finalMessage(); process.stdout.write("\n");

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const response = await client.chat.completions.create({ model: "gpt-5.4", messages: [{ role: "user", content: "Hello from CKEY" }], }); console.log(response.choices[0]?.message?.content);

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const stream = await client.chat.completions.create({ model: "gpt-5.4", stream: true, messages: [{ role: "user", content: "Write a short poem." }], }); for await (const chunk of stream) { const delta = chunk.choices[0]?.delta?.content ?? ""; if (delta) { process.stdout.write(delta); } } process.stdout.write("\n");

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model":"claude-opus-5", "max_tokens":1024, "messages":[ {"role":"user","content":"Write a fizzbuzz in Python."} ] }'

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ --no-buffer \ -d '{ "model":"claude-opus-5", "max_tokens":1024, "stream":true, "messages":[ {"role":"user","content":"Tell me a short story."} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"gpt-5.4", "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ --no-buffer \ -d '{ "model":"gpt-5.4", "stream":true, "messages":[ {"role":"user","content":"Write a short poem."} ] }'

curl "https://api.xah.io/v1beta/models/gemini-2.5-flash-lite:generateContent" \ -H "Content-Type: application/json" \ -H "x-goog-api-key: sk-YOUR_API_KEY" \ -d '{ "contents":[ {"role":"user","parts":[{"text":"Write a fizzbuzz in Python."}]} ] }'

curl https://api.xah.io/api/chat \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"qwen3.8-max", "stream":false, "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

curl https://api.xah.io/api/generate \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"qwen3.8-max", "prompt":"Hello from CKEY", "stream":false }'

OpenAI-compatible chat/completions /v1

Cursor

Cursor应使用自定义API key和自定义base URL走OpenAI兼容模式。

需要填写的信息

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
模型: gpt-5.4
路由: chat/completions
套餐要求: 需要支持自定义API endpoint的Cursor套餐。

建议步骤

1打开Cursor Settings，进入AI / Models / API Keys。
2如果您的Cursor版本使用其他名称，请启用自定义OpenAI key或自定义provider选项。
3粘贴下方显示的API key和Base URL。
4选择推荐模型或价格表中其他当前活跃的模型。

可直接复制的配置模板

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

注意事项

Cursor使用OpenAI兼容模式，因此Base URL必须包含`/v1`。
如果某个模型在Cursor中无法运行，请切换到列表中其他活跃的OpenAI兼容模型。
保存后，发送一个简短prompt确认`chat/completions`路由正常工作。

Anthropic-compatible messages root URL

Claude Code

Claude Code应通过Anthropic环境变量配置，但Base URL必须是根域名。

安装Claude Code

macOS / Linux / Windows（Node 18+）： npm install -g @anthropic-ai/claude-code
安装后，运行`claude`进行确认。配置保存在`~/.claude/settings.json`。
Linux / macOS：`~/.claude/settings.json`
Windows：`%USERPROFILE%/.claude/settings.json`

需要填写的信息

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io
模型: claude-opus-5
路由: messages
最大tokens: 1024

注意事项

`ANTHROPIC_BASE_URL`不要包含`/v1`。
优先选择支持`messages`路由的模型。
如果Claude Code要求先登录授权，请先完成一次登录流程，再使用下面的环境变量重新打开。
通过`messages`路由发出的请求必须附带`max_tokens`字段。

临时终端

export ANTHROPIC_BASE_URL="https://api.xah.io"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
claude --bare

临时PowerShell会话

$env:ANTHROPIC_BASE_URL = "https://api.xah.io"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_API_KEY"
claude --bare

持久化配置

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.xah.io",
        "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
    }
}

VS Code扩展

VS Code中的扩展通常在OpenAI兼容模式配合自定义base URL时最稳定。

需要填写的信息

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
模型: claude-opus-5
路由: messages or chat/completions
最大tokens: 1024

Continue

name: CKEY API
version: 1.0.0
schema: v1
models:
  - name: claude-opus-5
    provider: anthropic
    model: claude-opus-5
    apiBase: https://api.xah.io/v1
    apiKey: sk-YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply

Cline

使用OpenAI兼容provider，Base URL要带`/v1`，API key从控制台获取。

Roo Code

使用OpenAI兼容provider，Base URL要带`/v1`，API key从控制台获取。

Kilo Code

使用OpenAI兼容provider，Base URL要带`/v1`，API key从控制台获取。

注意事项

使用OpenAI兼容provider，Base URL要带`/v1`，API key从控制台获取。
Cursor使用OpenAI兼容模式，因此Base URL必须包含`/v1`。
保存后，发送一个简短prompt确认`chat/completions`路由正常工作。
通过`messages`路由发出的请求必须附带`max_tokens`字段。

OpenAI-compatible ~/.codex /v1

Codex CLI

用于VS Code的Codex扩展支持OpenAI兼容API，可使用自定义base URL和API key。

安装Codex CLI

macOS / Linux / Windows（Node 18+）： npm install -g @openai/codex
安装后，运行`codex`进行验证。Codex从`~/.codex/auth.json`读取认证信息，从`~/.codex/config.toml`读取配置。
配置：`~/.codex/config.toml`（Windows：`%USERPROFILE%/.codex/config.toml`）
认证：`~/.codex/auth.json`（Windows：`%USERPROFILE%/.codex/auth.json`）

需要填写的信息

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
模型: gpt-5.4
路由: chat/completions

建议步骤

1从VS Code Marketplace安装Codex扩展。
2打开VS Code Settings，搜索Codex配置。
3在Codex配置中填写API Key和Base URL。
4从当前活跃模型列表中选择模型。

`~/.codex/config.toml`的内容

model = "gpt-5.4"
model_reasoning_effort = "high"
personality = "pragmatic"

openai_base_url = "https://api.xah.io/v1"

`~/.codex/auth.json`的内容

{
    "auth_mode": "apikey",
    "OPENAI_API_KEY": "sk-YOUR_API_KEY"
}

注意事项

Codex使用OpenAI兼容endpoint，因此Base URL必须包含/v1。
配置完成后，重新加载VS Code使更改生效。
打开一个代码文件尝试与Codex聊天进行测试。

OpenAI-compatible ~/.factory /v1

Factory Droid

Factory Droid是一款CLI助手，允许通过`settings.json`文件配置自定义模型。

安装Droid CLI

macOS / Linux： curl -fsSL https://app.factory.ai/cli | sh
Windows（PowerShell）： iwr -useb https://app.factory.ai/cli/install.ps1 | iex
安装后，运行`droid`进行验证。
Linux / macOS：`~/.factory/settings.json`
Windows：`%USERPROFILE%/.factory/settings.json`

需要填写的信息

Provider: openai
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
模型: gpt-5.4
路由: chat/completions

注意事项

`customModels`中的每个条目都需要唯一的`id`和递增的`index`（0, 1, 2...）。
将`provider`设为`openai`，使Droid走OpenAI兼容流程。
可以复制数组中的对象并修改`model` + `id`来添加更多模型。

`~/.factory/settings.json`的内容

{
    "customModels": [
        {
            "model": "gpt-5.4",
            "id": "custom:ckey-0",
            "index": 0,
            "baseUrl": "https://api.xah.io/v1",
            "apiKey": "sk-YOUR_API_KEY",
            "displayName": "gpt-5.4",
            "maxOutputTokens": 131072,
            "noImageSupport": false,
            "provider": "openai"
        }
    ]
}

OpenCode

OpenCode可将其Anthropic provider指向您的endpoint并使用同一个API key。

安装OpenCode

通过npm安装： npm install -g opencode-ai
安装后，运行`opencode`进行验证。配置位于`~/.config/opencode/opencode.json`（或`.jsonc`）。

配置文件路径

Windows：`%USERPROFILE%/.config/opencode/opencode.json`
Linux / macOS：`~/.config/opencode/opencode.json`

需要填写的信息

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
模型: claude-opus-5
路由: messages
最大tokens: 1024

可直接复制的配置模板

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "ckey": {
            "npm": "@ai-sdk/openai-compatible",
            "options": {
                "baseURL": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY"
            },
            "models": {
                "claude-opus-5": {
                    "name": "claude-opus-5"
                },
                "gpt-5.4": {
                    "name": "gpt-5.4"
                },
                "deepseek-v4-flash": {
                    "name": "deepseek-v4-flash"
                },
                "deepseek-v4-flash-0731": {
                    "name": "deepseek-v4-flash-0731"
                },
                "deepseek-v4-pro-0813": {
                    "name": "deepseek-v4-pro-0813"
                },
                "gpt-5.5": {
                    "name": "gpt-5.5"
                }
            }
        }
    },
    "model": "ckey/claude-opus-5",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-opus-5"
        }
    }
}

注意事项

OpenCode应指向带`/v1`的endpoint。
如果您的流程使用anthropic风格的工具，请优先选择当前活跃的Claude模型。
如果在配置其他位置更换模型，请保持base URL和API key与下方一致。
通过`messages`路由发出的请求必须附带`max_tokens`字段。

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw可通过`openclaw.json`文件使用OpenAI兼容provider，provider别名设为`ckey`。

配置文件路径

项目根目录：`./openclaw.json`
Windows：`%USERPROFILE%/.openclaw/openclaw.json`
Linux / macOS：`~/.openclaw/openclaw.json`

需要填写的信息

Provider: ckey / OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
模型: ckey/gpt-5.4
路由: chat/completions

可直接复制的配置模板

{
    "agents": {
        "defaults": {
            "model": {
                "primary": "ckey/gpt-5.4"
            }
        }
    },
    "models": {
        "providers": {
            "ckey": {
                "baseUrl": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gpt-5.4",
                        "name": "gpt-5.4"
                    },
                    {
                        "id": "claude-opus-5",
                        "name": "claude-opus-5"
                    },
                    {
                        "id": "deepseek-v4-flash",
                        "name": "deepseek-v4-flash"
                    },
                    {
                        "id": "deepseek-v4-flash-0731",
                        "name": "deepseek-v4-flash-0731"
                    },
                    {
                        "id": "deepseek-v4-pro-0813",
                        "name": "deepseek-v4-pro-0813"
                    },
                    {
                        "id": "glm-5.2",
                        "name": "glm-5.2"
                    }
                ]
            }
        }
    }
}

注意事项

OpenClaw应使用带`/v1`的`baseUrl`。
保持`api`为`openai-completions`，走OpenAI兼容流程。
您可以在列表中添加或移除模型，但`ckey/`别名和API key应与示例保持一致。

按工具分别配置客户端

配置前准备

Base URL规则

SDK

Anthropic API请求

Anthropic API流式

OpenAI兼容请求

OpenAI兼容流式

Anthropic API请求

Anthropic API流式

OpenAI兼容请求

OpenAI兼容流式

Anthropic API请求

Anthropic API流式

OpenAI兼容请求

OpenAI兼容流式

Gemini（Google）请求

Ollama请求

Ollama生成 (/api/generate)

以base64发送本地图片

通过URL发送图片

Base URL

模型

API Key

Cursor

需要填写的信息

建议步骤

可直接复制的配置模板

推荐尝试的模型

注意事项

Claude Code

安装Claude Code

需要填写的信息

注意事项

临时终端

临时PowerShell会话

持久化配置

推荐尝试的模型

VS Code扩展

需要填写的信息

Continue

Cline

Roo Code

Kilo Code

推荐尝试的模型

注意事项

Codex CLI

安装Codex CLI

需要填写的信息

建议步骤

`~/.codex/config.toml`的内容

`~/.codex/auth.json`的内容

推荐尝试的模型

注意事项

Factory Droid

安装Droid CLI

需要填写的信息

注意事项

`~/.factory/settings.json`的内容

推荐尝试的模型

OpenCode

安装OpenCode

配置文件路径

需要填写的信息

可直接复制的配置模板

推荐尝试的模型

注意事项

OpenClaw

配置文件路径

需要填写的信息

可直接复制的配置模板

推荐尝试的模型

注意事项