本教程分为 编辑器扩展 和 命令行 CLI 两种使用方式,请按实际需要选择,推荐优先在 VS Code / Cursor 中安装 Anthropic 官方 Claude Code 扩展,通过图形化面板使用。| 使用方式 | 适用场景 | 是否需要单独安装 CLI | 是否需要 Node.js |
|---|
| Claude Code 扩展(推荐) | 在 VS Code / Cursor 中聊天、分析项目、修改代码、查看差异 | 不需要 | 扩展本身不需要 |
| Claude Code CLI | 在系统终端或编辑器集成终端中使用 claude 命令 | 需要 | 官方原生安装不需要;npm 安装需要 Node.js 22+ |
扩展自带供聊天面板使用的 Claude Code 程序。安装扩展后即可按第一部分配置使用,无需先执行 npm 安装命令。
如果需要在终端中输入 claude,请按第二部分单独安装 CLI。
接口信息#
| 配置项 | 作用 | 填写内容 |
|---|
ANTHROPIC_BASE_URL | API 基础地址 | https://n.lconai.com |
ANTHROPIC_AUTH_TOKEN | 接口认证凭据 | 智创聚合后台生成的 API Key |
ANTHROPIC_AUTH_TOKEN 直接填写 sk- 开头的 Key,无需自行添加 Bearer 前缀。请使用当前分组支持的 Claude 模型。模型名称、额度及价格以智创聚合后台为准。第一部分:安装并配置 Claude Code 扩展(推荐)#
本部分适用于 VS Code 和 Cursor 的 Claude Code 图形化面板。一、安装编辑器#
VS Code 需要 1.94.0 或更高版本,建议使用当前稳定版。二、安装官方 Claude Code 扩展#
2.
Windows / Linux:Ctrl + Shift + X
4.
确认发布者为 Anthropic,扩展标识为 anthropic.claude-code。
安装完成后,如果扩展没有显示,打开命令面板并执行:Windows / Linux:Ctrl + Shift + P
只使用扩展聊天面板时,到这里不需要安装 Node.js,也不需要安装 Claude Code CLI。如果 Claude 需要运行项目的构建、测试或启动命令,则项目所需的 Node.js、Python、Java 等开发环境仍需另外安装。
三、配置 API 地址和 Key#
推荐将接口配置写入 Claude Code 用户设置文件。这样扩展直接读取配置,无需依赖终端临时环境变量。1. 找到用户设置文件#
| 运行环境 | 默认文件位置 |
|---|
| Windows 原生 | C:\Users\你的用户名\.claude\settings.json |
| macOS | /Users/你的用户名/.claude/settings.json |
| Linux | /home/你的用户名/.claude/settings.json |
| WSL / SSH 远程环境 | 运行 Claude Code 的远程用户主目录下 .claude/settings.json |
如果 .claude 目录或 settings.json 不存在,可以手动创建。如果设置了 CLAUDE_CONFIG_DIR,请以该变量指定的配置目录为准。
在 WSL、SSH 或开发容器中使用时,应确认扩展实际运行的位置,并编辑该环境中的配置文件。
2. 填写 Claude Code settings.json#
{
"env": {
"ANTHROPIC_BASE_URL": "https://n.lconai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
将 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 替换为你的智创聚合 API Key。如果已有其他配置,请合并 env 字段,保留原有设置。Windows 中确认文件不是 settings.json.txt。
四、关闭扩展登录提示#
使用本站中转接口时,在编辑器中启用 Disable Login Prompt。3.
勾选 Claude Code: Disable Login Prompt。
Preferences: Open User Settings (JSON)
{
"claudeCode.disableLoginPrompt": true
}
如果已有编辑器配置,只需添加该字段,不要覆盖整个文件。Claude Code 用户设置:.claude/settings.json,填写 env、API 地址和 Key。
编辑器用户设置:通过 Preferences: Open User Settings (JSON) 打开,填写 claudeCode.disableLoginPrompt。
五、重载并开始使用#
2.
执行 Developer: Reload Window。
打开代码文件后,编辑器右上角的 Claude Code 图标。
请分析当前项目的目录结构,说明项目的技术栈和主要入口文件。
如果能正常返回,且智创聚合后台出现对应调用记录,说明接入成功。引用文件与代码#
请检查 @src/ 目录中的接口实现,并指出可能的问题。
六、可选:仅为扩展设置环境变量#
如果希望 API 配置仅用于编辑器扩展,也可以在编辑器用户设置 JSON 中配置:{
"claudeCode.disableLoginPrompt": true,
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://n.lconai.com"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
]
}
这是第三节用户配置文件方式的另一种选择。建议选择一种方式维护,避免多处保存不同的 API 地址或 Key。claudeCode.environmentVariables 用于扩展启动的 Claude Code 进程,不等同于系统环境变量,也不会自动为独立终端中的 claude 命令配置接口。
第二部分:安装并配置 Claude Code CLI(终端用户)#
本部分适用于希望在 PowerShell、CMD、Bash、Zsh 或编辑器集成终端 中输入 claude 的用户。一、环境准备#
| 项目 | 要求 |
|---|
| macOS | macOS 13 或更高版本 |
| Windows | Windows 10 1809 或更高版本 |
| Linux | Ubuntu 20.04、Debian 10 或更高版本 |
| 内存 | 建议 4 GB 或以上 |
| Shell | Bash、Zsh、PowerShell 或 CMD |
| 网络 | 能访问安装资源及本站 API |
Windows 原生环境建议安装 Git for Windows,以便使用 Git 和 Git Bash。当前版本未安装 Git Bash 时,可使用 PowerShell 执行 Shell 工具命令;旧版本的要求可能不同。二、安装 CLI#
方式一:官方原生安装(推荐)#
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
方式二:npm 安装#
使用 npm 安装时,需要 Node.js 22 或更高版本。普通 npm install 命令使用当前 npm 配置的源;只有显式指定镜像或已配置镜像时,才会使用国内镜像。如果出现全局安装权限错误,建议使用 Node.js 版本管理器或调整 npm 全局安装目录,不要直接使用 sudo npm install -g。验证安装#
三、配置 CLI 接口#
推荐使用 Claude Code 用户设置文件,也可以使用当前终端环境变量。两种方式任选一种即可。方式一:用户设置文件(推荐)#
| 环境 | 默认文件位置 |
|---|
| Windows 原生 | %USERPROFILE%\.claude\settings.json |
| macOS / Linux / WSL | ~/.claude/settings.json |
{
"env": {
"ANTHROPIC_BASE_URL": "https://n.lconai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
如果已经按第一部分配置了同一运行环境下的用户设置文件,CLI 可以读取该配置,无需重复填写。方式二:当前终端临时配置#
以下变量仅对当前终端及其启动的进程有效。关闭终端后需要重新设置。macOS / Linux / WSL#
Windows PowerShell#
$env:ANTHROPIC_BASE_URL = "https://n.lconai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Set-Location "D:\你的项目路径"
claude
Windows CMD#
set "ANTHROPIC_BASE_URL=https://n.lconai.com"
set "ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
cd /d "D:\你的项目路径"
claude
PowerShell 使用 $env:变量名,CMD 使用 set,Bash / Zsh 使用 export。请按当前终端类型执行。
四、启动并验证 CLI#
请分析当前项目的技术栈,并说明如何启动和运行测试。
五、在 VS Code / Cursor 集成终端中使用 CLI#
先完成本部分的独立 CLI 安装和 API 配置,然后:| 入口 | 启动方式 | 使用的程序 |
|---|
| Claude Code 扩展面板 | 点击扩展图标或通过命令面板打开 | 扩展自带的 Claude Code |
| 编辑器集成终端 | 输入 claude | 单独安装并加入 PATH 的 CLI |
CLI 的 npm 安装更新不会自动更新编辑器扩展;扩展更新也不会自动更新系统安装的 CLI。六、CLI 更新#
第三部分:模型设置与常见问题#
一、选择模型#
扩展中选择#
在 Claude Code 扩展面板中打开模型选择菜单,选择当前可用模型。支持的版本也可以输入:CLI 中选择#
设置默认模型#
在 Claude Code 用户设置文件中合并 model 字段:{
"model": "后台提供的模型名称",
"env": {
"ANTHROPIC_BASE_URL": "https://n.lconai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
请将“后台提供的模型名称”替换为真实模型 ID,不要原样使用占位文字。如果提示模型不存在,请检查默认模型及辅助任务使用的模型是否都在当前分组支持范围内。二、扩展反复提示登录#
1.
是否启用了 claudeCode.disableLoginPrompt。
3.
是否执行了 Developer: Reload Window 并新建会话。
4.
WSL / SSH / 容器环境中,是否编辑了实际运行环境的配置文件。
关闭登录提示只影响界面行为,仍需有效的 API 配置和 Key。三、扩展可以使用,但终端提示找不到 claude#
扩展自带的程序用于聊天面板,不会自动将 claude 命令加入系统 PATH。四、CLI 安装后仍找不到 claude#
先重新打开终端。如果使用编辑器集成终端,请完全退出并重新打开编辑器。原生安装:检查用户主目录下的 .local/bin 是否加入 PATH。
npm 安装:检查 npm config get prefix 对应的全局命令目录是否加入 PATH。
五、认证失败或返回 401#
是否配置了其他 ANTHROPIC_API_KEY、OAuth 凭据或第三方平台变量。
排查时不要将真实 Key 输出到公开日志或截图中。六、连接失败或返回 404#
Claude Code 会根据基础地址构造接口路径。本教程中不要自行追加 /v1 或 /v1/messages。同时检查网络、代理设置及当前通道是否支持 Claude Code 所需的 Anthropic Messages 接口。七、扩展未显示或无法启动#
1.
是否安装发布者为 Anthropic 的官方扩展。
6.
WSL / SSH 环境中是否已在对应环境安装扩展。
可以通过命令面板搜索 Claude Code,查看可用入口。如果出现启动错误,通过“查看 → 输出”选择 Claude Code 对应日志通道,查看错误信息。八、npm 安装失败#
如果 PowerShell 提示禁止运行 npm.ps1,可以使用:npm.cmd install -g @anthropic-ai/claude-code@latest
如果下载较慢,可临时指定镜像源;如果全局目录权限不足,可改用官方原生安装或 Node.js 版本管理工具。九、返回 429、额度不足或模型无权限#
十、官方账号功能不可用#
远程控制、云端会话等依赖官方账号或官方服务的功能,可能无法通过自定义中转地址使用。具体能力以当前 Claude Code 版本和本站通道支持情况为准。十一、避免配置重复#
建议优先使用用户级 .claude/settings.json 维护 API 地址和 Key。如果同时使用系统环境变量、扩展环境变量和项目配置,请确认它们的值一致。切换接口时,应同步修改或移除原有配置,并重新启动会话。官方参考文档#
如遇扩展安装、API 配置或 CLI 使用问题,可联系客服免费提供远程配置服务。