IDE 扩展

Claude Code 与 Codex 都提供编辑器集成，适用于 VS Code 以及部分兼容 VS Code 扩展的编辑器。扩展会复用对应 CLI 的配置，因此应先完成 CLI 接入。

Claude Code 扩展

1. 先完成 Claude Code 配置，并在终端确认 claude 可正常调用。
2. 在编辑器扩展市场搜索 Claude Code。
3. 核对发布者为 Anthropic 后再安装。
4. 完全退出编辑器，从已配置环境变量的终端启动项目。

code .

如果使用其他编辑器，请将 code 换成对应的启动命令。

Codex 扩展

1. 先完成 Codex 配置，并在终端确认 codex 可正常启动。
2. 在编辑器扩展市场搜索 Codex。
3. 核对发布者为 OpenAI 后再安装。
4. 扩展会读取用户级 ~/.codex/config.toml 和相同的认证环境变量。

Codex 的提供商配置不要放在项目级 .codex/config.toml，因为项目配置不能覆盖提供商与认证设置。

Windows 环境变量

如果通过桌面快捷方式启动编辑器，PowerShell 当前会话中的 $env:... 不会被编辑器读取。请使用用户级环境变量，设置后完全退出并重新打开编辑器。

排查顺序

1. 在编辑器内置终端执行 claude --version 或 codex --version。
2. 检查 Base URL 是否正确，且没有重复的 /v1。
3. 检查编辑器进程能否读取所需环境变量。
4. 检查模型 ID 和令牌权限。
5. 查看云枢控制台是否产生请求日志。

DANGER

不要把真实 API Key 写入工作区设置、项目配置或可以同步到云端的编辑器设置中。