常见问题

接入时最容易遇到的问题，在这里快速找到答案。

API 密钥和登录密码有什么区别？

登录密码用于访问账户，API 密钥用于让工具调用接口。工具要求填写 API Key 时，应使用密钥页面创建的密钥。

一个密钥能在多个工具中使用吗？

只要协议、模型权限和限制都满足，多个工具可以使用同一枚密钥。不过，为不同用途单独创建密钥，更方便查看用量、撤销访问和定位问题。

为什么模型广场有模型，我却不能调用？

公开目录展示可浏览的模型，实际访问还取决于密钥的分组、模型限制和渠道状态。检查密钥所属分组是否与模型目录对应。

Base URL 到底要不要加 /v1？

本指南的 Codex 自定义服务商和 OpenAI SDK 使用 https://acode.ink/v1。Claude Code 通常使用 https://acode.ink，并要求分组支持 Anthropic 协议。

其他客户端可能自行追加路径，优先看「使用密钥」生成的说明。详见接入地址速查。

可以直接在 ChatGPT 网页里填这个密钥吗？

本指南面向支持自定义 API 地址的工具与服务端程序。不要把网页聊天账号、订阅和 API 密钥混为一谈；按具体客户端提供的服务商配置能力接入。

为什么工具能启动，却没有模型回复？

工具启动只说明本地程序可以运行。还需要验证实际请求是否成功。检查地址、认证、模型和分组，并对照错误排查处理返回信息。

为什么重开终端后配置不见了？

教程中的 export 与 $env: 示例只对当前终端生效。关闭终端后，需要重新设置，或使用 CC Switch 等方式管理配置。修改配置后，已有进程通常也需要重启。

怎样确认请求走的是 ACode？

检查工具当前的服务商和 Base URL，并在 ACode 使用记录中核对同一时间的请求。仅看到模型回复并不能说明用了哪个服务商。

可以把密钥放进网页代码吗？

不要把私人密钥放在会发送给浏览器的代码中。网页前端调用自己的后端，再由后端持有密钥并请求 ACode。

联系客服时需要提供什么？

提供工具名称与版本、请求时间及所在时区、Base URL、模型名称、HTTP 状态码、错误正文和请求 ID（如有）。先遮盖截图和日志里的完整密钥，再通过站点公布的渠道联系。