OpenClaude：在一个终端里切换不同 AI 编程模型
一分钟看懂
OpenClaude 是一个开源的终端编程 Agent。它把“选择模型、读取代码、修改文件、执行命令、调用外部工具、管理对话”放进同一套工作流里。它最有价值的地方不是再造一个聊天窗口，而是让你不用因为更换模型供应商，就连同整套编程习惯一起更换。
你可以接入 OpenAI 兼容接口、Gemini、GitHub Models、Codex、Ollama 等云端或本地模型，并为不同提供商保存配置。日常使用时，Agent 能检索仓库、读写文件、运行 Bash 命令、拆分子任务，也能通过 MCP 连接更多工具。
你可以用它做什么
在现有项目里完成开发任务
进入代码仓库后直接描述需求，例如定位一个错误、增加接口、补测试或解释陌生模块。OpenClaude 可以先搜索文件和调用关系，再编辑代码并运行命令验证结果。它比单纯复制代码到网页聊天框更适合跨文件任务，因为处理过程始终围绕当前工作目录展开。
按任务选择不同模型
你可以把速度快、成本低的模型用于搜索和小修改，把能力更强的模型用于复杂重构；也可以在隐私或离线场景下改用 Ollama 等本地后端。/provider 提供引导式配置，常用连接可以保存为配置档案，减少重复填写地址、模型名和凭证。
扩展团队自己的工具链
项目内置文件、搜索、命令、任务和网页等工具，同时支持 MCP。团队可以把文档检索、数据库查询或内部服务接入同一个 Agent，而不必修改核心交互方式。它还提供无界面服务模式，方便进一步嵌入编辑器或其他客户端。
保留和恢复复杂任务上下文
对话可以继续、恢复或分叉，耗时工作也可以作为后台会话执行。这适合把一次较大的改造拆成多个方向：保留原始任务，再从某个节点尝试另一种实现，而不是反复从头说明背景。
使用体验是什么样的
OpenClaude 以终端为中心，输入自然语言需求后，界面会流式展示模型回复和工具调用。它提供斜杠命令、任务管理、代码库映射与会话管理，并附带 VS Code 扩展。仓库里还包含一个像素风桌面伙伴，但它属于体验增强，不影响核心 CLI 的使用。
如果你已经习惯在终端里开发，它的学习成本主要在于首次配置提供商和理解工具权限；如果平时完全依赖图形界面，则需要适应命令行工作流。
主要能力
- 一套 CLI 连接多种云端与本地模型，并保存多个提供商配置。
- 读取、编辑、搜索文件，执行命令，使用子 Agent、任务和网页工具。
- 支持 MCP，将第三方或内部工具加入编程流程。
- 支持对话继续、恢复和分叉，以及后台运行的会话。
- 提供代码库映射和上下文能力，帮助模型理解较大的仓库。
- 支持图片输入，但实际可用性取决于所选模型和提供商。
- 提供 VS Code 扩展及基于 gRPC 的无界面服务模式。
适合哪些人
它适合希望自主选择模型、不想被单一平台绑定的开发者；适合同时使用公司代理、本地模型和商业 API 的团队；也适合愿意自己维护配置、重视可扩展性的命令行用户。
如果你只是偶尔问一个代码问题，成熟的网页助手可能更省事。OpenClaude 的优势会在“需要访问真实仓库、频繁切换提供商、长期保留任务上下文”时更明显。
怎么开始使用
官方发布版要求 Node.js 22 或更高版本。安装后运行 openclaude，再用 /provider 选择和配置模型提供商。若使用 GitHub 相关能力，可以按照项目提供的 /onboard-github 流程完成设置。从源码开发时项目使用 Bun，但普通安装并不要求你先搭建 Bun 开发环境。
第一次使用建议在测试仓库中开始，先检查它准备执行的命令和文件修改，确认模型、权限及成本设置符合预期后，再用于正式项目。
使用前需要知道
OpenClaude 统一的是操作入口，不会消除模型本身的差异。不同提供商对工具调用、上下文长度、图片和流式响应的支持并不一致，小型本地模型也可能难以稳定完成复杂的多步修改。最终效果仍取决于模型能力、提示内容和仓库规模。
它使用自己的 .openclaude 配置体系，不会自动读取 Claude Code 的配置。API 密钥等敏感信息应按官方方式保存在本机配置或环境变量中，不要提交到 Git 仓库。允许 Agent 执行命令之前，也应像审查人工脚本一样确认其影响范围。