CalcShack · Agent 接入文档
统一入口 https://api.calcshack.com · Base URL https://api.calcshack.com/v1 · 全面兼容 OpenAI / Anthropic 协议
快速开始 · 密钥检测
你的 API Key(
sk- 开头,登录后在「令牌 → 新建令牌」创建,选择对应分组)
填入后,下方所有脚本会自动带上你的密钥,点「复制」即可直接使用。密钥只保存在你浏览器的 localStorage 里,本页面不会上传它。
我的可用模型(自动检测)
(填入密钥后点上方「一键检测」按钮,这里会列出你的密钥可用的全部模型,可整段复制粘贴到 Cursor / Cherry Studio / Cline 的模型列表里)
通用参数(任何 OpenAI 兼容客户端都认)
| 参数 | 值 |
|---|---|
| Base URL | https://api.calcshack.com/v1 |
| API Key | 你的 sk- 密钥 |
| 模型 | 见 模型广场(如 gpt-6.1-sol、claude-sonnet-5-5、deepseek-v4-flash、kimi-k2.7-code、glm-5.2) |
Claude Code · 一键部署
macOS / Linux
grep -q ANTHROPIC_AUTH_TOKEN ~/.bashrc 2>/dev/null || cat >> ~/.bashrc <<'EOF' export ANTHROPIC_BASE_URL="https://api.calcshack.com" export ANTHROPIC_AUTH_TOKEN="__KEY__" export ANTHROPIC_MODEL="__CMODEL__" EOF export ANTHROPIC_BASE_URL="https://api.calcshack.com" export ANTHROPIC_AUTH_TOKEN="__KEY__" export ANTHROPIC_MODEL="__CMODEL__" command -v claude >/dev/null || npm install -g @anthropic-ai/claude-code claude
自动完成:写入 ~/.bashrc 永久生效 → 未安装则自动 npm 安装 → 直接启动。zsh 用户把脚本里的 ~/.bashrc 换成 ~/.zshrc。需已装 Node.js。
Windows PowerShell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.calcshack.com","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","__KEY__","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","__CMODEL__","User")
$env:ANTHROPIC_BASE_URL="https://api.calcshack.com"
$env:ANTHROPIC_AUTH_TOKEN="__KEY__"
$env:ANTHROPIC_MODEL="__CMODEL__"
if (-not (Get-Command claude -ErrorAction SilentlyContinue)) { npm install -g @anthropic-ai/claude-code }
claude
整段粘进 PowerShell 回车即完成部署并启动;环境变量永久写入,新终端也生效。需已装 Node.js。注意:Claude Desktop 桌面 App 不支持自定义接口,请用本节的 Claude Code 或 Cherry Studio。
Codex CLI · 一键部署
macOS / Linux
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF' model = "__GMODEL__" model_provider = "calcshack" [model_providers.calcshack] name = "CalcShack" base_url = "https://api.calcshack.com/v1" env_key = "CALCSHACK_API_KEY" wire_api = "chat" EOF grep -q CALCSHACK_API_KEY ~/.bashrc 2>/dev/null || echo "export CALCSHACK_API_KEY=\"__KEY__\"" >> ~/.bashrc export CALCSHACK_API_KEY="__KEY__" command -v codex >/dev/null || npm install -g @openai/codex codex
自动完成:写 config.toml → 密钥永久写入 ~/.bashrc → 未安装则自动 npm 安装 → 直接启动。
Windows PowerShell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex" | Out-Null
@'
model = "__GMODEL__"
model_provider = "calcshack"
[model_providers.calcshack]
name = "CalcShack"
base_url = "https://api.calcshack.com/v1"
env_key = "CALCSHACK_API_KEY"
wire_api = "chat"
'@ | Set-Content -Encoding UTF8 "$env:USERPROFILE\.codex\config.toml"
[Environment]::SetEnvironmentVariable("CALCSHACK_API_KEY","__KEY__","User")
$env:CALCSHACK_API_KEY="__KEY__"
if (-not (Get-Command codex -ErrorAction SilentlyContinue)) { npm install -g @openai/codex }
codex
整段粘进 PowerShell 回车即完成部署并启动,无需手动改任何文件。需已装 Node.js。
DeepSeek Harness(dsh)
安装并启动
npm install -g @deepseek-ai/dsh dsh web
也可不安装直接运行:
npx @deepseek-ai/dsh。启动后浏览器打开 http://localhost:3080 进入 Web UI。首次引导若要求填 DeepSeek 官方密钥,选择「稍后配置」,改用下方自定义提供商接入 CalcShack。添加 CalcShack 提供商
1. Web UI 打开 Settings → Models → Add Model Provider,选择「第三方 / 自定义提供商」。
2. 按下表填写并保存,立即生效、无需重启。
3. 新会话中选择 CalcShack 的模型即可使用。
2. 按下表填写并保存,立即生效、无需重启。
3. 新会话中选择 CalcShack 的模型即可使用。
| 配置项 | 填写内容 |
|---|---|
| Provider ID | calcshack |
| 显示名 | CalcShack |
| Base URL | https://api.calcshack.com/v1 |
| API 协议 | openai-completions(OpenAI 兼容) |
| API Key | 你的 sk- 密钥 |
| Model ID | 如 gpt-6.1-sol,或 deepseek 系模型(见上方检测列表) |
· 配置写入
· 报错 402 一般是余额不足,去充值即可。
· 官方仓库:deepseek-ai/deepseek-harness
~/.dsh/settings.yaml,密钥以明文存于 ~/.dsh/.credentials.yaml,切勿提交到代码仓库。· 报错 402 一般是余额不足,去充值即可。
· 官方仓库:deepseek-ai/deepseek-harness
Cursor
| 设置项 | 值 |
|---|---|
| 入口 | Settings → Models → OpenAI API Key → Override |
| API Key | 你的 sk- 密钥 |
| Base URL | https://api.calcshack.com/v1 |
| 模型 | 点 + Add Model 手动添加模型名(可从上方检测列表复制) |
Cline / Roo Code(VSCode 插件)
| 设置项 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.calcshack.com/v1 |
| API Key | 你的 sk- 密钥 |
| Model ID | 如 claude-sonnet-5-5、gpt-6.1-sol、kimi-k2.7-code |
Cherry Studio
| 设置项 | 值 |
|---|---|
| 入口 | 设置 → 模型服务 → 添加服务商 → OpenAI |
| API 地址 | https://api.calcshack.com/v1 |
| API 密钥 | 你的 sk- 密钥 |
| 模型 | 添加模型时手填模型 ID(可从上方检测列表复制) |
NextChat(ChatGPT Next Web)
接入步骤
1. 登录 CalcShack,在「令牌」里创建专用 API 密钥,确认密钥所属分组。
2. 在「模型广场」选择该分组可用的模型,复制完整模型 ID(也可直接用「⚡ 一键检测」自动列出你的全部可用模型)。
3. 打开 NextChat 设置 → 启用自定义接口,模型服务商选择 OpenAI,按下表填写。
2. 在「模型广场」选择该分组可用的模型,复制完整模型 ID(也可直接用「⚡ 一键检测」自动列出你的全部可用模型)。
3. 打开 NextChat 设置 → 启用自定义接口,模型服务商选择 OpenAI,按下表填写。
| 配置项 | 填写内容 |
|---|---|
| 接口地址 | https://api.calcshack.com(根地址,不带 /v1) |
| API Key | 你的 sk- 密钥 |
| 自定义模型名 | 如 gpt-6.1-sol,多个模型用英文逗号分隔 |
保存并启用后,在模型下拉框选中刚添加的模型即可开聊。官方仓库:ChatGPTNextWeb/NextChat
自部署实例(服务端环境变量)
BASE_URL=https://api.calcshack.com OPENAI_API_KEY=__KEY__ CUSTOM_MODELS=+__GMODEL__
更新环境后按自己的部署方式重启实例。务必为自部署实例配置访问控制,不要把带服务端密钥的实例开放给未知用户;也不要把自己的密钥填进不可信的公共 NextChat 站点。
验证与排错
· 先发一句简短文字,收到回复后到本站「日志」页核对请求模型与消耗(连接检测也可能产生计费请求)。
· NextChat 会自动追加 /v1/chat/completions;若报错路径出现重复 /v1/v1,把接口地址改回根地址。
· 401:核对密钥是否带空格、域名是否正确。404:核对完整请求路径和模型 ID。
· 模型列表为空:检查密钥分组、模型限制与有效期;NextChat 不支持自动拉取,需手动填写准确模型 ID。
· 文字对话通过后,再按需测试图片输入、流式输出和工具调用。
· NextChat 会自动追加 /v1/chat/completions;若报错路径出现重复 /v1/v1,把接口地址改回根地址。
· 401:核对密钥是否带空格、域名是否正确。404:核对完整请求路径和模型 ID。
· 模型列表为空:检查密钥分组、模型限制与有效期;NextChat 不支持自动拉取,需手动填写准确模型 ID。
· 文字对话通过后,再按需测试图片输入、流式输出和工具调用。
Chatbox(桌面 / 手机)
接入步骤
1. 打开 设置 → 模型提供方 → 添加,名称填 CalcShack。
2. 选择「OpenAI API 兼容」模式,填写 API 主机和密钥。
3. 点「获取模型列表」并启用所需模型;不能自动获取就手动输入准确模型 ID。
4. 保存后在对话中选择新提供方。手机端在同样的模型提供方设置里配置。
2. 选择「OpenAI API 兼容」模式,填写 API 主机和密钥。
3. 点「获取模型列表」并启用所需模型;不能自动获取就手动输入准确模型 ID。
4. 保存后在对话中选择新提供方。手机端在同样的模型提供方设置里配置。
| 配置项 | 填写内容 |
|---|---|
| 名称 | CalcShack |
| API 模式 | OpenAI API 兼容 |
| API 主机 | https://api.calcshack.com/v1 |
| API 密钥 | 你的 sk- 密钥 |
· 若版本提供 OpenAI Responses 兼容模式:主机仍填
· Anthropic Claude 兼容模式:最终请求须落到
· 官方指南:Chatbox BYOK
https://api.calcshack.com/v1,且模型须支持 Responses。· Anthropic Claude 兼容模式:最终请求须落到
https://api.calcshack.com/v1/messages;字段示例以 /v1 结尾就填 https://api.calcshack.com/v1,客户端会自动追加 /v1/messages 就填根地址。不同模式不要混用地址。· 官方指南:Chatbox BYOK
LobeChat(LobeHub)
接入步骤
1. 进入 设置 → AI 服务商,选择 OpenAI 或添加 OpenAI 兼容服务商。
2. 将「API 代理地址 / Base URL」改为 CalcShack 地址,填入密钥。
3. 获取模型列表或手动添加准确模型 ID 并开启。
4. 先用 Chat Completions 模式做连通性检查,再在会话中选择此服务商。
2. 将「API 代理地址 / Base URL」改为 CalcShack 地址,填入密钥。
3. 获取模型列表或手动添加准确模型 ID 并开启。
4. 先用 Chat Completions 模式做连通性检查,再在会话中选择此服务商。
| 配置项 | 填写内容 |
|---|---|
| API 代理地址 / Base URL | https://api.calcshack.com/v1 |
| API Key | 你的 sk- 密钥 |
| 模型 ID | 模型广场中的准确 ID |
OpenCat(iOS / macOS)
接入步骤
1. 进入 设置 → 服务商,选择 OpenAI 兼容入口。
2. 填写 Base URL 和 API Key,添加自定义模型 ID。
3. 验证并保存,返回对话选择对应模型。
2. 填写 Base URL 和 API Key,添加自定义模型 ID。
3. 验证并保存,返回对话选择对应模型。
| 配置项 | 填写内容 |
|---|---|
| 基础 URL | https://api.calcshack.com/v1 |
| 密钥 | 你的 sk- 密钥 |
| 自定义模型 | 本站准确模型 ID,多个模型分别添加 |
· OpenCat Cloud 订阅与 CalcShack API 用量是两套服务,确认当前对话用的是你配置的 API 服务商。
· 不同地区发行版入口可能不同。官方帮助:OpenCat FAQ
· 不同地区发行版入口可能不同。官方帮助:OpenCat FAQ
BotGem
接入步骤
1. 打开 Setting → Service Provider,添加 OpenAI 或 OpenAI API Compatible 提供商。
2. 名称设为 CalcShack,填写 API Server 和你的密钥。
3. 刷新模型列表,或手动输入本站准确模型 ID。
4. 运行连接检查并保存,新建对话选择此模型。
2. 名称设为 CalcShack,填写 API Server 和你的密钥。
3. 刷新模型列表,或手动输入本站准确模型 ID。
4. 运行连接检查并保存,新建对话选择此模型。
| 配置项 | 填写内容 |
|---|---|
| Name | CalcShack |
| API Server(自动追加 /v1/chat/completions 的版本) | https://api.calcshack.com |
| Base URL(字段示例已含 /v1 的版本) | https://api.calcshack.com/v1 |
| API Key | 你的 sk- 密钥 |
· 以最终请求为准:应为 /v1/chat/completions,出现 /v1/v1 就去掉地址里多余的一段。
· 官方:BotGem OpenAI 兼容配置
· 官方:BotGem OpenAI 兼容配置
OpenClaw
安装与引导(macOS / Linux / WSL2)
curl -fsSL https://openclaw.ai/install.sh | bash openclaw onboard --install-daemon
安装与引导(Windows PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex openclaw onboard --install-daemon
添加 CalcShack 模型提供商
在引导中进入模型配置,或运行
openclaw configure --section model,选择与令牌分组协议兼容的自定义提供商,按下表填写后保存并重启网关。| 字段 | 填写内容 |
|---|---|
| Provider ID | calcshack |
| OpenAI 兼容 baseUrl | https://api.calcshack.com/v1 |
| Chat Completions API 类型 | openai-completions |
| API Key | 你的 sk- 密钥 |
| Model ID | 当前分组可用的准确模型 ID |
· 选 Anthropic Messages 兼容模式时用根地址
· 模型提供商 Key 与本地 OpenClaw 网关登录令牌是两种凭证,不能互换。
· 网关暴露到本机之外前保持鉴权开启;密钥只存本地配置;升级或改配置后服务异常时运行
https://api.calcshack.com,最终生成 /v1/messages 请求,不要加 /anthropic 前缀。· 模型提供商 Key 与本地 OpenClaw 网关登录令牌是两种凭证,不能互换。
· 网关暴露到本机之外前保持鉴权开启;密钥只存本地配置;升级或改配置后服务异常时运行
openclaw doctor。官方:模型提供商文档验证服务
openclaw gateway restart openclaw gateway status openclaw dashboard
WorkBuddy
接入步骤
1. 进入 设置 → 模型,选择「添加模型」或「自定义 API」。
2. 选择自定义提供商,填写完整接口地址、密钥和模型 ID。
3. 按模型实际能力配置工具调用、图片输入与推理模式,保存。
4. 在聊天模型选择器的自定义模型中选中刚保存的配置。
2. 选择自定义提供商,填写完整接口地址、密钥和模型 ID。
3. 按模型实际能力配置工具调用、图片输入与推理模式,保存。
4. 在聊天模型选择器的自定义模型中选中刚保存的配置。
| 配置项 | 填写内容 |
|---|---|
| 提供商 | 自定义 / Custom |
| 完整接口地址 | https://api.calcshack.com/v1/chat/completions |
| API KEY | 你的 sk- 密钥 |
| 模型名称 | 当前分组可用的模型 ID |
· 工作流需要工具调用时,除勾选能力外还要确认模型与线路实际支持。
· 若版本把字段改成 Base URL,按示例填
· 官方:WorkBuddy 模型配置
· 若版本把字段改成 Base URL,按示例填
https://api.calcshack.com/v1 并核对最终请求路径。· 官方:WorkBuddy 模型配置
Claude Cowork(第三方推理)
先确认版本与账号
Claude Cowork 与 Claude Code 的配置入口不同,不能只设置 ANTHROPIC_BASE_URL 就认定桌面端已接入;第三方推理功能取决于桌面版本、部署方式和组织策略。以下仅在你的客户端存在 Gateway(Anthropic-compatible)配置入口时适用。
| 配置项 | 填写内容 |
|---|---|
| Gateway base URL | https://api.calcshack.com |
| Gateway API key | 你的 sk- 密钥 |
| Gateway auth scheme | x-api-key |
| 最终 Messages 路径 | https://api.calcshack.com/v1/messages |
| 模型 | 分组内支持 Anthropic Messages 的 Claude 模型(见顶部检测列表) |
· 保存后先做最小测试,并到本站「日志」页确认实际请求;界面显示连接就绪不代表工具、文件处理能力可用。
· 没有 Gateway 入口时:不要把 API Key 填进 MCP Server 地址或 Claude 账号登录字段(那是两回事)。可改用 Cherry Studio、Chatbox 或 Claude Code。
· 官方:Claude 帮助中心
· 没有 Gateway 入口时:不要把 API Key 填进 MCP Server 地址或 Claude 账号登录字段(那是两回事)。可改用 Cherry Studio、Chatbox 或 Claude Code。
· 官方:Claude 帮助中心
命令行 / 代码直调
curl
curl https://api.calcshack.com/v1/chat/completions \
-H "Authorization: Bearer __KEY__" \
-H "Content-Type: application/json" \
-d '{"model":"__GMODEL__","messages":[{"role":"user","content":"你好"}]}'Python(openai SDK)
from openai import OpenAI
client = OpenAI(api_key="__KEY__", base_url="https://api.calcshack.com/v1")
r = client.chat.completions.create(model="__GMODEL__", messages=[{"role":"user","content":"你好"}])
print(r.choices[0].message.content)Node.js(openai SDK)
import OpenAI from "openai";
const client = new OpenAI({ apiKey: "__KEY__", baseURL: "https://api.calcshack.com/v1" });
const r = await client.chat.completions.create({ model: "__GMODEL__", messages: [{ role: "user", content: "你好" }] });
console.log(r.choices[0].message.content);充值与兑换
首页公告栏点金额(¥10–¥500)→ 小豆集市付款(微信/支付宝)→ 秒发 32 位卡密 → 回本站「钱包 → 兑换码」粘贴兑换,余额按人民币 1:1 显示。
常见报错
| 报错 | 处理 |
|---|---|
| 401 / invalid token | 密钥错误或已删除,重新创建令牌;注意复制时别带空格 |
| No available channel for model | 该模型不在你令牌的分组内,创建令牌时选对分组 |
| 404 / 路径出现 /v1/v1 | 客户端自动追加了 /v1,把填写的地址改回根地址或去掉多余的 /v1 |
| does not support parameter presencePenalty / frequencyPenalty | grok 系列不支持这两个参数,请求里删掉即可 |
| insufficient_user_quota / 402 | 余额不足,去充值 |
| model_price_error | 新上架模型未定价,请联系管理员 |
| 超时 / 502 | 稍后重试,渠道会自动切换 |