1. 为什么要在 VS Code 里联动 Claude CodeVS Code 联动 Claude Code 安装教程要解决的核心问题很具体你已经在终端里用上了 Claude Code CLI但每次改代码都要切窗口、复制路径、手动贴上下文效率被切得很碎。把 Claude Code 装进 VS Code 之后编辑器里选中一段代码就能直接对话改完的文件差异会以 diff 形式回显确认后再落盘整个链路不用离开 IDE。这套方案适合三类人一是日常在 VS Code 里写业务代码、想让 AI 直接读当前工作区的开发者二是团队里多人共用一套 AI 通道、需要统一 Key 和统一出口的工程组三是用远程开发机或容器写代码、本地只跑一个编辑器的同学。它的本质是把 Claude Code 当成一个编辑器内的 AI 进程VS Code 扩展负责拉起进程并转发请求真正的模型调用走的是你在 settings.json 里配置的通道。我试过把 CLI 和扩展分开配、Key 写两遍的做法结果是两边行为不一致排查起来很痛苦。所以这篇教程的主线是先装 CLI再装扩展最后用一份统一的 settings.json 骨架把通道、超时、语言一次性对齐让终端和编辑器共用同一套配置。下面从环境准备开始每一步都给可复制的命令和配置。2. 前置准备环境、CLI 与统一 Key2.1 检查 Node 与 npm 版本Claude Code CLI 依赖 Node 运行时版本过低会在安装阶段直接报错。先确认node --version npm --version建议 Node 18.x 或更高、npm 9.x 或更高。如果版本偏低用 nvm 装一个 LTScurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc nvm install --lts nvm use --lts装完再跑一次node --version确认切换成功。这一步别跳过后面扩展拉不起进程十有八九是 Node 版本或路径的问题。2.2 安装 Claude Code CLI全局安装 CLInpm install -g anthropic-ai/claude-code claude --version能打印出版本号就说明 CLI 就位。记住which claude的输出路径后面排查扩展找不到 CLI时会用到。2.3 在 TaoToken 拿统一 Key打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key。这个 Key 就是统一 Key——终端里的 Claude Code 和 VS Code 扩展都指向它不用维护两套凭证。创建入口在控制台的 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。生成后先复制到剪贴板Key 只显示一次丢了只能重建。注意Key 属于敏感凭证不要写进会提交到 Git 的文件。下面配置里我会把它放在用户级 settings.json项目级文件只放非敏感项。2.4 创建规范的工作目录目录名用连字符避免空格否则扩展拼路径时容易出问题mkdir -p ~/claude-code-demo cd ~/claude-code-demo到这里前置就绪Node 就位、CLI 可执行、Key 到手、工作目录干净。接下来进入配置环节。3. 可复制的 settings.json 骨架3.1 用户级配置~/.claude/settings.jsonClaude Code 读取配置的优先级是项目级.claude/settings.local.json 项目级.claude/settings.json 用户级~/.claude/settings.json。统一 Key 放在用户级所有项目自动继承。创建目录并写入骨架mkdir -p ~/.claude cat ~/.claude/settings.json EOF { env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 把这里替换成你的TaoToken Key, API_TIMEOUT_MS: 3000000 }, language: chinese, enabledPlugins: {} } EOF逐项说明字段作用建议值ANTHROPIC_BASE_URL请求出口地址https://taotoken.net/apiANTHROPIC_AUTH_TOKEN统一鉴权 Key你的 TaoToken KeyAPI_TIMEOUT_MS单次请求超时毫秒3000000language交互语言chineseenabledPlugins插件开关按需填API_TIMEOUT_MS给到 3000000 是为了长上下文和长文件改写不被中途掐断网络一般时尤其明显。3.2 项目级配置只放非敏感项在项目根目录建.claude/settings.json放团队共享的规则不放 Keymkdir -p .claude cat .claude/settings.json EOF { language: chinese, env: { API_TIMEOUT_MS: 3000000 } } EOF个人覆盖项写进.claude/settings.local.json并把它加进.gitignoreecho .claude/settings.local.json .gitignore3.3 VS Code 侧配置禁用登录提示扩展默认会弹登录引导用统一 Key 时要关掉它。在 VS Code 用户设置里加{ claudeCode.disableLoginPrompt: true }如果你用的是远程开发或 code-server用户设置文件路径通常是~/.local/share/code-server/User/settings.json本地 VS Code 则是~/.config/Code/User/settings.jsonLinux或对应平台的 User 目录。改完重启编辑器生效。3.4 校验 JSON 合法性配置写完先验一遍格式错会导致整份配置被忽略cat ~/.claude/settings.json | jq .jq能正常输出格式化结果就说明 JSON 合法。没装 jq 的话用python -m json.tool ~/.claude/settings.json也行。4. 安装扩展并验证联动是否生效4.1 安装 Claude Code 扩展在 VS Code 扩展面板搜索 Claude Code选择 Anthropic 发布的那个点安装。命令行方式code --install-extension anthropic.claude-codecode-server 用户把code换成code-server。装完重载窗口。4.2 打开 Claude Code 面板三种方式任选点编辑器右上角的闪电图标按CtrlShiftP输入 Claude Code 选打开或点右下角状态栏的 Claude Code 标识。面板能正常弹出说明扩展进程已启动。4.3 验证联动三个具体动作动作一终端侧验证通道。在项目目录执行cd ~/claude-code-demo claude进入交互后输入一句测试比如用一句话说明这个目录的作用。能正常回复说明 CLI 侧的 Key 和出口是通的。动作二编辑器侧验证上下文。在 VS Code 里打开~/claude-code-demo目录新建一个demo.py写几行代码选中后在 Claude Code 面板提问解释这段代码。如果它能读到选中内容并回答说明扩展和 CLI 之间的进程通信正常。动作三验证文件改写回显。让 Claude Code 修改demo.py里的某个函数观察是否弹出 diff 视图。有 diff 且能确认应用说明写权限链路完整。三个动作都通过联动就算真正生效了。只通过前两个、第三个失败通常是工作区权限或 CLI 路径问题看下一节。4.4 用模型对话快速确认通道如果你只想先确认 Key 和模型通道没问题不想装扩展可以直接用模型对话页面发一条请求https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。能正常返回内容说明 Key 有效、出口可达再回头排查编辑器侧就有的放矢。5. 本篇常见错排查5.1 Failed to spawn Claude Code process症状是扩展报spawn ... EACCES或找不到可执行文件。按顺序查which claude claude --version ls -la $(which claude)如果which claude为空说明 CLI 没进 PATH重装或把 npm 全局 bin 目录加进 PATH。如果路径里有空格把工作目录改成连字符命名。权限不足就补执行位chmod x $(which claude)5.2 登录界面卡住扩展仍弹 Google/GitHub 登录选项说明claudeCode.disableLoginPrompt没生效。确认改的是用户级settings.json不是工作区级改完必须重载窗口不是只刷新面板。5.3 终端无法连接 IDE执行/ide提示找不到可用 IDE多半是终端当前目录和 IDE 打开的项目目录不一致。切到同一目录再试cd ~/claude-code-demo claude /ide5.4 环境变量不生效配置改了但行为没变先验 JSONcat ~/.claude/settings.json | jq . cat .claude/settings.local.json | jq .再看是不是项目级配置覆盖了用户级。优先级顺序前面讲过项目级.local最高。5.5 扩展安装后无响应先看版本是否满足要求再查扩展宿主日志CtrlShiftP→ Show Logs → Extension Host。常见原因是 Node 版本过低或 CLI 路径未识别。重载窗口Developer: Reload Window往往能解决临时状态问题。5.6 权限错误 EACCESnpm 全局目录权限不对时修复归属sudo chown -R $USER:$(id -gn $USER) ~/.npm-global或者干脆用 nvm 管理 Node避免全局目录需要 sudo。6. 长期编码与 Agent 场景的通道选择如果你只是偶尔在编辑器里问几句上面的统一 Key 配置就够了。但如果你打算把 Claude Code 当成日常编码主力或者要跑 Agent 类的多步任务建议单独看一下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它面向的是长时间、高频次的编码会话和按次调用的 Key 在配额模型上不一样选对了能省不少心。接入细节和参数说明统一看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。文档里对 BASE_URL、超时、项目级配置的覆盖关系写得比较清楚遇到本文没覆盖的字段可以直接对照。最后给一个我踩过的坑改完~/.claude/settings.json后终端里的 Claude Code 会重新读取但已经打开的 VS Code 扩展进程不会自动重载配置。所以每次动 Key 或 BASE_URL记得重载一次编辑器窗口否则你会以为是配置写错了其实是旧进程还在用老配置。把配置纳入版本控制时只提交项目级非敏感文件用户级那份永远留在本机。