兄弟们,最近Codex是不是让你又爱又恨?作为OpenAI的下一代AI编程神器,写代码确实猛,但国内直连的麻烦事儿也真让人头大:要么网络不通,要么token不够用。今天这篇保姆级教程,从安装到配置一步不落,手把手教你用 tokenstore.one 中转站 + cc-switch配置神器,不但免翻墙,还能轻松绕开协议不兼容的坑,丝滑接入GPT-5.5等顶级模型
---
一、第一步:安装Codex CLI(两种方式任选)
Codex是一个命令行工具,安装前确保你的电脑有Node.js 18或更高版本。
方式一:用npm安装(推荐,适合所有人)
打开终端(Mac/Linux)或命令提示符/PowerShell(Win),输入:
```bash
npm install -g @openai/codex
``
国内网络慢的话,可以用淘宝镜像加速:
```bash
npm install -g @openai/codex --registry=https://registry.npmmirror.com
```
安装完成后,验证一下是否成功:
```bash
codex --version
```
能看到版本号就说明装好了。
方式二:用其他方式安装
· Mac用户:也可以用Homebrew brew install codex 或 brew install --cask codex
· 脚本安装(Mac/Linux):
```bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
· 脚本安装(Windows):
```powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```
· 手动下载:去GitHub Releases找对应你系统的二进制包(如Mac ARM版是codex-aarch64-apple-darwin.tar.gz)
---
二、配置神器登场:cc-switch是啥?
cc-switch是一个本地AI编程工具的“模型配置管理器”,可以把它想象成一个万能遥控器。我们用它主要干两件事情
1. 一键切换:把tokenstore.one的API Key和地址导入,不用手动改配置文件。
2. 协议转换(最关键!):cc-switch内置了“本地路由”功能,能自动把Codex的Responses API请求“翻译”成国内网关懂的Chat Completions API请求,彻底搞定405报错。
---
三、实战操作:三步走,Codex
第一步:准备工作
1. 注册tokenstore.one:访问https://tokenstore.one注册账号,进入控制台创建一个API Key(令牌),复制下来备用(格式一般是sk-xxx)。
2. 安装cc-switch:去GitHub Releases搜索cc-switch,下载对应你系统的安装包(Mac用DMG,Win用MSI)。Mac用户也可以直接brew install --cask cc-switch。
第二步:在cc-switch里配置“翻译官”
1. 打开cc-switch,切换到顶部的 「Codex」 标签页。
2. 点击右上角 「添加供应商」。如果你的中转站支持一键导入,直接点“一键导入cc-switch”链接自动填充。
3. 手动配置也不难:选择 「Custom Gateway」 或 「OpenAI Compatible」。
· Provider名称:随便填,比如“tokenstore”。
· Base URL:填tokenstore.one给你的网关地址(通常是https://api.xxx.one/v1)。
· API Key:粘贴刚才复制的tokenstore.one Key。
第三步:启用
1. 进入cc-switch的 「设置」→「路由」 页面。
2. 打开 「路由总开关」,并单独开启 「Codex路由」。
3. 回到Codex供应商列表,点击你刚建的配置上的 「启用」。
4. 重启你的终端,输入codex命令。搞定!现在Codex已经通过本地路由走tokenstore.one的API了。
---
✅ 验证成功!
配置完成后,在终端输入codex,看到类似下面的界面就说明大功告成:
```
> codex
Codex v0.5.0
Model: gpt-5-code
Connected to: http://127.0.0.1:15721/v1 (via cc-switch)
API Source: https://api.tokenstore.one/v1
Ready. Ask me anything about your code
---
四、避坑指南与常见问题
· 问:启动后问它是什么模型,回答GPT-5?
· 答:正常现象!这是Codex内置的提示词导致的“幻觉”,实际调用的已经是你配置的模型了,去cc-switch的“使用统计”看看消耗记录就真相大白了。
· 问:还是报405或404?
· 答:检查两件事:一是cc-switch的“本地路由”开关是否打开;二是Codex有没有被手动改过配置,在路由模式下它会由cc-switch自动接管,不用你操心。
· 问:模型列表里看不到我想要的模型?
· 答:在cc-switch的Provider配置里填好“模型”字段,然后完全退出Codex终端再重新打开,让它重新加载配置。
---
总结
这套 tokenstore.one + cc-switch 的方案,完美解决了Codex在国内网络不通和协议不兼容的痛点。cc-switch的本地路由功能就像个贴心翻译官,让你在国内也能愉快地使用顶级AI编程助手,再也不用对着405报错干瞪眼了!
快去tokenstore.one注册试试吧!🚀