天机云大模型接入教程:Claude Code、Claude Desktop、DeepSeek / GPT 怎么用(图文)

一个 API Key 调用 Claude、DeepSeek、GPT 等大模型,费用从大模型余额扣除。本文手把手讲清楚:在 Claude Code 命令行、Claude Desktop 桌面版、Cherry Studio 等聊天客户端,以及 Python / Node 代码里怎么接入天机云大模型。

天机云 TIANJI CLOUD · 更新于 · 首发

天机云大模型同时兼容 OpenAI 和 Anthropic 两种接口格式。只要在面板里建一个 API Key,就能在常用的 AI 工具和自己的程序里调用多家大模型,按实际用量从大模型余额扣费;需要先从天机云余额转入,也可开启自动转入。

下面先用三步拿到需要的东西,再按你用的工具看对应章节。

准备:三步拿到 Key、模型和地址

1. 创建 API Key

登录天机面板,左侧菜单点「天机云大模型」,进入「API Key」分页,填个名字点「新建 Key」。完整 Key 只显示这一次,点「复制」保存好,像密码一样保管。

天机面板 API Key 分页:新建 Key 后弹窗显示完整 Key 和复制按钮
新建后完整 Key 只显示一次(图中已打码)。

2. 选模型,复制模型 ID

进入「模型」分页,搜索想用的模型(Claude、DeepSeek、GPT 等),点模型 ID 旁边的「复制」。模型 ID 形如 「deepseek/deepseek-v4-pro」,必须完整复制。每个模型的价格也在这一页。

天机面板模型分页:搜索 deepseek,列表显示模型名称、模型 ID 和复制按钮、上下文长度、输入价和输出价
搜索模型并复制 ID。价格以面板实时显示为准。

3. 记下接口地址

用在哪里填写
Claude Code、Claude Desktop、Anthropic SDKhttps://ai.tianjiyun.org
Cherry Studio、Cursor、Chatbox、OpenAI SDK 等 OpenAI 兼容工具https://ai.tianjiyun.org/v1
API Key第 1 步复制的 tj- 开头那串
模型第 2 步复制的模型 ID

Claude Code(命令行编程助手)

Claude Code 是 Anthropic 官方的命令行编程助手,在终端里让 AI 读代码、改代码、跑命令。

安装

macOS / Linux / WSL:

终端
curl -fsSL https://claude.ai/install.sh | bash

Windows(PowerShell):

PowerShell
irm https://claude.ai/install.ps1 | iex

也可以用 npm 安装(需要 Node.js 22 或更高版本):

终端
npm install -g @anthropic-ai/claude-code@latest

装好后运行 「claude --version」,能看到版本号就行。

写配置文件(推荐,一次配好长期有效)

打开(没有就新建)配置文件:macOS / Linux 是 「~/.claude/settings.json」,Windows 是 「%USERPROFILE%\.claude\settings.json」。写入下面内容,把 「tj-你的Key」 换成你的 Key:

settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.tianjiyun.org",
    "ANTHROPIC_AUTH_TOKEN": "tj-你的Key",
    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-5.5"
  }
}

只想临时试一下,也可以用环境变量(关掉终端就失效):

macOS / Linux 终端
export ANTHROPIC_BASE_URL="https://ai.tianjiyun.org"
export ANTHROPIC_AUTH_TOKEN="tj-你的Key"
export ANTHROPIC_MODEL="anthropic/claude-sonnet-5.5"
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://ai.tianjiyun.org"
$env:ANTHROPIC_AUTH_TOKEN="tj-你的Key"
$env:ANTHROPIC_MODEL="anthropic/claude-sonnet-5.5"
claude

验证

在任意项目目录运行下面命令,能收到回答就说明接通了:

终端
claude -p "用一句话介绍你自己"
终端里运行 claude -p 后正常返回回答
按真实运行结果还原(模型为 DeepSeek)。

如果看到「doesn't recognize the model … assumes a context window of 200k tokens」,这是 Claude Code 对非官方模型 ID 的正常提示,不影响使用。进入交互界面后输入 「/status」,能看到 Anthropic base URL 一行是天机云的地址。

之前登录过 Claude 官方账号、一直弹登录界面:在 Claude Code 里输入 「/logout」 退出原账号再重新打开;仍弹的话先把 Claude Code 升级到最新版。

VS Code 的 Claude Code 插件要在 VS Code 的 settings.json 里另外写一份:

VS Code settings.json
{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://ai.tianjiyun.org"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "tj-你的Key"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "anthropic/claude-sonnet-5.5"
    }
  ],
  "claudeCode.disableLoginPrompt": true
}

