
如何为Orkas配置你自己的AI模型Claude、OpenAI、Ollama本地模型三端并存的完整设置指南【免费下载链接】OrkasOrkas is an open-source, local-first AI desktop app: a commander LLM directs specialist sub-agents, and runs your installed coding CLIs — Claude Code, Codex, OpenCode, OpenClaw, Hermes — as local sessions. Agents self-evolve via reflection and skill crystallization. BYO keys. macOS / Windows / Linux.项目地址: https://gitcode.com/gh_mirrors/or/OrkasOrkas 是一款开源、本地优先local-first的 AI 多智能体桌面应用由指挥官CommanderLLM 统筹调度专业子智能体并能驱动 Claude Code、Codex、OpenCode 等已安装的编码 CLI。本文是一份面向新手的 Orkas 模型配置完整指南带你用最简单的步骤完成 ClaudeAnthropic、OpenAI 与 Ollama 本地模型三种接入让自带钥匙BYO keys真正跑起来。全程只需打开Settings → AI Providers一个入口API 密钥和对话数据都保存在你自己的磁盘上。为什么要在 Orkas 里配置自己的 AI 模型很多人第一次接触 Orkas 会问它自己不是模型那模型从哪来答案是——用你自己的模型。Orkas 本身负责编排智能体、工具与对话模型调用由你的机器直连模型提供商不经过任何 Orkas 服务器中转。这带来三个好处隐私API key 与对话记录只存在于本地磁盘自由组合一个智能体跑 Claude另一个跑本地 Ollama同一个聊天里各用各的模型成本可控只用你付费的模型服务无平台抽成。官方 FAQ 明确说明Orkas 不是本地 LLM而是运行在你的机器上、通过你自己的 API key或本地模型端点调用你选择的模型。模型目录的完整清单定义在 public_model_catalog.ts 中涵盖 Claude Opus 5.5、GPT-6 Astra、Gemini 3.8 Flash 等主流型号而设置页里有哪些提供商可选则由 provider_catalog.ts 中的CATALOG单一来源统一管理。配置前的准备获取你的 API Key不同提供商的 key 获取入口如下都在各自官网的控制台创建提供商Key 用途说明AnthropicClaudeAPI key用于 Claude Opus / Sonnet 系列模型OpenAIAPI key用于 GPT-6 系列模型Ollama本地无真实 key本地端点通常填ollama或任意占位值即可 小技巧OpenAI Codex 与部分提供商支持OAuth 授权登录无需手动填 key设置页会自动展示API Key / OAuth两种接入方式源码逻辑见 settings.js 的_settingsChooseAccountMethod函数——有 OAuth 的提供商会引导你走授权流程。一键配置步骤Settings → AI Providers三种模型走的是同一个入口按下面的顺序操作即可第 1 步进入模型设置页启动 Orkas 后打开Settings → AI Providers。页面以卡片形式列出所有受支持的提供商Anthropic、OpenAI、OpenAI Codex、Google Gemini、DeepSeek、Zhipu GLM、Moonshot、MiniMax、Doubao、OpenRouter以及用于 Ollama 的Custom (OpenAI-compatible)卡片。第 2 步配置 ClaudeAnthropic点击Anthropic卡片 → 选择API Key方式粘贴你在 Anthropic 控制台创建的 key在下拉框中挑选模型例如Claude Opus 5.5或Claude Sonnet 5.5保存。下拉框中的候选模型来自精选清单保证型号 ID 与运行时严格一致见 public_model_catalog.ts。第 3 步配置 OpenAI点击OpenAI卡片 →API Key方式粘贴 key选择GPT-6 Astra、GPT-6 Sol等模型如果你更习惯订阅制登录可改用OpenAI Codex卡片走 OAuth 一键授权两者可在同一应用中并存。第 4 步接入 Ollama 本地模型零云成本Ollama 和 LM Studio 这类本地推理服务都实现 OpenAI 兼容协议所以使用Custom (OpenAI-compatible)卡片接入先在本机启动 Ollama默认监听http://localhost:11434点击Custom (OpenAI-compatible)卡片Base URL填写本地端点地址这是必填项缺失或格式错误会提示settings.custom.error_base_urlModel ID填写 Ollama 中的模型名如你已拉取的模型 IDAPI Key填任意占位值即可保存后本地模型就会出现在模型选择器里。相关校验逻辑Base URL 必填、格式合法性等集中在 settings.js 的自定义错误映射表中配置错误时界面会给出明确的中文提示。三端并存的玩法让不同智能体用不同模型配置好三个提供商后真正的价值才出现——Orkas 允许每个智能体绑定不同提供商互不锁定让DeepResearcher用 Claude 做深度调研长文本推理强让OfficeWorker用 OpenAI 处理文档让日常闲聊类任务交给Ollama 本地模型零成本、断网也能跑。README 的 FAQ 中直接给出了这个场景的答案可以在同一个聊天里一个智能体跑本地模型另一个跑云端托管模型。上下文预算也会按模型自动适配——32K 窗口和 1M 窗口的模型使用同一套压缩策略实现见 context-budget.ts。常见问题FAQQ1我的 API key 存在哪里存在你的磁盘上本地工作区macOS/Linux 为~/.orkas/Windows 为最小非系统盘的\.orkas\。模型调用从你的机器直连提供商Orkas 不中转、不归档。Q2断网能用吗可以。把智能体指向 Ollama 等本地端点后除模型推理外完全离线可用。Q3模型列表能自定义吗可以。运行时模型目录支持通过 model-catalog JSON 覆盖内置清单注册与解析逻辑见 provider_catalog.ts 的curatedModelsFor函数。Q4Linux 上如何运行 Orkas目前 Linuxglibc 2.34从源码运行git clone https://gitcode.com/gh_mirrors/or/Orkas cd Orkas ./run.sh首次启动会自动准备依赖并创建工作区随后按本文步骤进入Settings → AI Providers完成配置即可。总结步骤操作关键入口1️⃣打开Settings → AI Providers设置页2️⃣Anthropic 卡片填 key选 Claude 模型Claude 卡片3️⃣OpenAI 卡片填 key 或走 Codex OAuthOpenAI 卡片4️⃣Custom 卡片填 Base URL 接入 OllamaCustom 卡片5️⃣给不同智能体分配不同模型享受三端并存智能体设置整套配置 10 分钟内即可完成。Orkas 的本地优先 自带钥匙设计意味着你付给模型商的每一分钱都花在刀刃上而你的数据、key 和智能体全部只属于你自己 【免费下载链接】OrkasOrkas is an open-source, local-first AI desktop app: a commander LLM directs specialist sub-agents, and runs your installed coding CLIs — Claude Code, Codex, OpenCode, OpenClaw, Hermes — as local sessions. Agents self-evolve via reflection and skill crystallization. BYO keys. macOS / Windows / Linux.项目地址: https://gitcode.com/gh_mirrors/or/Orkas创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考