DeepAI · 环境准备 › 安装 Claude Code

安装 Claude Code

Anthropic 官方 AI 编程工具

推荐:VS Code 插件装法

Claude Code 是 Anthropic 官方出的 AI 编程工具,你用大白话告诉它要做什么,它帮你写代码、改文件、执行命令。 最省事的装法是当成 VS Code 插件:在 VS Code 左侧「扩展」面板搜索 Claude Code,点安装,装好后侧边栏会多出它的图标,点开就能用。(更习惯命令行的同学,也可以按下面第二节用 npm 安装。)

Mac / Windows 装法一样Claude Code 是装在 VS Code 里的插件,Mac 和 Windows 的安装方式完全相同—— 都是在 VS Code 的「扩展」面板里搜索、点安装,不分系统。
在 VS Code 扩展市场搜索并安装 Claude Code 插件
在 VS Code 扩展市场搜索并安装 Claude Code 插件
安装完成后点击侧边栏图标打开 Claude Code 面板
安装完成后点击侧边栏图标打开 Claude Code 面板
面板就绪,可以开始输入指令
面板就绪,可以开始输入指令
Claude Code 插件首次打开出现的登录选择界面:Claude.ai Subscription、Anthropic Console、Bedrock 三个选项
看到这个登录选择界面 = 安装完成的标志;这一页上的任何选项都不要点
看到上面这个界面,说明已经安装完成插件装好后第一次打开会出现这个「How do you want to log in?」登录选择界面——到这里安装这一步就完成了,三个登录选项一个都不要点(我们不用 Anthropic 账号,走的是 DeepAI 网关)。插件安装完成后,不需要打开终端,不需要再执行 npm install,也不需要运行 claude。直接继续下一步:CC Switch 的安装和配置 →,配好密钥、重启 VS Code 后它会自动接上网关。

命令行装法(可选)

已经安装 VS Code 插件的同学到这里就够了,下面整节都可以跳过。命令行方式只留给明确想用 CLI 的同学;两种装法选一个即可,不要重复安装。
装之前确认 Node 已经装好(见上一节「装 Node」);没装的先回去装。Git 也建议一并装好。

确保 VPN 已开启,然后在 VS Code 终端里运行下面的命令。安装大约需要 1–2 分钟(视网速而定)。

# 安装 Claude Code(需先连 VPN) npm install -g @anthropic-ai/claude-code # 验证安装是否成功 claude --version
装好后先别急着运行 claude 登录看到 claude --version 打出版本号,就说明装好了,这一步到此为止先别运行 claude 去登录——它要连的是 DeepAI 网关,而网关的密钥还没填。 授权放在下一步「CC Switch 配置」:用 CC Switch 填好密钥、重启 VS Code 之后, 从侧边栏打开 Claude Code 插件, 它会自动走网关,不需要 Anthropic 账号。现在就运行只会卡在登录界面。
如果看到红色报错里有 permission deniedEACCES 字样,先别自己改,把报错截图发到 DeepAI 飞书群 @助教,有同学踩过、有固定解法。
Windows 命令行安装 Claude Code 全过程(点图看大图)
先确认 Clash 系统代理 / TUN 已打开(VPN 生效)
1. 先确认 Clash 系统代理 / TUN 已打开(VPN 生效)
测试网络是否能连上境外服务
2. 测试网络是否能连上境外服务
在 VS Code 终端输入 npm install -g @anthropic-ai/claude-code
3. 在 VS Code 终端输入 npm install -g @anthropic-ai/claude-code
正在安装…
4. 正在安装…
安装成功
5. 安装成功
运行 claude --version 看到版本号,说明装好了
6. 运行 claude --version 看到版本号,说明装好了