Claude Desktop(桌面 App)

Claude Desktop 是 Anthropic 官方的桌面 App(macOS / Windows),较新版本支持接入第三方接口。它不读取 Claude Code 的 settings.json,要在 App 里单独设置,请先更新到最新版本。

设置项填写
Inference providerGateway
Gateway base URLhttps://ai.tianjiyun.org
Gateway API keytj-你的Key
Gateway auth schemeBearer(默认)
Claude Desktop 第三方接口设置示意图:Inference provider 选 Gateway,填写网关地址和 API Key,认证方式 Bearer
示意图:按 Claude 官方文档的设置项绘制,实际界面以你的版本为准。

启用第三方接口后,Claude Desktop 里依赖 Anthropic 官方云端的部分功能(如云端环境、远程控制)会不可用,这是官方限制。

DeepSeek / GPT 等模型:用 Cherry Studio 聊天

想像用网页版 ChatGPT 一样聊天,或者用 DeepSeek、GPT 等模型,推荐用 Cherry Studio(免费开源,Windows / macOS / Linux),到官网下载安装。同样的填法也适用于 Chatbox、Cursor、Cline 等支持「OpenAI 兼容接口」的工具。

设置项填写
提供商名称天机云(随意填)
提供商类型OpenAI
API 密钥tj-你的Key
API 地址https://ai.tianjiyun.org/v1
Cherry Studio 模型服务设置示意图:提供商天机云、类型 OpenAI、填写 API 密钥和 API 地址、添加模型
示意图:实际界面以你安装的版本为准。

提示 404 或连接失败:检查 API 地址结尾是 /v1(不要多写 /chat/completions),提供商类型选 OpenAI,Key 前后不要有空格。

在代码里调用

OpenAI 官方 SDK 和 Anthropic 官方 SDK 都能直接用,只改接口地址和 Key。OpenAI 格式的地址带 /v1,Anthropic SDK 的地址不带 /v1。都支持流式输出。

Python · OpenAI SDK(pip install openai)
from openai import OpenAI

client = OpenAI(base_url="https://ai.tianjiyun.org/v1", api_key="tj-你的Key")
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-pro",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
Python · Anthropic SDK(pip install anthropic)
import anthropic

client = anthropic.Anthropic(base_url="https://ai.tianjiyun.org", api_key="tj-你的Key")
msg = client.messages.create(
    model="anthropic/claude-sonnet-5.5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)
Node.js · OpenAI SDK(npm install openai)
import OpenAI from 'openai';

const client = new OpenAI({ baseURL: 'https://ai.tianjiyun.org/v1', apiKey: 'tj-你的Key' });
const resp = await client.chat.completions.create({
  model: 'openai/gpt-5.2',
  messages: [{ role: 'user', content: '你好' }],
});
console.log(resp.choices[0].message.content);
curl 快速测试
curl https://ai.tianjiyun.org/v1/chat/completions \
  -H "Authorization: Bearer tj-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-v4-pro","messages":[{"role":"user","content":"你好"}]}'

常见问题

怎么收费?

按每次调用的实际用量计费,不同模型价格不同,在面板「天机云大模型 → 模型」页可以看到每个模型的输入、输出价格。费用从大模型余额扣除;请先在面板将天机云余额转入大模型余额,也可以开启自动转入。

提示余额不足(402)怎么办?

大模型余额不够本次调用时,请先在面板把天机云余额转入大模型余额,或开启自动转入后重试。单次请求设置了很大的 max_tokens 时,需要的余额也会更多,可以适当调小。

提示 401 / Invalid API key?

Key 填错了、多了空格,或者这个 Key 已被撤销。到面板「API Key」页检查,必要时新建一个。

提示 403 / Key 已暂停?

这个 Key 被暂停了,或者达到了你给它设的花费上限。到面板「API Key」页恢复或调高上限。

能不能控制某个 Key 最多花多少钱?

可以。面板「API Key」页点编辑,给 Key 设置花费上限(按天、按月或总计),到达上限后这个 Key 会被拦下,不影响其他 Key。

在哪看每次调用花了多少?

面板「用量明细」页有每次调用的时间、模型、token 数、花费和耗时,可以按 Key、模型筛选。

我的对话内容会被保存吗?

只记录调用次数、模型、token 数、花费等计费信息,不保存你的提问和回答内容。

有使用限制吗?

有。请遵守法律法规和各模型服务商的使用政策,不要转售或分享 API Key。完整规则见《天机云大模型使用条款》(tianjiyun.org/legal/ai-api-terms)。

← 全部文章