GPTX.CC 使用教程

快速开始：3 步拿到 API Key

1. 注册登录：打开 https://api.gptx.cc，用邮箱注册，收验证码完成登录。
2. 充值：进「充值」页面充点余额。按量计费，用多少扣多少，充多少随你。
3. 创建 Key（选对分组）：进「API 密钥」页面点新建，按你要用的模型选分组：要用 Claude 选 Anthropic 组，要用 GPT 选 OpenAI 组，画图选 GPT 生图 组。两类都要用就各建一个 Key。复制出来的 sk-xxxxxxxx 就是你的 Key。

支持的模型

常用的就下面这些，控制台里能看到完整清单。同一个 Key 全都能调，不用分开申请。

两个地址，别填错（最容易踩的坑）

GPTX 同时兼容 Anthropic 和 OpenAI 两套协议，客户端类型不同，填的地址也不同：

环境准备（用 CLI/桌面端才需要）

Claude Code、Codex 这些命令行工具依赖 Node.js，建议先装 Node.js 22+。纯 GUI 客户端（ChatBox、Cherry Studio）跳过这步。

macOS / Linux / WSL2

curl -fsSL https://fnm.vercel.app/install | bash
fnm install 22
fnm use 22
node -v   # 看到 v22.x.x 就对了

Windows

去 Node.js 官网下 LTS 22.x 一路下一步；装完开 PowerShell 输 node -v 验证。强烈建议装 WSL2（PowerShell 里跑 wsl --install，重启后在 Ubuntu 里操作，体验接近 Mac）。

方案一：Claude Code 终端（开发者首选）

Anthropic 官方的命令行编程助手，在项目目录里直接用。核心就一件事：把它的请求地址改到 GPTX。

1. 安装

# macOS / Linux / WSL2
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell（需先装 Git for Windows）
irm https://claude.ai/install.ps1 | iex

claude --version

2. 配置（二选一）

方法 A · 环境变量（写进 ~/.zshrc 或 ~/.bashrc）：

export ANTHROPIC_BASE_URL="https://api.gptx.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
source ~/.zshrc   # 或 source ~/.bashrc

Windows PowerShell：

setx ANTHROPIC_BASE_URL "https://api.gptx.cc"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"
# 设完关掉当前窗口，重开一个新终端才生效

方法 B · 配置文件（编辑 ~/.claude/settings.json）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.gptx.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

3. 验证

cd 任意一个项目目录
claude
/model claude-sonnet-4-6

进去随便问一句「你好，你是什么模型」，能正常回就通了。

方案二：Claude Code 桌面端（图形界面）

不想碰命令行的，用桌面端 + CC Switch 一键切换。

1. 先按上面装好 Node.js 22+，再下载安装 Claude Code 桌面端。
2. 下载安装 CC Switch（选和你系统对应的版本）。
3. 打开 CC Switch，选 Claude 桌面端入口，点加号新增配置。
4. API Key 填你的 sk-xxx，URL 填 https://api.gptx.cc，官网链接可以不填。
5. 模型映射不要打开，点「获取模型列表」，看到绿色成功提示后保存。
6. 点左上角「打开本地路由」，重启桌面端，选模型即可用。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.gptx.cc",
    "ANTHROPIC_API_KEY": "sk-你的Key",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
    "API_TIMEOUT_MS": "1200000"
  }
}

方案三：Codex（跑 GPT-5.5）

Codex CLI 走 OpenAI 的 Responses 协议，GPTX 原生支持，能跑 gpt-5.5。

npm i -g @openai/codex

配置目录：Mac/Linux 是 ~/.codex，Windows 是 %USERPROFILE%\.codex。没有 config.toml / auth.json 就手动建。

编辑 ~/.codex/config.toml

model_provider = "gptx"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.gptx]
name = "GPTX"
base_url = "https://api.gptx.cc"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

编辑 ~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-你的Key"
}

桌面端重启后自动读新配置；CLI 进项目目录直接跑 codex。

方案四：Cursor

Cursor 里用 GPTX 走 OpenAI 兼容通道即可。

1. 打开 Cursor 设置 → Models。
2. 找到 OpenAI API Key，展开 Override OpenAI Base URL，填 https://api.gptx.cc/v1。
3. API Key 填你的 sk-xxx，点 Verify 验证。
4. 在模型列表里添加自定义模型，填 gpt-5.6-sol 或 claude-sonnet-4-6，勾上启用。

方案五：VS Code 插件（Cline）

VS Code 里用 Cline 插件最省事，走 OpenAI 兼容通道。

1. 在扩展面板搜 Cline（或 Cline 中文版）安装。
2. 点 Cline 右上角齿轮进设置。
3. API Provider 选 OpenAI Compatible。
4. Base URL 填 https://api.gptx.cc/v1。
5. API Key 填你的 sk-xxx。
6. 模型名填 claude-sonnet-4-6 / claude-opus-4-8 / gpt-5.6-sol，按需换。
7. 保存，重开 Cline 会话即可用。

