TinyPx API 文档

主题

快速切换 API 配置 ​

本指南介绍如何在不同 API 服务商之间快速切换 Claude Code 和 Codex 配置。

方法 1：使用环境变量（推荐） ​

切换到 TinyPx API ​

Linux / macOS（Bash）

bash
# 添加到 ~/.bashrc 或 ~/.bash_profile
export ANTHROPIC_API_KEY="你的 TinyPx API 令牌"
export ANTHROPIC_BASE_URL="https://ai.tinypx.cn"
export OPENAI_API_KEY="你的 TinyPx API 令牌"
export OPENAI_BASE_URL="https://ai.tinypx.cn/v1"

# 重新加载配置
source ~/.bashrc

Linux / macOS（Zsh）

bash
# 添加到 ~/.zshrc
export ANTHROPIC_API_KEY="你的 TinyPx API 令牌"
export ANTHROPIC_BASE_URL="https://ai.tinypx.cn"
export OPENAI_API_KEY="你的 TinyPx API 令牌"
export OPENAI_BASE_URL="https://ai.tinypx.cn/v1"

# 重新加载配置
source ~/.zshrc

Windows PowerShell

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的 TinyPx API 令牌", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.tinypx.cn", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的 TinyPx API 令牌", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://ai.tinypx.cn/v1", "User")

切换回官方 API ​

Linux / macOS

bash
export ANTHROPIC_BASE_URL="https://api.anthropic.com"
export OPENAI_BASE_URL="https://api.openai.com/v1"

Windows PowerShell

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.anthropic.com", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.openai.com/v1", "User")

别忘了密钥也要换

切换回官方 API 时，ANTHROPIC_API_KEY / OPENAI_API_KEY 也要换成对应官方平台的令牌， 否则会报 401。TinyPx 的令牌在官方端点上是无效的，反之亦然。

方法 2：使用配置文件 ​

Claude Code 配置文件 ​

编辑 ~/.claude/settings.json（Linux/macOS）或 %USERPROFILE%\.claude\settings.json（Windows）。

TinyPx API：

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

官方 API：

json
{
  "env": {
    "ANTHROPIC_API_KEY": "你的 Anthropic API 令牌",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}

Codex 配置文件 ​

编辑 ~/.codex/config.toml（Linux/macOS）或 %USERPROFILE%\.codex\config.toml（Windows）。

TinyPx API：

toml
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：

toml
model_provider = "openai"

[model_providers.openai]
name = "OpenAI"
base_url = "https://api.openai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

两套 provider 可以共存

config.toml 里可以同时保留 [model_providers.tinypx] 和 [model_providers.openai] 两段， 切换时只改顶部那行 model_provider = "..." 即可，不用来回删配置。

创建切换脚本 ​

Linux / macOS 脚本 ​

创建 ~/switch-to-tinypx.sh：

bash
#!/bin/bash
export ANTHROPIC_API_KEY="你的 TinyPx API 令牌"
export ANTHROPIC_BASE_URL="https://ai.tinypx.cn"
export OPENAI_API_KEY="你的 TinyPx API 令牌"
export OPENAI_BASE_URL="https://ai.tinypx.cn/v1"
echo "已切换到 TinyPx API"

创建 ~/switch-to-official.sh：

bash
#!/bin/bash
export ANTHROPIC_API_KEY="你的 Anthropic API 令牌"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"
export OPENAI_API_KEY="你的 OpenAI API 令牌"
export OPENAI_BASE_URL="https://api.openai.com/v1"
echo "已切换到官方 API"

添加执行权限：

bash
chmod +x ~/switch-to-tinypx.sh ~/switch-to-official.sh

使用（必须用 source）：

bash
# 切换到 TinyPx API
source ~/switch-to-tinypx.sh

# 切换到官方 API
source ~/switch-to-official.sh

必须用 source 执行

直接 ./switch-to-tinypx.sh 是无效的 —— 脚本会在子进程里设置环境变量， 子进程一退出变量就消失了，当前终端完全不受影响。 必须用 source ~/switch-to-tinypx.sh（或简写 . ~/switch-to-tinypx.sh）让它在当前 shell 里执行。

Windows 脚本 ​

创建 switch-to-tinypx.ps1：

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的 TinyPx API 令牌", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.tinypx.cn", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的 TinyPx API 令牌", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://ai.tinypx.cn/v1", "User")
Write-Host "已切换到 TinyPx API（需重开终端生效）"

创建 switch-to-official.ps1：

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的 Anthropic API 令牌", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.anthropic.com", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的 OpenAI API 令牌", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.openai.com/v1", "User")
Write-Host "已切换到官方 API（需重开终端生效）"

使用：

powershell
.\switch-to-tinypx.ps1
.\switch-to-official.ps1

需要重开终端

SetEnvironmentVariable(..., "User") 写的是持久化的用户环境变量， 当前已打开的终端读不到新值，需要重开一个终端窗口。 想让当前窗口立即生效，额外执行 $env:ANTHROPIC_BASE_URL = "https://ai.tinypx.cn" 这样的赋值。

脚本里有明文密钥

这些脚本包含明文 API 令牌。请勿提交到 Git，并限制文件权限： chmod 600 ~/switch-to-*.sh（Linux/macOS）。

验证配置 ​

Linux / macOS

bash
echo $ANTHROPIC_BASE_URL
echo $OPENAI_BASE_URL

Windows PowerShell

powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:OPENAI_BASE_URL

环境变量对照表 ​

环境变量用途TinyPx API官方 API
ANTHROPIC_API_KEYClaude Code 密钥TinyPx 令牌Anthropic 令牌
ANTHROPIC_BASE_URLClaude Code 地址https://ai.tinypx.cnhttps://api.anthropic.com
OPENAI_API_KEYCodex/OpenAI 密钥TinyPx 令牌OpenAI 令牌
OPENAI_BASE_URLCodex/OpenAI 地址https://ai.tinypx.cn/v1https://api.openai.com/v1

端点格式别搞错

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

优先级说明 ​

如果环境变量和配置文件同时存在，可能出现"改了配置文件却不生效"的情况。 排查时建议先清掉环境变量，只保留一处配置：

bash
# Linux/macOS 临时清除，验证配置文件是否生效
unset ANTHROPIC_BASE_URL ANTHROPIC_API_KEY
powershell
# Windows 临时清除当前会话
Remove-Item Env:\ANTHROPIC_BASE_URL -ErrorAction SilentlyContinue
Remove-Item Env:\ANTHROPIC_API_KEY -ErrorAction SilentlyContinue

下一步 ​

提示

如果你经常需要切换 API 服务商，建议用配置文件方式或切换脚本，比每次手改更省事。

官方 QQ 群 634534003 · 客服 QQ 179710692

Copyright © 2026 TinyPx API