疑难杂症排查指南

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

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

1. 确认你的 Key 没写错（不要多空格）
2. 确认 Base URL 写对：
   • OpenAI/Anthropic 兼容：https://api.ci-yuan-ai.com/v1
   • 少数工具不带 /v1：https://api.ci-yuan-ai.com
3. 确认你的网络能访问目标地址

1. Claude Code 常见问题

1) 一直弹登录 / 走官方服务

先确认你已经设置了：

• ANTHROPIC_BASE_URL=https://api.ci-yuan-ai.com
• ANTHROPIC_AUTH_TOKEN=你的词元AI Key

验证方式：

Windows PowerShell：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

macOS/Linux：

echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_AUTH_TOKEN"

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

• /tools/claude-code/windows
• /tools/claude-code/macos
• /tools/claude-code/linux

2) 400 / 会话异常

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

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

2. Codex 常见问题

1) 配置写了但没生效

先确认配置文件存在：

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

再确认 base_url 是：

https://api.ci-yuan-ai.com/v1

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

3. Gemini CLI 常见问题

1) 安装后没有 gemini 命令

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

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

如果仍然没有，再试：

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

2) 配了 Key 仍然提示登录

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

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

4. OpenCode 常见问题

1) 启动时报找不到 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

2) 配置文件 JSON 格式错误

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

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

5. OpenClaw 常见问题

1) doctor 提示 provider/api 配置不对

接入词元AI时，建议 api 用：

{ "api": "openai-responses" }

并把 baseUrl 指向：

https://api.ci-yuan-ai.com/v1

6. 仍然没解决？

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

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

联系入口：

• /help/support