天机云大模型接入教程: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 只显示这一次,点「复制」保存好,像密码一样保管。

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

3. 记下接口地址
| 用在哪里 | 填写 |
|---|---|
| Claude Code、Claude Desktop、Anthropic SDK | https://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:
Windows(PowerShell):
也可以用 npm 安装(需要 Node.js 22 或更高版本):
装好后运行 「claude --version」,能看到版本号就行。
写配置文件(推荐,一次配好长期有效)
打开(没有就新建)配置文件:macOS / Linux 是 「~/.claude/settings.json」,Windows 是 「%USERPROFILE%\.claude\settings.json」。写入下面内容,把 「tj-你的Key」 换成你的 Key:
- ANTHROPIC_BASE_URL 只填地址,后面不要加 /v1。
- ANTHROPIC_MODEL 是主力模型;ANTHROPIC_DEFAULT_HAIKU_MODEL 用于生成标题等后台小任务,填一个便宜快速的模型能省钱。
- 想用 DeepSeek 等其他模型写代码,把这几个模型 ID 换成面板「模型」页复制来的 ID 即可,例如 「deepseek/deepseek-v4-pro」。
- 不要把这个文件放进项目代码仓库,会把 Key 一起提交。
只想临时试一下,也可以用环境变量(关掉终端就失效):
验证
在任意项目目录运行下面命令,能收到回答就说明接通了:

如果看到「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 里另外写一份:
Claude Desktop(桌面 App)
Claude Desktop 是 Anthropic 官方的桌面 App(macOS / Windows),较新版本支持接入第三方接口。它不读取 Claude Code 的 settings.json,要在 App 里单独设置,请先更新到最新版本。
- 菜单栏 Help(帮助)→ Troubleshooting(故障排除)→ Enable Developer Mode(启用开发者模式),菜单栏会多出 Developer 菜单。
- 菜单栏 Developer → Configure Third-Party Inference…,按下表填写后保存,然后重启 Claude Desktop。
| 设置项 | 填写 |
|---|---|
| Inference provider | Gateway |
| Gateway base URL | https://ai.tianjiyun.org |
| Gateway API key | tj-你的Key |
| Gateway auth scheme | Bearer(默认) |

- 重启后新建对话,在模型选择处选择要用的模型;列表里没有的,到面板「模型」页复制模型 ID 后填入。
启用第三方接口后,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 |

- 在这个服务下点「管理」可以拉取全部模型,或点「添加」手动填模型 ID(到面板「模型」页复制),例如 「deepseek/deepseek-v4-pro」、「openai/gpt-5.2」、「anthropic/claude-sonnet-5.5」。可用模型和价格以面板「模型」页为准。
- 点 API 密钥旁的「检查」,提示连接成功即可。回到对话页,在顶部选择刚添加的模型开始聊天。
提示 404 或连接失败:检查 API 地址结尾是 /v1(不要多写 /chat/completions),提供商类型选 OpenAI,Key 前后不要有空格。
在代码里调用
OpenAI 官方 SDK 和 Anthropic 官方 SDK 都能直接用,只改接口地址和 Key。OpenAI 格式的地址带 /v1,Anthropic SDK 的地址不带 /v1。都支持流式输出。
常见问题
怎么收费?
按每次调用的实际用量计费,不同模型价格不同,在面板「天机云大模型 → 模型」页可以看到每个模型的输入、输出价格。费用从大模型余额扣除;请先在面板将天机云余额转入大模型余额,也可以开启自动转入。
提示余额不足(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)。