Claude Code 安装指南:从零开始上手Anthropic官方CLI工具

引言

最近,AI编程助手市场又迎来一位重量级选手——Anthropic官方推出了Claude Code CLI工具。不同于Copilot那种嵌入IDE的辅助模式,Claude Code是一个独立的命令行工具,它更像是一个"全能AI助手",不仅能写代码,还能帮你管理项目、写文档、甚至搭建知识库。

对于国内开发者来说,最大的障碍是访问限制和模型选择。本文将手把手教你如何绕过这些障碍,快速上手Claude Code。

本文所有链接都在最后参考资料中列出。

正文

一、Claude Code的三种安装方式

目前安装Claude Code主要有三种方式:

方式一:通过官网直接安装

这是最简单的方式,访问Anthropic官网下载安装包即可。但问题在于——国内IP直接访问Anthropic官网会受到限制,当下载时会看到"App unavailable in region | Claude by Anthropic",这是因为Anthropic封禁了中国大陆的访问。即使下载了安装器也还要从外网下载安装文件,同样也会受限。

方式二:通过Windows命令安装

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

同样会报错,原因和方式一遇到的一样——Anthropic封禁了中国大陆的访问。

方式三:通过npm安装(推荐)

如果你无法使用科学上网,那么使用npm来安装Claude Code是目前最容易做到的方式,下面将详细讲解。

二、npm安装详细步骤

下面我们重点介绍npm安装方式,这是国内用户最推荐的方案。

前置条件

1. 已安装Node.js
2. 已安装npm或pnpm

去NodeJS官网下载地址选择最新的LTS版本下载安装即可。

验证安装:

node -v# 输出示例: v24.15.0

npm -v# 输出示例: 11.12.1

并且设置使用阿里云镜像源:

npm config set registry https://registry.npmmirror.com

三、安装并使用Claude Code

步骤1:安装Claude Code

打开命令行,输入以下命令:

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

步骤2:验证安装

安装完成后,输入以下命令验证:

claude --version# 输出示例: 2.1.201 (Claude Code)

如果显示版本号,说明安装成功。

步骤3:首次启动

可以新建一个文件夹,进入文件夹后右键在菜单中选择"在终端打开",进入命令行窗口,并输入以下命令启动Claude Code:

claude

回车选择1,进入欢迎界面:

此时因为你没有购买任何模型,所以右下角显示未登录。如果你输入文字和Claude Code交互也会报错:

这时候,你就需要去购买一个模型来配置到Claude Code中。因为Anthropic官方的模型已经对中国大陆封禁,即使购买了也可能存在访问不稳定的风险,这里还是推荐购买国内的模型厂商。

如果你是程序员,那么推荐使用GLM-5系列(如GLM-5.1、GLM-5.2等)的模型,推荐购买Coding Plan的套餐,几十块一个月的普通版够大部分人用。目前有以下厂商提供:

• 智谱官方 Coding Plan - 每天10点开放优惠名额
• 方舟 Coding Plan - 每天0:00分开放优惠名额,最划算,也不好抢
• 讯飞星辰 Coding Plan - 不用怎么抢,买个月费39元的专业版,基本够用

下面以讯飞星辰的Coding Plan为例,购买后会看到套餐明细:

最主要的参数就是APIKey和modelId。

步骤4:配置API Key

我们将APIKey和modelId填入settings.json中,配置如下:

{"env":{"ANTHROPIC_AUTH_TOKEN":"填入你的APIKey","ANTHROPIC_MODEL":"astron-code-latest","CLAUDE_CODE_AUTO_COMPACT_WINDOW":"1000000","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":"1","API_TIMEOUT_MS":"600000"}}

settings.json默认在 C:\Users\<你当前的用户名>\.claude 下,如果没有就新建一个,注意编码格式为UTF-8。

步骤5:重新启动Claude Code

再次输入 claude 启动Claude Code:

可以看到模型名显示了我们配置的 astron-code-latest,并且Claude Code也不再提示未登录。接下来就可以和它愉快地对话了:

四、编译器集成Claude Code

以JetBrains的Intellij系列的编译器为例,在插件市场里找到Anthropic官方提供的插件安装:

安装好后,就在编译器右上角看到Claude Code的符号:

点击运行即可。

结语

Claude Code不是Copilot的替代品,而是新一代AI助手工具的代表。它的核心价值在于:

• 全栈能力: 不只是写代码,还能写文档、管项目、建知识库
• 项目级理解: 理解整个项目结构,而非单文件
• 低成本入门: npm安装+国内模型方案,费用可控

未来,AI助手会成为开发者的标配工具。现在入门Claude Code,就是提前掌握未来。

参考资料

Anthropic官网https://claude.com/product/claude-code

Claude Code官方快速入门教程https://code.claude.com/docs/zh-CN/quickstart

NodeJS官网下载地址https://nodejs.org/zh-cn/download

阿里云npm镜像源https://registry.npmmirror.com

智谱官方 Coding Planhttps://bigmodel.cn/glm-coding

方舟 Coding Planhttps://www.volcengine.com/activity/codingplan

讯飞星辰 Coding Planhttps://maas.xfyun.cn/packageSubscription