本文整理安装和启动阶段最常见的问题，适用于 Node.js、Git、Claude Code、Codex CLI 以及卡特 Token 站 API Key 配置后的首次启动。

​
先做基础检查

遇到安装或启动问题时，先打开一个新的终端，执行： 
node -v
npm -v
git --version
如果这三条命令任意一条没有版本号，先回到「Node.js和Git环境配置」完成基础环境安装。 再检查客户端命令是否可用： 
claude -v
codex --version
如果命令不存在，优先看下面的 PATH 和 npm 全局目录问题。

​
command not found: claude 或 codex

现象： 
command not found: claude
command not found: codex
常见原因是 npm 全局 bin 目录没有加入 PATH。 先查看 npm 全局安装目录： 
npm config get prefix
macOS / Linux 通常需要把对应的 bin 目录加入 shell 配置。例如： 
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
如果你使用 bash，把 ~/.zshrc 换成 ~/.bashrc 或 ~/.bash_profile。 Windows 用户可以重新打开 PowerShell。如果仍然找不到命令，检查下面目录是否在系统 PATH 中： 
%APPDATA%\npm

​
permission denied 或 EACCES

现象： 
permission denied
EACCES: permission denied
这通常发生在全局安装 npm 包时。macOS / Linux 不建议直接用 sudo npm install -g，更推荐把 npm 全局目录放到用户目录： 
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
如果你使用 bash，把 ~/.zshrc 换成 ~/.bashrc。 然后重新安装： 
npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex
Windows 可以用管理员身份打开 PowerShell 后执行： 
npm config set prefix "$env:APPDATA\npm"
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
关闭并重新打开终端后再安装。

​
PowerShell 无法执行脚本

现象： 
running scripts is disabled on this system
以管理员身份打开 PowerShell，执行： 
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
然后关闭当前 PowerShell，重新打开后再执行安装或启动命令。

​
Claude Code 首次启动提示无法连接 Anthropic

现象： 
Unable to connect to Anthropic services
Please check your internet connection and network settings.
如果你是使用卡特 Token 站的 Claude 兼容接口，优先确认环境变量已经设置： 
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
Windows PowerShell： 
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
正确配置应为： 
ANTHROPIC_BASE_URL=https://api.cutaihub.com
ANTHROPIC_AUTH_TOKEN=你的完整API Key
Claude Code 不要把 Base URL 写成 https://api.cutaihub.com/v1。/v1 是 Codex 使用的 OpenAI 兼容接口路径。
如果仍然在首次启动时卡住，可以检查 ~/.claude.json，Windows 路径为： 
C:\Users\用户名\.claude.json
在最外层 JSON 对象中确认存在： 
{
  "hasCompletedOnboarding": true
}
如果文件里已经有其他字段，不要覆盖整个文件，只在最外层对象中补充这一项并保持 JSON 格式合法。

​
Codex 启动后请求失败

Codex 能启动但请求失败，优先检查 ~/.codex/config.toml 和 ~/.codex/auth.json。 config.toml 中的 Base URL 必须带 /v1： 
model_provider = "cutai_codex"

[model_providers.cutai_codex]
name = "cutai_codex"
base_url = "https://api.cutaihub.com/v1"
requires_openai_auth = true
auth.json 应包含完整 API Key： 
{
  "OPENAI_API_KEY": "你的API Key"
}
Codex 必须使用 https://api.cutaihub.com/v1。如果只写 https://api.cutaihub.com，请求通常会失败。

​
旧版本安装残留

如果你之前多次安装过 Claude Code 或 Codex，出现版本混乱、命令指向旧路径、升级后仍然异常，可以先查看全局包： 
npm list -g --depth=0
按需清理旧包： 
npm uninstall -g @anthropic-ai/claude-code
npm uninstall -g @openai/codex
再重新安装： 
npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex
清理前如果你已经有 Claude Code 或 Codex 本地配置，建议先备份： 
cp -r ~/.claude ~/.claude.backup 2>/dev/null || true
cp -r ~/.codex ~/.codex.backup 2>/dev/null || true
Windows PowerShell： 
if (Test-Path "$env:USERPROFILE\.claude") { Copy-Item "$env:USERPROFILE\.claude" "$env:USERPROFILE\.claude.backup" -Recurse }
if (Test-Path "$env:USERPROFILE\.codex") { Copy-Item "$env:USERPROFILE\.codex" "$env:USERPROFILE\.codex.backup" -Recurse }

​
仍然无法启动

联系卡特客服时，请一次性提供：
  • 操作系统和版本。
  • node -v、npm -v、git --version 输出。
  • claude -v 或 codex --version 输出。
  • 完整报错截图或终端文本。
  • 你使用的是 Claude Code 还是 Codex。
  • API Key 所在令牌分组。
不要发送完整 API Key。可以只提供前后几位，例如 sk-abc...xyz。