OpenClaude 快速上手指南3 步把任意 LLM 跑进你的终端【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaudeOpenClaude 是一款开源的多模型 AI 编程 CLI。OpenAI、DeepSeek、Gemini 这类云端 API或者 Ollama 本地模型都能接进同一个终端编程助手。换个模型不用换工具链。场景对号你先认领一条路径如果你手里已经有 OpenAI 或 DeepSeek 的 key走云端路径export 三个变量就能启动全程不需要本地模型。如果你想离线跑、或者不想付调用费走 Ollama 本地路径只需把地址指向本机11434端口不用 key。如果你是 Windows 用户安装和启动方式略有不同直接看 docs/quick-start-windows.mdmacOS/Linux 看 docs/quick-start-mac-linux.md。如果你只是想看源码、不想参与构建Bun 相关的事全部跳过npm 安装即可。动手前核对环境依赖清单项目要求级别Node.js 22.0.0npm 安装和运行时都用它必装ripgrep任意较新版本rg --version能输出即可必装Ollama仅当你要跑本地模型可选Bun1.3.13仅源码构建需要可跳过最短路径第一次跑通先装一条命令npm install -g gitlawb/openclaudelatest然后按云端 OpenAI 兼容路径启动这是覆盖场景最多的一条export CLAUDE_CODE_USE_OPENAI1 export OPENAI_API_KEYsk-your-key export OPENAI_MODELgpt-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里写agentModelsagentRouting即可细节见 docs/agent-routing.md。任务执行工具都内置文件读写、Bash、Grep、Glob、代理与子任务拆分是开箱即用的内置工具实现集中在 src/tools/。成本与路由简单的事别花大钱/cost看成本与路由汇总。/smartroute开启智能路由把简单查询自动交给更便宜的模型原理见 docs/smart-routing.md。新手高频报错自救现象装完找不到openclaude命令可能原因终端没重开npm 全局路径没进 PATH。 解法重开终端再试仍不行就重装npm install -g gitlawb/openclaudelatest用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管理自定义功能。MCPsrc/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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考