如果你装的是 Anthropic 官方 Claude Code for VS Code 插件，则在 VS Code 的 settings.json 里写环境变量：

{
  "claude-code.env": {
    "ANTHROPIC_BASE_URL": "https://api.gptx.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

方案六：ChatBox / Cherry Studio（图形客户端）

只想聊天、不写代码的，用 ChatBox 或 Cherry Studio 这类 GUI 客户端最方便。两者配法一样，都走 OpenAI 兼容。

1. 打开设置，模型服务商选 OpenAI（或「OpenAI API 兼容」/ Custom）。
2. API 域名 / Base URL 填 https://api.gptx.cc/v1。
3. API 密钥填你的 sk-xxx。
4. 模型填 gpt-5.6-sol 或 claude-sonnet-4-6（Cherry Studio 可点「获取模型」拉全列表）。
5. 保存，回到对话选好模型就能聊。

方案七：OpenClaw / OpenCode

OpenClaw

安装后跑配置向导：AI 提供商选 Anthropic，API Key 填你的 Key，Base URL 填 https://api.gptx.cc，模型选 claude-opus-4-8。也可手动编辑 ~/.openclaw/openclaw.json：

{
  "providers": {
    "gptx": {
      "baseUrl": "https://api.gptx.cc",
      "auth": "api-key",
      "apiKey": "sk-你的Key",
      "api": "anthropic-messages",
      "models": [
        { "id": "claude-opus-4-8", "name": "claude-opus-4-8",
          "contextWindow": 1000000, "maxTokens": 65536 }
      ]
    }
  },
  "agents": { "defaults": { "model": "gptx/claude-opus-4-8" } }
}

OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.gptx.cc",
        "apiKey": "sk-你的Key"
      }
    }
  },
  "model": "anthropic/claude-opus-4-8",
  "small_model": "anthropic/claude-haiku-4-5-20251001"
}

直接调 API（写程序用）

要在自己的代码里调用，GPTX 两套协议都支持，用哪套看你顺手。

OpenAI 协议 · curl

curl https://api.gptx.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "你好"}]
  }'

OpenAI 协议 · Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Key",
    base_url="https://api.gptx.cc/v1",
)
resp = client.chat.completions.create(
    model="gpt-5.6-sol",          # 也可填 claude-sonnet-4-6
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

OpenAI 协议 · Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的Key",
  baseURL: "https://api.gptx.cc/v1",
});
const r = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);

Anthropic 原生协议 · curl

要用 Claude 原生特性（如 /v1/messages），地址用不带 /v1 的根：

curl https://api.gptx.cc/v1/messages \
  -H "x-api-key: sk-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

画图（文生图）

curl https://api.gptx.cc/v1/images/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴墨镜的柴犬，扁平插画风",
    "size": "1024x1024"
  }'

返回里带图片数据，取出来保存即可。尺寸支持 1024/2048/4096 等常见规格。

计费说明

• 按量计费：按 Token 实际用量扣费，用多少扣多少，不用不扣。
• 余额查询：控制台随时看余额和用量明细，具体价格以控制台为准。
• 余额预警：余额快用完时会邮件提醒你，别担心跑一半断供。

常见问题

Q：地址到底带不带 /v1？

Claude Code、Codex、OpenClaw、OpenCode 这类「原生」客户端填 https://api.gptx.cc（不带 /v1）；ChatBox、Cline、Cherry Studio、Cursor 这类「OpenAI 兼容」客户端填 https://api.gptx.cc/v1（带 /v1）。这是最常见的错。

Q：报 401 / 无效密钥？

Key 复制错了、带了多余空格、或者填错了字段。重新去控制台复制一遍；注意有的客户端要填 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY，两个都试下。

Q：报 403 / 余额不足？

余额没了，去充值页充一下即可，秒到账。

Q：请求一直无响应 / 转圈？

先确认地址填对（见上）；Claude Code 桌面端参考「方案二」的 settings.json 补上 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 和 API_TIMEOUT_MS；命令行工具重开一个新终端让环境变量生效。

Q：选哪个模型好？

写代码优先 claude-sonnet-4-6（性价比高）或 claude-opus-4-8（最强）；跑 Codex 用 gpt-5.5；批量简单任务用 claude-haiku-4-5-20251001 省钱。

Q：模型列表拉不出来 / 提示获取失败？

多为地址或 Key 没填对，或客户端开了「模型映射」。CC Switch 里记得关掉模型映射再点获取列表。

Q：还是搞不定？

加客服微信 mulan_2024，把你用的客户端和报错截图发过来，帮你看。