API 端点说明

使用 TinyPx API 配置 Claude Code、Codex、OpenClaw 等 AI 工具时，需要注意不同工具使用不同的 API 端点格式。

关键区别

最容易踩的坑

不同工具使用不同的 API 端点格式，请务必注意 /v1 后缀的有无。

Claude Code（Anthropic API）

API 端点：https://ai.tinypx.cn

特点：

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

配置示例：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.tinypx.cn",
    "ANTHROPIC_API_KEY": "你的API令牌"
  }
}

Codex / OpenClaw（OpenAI API 兼容）

API 端点：https://ai.tinypx.cn/v1

特点：

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

配置示例：

model_provider = "tinypx"

[model_providers.tinypx]
name = "TinyPx API"
base_url = "https://ai.tinypx.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

快速参考表

工具	API 端点	是否带 /v1	API 格式
Claude Code	https://ai.tinypx.cn	❌ 否	Anthropic
Codex CLI	https://ai.tinypx.cn/v1	✅ 是	OpenAI
OpenClaw	https://ai.tinypx.cn/v1	✅ 是	OpenAI
快速切换配置	按目标工具手动切换	—	两者都支持

为什么有这个区别？

Anthropic API 格式 Anthropic 的官方 API 端点是 https://api.anthropic.com，不使用 /v1 后缀。Claude Code 遵循这个格式。

OpenAI API 格式 OpenAI 的官方 API 端点是 https://api.openai.com/v1，用 /v1 表示 API 版本。所有 OpenAI 兼容的工具（包括 Codex、OpenClaw）都遵循这个格式。

常见错误

❌ 错误配置

Claude Code 错误地加上了 /v1：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.tinypx.cn/v1"
  }
}

Codex 忘记添加 /v1：

base_url = "https://ai.tinypx.cn"

✅ 正确配置

Claude Code：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.tinypx.cn"
  }
}

Codex：

base_url = "https://ai.tinypx.cn/v1"

如何判断该用哪个端点

看工具文档

• 提到「Anthropic API」或「Claude API」→ 不带 /v1
• 提到「OpenAI API」或「OpenAI 兼容」→ 带 /v1

看配置字段名

• ANTHROPIC_BASE_URL → 不带 /v1
• OPENAI_BASE_URL 或 base_url → 带 /v1

看官方示例

• 官方示例用 api.anthropic.com → 不带 /v1
• 官方示例用 api.openai.com/v1 → 带 /v1

测试连接

测试 Claude Code 端点：

curl -I https://ai.tinypx.cn

测试 Codex / OpenAI 端点：

curl -I https://ai.tinypx.cn/v1

故障排除

Connection refused

先检查 API 端点是否正确：

• Claude Code → 确认使用 https://ai.tinypx.cn（不带 /v1）
• Codex / OpenClaw → 确认使用 https://ai.tinypx.cn/v1（带 /v1）

401 Unauthorized

这通常是 API 密钥问题，与端点格式无关。检查：

• API 密钥是否正确
• API 密钥是否有效、余额是否充足
• 环境变量是否正确设置

# Linux/macOS
echo $ANTHROPIC_API_KEY
echo $OPENAI_API_KEY

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

记忆技巧

• Claude Code = Clean（干净，不带 /v1）
• Codex = X = eXtra（额外的 /v1）

相关文档

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

获取 API 密钥

访问 TinyPx API 控制台 创建你的 API 令牌， 在 模型广场 查看各分组可用的模型与价格。