1024超能Coding周末参赛指南：toklens 兑换码使用、创建 Key 与 Codex 一键配置

兑换、创建 Key、在活动页一键配置 Codex，四步约 10 分钟，每一步有截图。

2026-10-18更新于 2026-10-23活动约 12 分钟读完TokLens Team

WaytoAGI 1024超能Coding周末 × toklens：赛博绿像素风头图，复古电视机里的像素小鹿

参加 WaytoAGI「1024超能Coding周末」（10月24日-25日，全程线上）的选手，拿到 toklens 兑换码后，按四步就能用上：在 toklens.ai 注册并验证邮箱，在「活动」页兑换，一键创建「waytoagi 黑客松」Key（额度已经分配进去），再在活动页的「接入指引」里一键配置 Codex。

每位参赛选手的额度折合约 1000 元人民币，兑换后 3 天内有效，到期没用完的部分作废。整个过程大约 10 分钟，每一步都配了截图。

本文步骤适用于 toklens 接入工具 @toklens/agentic-setup 0.1.4，2026 年 10 月核对。

01 你会拿到什么

额度规则：3 天有效、先扣活动额度再扣钱包余额、不可提现退款转让

一份算力：折合约 1000 元人民币，所有参赛选手同样一份。
一个专属 Key：名为「waytoagi 黑客松」，兑换后一键创建，算力已经放进去，不用自己分配。
有效期 3 天：从你兑换那一刻开始算。想把算力用在周末的比赛里，建议比赛前一两天再兑换。
规则很简单：先扣这份算力，再扣钱包余额；不能提现、不能退款、不能转让。

💡 页面上的额度显示的是美元。顶部的大字是你这份算力折算后的可用额度，下面那行小字会写清楚实际到账额度和折算关系，两个数字都不用担心，对得上。

02 四步，拿到你的专属 Key

四步拿到专属 Key：注册并验证邮箱、活动页兑换、创建 GPT 分组 Key、接入 Codex

第 1 步：注册 toklens，并验证邮箱

用浏览器打开 toklens.ai，点右上角「我的」，进入登录页。
切到「注册」标签。
填邮箱，点「发送 toklens.ai 验证码」，到邮箱里查收 6 位验证码。
把验证码和你设置的密码（至少 8 位）填进去，完成页面上的人机验证，点「注册」。

toklens 注册页：邮箱、验证码、密码三项

⚠️ 兑换算力前，必须先完成邮箱验证。没验证的账号兑换时会提示"请先完成注册并验证邮箱，再兑换礼品卡。"

第 2 步：进入「活动」页

登录后，左边侧栏里「钱包」的下面，就是「活动」。点进去。

第一次进来，顶部的「活动额度」是 US$0.00。这是正常的，等你兑换后，这里会换成你领到的额度。

toklens「活动」页：兑换前活动额度为 US$0.00，下面是兑换框

第 3 步：输入兑换码，兑换算力

在「兑换活动礼品卡」里，输入你在活动群里拿到的兑换码，点「兑换」。

toklens「活动」页：在兑换框输入兑换码（图中为示例码）

兑换成功后，页面顶部会立刻换成这次活动的信息：

WaytoAGI 的 Logo 和活动名称；
你领到的额度（大字）；
到期时间；
实际到账额度和折算说明。

toklens「活动」页：兑换成功后顶部显示 US$150.00 的活动额度和到期时间

每个账号，同一个活动只能兑换一张。码输错了、被用过了，页面都会直接提示原因，不会扣任何东西。

第 4 步：点一下，创建你的 Key

同一页往下，有一块「创建 Key」，点「创建 GPT 分组 Key」。

系统会为你创建一个名为「waytoagi 黑客松」的 Key，并且自动把刚兑换的算力放进这个 Key。不用选服务，不用手动分配，创建完就能用。

toklens「活动」页：已创建「waytoagi 黑客松」Key，显示 Key、接入地址和 Key 余额

创建完成后，页面会显示三样东西：

项目	说明
API Key	以 `sk-` 开头的一长串字符。图里做了遮挡，你看到的是完整的
接入地址（Base URL）	`https://lax.toklens.ai/v1`，自己写代码或接其他工具时用；一键配置和 Zenwork 不需要
Key 余额	这个 Key 现在能用的额度

⚠️ 活动页只在创建这一刻显示完整 Key。 请马上点「复制」，保存到你的密码管理器或本地笔记里。不要发给别人，不要写进公开的代码仓库，不要截图发到群里。

万一忘了保存，不要删掉重建（删掉的 Key 里的额度不会退回）。到左侧「API Key」页，点这个 Key 那一行右边的「…」，选「显示 Key」，就能再看到完整的 Key。

如果提示"Key 已生成，但额度还没分配成功"，别慌，点下面的「重试分配额度」就行。它只会补分配，不会多建 Key，也不会重复扣。这个按钮只在创建后的当前页面出现；如果已经刷新了页面，到「API Key」页给这个 Key 点「分配余额」。

