# 产品与排错

## 产品能力

### Codex 支持 high / medium / low 推理档位吗？

支持。Codex 官方支持的推理档位，如 `high`、`medium`、`low`、`minimal`，TokenFlows 会按模型能力透传，不做降级或掺假。

可用模型会随官方能力与平台策略更新，最新列表请以 [模型列表](/models) 为准。

### Codex 和 Claude Code 怎么选？

如果主要使用 GPT 系列模型，优先推荐 Codex。Codex 对 GPT 模型的缓存与代码上下文处理更友好，复杂编码任务的完成率通常更高，实际成本也更容易被缓存摊低。

Claude Code 的优势是响应更轻快，适合 Claude 模型和偏交互式的开发流程。Codex 在复杂任务中会更仔细地读取代码、规划和推理，因此简单问题不一定总是最快。

### 支持插件、CLI 和 IDE 吗？

支持 Codex CLI、Codex App、Claude Code、OpenCode 等本地开发工具接入。Codex 插件支持兼容 VS Code 官方插件体系的 IDE，例如 VS Code、Cursor、Windsurf 等；CLI 不限制 IDE，只要有可用终端即可。

Web 端能力通常依赖对应官方账号登录，不属于 TokenFlows API 的接入范围。

### 支持上传图片吗？

取决于你使用的工具本身是否支持图片输入。Codex CLI、Codex App 和相关插件支持图片能力时，TokenFlows 可以随工具正常使用。

Windows 原生控制台对图片和文件编码的兼容性较弱，建议 Windows 用户优先使用 WSL 或 Git Bash。

### 为什么我问模型是谁，它说自己是 GPT-4？

不要用模型自我介绍判断真实模型。模型回复会受到系统提示词、历史上下文和训练数据影响，并不是可靠的鉴别方式。

更可靠的方式是用同一段代码任务对比输出质量、工具调用能力和复杂问题解决效果，或在控制台查看实际请求的模型 ID 与用量记录。

## 计费与套餐

### 为什么只问一句“你好”也会产生明显消耗？

Codex、Claude Code 这类工具是 AI Agent，不是普通聊天机器人。它们可能会在回复前自动读取项目目录、扫描文件、分析上下文，并进行多轮内部推理。

所以即使你只发一句简单问题，只要在项目目录中运行，它也可能产生额外输入 token 和缓存 token。只想测试连通性或闲聊时，建议使用普通聊天工具或控制台 Playground。

### 额度大概能用多久？

实际用量取决于模型、上下文大小、是否命中缓存、任务复杂度和工具读取文件数量。编码 Agent 的单次对话可能消耗从数万到数十万 token 不等，复杂重构或大型代码库会更高。

TokenFlows 按模型实际用量计费，控制台会展示每次请求的明细。模型单价请查看 [模型列表](/models)，套餐额度与有效期请查看 [订阅套餐](/plans)。

### 为什么 GPT 系列实际成本会比直觉更低？

代码任务里大量输入是重复上下文，例如项目结构、依赖文件、历史消息和相同代码片段。命中缓存后，重复输入会按缓存价格计费，因此长会话或持续开发任务的实际成本通常低于按普通输入价直接估算。

这也是推荐 GPT 系列优先使用 Codex 的原因之一：缓存命中越高，越能摊低 Agent 的上下文成本。

### 套餐有限额吗？

套餐额度、有效期和可用模型以 [订阅套餐](/plans) 页面为准。GPT 请求会优先消耗套餐额度，用完后按账户余额继续计费。

如果遇到 `429`，通常表示短时间请求过快或触发了并发/频率限制。稍等片刻后重试即可。

### 可以开发票吗？

可以。需要开票时请联系人工客服，并提供开票信息与订单信息。

## 技术配置

### 如何使用最新 GPT 模型？

Codex CLI 可以通过命令行参数临时指定模型：

```bash
codex -m gpt-5.5
```

也可以在 Codex 配置中修改默认模型。Codex App 和 CLI 共用 `~/.codex/config.toml`，示例：

```toml
model = "gpt-5.5"
```

保存后重启 Codex 生效。可用模型请以 [模型列表](/models) 为准。

### 各 GPT 模型怎么选？

| 场景 | 推荐 |
| --- | --- |
| 效果优先、复杂架构与疑难任务 | 选择能力最强的 GPT 旗舰模型 |
| 日常开发、稳定可靠 | 选择上一代旗舰或主力模型 |
| 成本优先、轻量任务 | 选择 mini 或轻量模型；遇到困难任务再切换到更强模型 |

完整价格请查看 [模型列表](/models)。如果某个模型暂未出现在模型列表中，说明当前尚未开放或已调整。

### 是国内直连吗？

TokenFlows API 面向国内网络做了线路优化。一般不建议对 API 请求再套代理，否则可能降低速度，甚至造成连接失败。

如果访问官网或第三方工具下载页偶发超时，可以按你的网络情况临时切换代理；API 调用本身优先直连。

### Windows 中文乱码怎么办？

优先建议使用 WSL 或 Git Bash。若必须使用 Windows PowerShell，可在项目 `AGENTS.md` 或全局 `~/.codex/AGENTS.md` 中加入启动前提示，让 Codex 先设置 UTF-8：

```markdown
# Windows 终端编码
如果当前系统是 Windows，在执行其他命令前先运行：

[Console]::InputEncoding  = [Text.UTF8Encoding]::new($false)
[Console]::OutputEncoding = [Text.UTF8Encoding]::new($false)
chcp 65001 > $null
```

### Codex 总是说英文，怎么让它默认中文？

把语言要求写进 `AGENTS.md`，比在每次对话里重复要求更稳定。

只对当前项目生效：在项目根目录创建或编辑 `AGENTS.md`：

```markdown
# 交互要求
- Thinking 思考过程用中文表述
- Reply 回答用中文回复
```

对所有项目生效：创建全局文件 `~/.codex/AGENTS.md`，写入同样内容：

```bash
mkdir -p ~/.codex
```

### 遇到 401 错误怎么办？

401 通常是鉴权或额度问题：

- API Key 或账号配置不正确
- 账户余额或套餐额度已用完
- 套餐已过期或账号状态异常

先检查配置文件中的密钥，再到控制台确认余额、套餐和到期状态。

### stream error / Connection failed 是什么原因？

这类报错通常是网络问题，不代表账号异常。可以尝试：

- 切换网络环境
- 关闭或更换代理
- 重启终端或工具
- 稍后重试

如果同一密钥在控制台或其他网络下可用，基本可以判断是本地网络链路问题。

### 遇到 413 错误怎么办？

413 表示当前请求或会话上下文过大，超过工具或网关允许的大小。解决方式是新建会话，或减少一次性读取的大文件、日志和历史上下文。

### 如何售后？

登录控制台后查看页面底部的客服入口。遇到配置、额度、网络或发票问题，都可以联系人工客服处理。