咱们书接上文：史上最全！一文带你拿下市面主流AI编程，最新Claude/Codex/Kimi...安装教材，彻底搞懂插件版和命令行版！（上）-CSDN博客

2026最新最细 | | | 安装 Node.js 超详细教程：从下载到环境配置，一次搞定前端开发必备环境！-CSDN博客

目录

一、先说结论：Claude Code 到底有哪两种用法？

二、安装前要准备什么环境

三、在 VS Code 中安装 Claude Code 插件

四、Claude Code 插件安装后，为什么还不能直接用

五、VS Code 中配置 Claude Code 的 API

六、配置完成后，为什么建议重启 VS Code

七、全局安装 Claude Code 是什么？为什么很多人还要装它

八、如何全局安装 Claude Code

九、为什么我全局安装了 Claude，却找不到 .claude 文件夹

十、全局安装 Claude 后，应该如何配置 API

官方 Anthropic API 版

第三方兼容版

十一、VS Code 插件版和全局安装版，到底该怎么选

常见问题汇总

为什么你明明装了 Claude Code，却还是一头雾水？

这两天在折腾 AI 编程工具时，我发现很多人会同时遇到几个问题：

• VS Code 里 Claude Code 插件到底怎么装？

• 为什么有的人说要“全局安装 Claude”？

• 插件安装和命令行安装到底是什么关系？

• 为什么会遇到 command 'claude-vscode.editor.openLast' not found 这种报错？

如果你也有这些困惑，那么这篇文章就是写给你的。
本文会从 VS Code 集成 Claude Code 插件、全局安装 Claude Code 命令、API 配置方法、插件和全局安装的区别、常见报错解决方案 几个方面，带你把 Claude Code 这套工具链完整跑通。

一、先说结论：Claude Code 到底有哪两种用法？

        很多人第一次接触 Claude Code 时，最容易搞混的一点就是：为什么既有 VS Code 插件，又有全局安装？
其实它们不是互相替代，而是两个不同入口。

你可以把它理解成：

• VS Code 插件：把 Claude Code 集成到编辑器里，适合直接在 IDE 中对着当前文件、当前项目做交互。

• 全局安装 Claude：把 claude 命令装进系统终端，适合在命令行里进入项目目录后直接使用。

说白了，一个是 图形界面入口，一个是 命令行入口。
        很多高级功能、终端式工作流、在项目目录中快速调起 Claude，往往和全局安装关系更大；而在 VS Code 中直接操作、侧边栏交互、编辑器内联体验，则是插件更方便。

二、安装前要准备什么环境

在正式安装 Claude Code 之前，建议你先确认以下环境已经准备好：

• 已安装 VS Code；

• 已安装 Node.js，因为 Claude Code 的全局安装通常基于 npm；

• 已经具备可用的 API 接入方式，比如官方 Anthropic 账户、Anthropic Console，或者第三方兼容后端；

• 最好有一个本地项目目录，便于后面验证 Claude 是否真的能读取项目和工作区。

如果你前面已经把 Node.js 环境装好了，那么这一步基本就没什么难度了。没有就会出现下面的情况。

三、在 VS Code 中安装 Claude Code 插件

        首先打开 VS Code，点击左侧的 扩展（Extensions），或者直接按 Ctrl + Shift + X 打开扩展市场。
然后在搜索框里输入：

Claude Code

你通常会看到官方扩展 Claude Code for VS Code，点击安装即可。

安装完成后，VS Code 中就具备了 Claude Code 的集成入口，但这并不代表已经可以直接使用，因为后面通常还要完成登录或 API 配置。

下载完成后右上角会出现图标

四、Claude Code 插件安装后，为什么还不能直接用

很多人安装完插件后第一反应是：“怎么还是用不了？”
原因通常不是插件坏了，而是 Claude Code 还没有完成身份认证或模型后端配置。

从官方 VS Code 文档和实际插件页面来看，Claude Code 常见有几种认证或接入方式：

• 使用 Claude.ai 订阅登录；

