troubleshooting

CLI command does not exist

If the prompt command runningclaude,codex,geminidoes not exist, first verify that Node.js and npm are available:

Windows

node -v
npm -v

macOS

node -v
npm -v

Linux

node -v
npm -v

Then reinstall the corresponding CLI:

Windows

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

macOS

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

Linux

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

Please reopen the terminal after installation.

Claude Code Tips Missing Git

After installing Git, reopen the terminal and run:

Windows

git --version

macOS

git --version

Linux

git --version

After you can see the version number, runclaudeagain.

Key error

Common reasons:

• The API Key is not fully copied.
• There are extra spaces, quotes, or invisible characters in the configuration file.
• Fill in the keys of other suppliers in the PuLu AI configuration.
• API keys have been removed, disabled, or model/IP restrictions have been set.

It is recommended to recreate a test Key and not turn on model restrictions or IP whitelists first.

model does not exist

If the client prompt model does not exist:

1. Go back to the PuLu AI console to confirm the current account model available.
2. Check whether the API Key restricts the model.
3. Replace the model name in the client with the available model displayed on the console.

Configuration modification will not take effect

Most CLIs read the configuration file at startup. After modifying the configuration, please exit the current process completely and restart it.

Windows

# 退出当前 CLI
Ctrl + C

# 重新进入
codex

macOS

# 退出当前 CLI
Ctrl + C

# 重新进入
codex

Linux

# 退出当前 CLI
Ctrl + C

# 重新进入
codex

curl works, but the client does not work

If the curl example can return normally but the client fails, check first:

• Whether the client interface type is selected correctly, such as Responses, Chat Completions, Anthropic Messages, or Gemini.
• Whetherbase_urlis written ashttps://www.puluai.com/v1.
• Whether the client spliced additional paths, causing the final URL to appear repeatedly/v1.
• Whether the client supports streaming returns.