Skip to content

本页收录各工具配置过程中常见的问题和解决方法,如有未覆盖的问题,请联系客服。

通用问题

工具始终无法启动

如果 Claude Code 启动后要求登录 claude.ai 账号,通常是环境变量未正确设置,导致程序回退到官方登录流程。

处理方式:

  • 确认已正确设置 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN
  • Windows 重新打开 PowerShell;macOS 执行 source ~/.zshrc
  • 使用 claude doctor 检查配置状态

如果 Codex 启动后报 auth 错误,通常是 auth.json 格式错误或 API Key 填写有误。请检查:

json
{
  "uucode": {
    "api_key": "sk-你的令牌"
  }
}

Claude Code 专项

提示 claude: command not found

  • 检查 Node.js 版本:node -v,需 22+
  • 重新执行安装:npm install -g @anthropic-ai/claude-code
  • Windows 以管理员权限打开 PowerShell 后再安装

运行 Claude 后出现 SSL 证书错误

可临时添加:

powershell
[Environment]::SetEnvironmentVariable("NODE_TLS_REJECT_UNAUTHORIZED", "0", "User")
bash
export NODE_TLS_REJECT_UNAUTHORIZED=0

claude doctorANTHROPIC_BASE_URL 未设置

请重新按照 Claude Code 安装教程设置环境变量,并在新窗口中重新验证。

Codex 专项

找不到 Codex 配置文件

Windows:

text
C:\Users\你的用户名\.codex\

macOS / Linux:

text
~/.codex/

目录中应包含两个文件:

text
config.toml
auth.json

Codex 运行报 model not found

检查 config.toml 中的 model 字段是否正确,建议使用:

toml
model = "gpt-5.3-codex"

OpenClaw 专项

OpenCode 报 401 Unauthorized

请检查:

  • apiKey 是否填写正确
  • baseURL 是否为 https://sub.appdock.cn

OpenClaw GateWay 启动失败

可尝试重启:

bash
openclaw gateway restart

如果仍然失败,请检查端口是否被占用,或重新运行配置脚本。

仍未解决

如以上方案仍未解决问题,请联系客服。