Claude Code / Codex / Cherry Studio 接入水 API（Shui API）配置教程

水 API（shui.win）是一个 AI API 网关，兼容 Anthropic（/v1/messages）和 OpenAI（/v1/chat/completions、/v1/responses）接口格式。充值按 ¥1 换 $1 额度，GPT 系列按官方价 0.3 倍、Claude 系列按 0.7 倍计费。

下面三步就能把常用的 AI 编程工具切过来。

步骤 1：注册并获取 API Key

1. 打开 shui.win 用邮箱注册（需要邮箱验证）。
2. 登录后在「API 密钥」页面复制注册时自动创建的两个 Key：GPT Key（分组 default_gpt）和 Claude Key（分组 default_claude）。下文分别用 sk-你的GPT-key、sk-你的Claude-key 代替。
3. 接口地址：Claude 用 https://api.shui.win，OpenAI 兼容客户端用 https://api.shui.win/v1。

Claude Code

简单的方式是设置两个环境变量（注意地址不要加 /v1）：

export ANTHROPIC_BASE_URL="https://api.shui.win"
export ANTHROPIC_API_KEY="sk-你的Claude-key"
claude

想长期生效，可以写进 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.shui.win",
    "ANTHROPIC_API_KEY": "sk-你的Claude-key"
  }
}

Codex CLI

编辑 ~/.codex/config.toml：

model_provider = "shui"
model = "gpt-6.1-sol"

[model_providers.shui]
name = "Shui API"
base_url = "https://api.shui.win/v1"
wire_api = "responses"
env_key = "SHUI_GPT_API_KEY"

然后设置环境变量并启动：

export SHUI_GPT_API_KEY="sk-你的GPT-key"
codex

Cherry Studio 和其他 OpenAI 兼容客户端

1. 设置里新增模型服务商，类型选 OpenAI。
2. API 地址填 https://api.shui.win，API 密钥填对应分组的 Key（GPT 模型用 GPT Key）。
3. 点「管理」拉取模型列表，勾选要用的模型即可。

沉浸式翻译、Chatbox、LobeChat 等支持自定义 OpenAI 接口的工具，填法相同。

常见问题

• 报 401 API_KEY_REQUIRED：Key 没带上，检查环境变量名或客户端里的密钥是否填对。
• 支持哪些模型：以控制台和 模型广场 的列表为准。
• 怎么计费：¥1 = $1 额度，GPT 0.3×、Claude 0.7×，按实际用量扣费。各中转站价格对比见 首页对比表。

去 shui.win 注册 →