[实战] 手把手教你在 VS Code 终端配置官方 Claude Code：从入门到踩坑（完美解决第三方 API 认证问题）

最近在推特和技术群里，总看到大神们在 VS Code 终端里敲个 claude 命令，就能自动改代码、跑测试、修 Bug，操作行云流水。

起初我以为是 Cline 或者 Cursor，后来才知道，这是 Anthropic 官方推出的命令行工具——Claude Code (CLI)。

今天心血来潮折腾了一下，发现这玩意儿虽然强大，但对国内用户（尤其是使用第三方/中转 API 的朋友）并不友好。经历了一番折腾终于配置完美，特此记录全过程，希望能帮大家避坑。

一、搞清楚概念：它不是插件

首先要纠正一个认知误区：Claude Code 不是 VS Code 插件市场里点的那个“Install”。

它是一个基于 Node.js 的命令行工具。虽然我们通常在 VS Code 的内置终端里运行它，但它本质上是一个独立的程序。所以，别去插件市场搜了，直接看下面的步骤。

二、环境准备

因为是 Node.js 工具，电脑里必须得有 Node 环境。

检查 Node.js：在终端输入 node -v。
要求：版本必须在 v18 以上。
- 如果没有安装，去 nodejs.org 下载 LTS 版本（长期支持版）一路安装即可。

三、安装工具

打开 VS Code 的终端（快捷键 Ctrl + `），输入官方安装命令：

codeBash

# Windows 用户
npm install -g @anthropic-ai/claude-code

# Mac/Linux 用户可能需要加 sudo
sudo npm install -g @anthropic-ai/claude-code

安装很快，几秒钟就搞定。

四、最大的坑：认证环节（卡死在这里）

安装完输入 claude 启动，精彩的地方来了。官方设计了一个向导，让你选择登录方式：

codeText

Select login method:
❯ 1. Claude account with subscription
  2. Anthropic Console account
  3. 3rd-party platform (AWS/Google)

这里的坑在于：

如果你选 1 或 2，它会强制拉起浏览器让你去 Anthropic 官网登录。
如果你像我一样，用的是第三方中转 API（号商提供的 Key），这里根本没有选项让你填 Base URL 和 API Key！
我选了 3，结果它是针对 AWS Bedrock 和 Google Cloud 的，还是没法填中转地址。

✅ 解决方案：PowerShell 脚本一键配置

如果你也是用的第三方 API（通常是 sk- 开头，有一个自定义的接口地址），千万不要在那个选择界面纠缠，直接按 Ctrl+C 退出。

我们需要通过环境变量来“注入”配置。很多贴心的服务商会提供一键脚本。

我的解决步骤：

退出向导：按 Ctrl+C 退出 claude 的卡死界面。

获取脚本：去你的 API 服务商后台，找“Claude Code 配置”或者“终端配置”。通常长这样：

codePowershell

# 示例代码（请替换成你自己的 Key 和地址）
& { $base='https://你的中转地址'; $url='https://你的中转地址'; $key='sk-你的key...'; iwr -useb $base/setup-claude-code.ps1 | iex }

执行脚本：
在 VS Code 终端（确保是 PowerShell）粘贴并回车。
原理：这个脚本会自动帮你设置 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL 环境变量，绕过官方的浏览器登录验证。

执行完脚本后，再次输入 claude，你会发现直接跳过了登录页，成功了！🎉

五、首次运行配置

成功进入后，会有几个简单的交互设置，按需选择即可：

主题选择：它会问你 Dark mode 还是 Light mode。VS Code 一般选 Dark mode，看着舒服。
权限确认：
- Do you trust the files in this folder? -> 必须选 Yes，否则它没法干活。
- Use recommended settings? (Shift+Enter 换行) -> 建议选 Yes，这样回车就是发送消息，更顺手。

六、见证奇迹：真的“顺手”

配置完成后，终端会出现一个 ❯ 光标。这时候它已经是一个超级程序员了。

我做了一个测试：

指令：帮我用 HTML 和 JS 写一个贪吃蛇游戏，要好看一点的，保存为 snake.html

它的反应：

思考：列出 Plan（计划）。
行动：直接在我的文件夹里创建文件。
确认：它写好代码后，会弹出一个 Diff 视图让我确认。
- 这里有个技巧：选择 Yes, allow all edits during this session。这样后续它修 Bug 时就会全自动修改保存，不用每次都点确认，体验极度丝滑！

七、总结

Claude Code 之所以比 Copilot 这种插件感觉更“顺手”，是因为：

它拥有终端权限：可以自己跑 npm install，自己跑测试，自己修 Bug。
它拥有文件系统权限：不是给你一段代码让你复制，而是直接把文件给你改好了。

避坑核心总结：

不要试图在官方向导里找“输入第三方 Key”的地方。
直接用 PowerShell 脚本或者环境变量 (export ANTHROPIC_BASE_URL=...) 来配置。
一定要信任当前目录，并开启“Allow all edits”，才能体验全自动开发的快感。

配置好了，现在我也能像推特大神一样，在那儿喝咖啡，看终端自己写代码了！☕️

一、 搞清楚概念：它不是插件

二、 环境准备

三、 安装工具

四、 最大的坑：认证环节（卡死在这里）