1. 从一堆工具名里我看到了一个真实需求过去大半年我几乎把市面上主流的 AI 编程助手都折腾了一遍。Claude Code、Codex、OpenCode、Cursor这几个名字在圈子里出现的频率越来越高身边做开发的朋友也经常在群里甩一句“你那个配置怎么写的”“为什么我这边一直报错”。说实话刚开始我也踩了不少坑装完 Claude Code 发现终端里跑不起来Codex 在 Windows 上装到一半卡住OpenCode 提示免费额度只能在它自己的环境里用Cursor 打开全是英文找不到中文入口。这些问题单个看都不大但凑在一起就特别消耗精力。后来我干脆给自己定了个目标把这几个工具的安装、配置、使用、常见报错全部梳理一遍做成一个自己能随时查的“开放研究”笔记。这就是 OpenResearch 这个项目的由来。它不是一个具体的软件而是我围绕 Claude Code、Codex、OpenCode、Cursor 这几个主流 AI 编程工具做的一套从零上手到日常使用的完整实践记录。里面包含安装步骤、配置方法、中文设置、免费模型接入、报错排查以及我在实际写代码过程中总结出来的使用技巧。这篇文章适合谁看如果你是刚接触 AI 编程助手的新手想找一个能直接照着做的入门指南那这篇内容就是为你准备的。如果你已经用过其中一两个工具但被某个报错卡住或者想试试别的工具这里也有对应的排查思路和对比参考。我会尽量用大白话把每个环节讲清楚不堆术语不绕弯子让你看完就能动手操作。2. 四个工具到底怎么选先搞清楚它们各自擅长什么2.1 Claude Code、Codex、OpenCode、Cursor 的定位差异很多人一上来就问“哪个最好用”这个问题其实没有标准答案因为这几个工具的定位并不完全一样。我自己的理解是这样的Claude Code 更像是一个终端里的编程搭档。它跑在命令行里你可以直接让它读项目文件、改代码、跑测试。它的强项是理解整个项目结构适合那种“我想让它帮我重构一个模块”或者“帮我看看这个 bug 出在哪”的场景。安装方式主要是通过包管理器配置好之后在项目目录里直接调用。Codex 是另一条路线它更偏向代码补全和片段生成。你在编辑器里写代码它根据上下文给你补全建议。它的安装方式在不同系统上差异比较大Windows 上尤其容易遇到安装未完成的情况这个后面我会专门讲怎么处理。OpenCode 是一个开源的编程助手框架它的特点是你可以接入不同的模型提供商包括一些免费模型。它的免费额度有一个限制只能在 OpenCode 自己的环境里使用。如果你试图把它接到别的客户端上就会看到那个经典的报错“opencodes free tier can only be used from within opencode”。这个设计其实是为了防止滥用理解这一点之后你就知道该怎么正确使用它了。Cursor 则是一个完整的编辑器它基于 VS Code 做了深度定制把 AI 能力直接嵌到了编辑体验里。它的优势是上手门槛低界面友好适合不想折腾命令行的开发者。但它默认是英文界面很多人第一次打开就卡在“怎么设置中文”这一步。2.2 选型时我重点看哪几个维度我在选择用哪个工具的时候主要看四个维度安装难度、使用场景、费用成本、中文支持。安装难度上Cursor 最简单下载安装包双击就行Claude Code 需要先装 Node.js 环境然后用 npm 安装Codex 在 Windows 上最麻烦经常出现安装未完成的情况OpenCode 的安装相对灵活但配置模型接入需要一点耐心。使用场景上如果你习惯在终端里工作Claude Code 和 OpenCode 更顺手如果你喜欢在编辑器里写代码Cursor 和 Codex 更合适。我自己的习惯是大项目重构用 Claude Code日常写代码用 Cursor想试试免费模型的时候用 OpenCode。费用成本这块Cursor 有免费额度但用多了会提示“get cursor pro for more agent usage”意思是免费版的 agent 调用次数有限OpenCode 有免费模型可以用但限制在它自己的环境里Claude Code 和 Codex 通常需要你有对应的 API 额度或者订阅。中文支持方面Cursor 需要手动设置语言Claude Code 和 Codex 的界面本身是英文的但你可以用中文跟它对话。OpenCode 的界面也是英文为主不过社区里有中文配置的分享。2.3 一个简单的选择建议如果你是完全的新手我建议先从 Cursor 开始。它的界面最接近你熟悉的编辑器安装完设置成中文就能直接用了。等你对 AI 编程助手有了基本感觉再去试 Claude Code 或者 OpenCode会顺利很多。如果你已经有一定经验想找一个能深度参与项目开发的工具Claude Code 值得花时间配置。它的终端交互方式一开始可能不习惯但用顺了之后效率提升很明显。如果你对费用比较敏感想先用免费模型练手OpenCode 是个不错的选择。只要记住它的免费额度使用限制别想着把它接到别的客户端上就能避免很多不必要的报错。3. 安装环节的坑我踩过的和你怎么绕过去3.1 Claude Code 安装Node.js 版本是关键Claude Code 的安装本身不复杂官方推荐的方式是通过 npm 全局安装。但我在第一次装的时候遇到了一个问题终端里输入命令之后提示找不到这个命令。排查了半天发现是 Node.js 版本太旧了。Claude Code 对 Node.js 的版本有要求我实测下来Node.js 18 以上比较稳妥。你可以先在终端里跑node -v看一下当前版本。如果低于 18建议先升级 Node.js。升级的方式取决于你当初是怎么装的如果用 nvm 管理直接nvm install 18然后nvm use 18如果是官网下载的安装包就去官网下最新版覆盖安装。版本确认没问题之后安装命令是这样的npm install -g anthropic-ai/claude-code装完之后在终端里输入claude如果能看到欢迎信息说明安装成功了。如果提示权限问题Windows 上可以用管理员身份运行终端Mac 和 Linux 上可以在命令前面加sudo。注意不要用sudo去跑 Claude Code 本身只在安装的时候需要提权。日常使用直接用普通用户权限就行否则可能会遇到配置文件读写权限的问题。还有一个细节Claude Code 第一次运行的时候会引导你做一些初始配置比如选择模型、设置 API 密钥。如果你已经有对应的 API 额度按照提示填进去就行。如果没有可以先跳过后面在配置文件里补上。3.2 Codex 安装Windows 上的特殊处理Codex 在 Windows 上的安装是我遇到过最折腾的一个。官方提供的安装方式在 Mac 和 Linux 上比较顺畅但 Windows 上经常出现“安装未完成”的提示。我试了好几次最后总结出一套相对靠谱的流程。首先确保你的系统已经安装了Git for Windows和Python 3.10 以上。Codex 的某些依赖需要这两个环境。然后不要直接用官网的安装包而是通过包管理器来装。Windows 上我推荐用winget或者scoop。用 winget 的话命令是这样的winget install Codex如果 winget 里找不到可以试试 scoop。先安装 scoop然后scoop install codex装完之后在终端里输入codex --version如果能正常显示版本号说明安装成功了。如果还是提示找不到命令检查一下环境变量里有没有把 Codex 的安装路径加进去。实操心得Windows 上安装这类开发工具最容易出问题的就是环境变量和权限。我的习惯是装完之后重启一次终端让环境变量生效。如果还不行就手动去系统设置里把安装路径加到 PATH 里。另外Codex 的官网下载页面有时候会更新不及时如果你从官网下载的安装包装不上直接去它的代码仓库看最新的安装说明通常会有更详细的系统要求说明。3.3 OpenCode 安装注意免费额度的使用边界OpenCode 的安装方式比较灵活它支持多种安装途径。我试过用 npm 装也试过直接下载二进制文件。npm 的方式最简单npm install -g opencode装完之后运行opencode就能启动。但这里有一个非常重要的点OpenCode 的免费额度只能在 OpenCode 自己的环境里使用。什么意思呢就是你不能把 OpenCode 的免费模型配置到 Claude Code 或者别的客户端里去用。如果你这么做了就会看到那个报错“opencodes free tier can only be used from within opencode”。这个限制是 OpenCode 官方设定的目的是防止免费资源被滥用。所以正确的用法就是想用免费模型就在 OpenCode 里面用想用别的工具就去配置别的工具自己的模型。注意网上有一些教程教你如何把 OpenCode 的免费模型“导出”到其他工具里这些方法大多已经失效了而且违反使用条款。我建议不要在这上面浪费时间直接用 OpenCode 本身就好。OpenCode 还有一个“归档”功能用完之后项目会归档。有人问“opencode 归档后去哪了”其实归档就是把项目状态保存下来下次可以继续。归档文件默认放在用户目录下的.opencode文件夹里你可以去那里找。3.4 Cursor 安装与中文设置两步搞定Cursor 的安装是这几个里面最简单的。去官网下载对应系统的安装包双击安装一路下一步就行。装完之后打开你会看到一个类似 VS Code 的界面但全是英文。设置中文的步骤很简单按CtrlShiftPMac 上是CmdShiftP打开命令面板。输入Configure Display Language回车。在弹出的列表里选择中文简体。重启 Cursor。重启之后界面就变成中文了。如果列表里没有中文选项可以点击“安装其他语言”然后搜索“Chinese”安装语言包。实操心得Cursor 的语言设置和 VS Code 是一样的如果你之前用过 VS Code这一步会非常熟悉。另外Cursor 的免费版有 agent 使用次数限制用多了会提示你升级 Pro。如果你只是轻度使用免费版基本够用如果每天都用可以考虑升级。4. 配置与使用让工具真正跑起来4.1 Claude Code 的日常使用方式Claude Code 装好之后用法其实很直接。进入你的项目目录在终端里输入claude它就启动了。然后你可以用自然语言跟它交流比如“帮我看看这个文件里有没有明显的 bug”或者“把这个函数重构成更简洁的写法”。我常用的几个操作场景读代码直接问它“这个项目的入口文件在哪”它会帮你找。改代码告诉它“把这段逻辑改成异步的”它会给出修改建议你确认后它直接改文件。跑测试让它“运行一下测试看看有没有问题”它会执行测试命令并告诉你结果。Claude Code 还有一个“skills”的概念你可以理解为预置的技能包。安装 skills 的方式是在配置文件里添加对应的仓库地址。不过对于新手来说先把基础功能用熟再去折腾 skills 会更有成就感。注意Claude Code 在读取项目文件的时候会扫描当前目录下的内容。如果你的项目里有敏感信息比如密钥文件建议先把它加到忽略列表里避免被读取。4.2 Codex 的接入与模型选择Codex 装好之后你需要配置它使用哪个模型。默认情况下它会用官方推荐的模型。但很多人想把它接到 DeepSeek 或者其他模型上这就是“Codex 接入 DeepSeek”这个需求的来源。接入其他模型的方式通常是在配置文件里修改 API 端点。Codex 的配置文件一般在用户目录下的.codex文件夹里里面有一个config.json或者类似的配置文件。你需要把 API 地址改成对应提供商的地址然后把 API 密钥填进去。不过我要提醒一句不是所有模型都兼容 Codex 的接口格式。有些模型虽然提供了 API但请求和返回的格式跟 Codex 期望的不一样接进去之后会报错。我试过几个模型兼容性比较好的通常是那些明确支持 OpenAI 接口格式的。如果你不确定先去模型提供商的文档里看看它是否兼容 OpenAI 的 API 格式。4.3 OpenCode 的免费模型与 skillsOpenCode 最吸引人的地方就是它有免费模型可以用。启动 OpenCode 之后在模型选择里找到标有“free”的选项选中就能用。免费模型的响应速度可能比付费模型慢一些但对于日常的代码补全和简单问答来说完全够用。OpenCode 也有 skills 功能安装方式和 Claude Code 类似。你可以在 OpenCode 的配置里添加 skills 仓库然后它就会加载对应的技能。我装过几个常用的 skills比如代码审查、单元测试生成用起来挺方便的。实操心得OpenCode 的免费模型在高峰期可能会排队如果你发现响应特别慢可以换个时间段再试。另外免费模型的上下文长度通常比付费模型短处理大文件的时候要注意。4.4 Cursor 的核心功能与提示词技巧Cursor 的核心功能有三个代码补全、对话编辑、Agent 模式。代码补全就是你打字的时候它自动提示对话编辑是你选中一段代码然后按CtrlK输入指令它帮你改Agent 模式是你给它一个任务它自己规划步骤去完成。关于“Cursor 提示词泄露”这个话题网上讨论很多。其实所谓的泄露就是有人把 Cursor 内部用的提示词模板挖出来了。这些提示词主要是指导 AI 如何更好地完成编程任务比如“先理解需求再动手”“修改代码时要保持原有风格”之类的。你不需要刻意去记这些提示词但可以借鉴其中的思路给 Cursor 下指令的时候尽量把背景说清楚比如“这是一个 React 项目用的是 TypeScript帮我把这个组件的状态管理改成 useReducer”。Cursor 还有一个“Tab”功能就是智能补全。免费版有次数限制用完了会提示你升级。如果你觉得 Tab 补全很顺手可以考虑升级 Pro如果只是偶尔用免费版也够。5. 常见报错与排查那些让我抓狂的瞬间5.1 “cc switch local proxy failed while handling codex endpoint /responses”这个报错我遇到过好几次通常出现在你试图用一个代理工具在 Claude Code 和 Codex 之间切换的时候。报错的意思是本地代理在处理 Codex 的/responses端点时失败了。排查思路是这样的检查代理配置看看你的代理工具里Codex 的端点地址写对了没有。/responses这个路径是 Codex 的 API 路径如果写成了别的就会报这个错。检查端口占用本地代理通常会监听一个端口如果这个端口被别的程序占用了代理就起不来。你可以用netstat命令看一下端口占用情况。检查模型兼容性如果你把 Codex 的端点指向了一个不兼容的模型也会出现这个报错。确认你用的模型支持 Codex 的接口格式。注意这个报错很多时候是因为配置文件里有多余的空格或者换行符。我建议用 JSON 格式化工具检查一下配置文件确保格式正确。5.2 “error from provider (console): opencodes free tier can only be used from within opencode”这个报错的意思很明确你在 OpenCode 之外的地方用了它的免费额度。解决办法只有一个回到 OpenCode 里面去用。如果你确实需要在其他工具里用模型就去配置那个工具自己的模型而不是蹭 OpenCode 的免费额度。我理解很多人想省钱的心理但 OpenCode 的免费额度是它自己掏钱补贴的限制使用范围也合理。与其花时间找绕过的方法不如直接用它本身或者去找其他有免费额度的模型提供商。5.3 “get cursor pro for more agent usage, unlimited tab, and more”这是 Cursor 免费版的提示意思是你的 agent 使用次数或者 Tab 补全次数用完了。解决办法有两个等下一个周期重置或者升级 Pro。如果你不想升级可以调整使用习惯把 agent 用在最关键的任务上日常补全尽量自己写。我自己的做法是简单的代码补全自己动手复杂的重构或者调试才用 agent。5.4 Codex Windows 安装未完成这个问题前面提过这里再补充几个排查步骤确认 Python 版本python --version确保是 3.10 以上。确认 Git 已安装git --version。检查网络连接有些依赖需要从境外源下载网络不稳定会导致安装中断。尝试用管理员权限运行终端。如果还是不行去 Codex 的代码仓库提 issue附上你的系统版本和报错日志。5.5 常见问题速查表报错信息可能原因解决办法cc switch local proxy failed代理配置错误或端口占用检查端点地址和端口opencode free tier 限制在 OpenCode 外使用免费额度回到 OpenCode 内使用cursor pro 提示免费额度用完等待重置或升级codex 安装未完成依赖缺失或网络问题检查 Python、Git、网络claude code 命令找不到Node.js 版本过低升级到 Node.js 186. 我个人的使用体会和几个小建议折腾这几个工具的过程中我最大的感受是不要试图找到一个“完美”的工具而是找到适合当前任务的工具。Claude Code 适合深度参与项目Cursor 适合日常写代码OpenCode 适合想用免费模型的时候Codex 适合喜欢在编辑器里补全的开发者。它们之间不是替代关系而是互补关系。另外安装和配置阶段遇到报错是很正常的不要因为一个报错就放弃。大部分报错都有明确的提示信息你只要把报错信息复制出来搜一下通常都能找到解决方案。如果搜不到去对应的社区或者代码仓库提问附上你的系统信息和完整报错日志会更容易得到帮助。最后分享一个小技巧不管你用哪个工具都建议先在一个小项目上试手不要一上来就在主力项目上折腾。小项目出问题了容易恢复主力项目出问题了影响工作。等你在小项目上把工具用顺了再逐步迁移到日常工作中。这个 OpenResearch 笔记我还在持续更新后面如果遇到新的报错或者发现新的使用技巧我会继续补充进来。如果你也在用这几个工具欢迎交流你的经验和踩坑记录。 
长河君 · 2026/10/19 8:31:58 · 阅读 1.2k AI编程助手实战指南：Claude Code、Codex、OpenCode、Cursor安装配置与报错排查
1. 从一堆工具名里我看到了一个真实需求过去大半年我几乎把市面上主流的 AI 编程助手都折腾了一遍。Claude Code、Codex、OpenCode、Cursor这几个名字在圈子里出现的频率越来越高身边做开发的朋友也经常在群里甩一句“你那个配置怎么写的”“为什么我这边一直报错”。说实话刚开始我也踩了不少坑装完 Claude Code 发现终端里跑不起来Codex 在 Windows 上装到一半卡住OpenCode 提示免费额度只能在它自己的环境里用Cursor 打开全是英文找不到中文入口。这些问题单个看都不大但凑在一起就特别消耗精力。后来我干脆给自己定了个目标把这几个工具的安装、配置、使用、常见报错全部梳理一遍做成一个自己能随时查的“开放研究”笔记。这就是 OpenResearch 这个项目的由来。它不是一个具体的软件而是我围绕 Claude Code、Codex、OpenCode、Cursor 这几个主流 AI 编程工具做的一套从零上手到日常使用的完整实践记录。里面包含安装步骤、配置方法、中文设置、免费模型接入、报错排查以及我在实际写代码过程中总结出来的使用技巧。这篇文章适合谁看如果你是刚接触 AI 编程助手的新手想找一个能直接照着做的入门指南那这篇内容就是为你准备的。如果你已经用过其中一两个工具但被某个报错卡住或者想试试别的工具这里也有对应的排查思路和对比参考。我会尽量用大白话把每个环节讲清楚不堆术语不绕弯子让你看完就能动手操作。2. 四个工具到底怎么选先搞清楚它们各自擅长什么2.1 Claude Code、Codex、OpenCode、Cursor 的定位差异很多人一上来就问“哪个最好用”这个问题其实没有标准答案因为这几个工具的定位并不完全一样。我自己的理解是这样的Claude Code 更像是一个终端里的编程搭档。它跑在命令行里你可以直接让它读项目文件、改代码、跑测试。它的强项是理解整个项目结构适合那种“我想让它帮我重构一个模块”或者“帮我看看这个 bug 出在哪”的场景。安装方式主要是通过包管理器配置好之后在项目目录里直接调用。Codex 是另一条路线它更偏向代码补全和片段生成。你在编辑器里写代码它根据上下文给你补全建议。它的安装方式在不同系统上差异比较大Windows 上尤其容易遇到安装未完成的情况这个后面我会专门讲怎么处理。OpenCode 是一个开源的编程助手框架它的特点是你可以接入不同的模型提供商包括一些免费模型。它的免费额度有一个限制只能在 OpenCode 自己的环境里使用。如果你试图把它接到别的客户端上就会看到那个经典的报错“opencodes free tier can only be used from within opencode”。这个设计其实是为了防止滥用理解这一点之后你就知道该怎么正确使用它了。Cursor 则是一个完整的编辑器它基于 VS Code 做了深度定制把 AI 能力直接嵌到了编辑体验里。它的优势是上手门槛低界面友好适合不想折腾命令行的开发者。但它默认是英文界面很多人第一次打开就卡在“怎么设置中文”这一步。2.2 选型时我重点看哪几个维度我在选择用哪个工具的时候主要看四个维度安装难度、使用场景、费用成本、中文支持。安装难度上Cursor 最简单下载安装包双击就行Claude Code 需要先装 Node.js 环境然后用 npm 安装Codex 在 Windows 上最麻烦经常出现安装未完成的情况OpenCode 的安装相对灵活但配置模型接入需要一点耐心。使用场景上如果你习惯在终端里工作Claude Code 和 OpenCode 更顺手如果你喜欢在编辑器里写代码Cursor 和 Codex 更合适。我自己的习惯是大项目重构用 Claude Code日常写代码用 Cursor想试试免费模型的时候用 OpenCode。费用成本这块Cursor 有免费额度但用多了会提示“get cursor pro for more agent usage”意思是免费版的 agent 调用次数有限OpenCode 有免费模型可以用但限制在它自己的环境里Claude Code 和 Codex 通常需要你有对应的 API 额度或者订阅。中文支持方面Cursor 需要手动设置语言Claude Code 和 Codex 的界面本身是英文的但你可以用中文跟它对话。OpenCode 的界面也是英文为主不过社区里有中文配置的分享。2.3 一个简单的选择建议如果你是完全的新手我建议先从 Cursor 开始。它的界面最接近你熟悉的编辑器安装完设置成中文就能直接用了。等你对 AI 编程助手有了基本感觉再去试 Claude Code 或者 OpenCode会顺利很多。如果你已经有一定经验想找一个能深度参与项目开发的工具Claude Code 值得花时间配置。它的终端交互方式一开始可能不习惯但用顺了之后效率提升很明显。如果你对费用比较敏感想先用免费模型练手OpenCode 是个不错的选择。只要记住它的免费额度使用限制别想着把它接到别的客户端上就能避免很多不必要的报错。3. 安装环节的坑我踩过的和你怎么绕过去3.1 Claude Code 安装Node.js 版本是关键Claude Code 的安装本身不复杂官方推荐的方式是通过 npm 全局安装。但我在第一次装的时候遇到了一个问题终端里输入命令之后提示找不到这个命令。排查了半天发现是 Node.js 版本太旧了。Claude Code 对 Node.js 的版本有要求我实测下来Node.js 18 以上比较稳妥。你可以先在终端里跑node -v看一下当前版本。如果低于 18建议先升级 Node.js。升级的方式取决于你当初是怎么装的如果用 nvm 管理直接nvm install 18然后nvm use 18如果是官网下载的安装包就去官网下最新版覆盖安装。版本确认没问题之后安装命令是这样的npm install -g anthropic-ai/claude-code装完之后在终端里输入claude如果能看到欢迎信息说明安装成功了。如果提示权限问题Windows 上可以用管理员身份运行终端Mac 和 Linux 上可以在命令前面加sudo。注意不要用sudo去跑 Claude Code 本身只在安装的时候需要提权。日常使用直接用普通用户权限就行否则可能会遇到配置文件读写权限的问题。还有一个细节Claude Code 第一次运行的时候会引导你做一些初始配置比如选择模型、设置 API 密钥。如果你已经有对应的 API 额度按照提示填进去就行。如果没有可以先跳过后面在配置文件里补上。3.2 Codex 安装Windows 上的特殊处理Codex 在 Windows 上的安装是我遇到过最折腾的一个。官方提供的安装方式在 Mac 和 Linux 上比较顺畅但 Windows 上经常出现“安装未完成”的提示。我试了好几次最后总结出一套相对靠谱的流程。首先确保你的系统已经安装了Git for Windows和Python 3.10 以上。Codex 的某些依赖需要这两个环境。然后不要直接用官网的安装包而是通过包管理器来装。Windows 上我推荐用winget或者scoop。用 winget 的话命令是这样的winget install Codex如果 winget 里找不到可以试试 scoop。先安装 scoop然后scoop install codex装完之后在终端里输入codex --version如果能正常显示版本号说明安装成功了。如果还是提示找不到命令检查一下环境变量里有没有把 Codex 的安装路径加进去。实操心得Windows 上安装这类开发工具最容易出问题的就是环境变量和权限。我的习惯是装完之后重启一次终端让环境变量生效。如果还不行就手动去系统设置里把安装路径加到 PATH 里。另外Codex 的官网下载页面有时候会更新不及时如果你从官网下载的安装包装不上直接去它的代码仓库看最新的安装说明通常会有更详细的系统要求说明。3.3 OpenCode 安装注意免费额度的使用边界OpenCode 的安装方式比较灵活它支持多种安装途径。我试过用 npm 装也试过直接下载二进制文件。npm 的方式最简单npm install -g opencode装完之后运行opencode就能启动。但这里有一个非常重要的点OpenCode 的免费额度只能在 OpenCode 自己的环境里使用。什么意思呢就是你不能把 OpenCode 的免费模型配置到 Claude Code 或者别的客户端里去用。如果你这么做了就会看到那个报错“opencodes free tier can only be used from within opencode”。这个限制是 OpenCode 官方设定的目的是防止免费资源被滥用。所以正确的用法就是想用免费模型就在 OpenCode 里面用想用别的工具就去配置别的工具自己的模型。注意网上有一些教程教你如何把 OpenCode 的免费模型“导出”到其他工具里这些方法大多已经失效了而且违反使用条款。我建议不要在这上面浪费时间直接用 OpenCode 本身就好。OpenCode 还有一个“归档”功能用完之后项目会归档。有人问“opencode 归档后去哪了”其实归档就是把项目状态保存下来下次可以继续。归档文件默认放在用户目录下的.opencode文件夹里你可以去那里找。3.4 Cursor 安装与中文设置两步搞定Cursor 的安装是这几个里面最简单的。去官网下载对应系统的安装包双击安装一路下一步就行。装完之后打开你会看到一个类似 VS Code 的界面但全是英文。设置中文的步骤很简单按CtrlShiftPMac 上是CmdShiftP打开命令面板。输入Configure Display Language回车。在弹出的列表里选择中文简体。重启 Cursor。重启之后界面就变成中文了。如果列表里没有中文选项可以点击“安装其他语言”然后搜索“Chinese”安装语言包。实操心得Cursor 的语言设置和 VS Code 是一样的如果你之前用过 VS Code这一步会非常熟悉。另外Cursor 的免费版有 agent 使用次数限制用多了会提示你升级 Pro。如果你只是轻度使用免费版基本够用如果每天都用可以考虑升级。4. 配置与使用让工具真正跑起来4.1 Claude Code 的日常使用方式Claude Code 装好之后用法其实很直接。进入你的项目目录在终端里输入claude它就启动了。然后你可以用自然语言跟它交流比如“帮我看看这个文件里有没有明显的 bug”或者“把这个函数重构成更简洁的写法”。我常用的几个操作场景读代码直接问它“这个项目的入口文件在哪”它会帮你找。改代码告诉它“把这段逻辑改成异步的”它会给出修改建议你确认后它直接改文件。跑测试让它“运行一下测试看看有没有问题”它会执行测试命令并告诉你结果。Claude Code 还有一个“skills”的概念你可以理解为预置的技能包。安装 skills 的方式是在配置文件里添加对应的仓库地址。不过对于新手来说先把基础功能用熟再去折腾 skills 会更有成就感。注意Claude Code 在读取项目文件的时候会扫描当前目录下的内容。如果你的项目里有敏感信息比如密钥文件建议先把它加到忽略列表里避免被读取。4.2 Codex 的接入与模型选择Codex 装好之后你需要配置它使用哪个模型。默认情况下它会用官方推荐的模型。但很多人想把它接到 DeepSeek 或者其他模型上这就是“Codex 接入 DeepSeek”这个需求的来源。接入其他模型的方式通常是在配置文件里修改 API 端点。Codex 的配置文件一般在用户目录下的.codex文件夹里里面有一个config.json或者类似的配置文件。你需要把 API 地址改成对应提供商的地址然后把 API 密钥填进去。不过我要提醒一句不是所有模型都兼容 Codex 的接口格式。有些模型虽然提供了 API但请求和返回的格式跟 Codex 期望的不一样接进去之后会报错。我试过几个模型兼容性比较好的通常是那些明确支持 OpenAI 接口格式的。如果你不确定先去模型提供商的文档里看看它是否兼容 OpenAI 的 API 格式。4.3 OpenCode 的免费模型与 skillsOpenCode 最吸引人的地方就是它有免费模型可以用。启动 OpenCode 之后在模型选择里找到标有“free”的选项选中就能用。免费模型的响应速度可能比付费模型慢一些但对于日常的代码补全和简单问答来说完全够用。OpenCode 也有 skills 功能安装方式和 Claude Code 类似。你可以在 OpenCode 的配置里添加 skills 仓库然后它就会加载对应的技能。我装过几个常用的 skills比如代码审查、单元测试生成用起来挺方便的。实操心得OpenCode 的免费模型在高峰期可能会排队如果你发现响应特别慢可以换个时间段再试。另外免费模型的上下文长度通常比付费模型短处理大文件的时候要注意。4.4 Cursor 的核心功能与提示词技巧Cursor 的核心功能有三个代码补全、对话编辑、Agent 模式。代码补全就是你打字的时候它自动提示对话编辑是你选中一段代码然后按CtrlK输入指令它帮你改Agent 模式是你给它一个任务它自己规划步骤去完成。关于“Cursor 提示词泄露”这个话题网上讨论很多。其实所谓的泄露就是有人把 Cursor 内部用的提示词模板挖出来了。这些提示词主要是指导 AI 如何更好地完成编程任务比如“先理解需求再动手”“修改代码时要保持原有风格”之类的。你不需要刻意去记这些提示词但可以借鉴其中的思路给 Cursor 下指令的时候尽量把背景说清楚比如“这是一个 React 项目用的是 TypeScript帮我把这个组件的状态管理改成 useReducer”。Cursor 还有一个“Tab”功能就是智能补全。免费版有次数限制用完了会提示你升级。如果你觉得 Tab 补全很顺手可以考虑升级 Pro如果只是偶尔用免费版也够。5. 常见报错与排查那些让我抓狂的瞬间5.1 “cc switch local proxy failed while handling codex endpoint /responses”这个报错我遇到过好几次通常出现在你试图用一个代理工具在 Claude Code 和 Codex 之间切换的时候。报错的意思是本地代理在处理 Codex 的/responses端点时失败了。排查思路是这样的检查代理配置看看你的代理工具里Codex 的端点地址写对了没有。/responses这个路径是 Codex 的 API 路径如果写成了别的就会报这个错。检查端口占用本地代理通常会监听一个端口如果这个端口被别的程序占用了代理就起不来。你可以用netstat命令看一下端口占用情况。检查模型兼容性如果你把 Codex 的端点指向了一个不兼容的模型也会出现这个报错。确认你用的模型支持 Codex 的接口格式。注意这个报错很多时候是因为配置文件里有多余的空格或者换行符。我建议用 JSON 格式化工具检查一下配置文件确保格式正确。5.2 “error from provider (console): opencodes free tier can only be used from within opencode”这个报错的意思很明确你在 OpenCode 之外的地方用了它的免费额度。解决办法只有一个回到 OpenCode 里面去用。如果你确实需要在其他工具里用模型就去配置那个工具自己的模型而不是蹭 OpenCode 的免费额度。我理解很多人想省钱的心理但 OpenCode 的免费额度是它自己掏钱补贴的限制使用范围也合理。与其花时间找绕过的方法不如直接用它本身或者去找其他有免费额度的模型提供商。5.3 “get cursor pro for more agent usage, unlimited tab, and more”这是 Cursor 免费版的提示意思是你的 agent 使用次数或者 Tab 补全次数用完了。解决办法有两个等下一个周期重置或者升级 Pro。如果你不想升级可以调整使用习惯把 agent 用在最关键的任务上日常补全尽量自己写。我自己的做法是简单的代码补全自己动手复杂的重构或者调试才用 agent。5.4 Codex Windows 安装未完成这个问题前面提过这里再补充几个排查步骤确认 Python 版本python --version确保是 3.10 以上。确认 Git 已安装git --version。检查网络连接有些依赖需要从境外源下载网络不稳定会导致安装中断。尝试用管理员权限运行终端。如果还是不行去 Codex 的代码仓库提 issue附上你的系统版本和报错日志。5.5 常见问题速查表报错信息可能原因解决办法cc switch local proxy failed代理配置错误或端口占用检查端点地址和端口opencode free tier 限制在 OpenCode 外使用免费额度回到 OpenCode 内使用cursor pro 提示免费额度用完等待重置或升级codex 安装未完成依赖缺失或网络问题检查 Python、Git、网络claude code 命令找不到Node.js 版本过低升级到 Node.js 186. 我个人的使用体会和几个小建议折腾这几个工具的过程中我最大的感受是不要试图找到一个“完美”的工具而是找到适合当前任务的工具。Claude Code 适合深度参与项目Cursor 适合日常写代码OpenCode 适合想用免费模型的时候Codex 适合喜欢在编辑器里补全的开发者。它们之间不是替代关系而是互补关系。另外安装和配置阶段遇到报错是很正常的不要因为一个报错就放弃。大部分报错都有明确的提示信息你只要把报错信息复制出来搜一下通常都能找到解决方案。如果搜不到去对应的社区或者代码仓库提问附上你的系统信息和完整报错日志会更容易得到帮助。最后分享一个小技巧不管你用哪个工具都建议先在一个小项目上试手不要一上来就在主力项目上折腾。小项目出问题了容易恢复主力项目出问题了影响工作。等你在小项目上把工具用顺了再逐步迁移到日常工作中。这个 OpenResearch 笔记我还在持续更新后面如果遇到新的报错或者发现新的使用技巧我会继续补充进来。如果你也在用这几个工具欢迎交流你的经验和踩坑记录。