VScode 集成指南

Claude Code 和 Codex 可以与主流 IDE 集成使用，在你熟悉的开发环境中获得 AI 辅助编程能力。

1. Claude Code for VS Code

Anthropic 官方提供了 Claude Code for VS Code 扩展，可以在 VSCode 中深度集成 Claude Code，获得极佳的 AI 辅助编程体验。以下配置方式同样适用于其他基于 VSCode 的 IDE（如 Cursor、Windsurf 等）。

第一步：安装扩展

1. 打开 VSCode，点击左侧的扩展图标（或按 Ctrl+Shift+X / Cmd+Shift+X）
2. 在搜索框中输入「Claude Code for VS Code」
3. 找到 Anthropic 官方发布的扩展，点击「安装」
4. 安装完成后，重新加载 VSCode 窗口

第二步：配置 1xm 中转服务（重要！）

安装扩展后，需要配置 API Key 和中转地址才能正常使用。

配置文件位置：

• Windows：C:\Users\你的用户名\.claude\settings.json
• macOS：~/.claude/settings.json
• Linux：~/.claude/settings.json

如果该文件不存在，请手动创建。添加以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY",
    "ANTHROPIC_BASE_URL": "https://api.1xm.ai"
  },
  "includeCoAuthoredBy": false,
  "model": "sonnet[1m]"
}

配置说明

• ANTHROPIC_AUTH_TOKEN：填入你在 1xm 控制台生成的 API Key（令牌页面获取）
• ANTHROPIC_BASE_URL：固定填写 https://api.1xm.ai
• ⚠️ 修改配置后，必须彻底退出并重启 VSCode 才能生效！仅关闭窗口不够。Windows 用户需要在任务管理器中结束所有 node.exe 进程，否则旧的环境变量缓存会导致新配置不生效。

如何获取 API Key

登录 1xm.ai 后，进入「控制台 → 令牌」页面，创建一个新令牌即可获取 API Key。

验证配置

配置完成后，在 VSCode 中打开 Claude Code 面板，如果能正常连接则配置成功。也可以在 VSCode 内置终端运行 claude /doctor 检查配置状态。

---

2. Codex CLI + VS Code 插件

Codex CLI 是 OpenAI 官方推出的终端 AI 编程助手，可以直接读取项目代码、修改文件、执行命令，也可以通过 VS Code 插件使用。

安装前准备

• Node.js 22+、npm 10+
• Windows 用户建议使用 WSL 环境，稳定性更好

安装 Codex CLI

macOS / Linux：

npm install -g @openai/codex

Windows（CMD / PowerShell）：

npm install -g @openai/codex

验证安装：

codex --version

配置 1xm 中转服务

Codex 读取两个配置文件，位于 ~/.codex/（Windows 在 C:\Users\你的用户名\.codex\）。

第一步：创建 auth.json（存放 API Key）

{
  "providers": {
    "1xm": {
      "token": "你的1xm API Key"
    }
  }
}

第二步：创建 config.toml（存放模型和网关配置）

model_provider = "1xm"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.1xm]
name = "1xm"
base_url = "https://api.1xm.ai/v1"
wire_api = "responses"
requires_openai_auth = true

配置说明

• model：填写你要使用的模型名，如 gpt-5.2-codex、gpt-5.1-codex 等（以 1xm 模型列表为准）
• model_provider 和 [model_providers.xxx] 的名称必须完全一致，否则配置不生效
• base_url 填写 https://api.1xm.ai/v1（末尾带 /v1）
• ⚠️ 修改配置后必须重启终端才能生效！关闭当前终端窗口重新打开，Windows 用户同样需要结束相关 node.exe 进程。

启动 Codex

进入你的项目目录后运行：

cd 你的项目目录
codex

也可以直接带任务启动：

codex "帮我看下这个项目的结构，列出主要文件"

VS Code 插件（可选）

完成上述 .codex 配置后，在 VSCode 扩展商店搜索「Codex」安装 OpenAI 官方插件，安装完成后侧边栏会出现 Codex 面板，配置会自动读取 ~/.codex/ 目录。

常见问题

Q：命令找不到（codex: command not found） npm 全局路径未加入 PATH，重新执行 npm install -g @openai/codex 或检查 PATH 配置。

Q：401 未认证 检查 auth.json 格式是否正确，并重启终端。

Q：模型不可用（model not found） 模型名需与 1xm 模型列表中的名称完全一致，登录 1xm 控制台查看可用模型名。

Q：config.toml 没生效 确认 model_provider = "xxx" 和 [model_providers.xxx] 的名称完全一致，且已重启终端。

---

3. 其他 IDE

对于其他 IDE（JetBrains 系列、Cursor、Windsurf 等），可以通过内置终端使用 Claude Code CLI。只需确保系统环境变量已正确配置（参考对应系统的安装配置部分），然后在 IDE 终端中输入 claude 即可启动。

通用步骤

1. 确保已按照系统安装教程配置好环境变量（ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL）
2. 打开 IDE 的内置终端
3. 输入 claude 启动 Claude Code

提示

大多数 IDE 的内置终端会继承系统环境变量。如果环境变量不生效，请尝试重启 IDE 或检查终端类型设置。

最佳实践

• 在项目根目录启动 — 让 Claude Code 能够读取项目文件，提供更准确的建议
• 使用 /help 命令 — 查看所有可用的斜杠命令和功能
• 使用 /clear 命令 — 清空上下文，开始新的对话（减少 token 消耗）
• 善用 @file 引用 — 在对话中使用 @filename 快速引用项目文件
• 备份重要文件 — Claude Code 可以直接修改文件，操作前建议使用 Git 管理版本
• 使用 /doctor 诊断 — 遇到问题时运行 claude /doctor 检查配置