• 使用 Anthropic Console 按 API 调用计费；

• 使用 Bedrock、Vertex 等云端集成方式；

• 通过自定义 API Key、Base URL 和模型配置，接第三方兼容后端。

这也是为什么很多博客会教你去改 settings.json，因为很多人并不是直接走官方登录，而是走 API 配置方式。

五、VS Code 中配置 Claude Code 的 API

        如果你打算通过 API 使用 Claude Code，而不是直接点订阅登录，那么常见做法就是打开 VS Code 的 settings.json 进行配置。

如果不想配置，可以直接下载CC-Switch，具体可以参照我的上一篇博客~

操作路径通常是：

1. 找到 Claude Code 插件；

2. 点击插件右侧齿轮；

3. 进入设置；

4. 找到“在 settings.json 中编辑”或直接打开 VS Code 用户设置 JSON。

在一些社区教程中，Claude Code 的 VS Code 插件支持通过 claudeCode.environmentVariables 写入环境变量形式的配置，例如：

"claudeCode.environmentVariables": [ { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your_api_key" }, { "name": "ANTHROPIC_BASE_URL", "value": "https://your-api-base-url" }, { "name": "ANTHROPIC_MODEL", "value": "your-model-name" }, { "name": "ANTHROPIC_SMALL_FAST_MODEL", "value": "your-fast-model-name" } ]

这类字段在第三方教程里很常见，作用分别是：

• ANTHROPIC_AUTH_TOKEN：你的 API Key；

• ANTHROPIC_BASE_URL：后端接口地址；

• ANTHROPIC_MODEL：主模型名称；

• ANTHROPIC_SMALL_FAST_MODEL：更快的小模型名称，用来加速一些轻量交互。

        如果你用的是官方 Anthropic 接口，也可以根据实际版本改用 ANTHROPIC_API_KEY 风格的配置方式，因为不同版本资料里字段命名存在差异。

六、配置完成后，为什么建议重启 VS Code

        很多教程都会提一句：改完配置后，最好退出 VS Code 再重新打开。
        这不是玄学，而是因为某些扩展在初始化时就会读取环境变量或插件设置，改完后不重启，有时不会立刻生效。

所以我的建议是：

• 保存 settings.json；

• 完全关闭 VS Code；

• 重新打开 VS Code；

• 回到 Claude Code 插件面板重新测试。

这个细节看起来不起眼，但很容易决定你“第一次到底能不能用起来”。

七、全局安装 Claude Code 是什么？为什么很多人还要装它

        如果你已经在 VS Code 里装好了插件，可能会问：
那为什么还有那么多人要额外执行 npm install -g @anthropic-ai/claude-code？

答案很简单：因为很多人希望在 命令行里直接调用 Claude。
全局安装之后，你就可以在任意终端里使用 claude 命令；只要先进入项目目录，Claude Code 就可以围绕当前项目工作。

这类方式特别适合：

• 喜欢终端工作流的开发者；

• 想在项目根目录快速启动 Claude 的人；

• 需要本地读取目录、运行命令、结合 shell 操作的人。

也就是说，全局安装不是“多此一举”，而是给你多开了一扇门。

八、如何全局安装 Claude Code

前提是你已经安装好了 Node.js 和 npm。
然后打开命令行，执行：

npm install -g @anthropic-ai/claude-code

如果安装成功，再输入：

claude --version

能看到版本号，就说明全局命令已经安装成功。

比如常见输出可能类似：

只要能输出版本号，就说明命令本体已经装上了。

九、为什么我全局安装了 Claude，却找不到 .claude 文件夹

        这是很多人第一次装完之后最疑惑的问题之一。
原因是：安装成功并不代表一定会立刻生成 .claude 文件夹。

        有些情况下，Claude Code 会先生成 ~/.claude.json 这样的用户级配置文件，而不是立刻生成 ~/.claude/ 文件夹。
也就是说，你已经装好了 Claude，但它还没有创建你以为一定会出现的那个目录。

如果你想手动配置，可以自己创建：

mkdir %USERPROFILE%\.claude notepad %USERPROFILE%\.claude\settings.json

这样你就可以手动写入 API Key、Base URL 和模型配置了。

十、全局安装 Claude 后，应该如何配置 API

如果你要让命令行版本的 Claude 真正可用，核心仍然是把 API 信息配进去。

一种常见方式是创建：

C:\Users\你的用户名\.claude\settings.json

然后写入类似下面的配置：

官方 Anthropic API 版

{ "env": { "ANTHROPIC_API_KEY": "你的官方Anthropic_API_Key", "ANTHROPIC_BASE_URL": "https://api.anthropic.com", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514", "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-20250514" } }

第三方兼容版

{ "env": { "ANTHROPIC_API_KEY": "你的第三方API_Key", "ANTHROPIC_BASE_URL": "https://你的兼容网关地址", "ANTHROPIC_MODEL": "你的模型名", "ANTHROPIC_SMALL_FAST_MODEL": "你的快速模型名" } }

这里最重要的是三点：

• Key 要填对；

• Base URL 要填对；

• 模型名必须是对方后端真的支持的名字。

十一、VS Code 插件版和全局安装版，到底该怎么选

很多人看到这里还是会纠结：
我到底该只装插件，还是插件和全局安装一起装？

我的建议非常直接：

适合只装插件的人

• 平时主要在 VS Code 里工作；

• 更喜欢图形界面；

• 主要需求是编辑器内联辅助、面板对话、工作区交互。

适合插件 + 全局安装一起装的人

• 经常用终端；

• 喜欢在项目目录里直接启动 Claude；

• 希望以后扩展更多 CLI 工作流。

适合优先装全局命令的人

• 你主要用 shell、WSL、远程开发；

• 你更在意项目目录级别的操作，而不是 VS Code 面板体验。

简单说就是：
插件更像 IDE 入口，全局安装更像终端入口

遇到 command 'claude-vscode.editor.openLast' not found 怎么办

        这是 Claude Code 在 VS Code 中比较典型的一个报错，尤其在某些版本更新后，Windows 用户更容易遇到。

        从社区和相关文章来看，这个问题并不一定是你安装错了，很多时候是 扩展特定版本本身存在兼容性问题。

如果你是第一次接触 Claude Code，我的建议是：

1. 先安装 VS Code 插件，因为最直观；

2. 再 全局安装 Claude 命令，这样你后面不会被“插件限制”卡住；

3. API 配置尽量统一，避免插件一套、命令行一套；

4. 先在一个小项目里测试成功，再投入正式项目。

这样做的好处是：
无论插件能不能稳定工作，你至少都有一条备用路线。
插件异常时你还能切到终端；终端不方便时你又能回到 VS Code 面板。

常见问题汇总

1. 为什么插件装好了却不能聊天？

通常是还没完成登录或 API 配置。

2. 为什么全局安装成功了却找不到 .claude 文件夹？

因为有些情况下先生成的是 .claude.json，不是 .claude/ 目录。

3. 为什么重装插件也没解决 openLast not found？

因为某些时期是扩展版本本身的问题，不是你本地环境坏了。

4. 只装插件不装全局命令可以吗？

可以，但灵活性会差一些。

5. 只装全局命令不装插件可以吗？

也可以，只是编辑器内集成体验会少很多。

        总的来说，Claude Code 并不是“装个插件就结束”的工具，它更像一套完整的开发工作流入口。
        你真正需要搞清楚的不是“怎么点安装”，而是 VS Code 插件和全局命令分别负责什么、API 怎么统一配置、遇到问题时如何切换方案。
        当你把这两条路都打通之后，Claude Code 才会真正变成一个稳定可用的开发助手，而不是一个“看起来装上了、实际上用不顺”的插件。

        写在最后：

        当你读到这里，应该会恍然大悟，Codex和Claude的方式竟然如此相似，但又有些不同，那么恭喜你，你已经明白了，万变不离，规则早在潜移默化中形成了，工具再怎么变也还是工具，关键是使用它的人。