X-Code Docs

主题

常见问题 ​

Claude Code ​

Claude Code 报错 Unable to connect to Anthropic services / ERR_BAD_REQUEST ​

如果错误日志是：

text
Unable to connect to Anthropic services

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Please check your internet connection and network settings.

通常是 Claude Code 仍在访问 Anthropic 官方地址（api.anthropic.com），而不是 X-Code 地址。可按下面步骤处理：

  1. 确认已设置基础地址：ANTHROPIC_BASE_URL=https://x-code.cc。
  2. 确认 API Key 已生效（ANTHROPIC_AUTH_TOKEN），并重启终端会话。
  3. 若仍报错，补上 ~/.claude.json 的 hasCompletedOnboarding=true：
powershell
powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

执行后请重启 Claude Code。如果你看到的目标不再是 api.anthropic.com 而是 X-Code 域名，说明配置已生效。

配置后仍然提示未设置 API Key？ ​

先确认 ANTHROPIC_AUTH_TOKEN 已在当前终端生效；修改了 ~/.bashrc/~/.zshrc 后，记得执行 source 重新加载。

Windows 下环境变量配置后不生效？ ​

关闭并重新打开 PowerShell 或终端工具，确保新会话读取了最新系统环境变量。

如何确认请求走的是 X-Code 地址？ ​

检查 ANTHROPIC_BASE_URL 是否为 https://x-code.cc，并在命令行里打印环境变量进行二次确认。

Codex ​

Codex 启动后提示认证失败怎么办？ ​

先确认 OPENAI_API_KEY 正确，且 ~/.codex/config.toml 中 base_url 配置为 https://x-code.cc/v1。

修改 config.toml 后未生效？ ​

关闭当前 Codex 会话后重新启动，避免旧进程继续读取缓存配置。

如何检查当前使用的模型？ ​

查看 ~/.codex/config.toml 中的 model 字段，并确保与当前账号可用模型一致。

Grok Build ​

把 Key 写到 env_key 后无法使用？ ​

env_key 只能填写环境变量名（例如 XCODE_API_KEY），不能填写真的 API Key。若要直接把令牌写在配置文件里，请使用 api_key = "sk-xxxxx"。

提示模型不存在或无权限？ ​

确认 models_base_url 为 https://api-cn.x-code.cc/v1，model 与控制台可用模型一致（如 grok-4.5），且 API Key 复制完整、前后无多余空格。

如何确认配置已加载？ ​

执行 grok inspect 查看当前配置路径与模型；再用 grok -p "只回复 ok" -m grok-4.5 做最小请求测试。