想随时看余额？ 左侧「API Key」页，可以看到这个 Key 的名称、余额和状态。余额不够时，也可以在这里继续分配。

toklens「API Key」页：Key 的名称、服务、余额和「分配余额」按钮

03 拿到 Key 之后，怎么用

你有四种用法，选最顺手的一种。

你想用	推荐方式
在终端里用 Codex（Mac / Windows / Linux）	方式 A：活动页「接入指引」一键配置（最省事）
用 Codex App	方式 B：把配置文件放进 Codex 的配置目录
自己写代码 / 其他工具 / 别的 SDK	方式 C：Base URL + Key，OpenAI 兼容接口
用 Zenwork	方式 D：用 toklens 账号授权登录

方式 A：在活动页一键配置 Codex CLI（推荐）

toklens「活动」页「接入指引」：Codex CLI 一键配置，可选 macOS / Linux 或 Windows

活动页「创建 Key」下面有一块「接入指引」。

在「Codex CLI（一键配置）」里，选你的系统：「macOS / Linux」或「Windows」。
点「生成并复制命令」。命令会自动复制好，里面已经带上你的活动 Key，不需要再粘贴 Key。
打开终端，粘贴并回车：

Mac：打开「终端」（启动台里搜 Terminal）；
Windows：按 Win 键搜「PowerShell」打开（命令提示符、Windows Terminal 也可以），不需要以管理员身份运行。

等它跑完，网络慢时安装要几分钟。它会依次：

电脑上没有 Node.js 20.9 以上版本时，先从 nodejs.org 下载安装（会校验文件，不需要管理员权限，也不需要 Homebrew 或 git）；
安装 Codex 和 toklens 配置工具 @toklens/agentic-setup；
用你的活动 Key 单独配好一份 Codex 配置，模型由活动页按这个服务自动选好；
装好启动命令 codex-toklens；
自动打开 Codex。

看到「Codex 已接入 TokLens」，Codex 也打开了，就配好了。随便问一句，再到 toklens 的「用量明细」，可以看到这次调用的模型和扣费。

🔒 命令里带着你的活动 Key（页面上显示时已打码）。只在自己的电脑上运行，不要发到群里，也不要发给别人。

它只在你电脑的 ~/.toklens 目录里放配置，不会改动你原来的 ~/.codex，你原来用 ChatGPT 登录的 Codex 照常可用。

以后怎么用

打开新的终端，输入：

codex-toklens

就会用活动额度启动 Codex。直接输入 codex，读的还是你原来的配置。在 Codex 里输入 /model 可以切换模型。

它到底帮你配了什么

配置放在这个目录里（Windows 上是 %USERPROFILE%\.toklens\profiles\activity-waytoagi\codex）：

~/.toklens/profiles/activity-waytoagi/codex/config.toml
~/.toklens/profiles/activity-waytoagi/codex/auth.json

config.toml 大致是这样的（base_url 是你这个 Key 所属服务的地址，工具会自动填好）：

model_provider = "toklens"
model = "<活动页自动选的模型>"

[model_providers.toklens]
name = "toklens"
base_url = "https://lax.toklens.ai"
wire_api = "responses"
requires_openai_auth = true

auth.json 里就是你的 Key。在 Mac 和 Linux 上，这两个文件和 ~/.toklens/secrets/ 里的密钥文件权限都是 600，只有你自己的账户能读。

⚠️ 这些文件里有你的 Key，和密码一样重要，不要提交到 Git，也不要发给别人。

想再确认一遍配置有没有问题，可以运行：

toklens-agentic doctor --client openai_codex --profile activity-waytoagi

看到 doctor ok，就一切正常。

常见小问题

命令跑到一半失败了？ 多半是网络慢，下载 Node.js 或安装 Codex 超时。回到活动页重新点「生成并复制命令」，再运行一次就行。
Windows 上输入 codex-toklens 提示找不到？ 关掉这个窗口，重新打开一个 PowerShell 再试，新装的命令要在新窗口里才生效。
想看版本，或升级工具？ toklens-agentic --version 看版本，npm install -g @toklens/agentic-setup@latest 升级。
想用 Claude Code、OpenCode，或者换别的 Key？ 用左侧栏的「接入工具」，选好 Key 和工具生成命令。

方式 B：用 Codex App

Codex App 读取的是你电脑上 ~/.codex 目录里的配置。toklens 为你生成的配置文件在另一个目录，所以多一步：把它们放过去。

先按「方式 A」运行一遍一键配置命令，让 toklens 生成配置（Codex 打开后可以直接退出）。
先备份你原来的 Codex 配置，避免弄丢：

   cp -r ~/.codex ~/.codex.backup

