ThinkRail 如何接入你的 AI：JetBrains AI、Anthropic、OpenAI 与 API Key 全配置
【免费下载链接】thinkrailVibe code with pi in a lightweight, real IDE that customises itself around the way you work — The Vibe You Need项目地址: https://gitcode.com/GitHub_Trending/th/thinkrail
ThinkRail 是一款围绕pi编码 Agent 打造的轻量级 AI IDE，你可以在其中接入JetBrains AI、Anthropic、OpenAI等模型提供商——只需一次API Key配置或一次订阅登录，Agent 即可在真实 IDE 环境中读写代码、运行命令、交付变更。本文带你用最少的步骤完成 AI 接入与验证。
ThinkRail 本身不注册任何账号，也不中转你的密钥：它把模型、认证和成本计算完全交给pi引擎，你只需在Settings → Providers页面完成连接。接入方式一共有三种，各取所需：
| 方式 | 适用场景 | 操作 |
|---|---|---|
| 🔑 JetBrains AI（Central） | 有 JetBrains 订阅 / AI 额度 | 安装centralCLI 后一键 Connect |
| 🌐 订阅登录（OAuth） | 已有 Claude / ChatGPT / Copilot 订阅 | 点Sign in，浏览器完成授权 |
| 🐴 API Key | 自备 Anthropic、OpenAI 等密钥 | 点API key，粘贴密钥 |
一、方式一：接入 JetBrains AI（Central CLI）
JetBrains AI 的模型通过你本机的centralCLI 接入 ThinkRail，这是 JetBrains 用户最省心的路径——无需任何 API Key。
前置步骤：安装 central CLI
打开Settings → Providers，页面中的JetBrains AI卡片会先探测本机是否安装了central。若未安装（状态为absent），卡片会直接给出一条可一键复制的安装命令，执行后点击Recheck重新探测即可。
⚠️
central需要 1.4.0 及以上版本；版本过低时卡片会给出Update引导。
在应用内一键 Connect
探测通过后，卡片会按状态给出对应动作，整个生命周期都发生在应用内：
- Sign in—— 未登录时点击，应用会自动拉起
central login浏览器登录；若自动拉起失败，它会提示你在终端手动执行central login - Connect—— 执行
central add pi，把 JetBrains AI 模型注册进 ThinkRail - Connected—— 连接成功，顶栏出现配额与连接状态；若代理意外停止，会显示Start proxy按钮
- Disconnect—— 随时解除接入，恢复为普通运行时
连接成功后，来自 JetBrains AI 的模型在模型选择器中会标注JetBrains AI（模型行带JCP标签），与直连模型区分开。你还可以在卡片下方开启Show quota in top bar，让顶栏按 1～3600 秒（默认 30 秒）的周期刷新你账户的 AI 额度余量。
相关实现可参考：JetBrainsAiCard.tsx、jbcentral.ts 与跨模块设计说明 central-integration.md。
二、方式二：订阅登录（Claude / ChatGPT / Copilot）
已有订阅的用户不需要 API Key。Providers 页面的Subscriptions分组列出了支持 OAuth 的提供商，说明文案为：Use your existing Claude, ChatGPT, or Copilot plan — no API key needed.
点击对应提供商的Sign in，登录对话框会引导你完成浏览器授权：
- 点击Open sign-in page打开提供商的登录页（或复制链接到浏览器）
- 部分提供商走设备码流程：对话框显示一个验证码，你在浏览器中输码授权
- 授权完成后对话框自动变为{{provider}} connected绿色成功提示；若回调未能自动完成，可点击Paste the final URL粘贴浏览器最终停留的地址
登录后，该提供商在页面中移动到Connected分组，随时可以Sign out解除。登录流程由 LoginDialog.tsx 渲染，服务端逻辑见 auth/SPEC.md。
三、方式三：配置 API Key（Anthropic / OpenAI 等）
如果你更习惯按量付费的 API Key（例如ANTHROPIC_API_KEY、OPENAI_API_KEY对应的密钥），走Available分组：
- 在列表中展开更多提供商（Show N more）
- 点击目标提供商的API key按钮
- 在弹出的对话框中粘贴密钥（输入框为密码遮掩模式，按 Enter 或点Submit提交）
几个实用细节：
- 多提示表单也支持：像 Azure、Vertex 这类需要多项凭据的提供商，对话框会依次等待你输入每一项
- 密钥只存本地：凭证由
pi持久化在本机，网络协议层永不传输密钥明文 - 按量计费才显示价格：API Key 与环境变量接入的模型，在选择器中会直接标出每百万 token 的
$输入 / $输出列表价（见 modelPicker.ts）
如果你已经通过环境变量或pi的models.json配置过密钥，这些提供商会直接出现在Connected分组并标记为Managed（由应用外部管理，应用内不提供 Sign out）——点Refresh即可让状态同步。
四、验证接入：在聊天中选择模型
配置完成后，打开任意 workspace 的聊天面板，输入框左下角就是模型选择器：
- 每个模型旁标注接入方式（
subscription/API key/environment key/JetBrains AI） - 同一个 workspace 可开多个并行会话，每个会话独立选模型，并实时显示 token 消耗与成本
- 顶栏Connected指示灯表示引擎主连接正常
选完模型直接发消息即可。之后 Agent 的每次工具调用（读写文件、运行命令、MCP 服务审批）都会以卡片形式流式呈现，例如 MCP 非只读工具的审批界面：
五、快速排障清单
| 现象 | 原因与处理 |
|---|---|
卡片提示needsInstall | 未安装central，复制卡片给出的安装命令后 Recheck |
显示outdated | central版本过低，点Update（执行central update --install） |
提示signedOut | 点Sign in重新登录；失败则终端手动执行central login |
显示proxyStopped | 点Start proxy重启代理 |
| Providers 列表读不到 | 点右上角Refresh，确认引擎主机运行正常 |
📎 延伸阅读：提供商状态与登录通道的完整契约见 providerStatus.ts 与 ProvidersSettings.tsx；隐私说明见 README.md。
三条路径任选其一，两分钟就能让 ThinkRail 的 Agent 跑起来。配置完成后，把注意力交还给代码本身——它会在隔离的 git worktree workspace 中完成修改，你随时可以在 Changes 面板审阅每一处 diff。
【免费下载链接】thinkrailVibe code with pi in a lightweight, real IDE that customises itself around the way you work — The Vibe You Need项目地址: https://gitcode.com/GitHub_Trending/th/thinkrail
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
