跳到主要内容

Claude Code IDE

Claude Code for VS Code

一.安装插件​

除了CLI，Claude Code还有VS Code扩展版本。现在可以在VS Code扩展市场中一键安装Claude Code。

image.png

也可以直接在VS Code中使用CLaude Code CLI，扩展版本相较于CLI，安装更加简单，还提供了可视化的 GUI 面板，对不喜欢使用终端的同学会更友好。

image.png

image.png

二.首次使用​

安装完成后点击编辑区域logo即可打开Claude Code对话面板，第一次打开会提示登录使用，如果你已经开通了官方的服务，可以直接登录，如果没有，也可以操作下列步骤跳过登录，从而接入我们的第三方模型服务。

image.png

三.自定义API​

首先创建一个文本文档，将文件名改为config.json，并将其放入以下路径：

  • Mac ~/.claude/config.json
  • Windows C:\Users\Administrator\.claude\config.json

然后使用记事本打开，写入以下内容直接保存：

{
"primaryApiKey":"self"
}

回到VS Code扩展商店页面，点开Claude Code插件设置，找到Edit in settings.json这个链接跳转到JSON配置文件编辑页面。

image.png

image.png

将API配置命令行插入到环境变量配置文件的代码中。

    "claude-code.environmentVariables":[
        {
            "name": "ANTHROPIC_AUTH_TOKEN",
            "value": "在这里填入你的SK开头密钥"
        },
        {
            "name": "ANTHROPIC_BASE_URL",
            "value": "https://cloud.ai.liandxu.cn"
        }
    ],

image.png

如果是新文件，注意json格式，填：

{
    "claude-code.environmentVariables": [
        {
            "name": "ANTHROPIC_AUTH_TOKEN",
            "value": "sk-NfcHVcaLaGh0sQo0dpbC5KES6ZhXuwDIJ61tSV7csgtwjMes"
        },
        {
            "name": "ANTHROPIC_BASE_URL",
            "value": "https://cloud.ai.liandxu.cn"
        }
    ]
}

修改完成后，按Ctrl+S保存，重新打开Claude Code插件，即可正常使用Claude Code。

四.自定义使用第三方模型​

在VS Code中的Claude Code模型切换和CLI也有区别，在切换模型前打开自动执行权限模式，可以避免Claude Code在执行各项操作前弹窗让你确认。

image.png

打开自动执行权限：

image.png

填入其他模型：

image.png

五、测试是否配置成功​

重启 VS Code 后，点击左侧的 Claude Code 图标唤出对话面板。

在底部的输入框中直接发送测试语句： 你好，请问 1+1 等于几？

🟢 成功标志：如果它能直接用中文回答你 1+1=2，说明你已经成功连上了我们的接口！

🔴 失败标志：如果提示 Invalid API Key 或弹窗要求 Please run /login，说明你的 settings.json 没保存对，或者刚才没有彻底重启 VS Code，请检查第三步。

六、常见问题排查 (FAQ)​

Q：为什么输入问题后提示 Invalid API Key 或是让我登录？ A：VS Code 插件没有成功读取到你的环境变量。

  • 请检查第二步的 .claude/config.json 文件名是否正确（注意不要保存成了 config.json.txt）。

  • 请检查第三步中填写的 ANTHROPIC_BASE_URL 网址是否完全正确。

  • 最重要的是：修改完配置后必须彻底关闭整个 VS Code 软件并重新打开。

Q：插件右上角一直显示 Offline 状态？ A：不用担心。这是因为 Claude 官方插件会尝试连接 Google 服务器来检测网络。受国内网络环境影响显示离线是正常的，只要你的问题能发送出去并收到回复，就不影响正常敲代码。