跳到主要内容

疑难杂症排查指南

这页专门解决“连不上、超时、报错、工具启动异常”等问题。建议你按顺序排查，不要同时乱改一堆配置。

先做三件事（最快定位问题）​

  1. 确认你的 Key 没写错（不要多空格）

  2. 确认 Base URL 写对：

    • OpenAI/Anthropic 兼容：https://api.constreet.cc/v1
    • 少数工具不带 /v1：https://api.constreet.cc

  3. 确认你的网络能访问目标地址

Claude Code 常见问题​

一直弹登录 / 走官方服务​

先确认你已经设置了：

  • ANTHROPIC_BASE_URL=``https://api.constreet.cc
  • ANTHROPIC_AUTH_TOKEN=你的Constreet Key

验证方式：

Windows PowerShell：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

macOS/Linux：

echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_AUTH_TOKEN"

如果变量是空的，说明根本没生效，回到对应系统教程重做一遍：

400 / 会话异常​

通常是会话状态问题。你可以：

  • 在工具里执行 /clear 清空会话重开
  • 或者直接退出重启工具

Codex 常见问题​

配置写了但没生效​

先确认配置文件存在：

  • macOS/Linux：~/.codex/config.toml、~/.codex/auth.json
  • Windows：%USERPROFILE%\.codex\config.toml、%USERPROFILE%\.codex\auth.json

再确认 base_url 是：

https://api.constreet.cc/v1

以及 auth.json 里 Key 的字段名是 OPENAI_API_KEY。

Gemini CLI 常见问题​

安装后没有 gemini 命令​

不同版本包名可能不同。你可以依次尝试：

npm install -g @google/generative-ai-cli
gemini --version

如果仍然没有，再试：

npm install -g @google/gemini-cli
gemini --version

配了 Key 仍然提示登录​

优先使用 .env 配置，并确认文件路径正确：

  • Windows：%USERPROFILE%\.gemini\.env
  • macOS/Linux：~/.gemini/.env

OpenCode 常见问题​

启动时报找不到 SDK​

OpenCode 需要在配置目录安装 SDK，例如：

mkdir -p ~/.config/opencode
cd ~/.config/opencode
npm install @ai-sdk/anthropic

Windows 对应目录是：

cd $env:USERPROFILE\.config\opencode
npm install @ai-sdk/anthropic

配置文件 JSON 格式错误​

你可以用下面方式快速定位：

  • 检查有没有漏逗号、漏引号
  • 把文件复制到在线 JSON 校验工具里验证

OpenClaw 常见问题​

doctor 提示 provider/api 配置不对​

接入constreet时，建议 api 用：

{ "api": "openai-responses" }

并把 baseUrl 指向：

https://api.constreet.cc/v1

仍然没解决？​

请把下面信息准备好再联系支持，会快很多：

  1. 你用的工具名 + 版本（例如 claude --version）
  2. 你用的系统（Windows/macOS/Linux）和终端（PowerShell/zsh/bash）
  3. 你填的 Base URL（不要发 Key）
  4. 报错截图或完整报错文本

联系入口：