clade code 接入与配置说明文档

本文档用于指导如何在系统中配置 API 环境变量，以及如何通过不同的编程语言和工具调用我们的接口。

1. 环境变量配置示例 (Anthropic/Claude)

如果你需要配置底层的环境变量（如 .env 或 config.json），请参考以下示例。请将 YOUR_API_KEY_HERE 替换为真实的 Token。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY_HERE",
    "ANTHROPIC_BASE_URL": "https://api.lluu.ai",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-20250514",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514"
  }
}

2. 环境变量参数说明

环境变量名称	说明	示例值
`ANTHROPIC_AUTH_TOKEN`	API 密钥。用于鉴权的 Token，需保持私密。	`sk-xxxx...`
`ANTHROPIC_BASE_URL`	自定义 API 地址。指向中转网关。注意：在系统底层变量配置时通常不带 `/v1`。	`https://api.lluu.ai`
`ANTHROPIC_MODEL`	默认调用模型。未指定具体版本时的全局默认值。	`claude-sonnet-4-20250514`
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Haiku 映射。对应高速度、低成本的轻量级模型。	`claude-haiku-4-20250514`
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Sonnet 映射。对应性能与速度平衡的标准模型。	`claude-sonnet-4-20250514`
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Opus 映射。对应最强性能模型（此处演示自动降级到 Sonnet）。	`claude-sonnet-4-20250514`

3. API 调用示例 (OpenAI 兼容格式)

lluuai 完全兼容 OpenAI 的接口规范，你可以直接使用 OpenAI 的官方 SDK 进行调用，只需替换 Base URL 和 API Key 即可。

方式一：使用 Python SDK

方式二：使用 Node.js SDK

方式三：使用 cURL (命令行)

4. 常见问题 (FAQ)

Q: 为什么提示 401 错误？

A: 请检查 API Key 是否填写正确，以及请求头中是否包含了 Bearer 前缀。

Q: 支持哪些模型？

A: 我们支持包括 gpt-4o, claude-3-5-sonnet 等在内的多种主流模型，具体请参考“模型列表”文档。

Q: 必须要带 /v1 吗？

A: 是的，在使用 SDK 请求代码配置 Base URL 时，建议始终带上 /v1 以确保与官方 SDK 的最大兼容性（注意区分：底层系统环境变量中的 BASE_URL 配置通常不需要带）。

Claude code 接入说明

clade code 接入与配置说明文档#

1. 环境变量配置示例 (Anthropic/Claude)#

2. 环境变量参数说明#

3. API 调用示例 (OpenAI 兼容格式)#

方式一：使用 Python SDK#

方式二：使用 Node.js SDK#

方式三：使用 cURL (命令行)#

4. 常见问题 (FAQ)#