使用文档

FreeCoding 提供 Claude、GPT 系列模型的 API 接入。把你现有工具里的 Base URL 和 API Key 换成本站的，其余用法完全不变。

快速开始

注册账号
用邮箱注册，收验证码完成验证。
选择套餐分组
在控制台选一个分组（见下方「套餐与价格」）。不同分组对应不同的模型范围和单价。
创建 API Key
控制台 → API 密钥 → 新建，复制以 sk- 开头的密钥。密钥只显示一次，请立即保存。
配置客户端
按下面对应章节配置 Claude Code / Codex，或直接调用 API。

Base URL　https://freecoding.shop
部分工具要求填写带 /v1 的地址，届时填 https://freecoding.shop/v1。

套餐与价格

价格为官方原价的倍率。例如倍率 0.13 表示官方 $1 的用量在本站只花 $0.13。按 token 实际消耗计费，无套餐门槛、无最低消费。

分组	倍率	适用
GPT 特惠引流	0.13	官方1.3折，入门引流，经济实惠
GPT Plus+Pro混池主力	0.20	Plus/Pro 多账号混池，高可用主力档，含 codex 系列
GPT 高稳定Pro 旗舰	0.35	满血高并发，多线路兜底，最高可用性
Claude Air 特惠	0.10	Claude 全系模型，性价比最高
Claude Pro 高并发	0.30	高并发场景，重度使用
Claude Max 满血	2.00	满血号池，建议配合 Claude Code
Vision 图像生成	2.00	gpt-image-2 图像生成

每个分组内部配置了多条上游线路，优先走最优线路，失败自动切换到备用线路，对你透明无感。

Claude Code 接入

推荐使用 Claude Air 或 Claude Pro 分组。

方式一：环境变量（临时）

# macOS / Linux
export ANTHROPIC_BASE_URL="https://freecoding.shop"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://freecoding.shop"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

方式二：写进配置文件（永久）

编辑 ~/.claude/settings.json（Windows 在 C:\Users\你的用户名\.claude\settings.json）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://freecoding.shop",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}

如果文件里已有其它配置，只需在 env 中加上这两行，不要覆盖整个文件。改完重开终端生效。

Codex CLI 接入

推荐使用 GPT Plus+Pro混池或 GPT 高稳定Pro 分组。编辑 ~/.codex/config.toml：

model = "gpt-5.4"
model_provider = "freecoding"

[model_providers.freecoding]
name = "FreeCoding"
base_url = "https://freecoding.shop/v1"
wire_api = "responses"
env_key = "FREECODING_API_KEY"
requires_openai_auth = false

Codex 不把密钥写在配置文件里，而是读环境变量：

# Windows（需重开终端）
setx FREECODING_API_KEY "sk-你的密钥"

# macOS / Linux
export FREECODING_API_KEY="sk-你的密钥"

注意　base_url 必须带 /v1，末尾不要加斜杠。Codex 会自动在后面拼 /responses。

CC Switch 接入

如果你用 CC Switch 管理多个供应商，新增一个供应商，按下表填写：

字段	填写
名称	FreeCoding
接口地址（Claude Code）	`https://freecoding.shop`
接口地址（Codex）	`https://freecoding.shop/v1`
API Key	`sk-你的密钥`

Anthropic 协议

curl https://freecoding.shop/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

OpenAI 协议

curl https://freecoding.shop/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python（openai SDK）：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://freecoding.shop/v1",
)
resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Responses 协议

新版 OpenAI SDK 与 Codex 使用的协议：

curl https://freecoding.shop/v1/responses \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "你好",
    "stream": true
  }'

其它可用接口：/v1/embeddings、/v1/images/generations、/v1/images/edits、/v1/messages/count_tokens。

计费说明

按 token 实际消耗计费，用量以上游返回的统计为准，不做估算。
输入、输出、缓存读取、缓存写入各有单价，分别计算后合计。
预付费，余额实时扣减。余额不足时新请求会被拒绝，正在进行的请求不受影响。

关于缓存费用　多数模型的缓存写入单价约为输入价的 1.25 倍。新开一个会话时会写入大量缓存，这一发往往是整个会话里最贵的；后续请求复用缓存（缓存读取只有输入价的 0.1 倍）才划算。这是模型本身的计费机制，不是异常扣费。

关于流式中断　流式请求中途断开时，已经产生的 token 仍会计费，因为上游已经实际生成了这些内容。

常见问题

提示 401 / 无效的 API Key

检查密钥是否复制完整（含 sk- 前缀、无多余空格），以及请求头是否用对：Anthropic 协议用 x-api-key，OpenAI / Responses 协议用 Authorization: Bearer。

提示模型不存在 / 无权访问

该模型不在你当前分组的范围内。到控制台确认分组包含哪些模型，或切换到覆盖更全的分组。

Codex 报 404

九成是 base_url 少写了 /v1，或者末尾多了斜杠。正确写法是 https://freecoding.shop/v1。

改完配置没生效

环境变量只对新开的终端生效，老窗口读不到。改完请关掉终端重开。

速度慢或偶尔失败

每个分组都配置了多条线路并会自动切换。若持续异常，可尝试切换到兜底层数更多的分组（如 GPT 高稳定Pro）。

怎么查用量

控制台可查看余额、每日消费、按模型统计和逐笔调用明细。

其它问题请联系 freecoding_admin@126.com