如何用Orkas驱动Claude Code与Codex：3步把你的编程CLI接入本地智能体团队-开发者社区

如何用Orkas驱动Claude Code与Codex：3步把你的编程CLI接入本地智能体团队

【免费下载链接】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

Orkas 是一款开源、本地优先的 AI 智能体桌面应用，它的指挥官（Commander）可以把已安装在本机的Claude Code与Codex编程 CLI 作为本地会话驱动，让它们和 9 个内置专业智能体在同一个对话里协作。本文用 3 步教你完成 Orkas 安装、模型配置，并把编程 CLI 接入本地智能体团队，全程无需改动现有 CLI 配置。

为什么用 Orkas 驱动编程 CLI？

多智能体协作—— 指挥官统筹全局，把你的目标拆解后并行/接力分派，进度实时可见；
本地优先—— 对话、代码、API key 全部留在硬盘，模型调用直连服务商，不经过任何中转服务器；
自我进化—— 每个智能体任务结束后自动复盘，把有效做法结晶成私有技能，越用越强；
一个对话指挥全部—— Claude Code、Codex、OpenCode 等编程智能体与写作、研究等专家共用同一个聊天入口。

第一步：安装并启动 Orkas 桌面版

📥macOS / Windows 用户：直接下载官方安装包安装启动即可（下载方式见 README.zh-CN.md 的"下载"章节）。

🐧Linux 用户（glibc 2.34+，x64/arm64）：从源码运行，需要 Node 22.12+：

git clone https://gitcode.com/gh_mirrors/or/Orkas cd Orkas ./run.sh

首次启动会自动准备运行环境，并在~/.orkas/下创建工作区。如遇原生依赖报错，可执行npm run native:repair修复（详见 docs/native-dependencies.md）。

第二步：2 分钟配置模型 API Key

指挥官自己干活需要"燃料"，启动后进入设置 → AI 服务商，添加 API Key 或 OAuth 授权，支持 Claude · OpenAI · Gemini · DeepSeek · Kimi · GLM · Qwen · MiniMax · Doubao 等 9 家主流模型：

已有 Key 的用户直接粘贴即可；
想用本地模型？在自定义（OpenAI 兼容）里把 base URL 指向 Ollama / LM Studio 端点；
不同智能体可混用不同服务商，一个用 Claude、一个用 DeepSeek，完全无厂商锁定。

💡 你的 Key 只存在本机，Orkas 不做代理、不归档任何请求。

第三步：一键接入 Claude Code 与 Codex

这是最关键的一步，而且几乎不用动手：

确保 CLI 已安装—— 终端里能直接运行claude/codex命令即可（登录状态沿用你已有的配置）；
打开接入入口—— 在 Orkas 主界面左下角点击「接入智能体」（Claude Code · Codex 等）；
自动检测—— Orkas 会扫描 PATH 及常见安装目录（如~/.local/bin、Homebrew），列出已安装的 CLI 并校验版本号；
一键创建—— 选中 Claude Code 或 Codex，名称与描述自动填好，为编程智能体指定项目目录和权限策略（继承 / 逐次询问 / 完全访问）后保存。

背后的机制值得一看：CLI 注册表在 registry.ts 中为每个 CLI 声明了会话契约 —— Claude Code 与 Codex 都支持原生会话恢复（多轮对话不会失忆）、项目目录协议和 Orkas MCP 桥，这正是它们比"一次性跑脚本"体验好得多的原因。