把 toklens 生成的两个文件，复制到 Codex 的配置目录：

   cp ~/.toklens/profiles/activity-waytoagi/codex/config.toml ~/.codex/config.toml
   cp ~/.toklens/profiles/activity-waytoagi/codex/auth.json   ~/.codex/auth.json

重启 Codex App，发一条消息试试。
比赛结束，想换回原来的账号？把备份放回去：

   rm -rf ~/.codex && mv ~/.codex.backup ~/.codex

⚠️ auth.json 里就是你的 Key，和密码一样重要，不要提交到 Git，也不要发给别人。

方式 C：自己写代码 / 其他工具

toklens 的接口是 OpenAI 兼容的。任何支持自定义 Base URL 的工具或 SDK，改两个地方就能用：

要改的	填什么
Base URL	`https://lax.toklens.ai/v1`
API Key	你刚创建的 Key

先看看这个 Key 能用哪些模型（<你的 Key> 换成真实的 Key）：

curl https://lax.toklens.ai/v1/models \
  -H "Authorization: Bearer <你的 Key>"

从返回的列表里选一个 Codex 模型，发出第一次调用：

from openai import OpenAI

client = OpenAI(
    base_url="https://lax.toklens.ai/v1",
    api_key="<你的 Key>",
)

resp = client.chat.completions.create(
    model="<模型名>",  # 换成上一步列表里的 Codex 模型
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

Chat Completions、Responses、Anthropic Messages 三种接口都支持，用哪个看你的工具习惯。

更完整的写法见 toklens 手册：toklens.ai/zh/manual（「接入 Codex 和 Claude Code」「接入方式」两节最常用）。

方式 D：用 Zenwork

Zenwork 用 toklens 账号授权登录（OAuth），不需要复制 Key 或接入地址。

打开 Zenwork，在登录方式里选「TokLens」。
浏览器会打开 toklens 的授权页，确认登录的是领取活动的这个账号。用 Zenwork 命令行时，终端里会显示一个设备代码，按提示在 toklens 页面输入即可。
在「调用模型使用的 Key」里选「使用已有 Key」，再选「waytoagi 黑客松」。不要选「新建专用 Key」，新建的 Key 里没有活动额度。
点「授权」，回到 Zenwork 就能用了。

登录过的 Zenwork 会出现在左侧「已登录的工具」里，可以随时撤销。详见 Zenwork 接入 TokLens：用 TokLens 账号授权登录。

04 常见问题

提示"这个礼品码已经被用过了"？

每张码只能兑换一次。先确认没有输错，还不行就在活动群里联系工作人员换一张。

提示"请先完成注册并验证邮箱"？

去邮箱完成验证，再回来兑换。

页面顶部的额度是 0？

没兑换之前是 0，这是正常的。兑换成功后会变成你领到的额度。

Key 创建了，但余额是 0？

刚创建完、还没刷新页面时，点活动页上的「重试分配额度」补分配。已经刷新过页面的，到「API Key」页给这个 Key 点「分配余额」。

Key 忘了复制，找不到了？

到「API Key」页，点这个 Key 那一行右边的「…」，选「显示 Key」。不要删掉重建，删掉的 Key 里的额度不会退回。

调用报 429？

多半是这个 Key 的余额花完了，到「API Key」页看一下余额。也可能是请求太快，等一会儿再试。

调用报 401 或 403？

401 是没带上 Key 或 Key 无效，多半是复制漏了字符；403 是 Key 已过期或被停用，或者这个服务不支持你调用的接口或模型。先对照上面的表检查 Key 和 Base URL，再用 /v1/models 确认模型名。

一键配置命令跑到一半失败了？

回到活动页，重新点「生成并复制命令」再运行一次。如果是在「接入工具」页生成的命令，它 15 分钟内有效、只能用一次，刷新页面会生成新的。

可以把 Key 发给队友一起用吗？

不建议。Key 是调用模型的凭证，拿到它的人可以花掉你的算力，发出去等于把额度交给了别人。

3 天的有效期是怎么算的？

从你兑换那一刻开始算，页面顶部会显示到期时间。到期后，没用完的部分作废，已经放进 Key 但没用掉的，也会收回。

05 和赛道的关系

短剧、游戏、OPC 赛道：不限工具，toklens 的算力随便用。
用餐、办公、侦探赛道：想冲赛道前三，建议用对应赞助方的工具。但 toklens 的算力，照样可以给你的项目提供模型能力，用它做出来的作品，一样参加本地前三、人气奖和 1024 超能大奖。

06 请注意

toklens 由 TokenRush, Inc. 运营，与各模型厂商没有隶属关系。每个模型只在其厂商支持的国家和地区提供。 如果你所在的地区不在某个厂商的支持范围内，请不要使用该厂商的模型，也不要用 toklens 绕过地区或账号限制。详见 toklens.ai/zh/compliance/supported-regions。