企业官网建设流程全解析

OpenClaude 上手：终端接入任意模型，3 条命令跑通

【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude

OpenClaude 是一款开源的多模型 AI 编程 CLI，让你在终端里接入 200 多个模型：云端 OpenAI、DeepSeek、Gemini 的 API，到 Ollama 本地零 key 推理，写代码、调试、跑长任务都走同一套命令。

什么场景下值得装

• 你手里有 OpenAI、DeepSeek 等多家 key，不想为每家换一套工具链
• 想用本地 Ollama 模型免费跑推理，又不想单独为它做一套接入
• 修测试、重构这类长任务要跑几十分钟，不想让终端一直占着

装之前先确认

• Node.js ≥ 22.0.0：node --version
• ripgrep：代码搜索依赖，rg --version
• Bun ≥ 1.3.13：仅源码构建需要，bun --version；普通用户可跳过

从安装到跑通

第一步，安装。一行命令装好，打印出版本号就算成功（Arch 用户可直接paru -S openclaude）：

npm install -g @gitlawb/openclaude@latest openclaude --version

第二步，接模型。云端 key 和本地 Ollama 二选一照抄即可。云端以 OpenAI 为例（换 DeepSeek 时把OPENAI_BASE_URL和OPENAI_MODEL改成对应值）：

export CLAUDE_CODE_USE_OPENAI=1 export OPENAI_API_KEY=sk-your-key export OPENAI_MODEL=gpt-4o

本地 Ollama 不需要任何 key，先拉好模型再指到本机端口：

ollama pull qwen2.5-coder:7b export CLAUDE_CODE_USE_OPENAI=1 export OPENAI_BASE_URL=http://localhost:11434/v1 export OPENAI_MODEL=qwen2.5-coder:7b

第三步，启动验证。跑openclaude，出现提示符即接上了。不想每次手动 export，就进程序后跑/provider交互式配置，profile 会存成.openclaude-profile.json，之后直接启动。

跑通之后怎么用

写代码是最常用的场景。直接在提示词里说"修这个 bug"，它会自己调 bash、文件读写、代码搜索这些内置工具去完成。面对不熟的大仓库，先跑/repomap看一张按重要性排序的结构地图，再指到具体模块提问，比盲翻文件高效。

长任务别占着终端。openclaude --bg "fix failing tests"把它推到后台子进程，终端立刻空出来：

openclaude --bg "fix failing tests" openclaude ps openclaude logs fix-failing-tests -f openclaude kill fix-failing-tests

openclaude ps看列表，logs带-f实时跟踪进度，跑完不需要就kill掉。想接着上次聊，openclaude --continue直接回到最近一次会话。

花销和改动质量也有对应动作：/cost看成本与路由汇总；改完代码让模型用/review过一遍，不满意就/rewind回滚会话状态重来。

跑起来后还能玩个小的：/buddy孵化一个像素伙伴，你每提交一条消息它就放一个招牌动作，纯终端特效，不消耗 token。

卡住了先查这

• 报ripgrep not found→ 先系统级装好 ripgrep，在同一终端用rg --version确认有输出再启动
• 装完找不到openclaude命令 → 重开终端；仍不行就重装并跑openclaude --version验证
• 云端模型认证失败 → 先查 key 是否复制完整、未过期，再核对OPENAI_BASE_URL和 provider 是否匹配
• Ollama 不响应或历史像丢了 → 确认服务在跑、模型已 pull，另开终端ollama ps看 CONTEXT 列；OpenClaude 默认请求 32768 token 上下文，仍显示 4K 就重启 Ollama，细节见 docs/advanced-setup.md
• .env不生效 → 它不会被自动加载，用openclaude --provider-env-file .env显式传入

想深入看这里

• 代理路由：给 Explore、Plan 等代理分别指定模型，见 docs/agent-routing.md
• 智能路由：/smartroute把简单查询自动分给更便宜的模型，见 docs/smart-routing.md
• 代码库地图：repomap 的 PageRank 排序机制，见 docs/repo-map.md
• 插件体系源码：src/plugins/

【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude