<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[ZeroShell]]></title><description><![CDATA[ZeroShell]]></description><link>https://zeroshell.hashnode.dev</link><generator>RSS for Node</generator><lastBuildDate>Thu, 12 Nov 2026 09:15:56 GMT</lastBuildDate><atom:link href="https://zeroshell.hashnode.dev/rss.xml" rel="self" type="application/rss+xml"/><language><![CDATA[en]]></language><ttl>60</ttl><item><title><![CDATA[《怎么判断一个 API 中转站靠不靠谱：四个维度，和一个真实样本》]]></title><description><![CDATA[先说利益相关：下面提到的 ZeroShell 是我自己运营的站，所以这篇重点先讲怎么判断一个中转站靠不靠谱，结论你自己下。 判断中转站，我看四点： 第一，模型目录是不是按分组算的。 很多站宣传「几十个模型」，但那是全站聚合数字，单个 Key 能调的只是它所在分组的目录。建错分组，用 Claude 时直接报…]]></description><link>https://zeroshell.hashnode.dev/api</link><guid isPermaLink="true">https://zeroshell.hashnode.dev/api</guid><dc:creator><![CDATA[ZeroShell]]></dc:creator><pubDate>Wed, 04 Nov 2026 23:38:51 GMT</pubDate><content:encoded><![CDATA[<p>先说利益相关：下面提到的 ZeroShell 是我自己运营的站，所以这篇重点先讲怎么判断一个中转站靠不靠谱，结论你自己下。</p>
<p>判断中转站，我看四点：</p>
<p><strong>第一，模型目录是不是按分组算的。</strong> 很多站宣传「几十个模型」，但那是全站聚合数字，单个 Key 能调的只是它所在分组的目录。建错分组，用 Claude 时直接报 model_not_found，新手最容易栽在这。</p>
<p><strong>第二，价格是否公开明码。</strong> 敢把每个模型每百万 token 的输入/输出价挂在公开页、不用登录就能看的，至少计费口径可核对；只写「低至几折」的要小心。</p>
<p><strong>第三，有没有基本的防滥用。</strong> 注册要邮箱验证、有一定的风控，说明站方在控成本，这种站反而活得久；什么门槛都没有、撒钱无上限的，多半跑得快。</p>
<p><strong>第四，支付和起充门槛。</strong> 起充越低试错成本越低，先小额验通自己的工作流，再谈充多少。</p>
<p>拿 ZeroShell 当对照样本：接口是 OpenAI 兼容的 <code>https://zeroshell.top/v1</code>，同时有 Anthropic 原生 <code>/v1/messages</code>，所以 Claude Code 用官方分组的 Key 配 <code>ANTHROPIC_BASE_URL=https://zeroshell.top</code> 就能跑（这步实测通过）。分组情况如实说：低价组 27 个模型（DeepSeek、GLM、GPT、Grok、Kimi、Qwen，没有 Claude），官方组 22 个含 Claude 全系，46 是全站聚合数。价格举例：gpt-5.6-luna 输入 ¥0.075/百万，gpt-5.6-sol ¥0.375/¥2.25，claude-sonnet-4-6 ¥2.025/¥10.125，gemini-3.1-pro-preview ¥0.75/¥4.5，全在公开价格页。注册约 1 分钟、要邮箱验证，新号送 ¥1，邀请双方各 ¥1。</p>
<p>短板也明说：目前只能支付宝充值（$1 起，¥1=$1 额度），站子新、规模小，我不承诺什么可用性指标。建议就用送的 ¥1 把你自己的流程验一遍，通了再决定。问题反馈：<a href="mailto:support@zeroshell.top">support@zeroshell.top</a>。</p>
]]></content:encoded></item><item><title><![CDATA[Run Claude Code on a Relay Endpoint: Setup, the Model-Catalog Pitfall, and What It Actually Costs]]></title><description><![CDATA[Most AI coding tools speak one of two dialects: the OpenAI chat-completions format, or Anthropic's Messages format. If you want to run those tools against…]]></description><link>https://zeroshell.hashnode.dev/run-claude-code-on-a-relay-endpoint-setup-the-model-catalog-pitfall-and-what-it-actually-costs</link><guid isPermaLink="true">https://zeroshell.hashnode.dev/run-claude-code-on-a-relay-endpoint-setup-the-model-catalog-pitfall-and-what-it-actually-costs</guid><category><![CDATA[ClaudeCode]]></category><category><![CDATA[AI]]></category><category><![CDATA[api]]></category><category><![CDATA[Tutorial]]></category><dc:creator><![CDATA[ZeroShell]]></dc:creator><pubDate>Wed, 04 Nov 2026 15:56:09 GMT</pubDate><content:encoded><![CDATA[<p>Most AI coding tools speak one of two dialects: the OpenAI chat-completions format, or Anthropic's Messages format. If you want to run those tools against a third-party relay endpoint instead of a first-party account — for cost reasons, payment reasons, or because one key should cover several model families — the setup is short. The part that wastes people's time is a catalog mismatch that produces a confusing <code>model_not_found</code> error. This guide covers the configuration, that pitfall, and a cost breakdown with real listed prices, using one relay (ZeroShell, which I operate — disclosure at the end) as the worked example. The steps generalize to any OpenAI-compatible relay.</p>
<h2>The two endpoints you need to know</h2>
<p>A relay typically exposes:</p>
<ul>
<li><code>POST /v1/chat/completions</code> — the OpenAI-compatible endpoint. Base URL form: <code>https://zeroshell.top/v1</code>.</li>
<li><code>POST /v1/messages</code> — the Anthropic-native endpoint. This is the one Claude Code actually requires.</li>
</ul>
<p>That second endpoint is the real compatibility test. Plenty of relays advertise "Claude support" but only translate OpenAI-format requests; Claude Code sends Anthropic-format requests and fails against those. Before paying anything, verify the relay documents and serves <code>/v1/messages</code>. On ZeroShell both formats are served, and both have been exercised with live requests — Claude models respond over the OpenAI format and over <code>/v1/messages</code>.</p>
<h2>Claude Code configuration</h2>
<p>Claude Code reads its endpoint from environment variables:</p>
<pre><code class="language-bash">export ANTHROPIC_BASE_URL=https://zeroshell.top
export ANTHROPIC_API_KEY=&lt;your key&gt;
claude
</code></pre>
<p>Note the base URL has no <code>/v1</code> suffix here — Claude Code appends <code>/v1/messages</code> itself. Model names come from the relay's own catalog, for example <code>claude-sonnet-4-5</code>, so copy them from the relay's model list rather than typing from memory; a wrong suffix is the most common self-inflicted error.</p>
<h2>The pitfall: one account, several catalogs</h2>
<p>Here is the part most relay documentation glosses over. On ZeroShell, an API key belongs to a <strong>group</strong>, and each group has its own model catalog:</p>
<ul>
<li>A <strong>low-cost group</strong> key sees 27 models: DeepSeek, GLM, GPT, Grok, Kimi, and Qwen families. No Claude models at all.</li>
<li>An <strong>official group</strong> key sees 22 models, including the full Claude lineup.</li>
</ul>
<p>The site advertises 46 models — that figure is the aggregate across all groups, not what any single key can call. If you create a low-cost key and point Claude Code at it, every request returns <code>model_not_found</code>, and the error message blames the model rather than your key's group. The fix takes thirty seconds (create a key in the correct group), but only once you know groups exist. One account can hold keys in several groups, and the balance is shared, so the practical setup is: an official-group key for Claude Code, a low-cost key for bulk OpenAI-format work.</p>
<p>When evaluating any relay, ask this question first: <em>is the advertised model count per-key or per-account?</em> The answer determines whether your first integration attempt works.</p>
<h2>Other OpenAI-compatible tools</h2>
<p>For tools like Continue, Aider (in OpenAI mode), or chat clients such as Cherry Studio and NextChat, configuration is the standard trio:</p>
<ul>
<li>Base URL: <code>https://zeroshell.top/v1</code></li>
<li>API key: a key from the group that contains your model</li>
<li>Model: the exact catalog name, copied, not recalled</li>
</ul>
<p>A 30-second smoke test before wiring up any tool:</p>
<pre><code class="language-bash">curl https://zeroshell.top/v1/chat/completions \
  -H "Authorization: Bearer &lt;your key&gt;" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5-mini","messages":[{"role":"user","content":"ping"}]}'
</code></pre>
<p>If this returns a completion, every OpenAI-compatible client will work. If it returns a model error, suspect the group/catalog mismatch above before suspecting the endpoint.</p>
<h2>What it costs</h2>
<p>Relay pricing is per million tokens, published on the pricing page. Current listed prices:</p>
<table>
<thead>
<tr>
<th>Model</th>
<th>Input / 1M</th>
<th>Output / 1M</th>
</tr>
</thead>
<tbody><tr>
<td>gpt-5-nano</td>
<td>$0.03</td>
<td>$0.24</td>
</tr>
<tr>
<td>gpt-5-mini</td>
<td>$0.25</td>
<td>$2.00</td>
</tr>
<tr>
<td>gemini-2.5-pro</td>
<td>$1.25</td>
<td>$10.00</td>
</tr>
<tr>
<td>claude-sonnet-4-5</td>
<td>$3.00</td>
<td>$15.00</td>
</tr>
</tbody></table>
<p>Worked example: a heavy personal month of 20M input and 5M output tokens costs $19.25 on gpt-5-mini, $85 on gemini-2.5-pro, and $135 on claude-sonnet-4-5. That spread is exactly why the group system exists — route summarization and boilerplate to the cheap catalog, and reserve the Claude catalog for work where its output quality earns the difference.</p>
<h2>Getting started and honest limits</h2>
<p>Signup is a username, a password, and an email verification code — about a minute — and new accounts receive ¥1 of credit, which is enough to run every step in this guide. Top-ups are Alipay only, starting at $1, with ¥1 = $1 of quota; invites give ¥1 to both sides. Two limits worth stating plainly: there is no card or PayPal payment yet, so this suits users who can pay with Alipay; and it is a small, new service, so treat the free credit as a way to verify your own workflow before committing real volume. Questions and failure reports go to <a href="mailto:yangda611@gmail.com">yangda611@gmail.com</a>.</p>
<p><em>Disclosure: I operate ZeroShell. Every price and behavior above is from the public pricing page and documented, tested endpoint behavior as of November 2026; check the pricing page for current figures.</em></p>
]]></content:encoded></item></channel></rss>