Codex 桌面版新手教程

一、安装 Codex 桌面版

不用装 Node.js、不用敲命令，直接装桌面版。

1. 1. 打开电脑上的 微软商店（Microsoft Store），搜索框输入 Codex（认准 OpenAI 出品）。
2. 2. 点 「下载 / 获取」 按钮，等它自动装完。
3. 3. 装好后，开始菜单里能找到 Codex 图标，打开即可。

macOS 用户：微软商店是 Windows 专属，Mac 请到 Codex 官网下载对应的桌面版安装包。

二、安装 cc-switch

cc-switch 是个图形小工具，帮你 一键配置，省去手动改文件。

1. 1. 打开下载页：https://github.com/farion1231/cc-switch/releases
2. 2. 按系统下载安装：
   • Windows：下载 .exe / .msi，双击安装。
   • macOS：下载 .dmg 拖进「应用程序」；首次打开若提示无法验证开发者，去「系统设置 → 隐私与安全性」点「仍要打开」。
3. 3. 打开 cc-switch，让它 在后台保持运行。

三、获取密钥并导入

软件装好了，现在需要一个 API 密钥 才能让 Codex 干活。

这里用 TokenHub——原生模型、不降智、注册送体验额度，够你跟着这篇教程免费练手：

1. 1. 打开 TokenHub 注册页 注册并登录。
2. 2. 进入 「API 密钥」 页，点 「创建密钥」。
3. 3. 在该密钥旁点 「使用密钥」，网站会直接给出可复制的命令和配置片段。
4. 4. 打开 cc-switch，在对应工具标签里填入 TokenHub 提供的配置信息，点 「启用」。

搞定——全程不用手写任何配置文件。

四、开始使用 Codex

完全关闭 Codex 桌面版再重新打开（让配置生效），选好你要干活的文件夹（项目目录）。

在输入框里用大白话给它派活，比如打一句 帮我开发一个游戏，回车。

它就会自己开始写代码、跑起来——这就是 vibe coding。

• • 新手建议：第一次别让它大改代码：先让它「只读 + 给计划」，确认后再动手。
• • 重要项目改动前用 git 做检查点，方便随时回滚。

五、配置 Claude Code

Codex 官方偶尔会容量爆满（满屏 at capacity），把活儿全押在一个工具上不踏实。花 3 分钟把 Claude Code 也配上，它崩它的，你用你的。还是同一个 TokenHub 账号，不用重复注册。

1. 下载安装

打开官方下载页（Windows 和 Mac 都有）：https://claude.ai/download

下载后正常安装，跟装个普通软件一样，双击下一步就行。

2. 获取专属密钥

回 TokenHub 的「API 密钥」页，创建一把新的密钥，然后把密钥复制下来。

3. 配置环境变量

在 cc-switch 的 Claude Code 标签里点「+」添加供应商，填好以下四项：

点「添加」再点「使用中」启用。

命令行 / VSCode 用户：如果你不用 cc-switch，想直接在终端里配环境变量，或是在 VSCode 装 Claude Code 插件，在 TokenHub 密钥详情页点「使用密钥」可以直接复制命令和配置片段。

4. 重启验证

完全关闭 Claude 桌面版再重新打开（一定要彻底关，不是最小化），能正常打开对话界面就说明配置生效了。

六、常见问题 FAQ

七、安全与注意事项

• • 密钥 = 你的余额：勿泄露、勿提交 Git、勿发群。
• • Codex / Claude Code 会修改你的代码文件，重要项目先用 git 备份 / 做检查点。
• • 遇到搞不定的问题，可发邮件至 support@ailsl.top。