API 端点说明

#重要区别

#Claude Code（Anthropic API）

API 端点： https://www.qianmodao.com

特点：

• 不带 /v1 后缀
• 使用 Anthropic API 格式
• 配置字段：ANTHROPIC_BASE_URL

配置示例：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.qianmodao.com",
    "ANTHROPIC_API_KEY": "你的API令牌"
  }
}

#CodeX / OpenClaw（OpenAI API 兼容）

API 端点： https://www.qianmodao.com/v1

特点：

• 带 /v1 后缀
• 使用 OpenAI API 格式
• 配置字段：base_url 或 OPENAI_BASE_URL

配置示例：

model_provider = "qianmodao"

[model_providers.qianmodao]
name = "千模岛 API"
base_url = "https://www.qianmodao.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

#快速参考表

#为什么有这个区别？

#Anthropic API 格式

Anthropic 官方端点使用 https://api.anthropic.com， Base URL 不带 /v1；Claude Code 延续这一格式。

#OpenAI API 格式

OpenAI 官方端点使用 https://api.openai.com/v1，/v1 表示 API 版本。CodeX、OpenClaw 等兼容工具采用这一格式。

#常见错误

#❌ 错误配置示例

Claude Code 错误地添加了 /v1：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.qianmodao.com/v1"
  }
}

CodeX 忘记添加 /v1：

base_url = "https://www.qianmodao.com"

#✅ 正确配置示例

Claude Code：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.qianmodao.com"
  }
}

CodeX：

base_url = "https://www.qianmodao.com/v1"

#如何判断使用哪个端点？

#简单判断方法

1. 工具文档提到 Anthropic API 或 Claude API：地址不带 /v1。
2. 工具文档提到 OpenAI API 或 OpenAI 兼容：地址带 /v1。
3. 配置字段是 ANTHROPIC_BASE_URL：地址不带 /v1。
4. 配置字段是 OPENAI_BASE_URL 或 base_url： 地址带 /v1。

#测试连接

#测试 Claude Code 端点

curl -I https://www.qianmodao.com

#测试 CodeX/OpenAI 端点

curl -I https://www.qianmodao.com/v1

#使用快速切换配置

如果需要在千模岛 API 和官方 API 之间切换，请继续查看 快速切换配置。

#故障排除

#Connection refused 错误

• Claude Code：确认使用 https://www.qianmodao.com，不带 /v1。
• CodeX / OpenClaw：确认使用 https://www.qianmodao.com/v1，带 /v1。

#401 Unauthorized 错误

401 通常与 API Key 有关，而不是端点格式。先检查环境变量：

# Linux/macOS
echo $ANTHROPIC_API_KEY
echo $OPENAI_API_KEY

# Windows PowerShell
echo $env:ANTHROPIC_API_KEY
echo $env:OPENAI_API_KEY

#相关文档

• Claude Code 配置
• CodeX 配置
• OpenClaw 配置
• 快速切换 API 配置
• 常见问题