企业官网建设流程全解析

OpenClaude 快速上手指南：3 步把任意 LLM 跑进你的终端

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

OpenClaude 是一款开源的多模型 AI 编程 CLI。OpenAI、DeepSeek、Gemini 这类云端 API，或者 Ollama 本地模型，都能接进同一个终端编程助手。换个模型，不用换工具链。

场景对号：你先认领一条路径

• 如果你手里已经有 OpenAI 或 DeepSeek 的 key：走云端路径，export 三个变量就能启动，全程不需要本地模型。
• 如果你想离线跑、或者不想付调用费：走 Ollama 本地路径，只需把地址指向本机11434端口，不用 key。
• 如果你是 Windows 用户：安装和启动方式略有不同，直接看 docs/quick-start-windows.md，macOS/Linux 看 docs/quick-start-mac-linux.md。
• 如果你只是想看源码、不想参与构建：Bun 相关的事全部跳过，npm 安装即可。

动手前核对：环境依赖清单

最短路径：第一次跑通

先装，一条命令：

npm install -g @gitlawb/openclaude@latest

然后按云端 OpenAI 兼容路径启动（这是覆盖场景最多的一条）：

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

看到交互界面，说明已经动起来。

换口味提示：想跑本地 Ollama 的话，把OPENAI_BASE_URL指到http://localhost:11434/v1、OPENAI_MODEL改成你 pull 下来的模型名，其余不变且无需 key，完整步骤在 docs/quick-start-mac-linux.md。

启动之后建议跑一次/provider：交互式选 provider、填凭据，profile 会存到.openclaude-profile.json，以后就不用每次手动 export 了。

核心能力速览

按你会用到的场景分四组看：

会话管理：不用从头再来

• openclaude --continue接着最近一次对话继续；--resume <session-id>恢复指定会话。
• 加--fork-session从旧会话分叉出一条新线，原记录不动。
• 长任务挂后台：openclaude --bg "fix failing tests"，之后用openclaude ps看列表，openclaude logs <name> -f实时跟踪，openclaude kill <name>结束。后台会话是本地子进程，不额外起守护服务。

模型与 provider：随时切

• /provider交互式配置并保存 profile；/model在当前会话内切模型。
• 想给不同代理配不同模型（比如 Explore 走便宜模型、主会话走强模型），在~/.openclaude/settings.json里写agentModels+agentRouting即可，细节见 docs/agent-routing.md。

任务执行：工具都内置

文件读写、Bash、Grep、Glob、代理与子任务拆分是开箱即用的内置工具，实现集中在 src/tools/。

成本与路由：简单的事别花大钱

• /cost看成本与路由汇总。
• /smartroute开启智能路由，把简单查询自动交给更便宜的模型，原理见 docs/smart-routing.md。

新手高频报错自救

现象：装完找不到openclaude命令可能原因：终端没重开，npm 全局路径没进 PATH。 解法：重开终端再试；仍不行就重装npm install -g @gitlawb/openclaude@latest，用openclaude --version验证。

现象：提示ripgrep not found可能原因：系统没装 ripgrep，或不在当前终端的 PATH 里。 解法：系统级安装 ripgrep 后，在同一个终端里跑rg --version确认有输出，再启动 OpenClaude。

现象：云端模型认证失败、连不上可能原因：key 复制不完整或已过期；OPENAI_BASE_URL和实际 provider 不匹配。 解法：先核对 key 完整且有效，再对照 provider 检查 base URL 和模型名。

现象：Ollama 模型不响应，或会话历史像丢了可能原因：Ollama 没在跑、模型没 pull 成功、或上下文窗口没生效。 解法：另开终端ollama ps看 CONTEXT 列。OpenClaude 默认每次请求 32K 上下文，若仍显示 4K 之类的小值，重启 Ollama 服务再试。

现象：.env写了但配置不生效可能原因：OpenClaude 不会自动读.env，且配置目录是~/.openclaude，不读 Claude Code 的~/.claude。 解法：显式指定openclaude --provider-env-file .env（仅 provider/setup 变量），运行时变量仍从 shell 导出。

进阶地图

每个方向只给入口，一句话说明：

• 插件：src/plugins/，用/plugin管理自定义功能。
• MCP：src/services/mcp/，/mcp list查看已接入的外部资源。
• 技能：src/skills/，内置技能与发现机制。
• VS Code 集成：vscode-extension/openclaude-vscode/，启动集成与编辑器内聊天。

顺手试一下/buddy：孵化一个像素伙伴，你每发一条消息它就放一支箭。纯终端特效，不消耗 token。

收口：下一步该看哪

• 想看 20 余家 provider 的环境变量对照和社区入口，翻 README.md。
• 要用 Codex、Gemini、Mistral、LiteLLM 或做 provider profile 进阶配置，读 docs/advanced-setup.md。
• 现在就可以试：/provider配好 profile，再跑/repomap看一眼当前代码库的结构地图。

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