1. 这个邀请活动到底是怎么回事
先把结论摆在前面：opencode Go 这个邀请活动，本质上是官方为了拉新做的一次双向激励——你通过自己的专属分享链接邀请别人注册并登录桌面端，对方拿到 $5 的额度，你自己也能拿到 $5。听起来像是那种"拉人头"的老套路，但实测下来它的到账逻辑、使用范围、以及和免费额度的关系，跟一般的推广活动还真不太一样，值得单独拿出来聊一聊。
我自己是从去年底开始把 opencode 当成日常主力 AI 编程工具之一的，中间踩过不少坑，也帮身边几个朋友配过环境。这次邀请活动出来之后，我第一时间试了一遍完整流程，从生成链接、对方注册、登录桌面端、到双方额度到账，全程记录了下来。这篇文章就把整个链路拆开讲清楚：活动机制是什么、为什么这么设计、怎么操作才能确保双方都拿到钱、以及那些官方文档里不会写的坑。
适合谁看？三类人。第一类是完全没用过 opencode、想借着这个活动低成本试水的开发者；第二类是已经在用、想顺手薅一波额度补贴自己日常 token 消耗的老用户；第三类是单纯对 AI 编程工具的推广机制感兴趣、想研究一下这类产品怎么做增长的技术人。不管你是哪一类，只要跟着下面的步骤走，基本不会翻车。
需要提前说明的是，opencode 本身是一个终端优先的 AI 编程助手，支持多种模型接入，有 CLI 版本也有桌面端。它的免费额度有个限制——只能在 opencode 自己的环境里用，不能随便接到别的客户端上。这个限制后面会详细讲，因为它直接关系到你邀请来的朋友能不能顺利把 $5 花出去。
2. 活动机制拆解：为什么是"双方各拿 $5"
2.1 双向激励背后的产品逻辑
很多工具的邀请活动是单向的，邀请人拿奖励，被邀请人啥也没有，或者只给个"首月折扣"。opencode Go 这次做成双向，其实是有讲究的。
从产品角度看，AI 编程工具的核心成本在推理算力，也就是 token 消耗。一个新用户注册进来，如果没有任何额度，他大概率会先观望，不会真的把工具接进自己的工作流。而一旦给了他 $5 的可用额度，哪怕只是几十万 token，也足够他跑完几个真实的小项目，形成使用习惯。这 $5 对官方来说是获客成本，对被邀请人来说是零门槛试用券，对邀请人来说是持续使用的补贴——三方都划算。
从技术角度看，$5 这个数字也不是随便定的。按目前主流模型的定价，$5 大概能覆盖一个中等规模项目的日常问答量，比如你让 AI 帮你重构一个几百行的模块、写一批单元测试、或者排查几个编译错误，基本够用一两周。它不足以让你无限白嫖，但足够让你判断这个工具到底适不适合自己。
2.2 额度到账的触发条件
这里是最容易踩坑的地方。很多人以为"对方点了我链接注册"就算成功，其实不是。根据我实测，完整的触发链路是这样的：
- 你生成专属分享链接
- 对方通过这个链接完成注册
- 对方下载并登录桌面端（注意，是桌面端，不是网页版，也不是纯 CLI）
- 系统确认这个账号是"有效新用户"
- 双方额度到账
第三步是卡人的关键。我有个朋友注册完只用了网页版，等了三天额度都没到，后来登录了一次桌面端，当天就到账了。所以如果你邀请别人，一定要提醒对方：注册完记得装桌面端并登录一次。
提示：桌面端登录这个动作，官方没有在活动页面上用大字标出来，但它是风控判断"真实用户"的重要依据。纯网页注册的账号，系统会默认风险较高，可能延迟发放甚至不发。
2.3 $5 额度的使用范围
到账的 $5 不是现金，是平台内的额度，只能用于调用 opencode 支持的模型。这里有个细节要注意：opencode 的免费额度和付费额度在使用范围上是有区别的。
| 额度类型 | 可用范围 | 是否可接第三方客户端 |
|---|---|---|
| 免费 tier | 仅限 opencode 自身环境 | 否 |
| 邀请奖励 $5 | 同付费额度 | 视配置而定 |
| 自充值额度 | 全范围 | 是 |
我实测下来，邀请奖励的 $5 到账后，是走付费额度通道的，也就是说它比免费 tier 灵活一些。但如果你想把额度接到别的编辑器里用，还是得看你的具体配置方式，这块后面会讲。
3. 完整实操流程：从生成链接到双方到账
3.1 前置准备：账号和环境
在开始邀请之前，你自己得先有一个正常使用的 opencode 账号，而且最好是已经登录过桌面端的。原因很简单：一个从没登录过桌面端的账号去邀请别人，系统大概率会判定为异常，奖励可能不发。
我建议的前置检查清单：
- 账号已注册且邮箱已验证
- 桌面端已安装并至少登录过一次
- 账号没有历史违规记录（比如滥用免费额度）
- 网络环境稳定，不要频繁切换
关于安装，opencode 的桌面端支持主流操作系统。如果你之前只用过 CLI 版本，建议这次专门装一下桌面端，因为邀请活动的判定和桌面端强绑定。
3.2 生成你的专属分享链接
登录之后，在账号设置或者活动页面里能找到"邀请"入口。点进去会生成一个带你用户标识的链接。这个链接就是你后面要发给朋友的。
这里有个小技巧：链接生成后，先自己用无痕窗口点一次，看看落地页是否正常加载、注册按钮是否可用。我遇到过链接生成后落地页 404 的情况，原因是账号状态没同步，退出重登一次就好了。自己先验证一遍，能避免朋友点进去一脸懵。
3.3 对方注册与登录桌面端
把链接发给朋友后，让对方按这个顺序操作：
- 点击链接进入注册页
- 用邮箱完成注册（建议用常用邮箱，别用临时邮箱，风控会拦）
- 下载桌面端安装包
- 安装并登录
- 确认账号状态正常
第五步怎么确认？让对方打开桌面端，看看能不能正常发起对话。如果一进去就报错，比如提示免费额度只能在 opencode 内使用之类的信息，说明账号环境有问题，需要先解决再等奖励。
我朋友当时遇到过一个报错，大意是"free tier can only be used from within opencode"，他以为是账号被封了，其实是因为他之前用某个第三方客户端尝试接入，触发了限制。解决办法很简单：卸载第三方配置，只用官方桌面端登录一次，报错就消失了。
3.4 额度到账的确认与查询
双方额度到账的时间不固定，我实测最快的是对方登录桌面端后 10 分钟左右就到账，慢的等了大半天。查询位置在账号的额度或账单页面。
到账后你会看到一笔单独的记录，标注为邀请奖励之类的字样。如果超过 24 小时还没到，可以走客服渠道反馈，但反馈前先自查这几点：
- 对方是否真的登录了桌面端
- 对方账号是否是全新注册（老账号换链接不算）
- 你的账号本身是否状态正常
- 有没有在同一网络环境下批量注册的嫌疑
注意：同一台设备、同一个网络下短时间内注册多个账号去互相邀请，很容易被风控识别。我见过有人用虚拟机批量操作，结果双方额度全部被回收。老老实实一个真实用户一个账号，最稳。
4. 那些官方不会告诉你的坑
4.1 免费额度和奖励额度的优先级
这是个很隐蔽的坑。当你同时拥有免费额度和邀请奖励额度时，系统扣费是有优先级的。我实测下来，它会先扣免费额度，再扣奖励额度。这意味着什么？意味着如果你的免费额度还没用完，你的 $5 奖励其实一直躺在那里没动。
这本身不是坏事，但如果你想让奖励额度用在更重要的地方，就得注意免费额度的消耗节奏。另外，免费额度有使用范围限制，一旦你触发了"只能在 opencode 内使用"的限制，可能会影响你对整体额度的判断。
4.2 桌面端登录失败的常见原因
我帮朋友排查过好几次桌面端登录问题，总结下来主要是这几类：
| 现象 | 可能原因 | 解决方向 |
|---|---|---|
| 登录后一直转圈 | 网络到认证服务不通 | 检查网络，换时段重试 |
| 提示 session 相关错误 | 本地缓存损坏 | 清除配置目录后重登 |
| 报 provider console 错误 | 账号被限制在特定环境 | 只用官方桌面端，移除第三方配置 |
| 登录成功但无额度 | 奖励未触发或延迟 | 等待并自查触发条件 |
其中"session 相关错误"这个，报错信息里经常带一串 JSON，看着吓人，其实多半是本地状态文件坏了。找到配置目录删掉重登，基本能解决。
4.3 关于"只能本地访问"的限制
有段时间社区里讨论比较多的是 opencode 的 web 服务只能本地访问，局域网内其他设备连不上。这个和邀请活动没直接关系，但会影响你把工具分享给团队使用的体验。如果你确实需要局域网访问，得改配置里的监听地址，把默认的 localhost 改成 0.0.0.0，同时注意防火墙放行。
不过要提醒一句：改成 0.0.0.0 之后，任何能访问你网络的设备都能连上，安全性会下降。如果只是自己用，保持默认最省心。
4.4 邀请链接被滥用的风险
最后说个严肃的。邀请活动最怕的就是被薅羊毛党盯上。如果你发现自己的链接突然带来大量注册，但这些人根本不是真实开发者，那你的账号很可能被牵连。官方的风控不是吃素的，一旦判定异常，轻则回收奖励，重则封号。
所以我的建议是：只把链接发给真正会用这个工具的人。朋友、同事、技术群里的活跃开发者，这些都没问题。别为了多拿几份 $5 去各种薅羊毛渠道发链接，得不偿失。
5. 常见问题速查与排查思路
5.1 额度没到账怎么办
按这个顺序排查：
- 确认对方是通过你的链接注册的，而不是自己搜到官网注册的
- 确认对方登录过桌面端
- 确认对方是全新账号
- 确认你自己的账号状态正常
- 等待 24 小时
- 以上都满足还没到，联系客服并提供双方账号信息
我遇到过最离谱的一次，是朋友点链接后中途换了浏览器，结果注册流程没带上邀请标识，等于白注册。所以提醒对方：点链接后一口气走完注册，别中途跳来跳去。
5.2 奖励额度能不能提现或转移
不能。$5 是平台内额度，只能用于消费模型调用，不能提现，也不能转给别的账号。这点在活动规则里写得很清楚，别抱幻想。
5.3 一个账号能邀请多少人
官方没有明确写上限，但从风控逻辑看，短时间内邀请大量用户肯定会触发审核。我的经验是，正常社交范围内邀请几个到十几个没问题，再多就要小心了。
5.4 奖励额度会过期吗
会。具体有效期以活动规则为准，我建议到账后尽快用掉，别囤着。AI 工具的额度不像话费，囤着没有增值空间，反而可能过期作废。
5.5 桌面端和 CLI 版本的关系
很多人搞不清这两个。简单说，桌面端是带图形界面的完整客户端，CLI 是终端里用的命令行版本。邀请活动的判定和桌面端绑定，但日常使用你完全可以用 CLI。两者账号是通的，登录一次桌面端激活奖励后，CLI 里也能看到额度。
6. 我个人的使用体会
折腾这一圈下来，我对 opencode Go 这个邀请活动的评价是：机制设计得挺聪明，但执行细节上对普通用户不够友好。双向 $5 的激励确实有吸引力，可"必须登录桌面端"这个隐藏条件，如果不提前知道，很容易让人以为活动是骗人的。
我自己的做法是，把整个流程整理成一段话发给朋友，让他们照着做，成功率明显提高。具体话术大概是：点我链接注册，注册完装桌面端登录一次，然后等额度到账，到账后告诉我一声。就这么简单几句，比让他们自己摸索强多了。
另外一个小技巧：如果你自己就是被邀请方，注册时尽量用和邀请人不同的网络环境，避免被误判为同人多账号。这不是教你作弊，而是避免正常操作被风控误伤。
至于这个活动值不值得参与，我的看法是：如果你本来就在用 opencode，顺手邀请几个真实的朋友，双方都拿 $5，何乐而不为。但如果你是为了薅额度专门去拉人头，那还是算了，风控这一关过不去，账号搭进去不值当。工具本身好不好用，才是决定你留不留下来的关键，$5 只是个让你愿意迈出第一步的理由。
