🚀 一文搞定 claude code：国内环境下的安装、配置与体验

前言

这段时间claude code很火,到处都有文章介绍这个工具. 作为程序员,我必须立刻体验.这篇文章记录了我怎么在window环境中安装、配置、使用claude code

🤖 什么是`claude code`?

claude code 是由 Anthropic 推出的 AI 编程助手，类似于 Copilot 或 ChatGPT Code Interpreter。它基于 Claude 大模型，能够理解自然语言指令，帮助开发者自动生成、补全、优化代码，甚至能理解和分析整个项目结构。你可以用它来写代码、查 bug、生成文档、解释代码逻辑等，大大提升开发效率。

其主要特点包括：

支持多种编程语言，适合前后端开发
能够理解复杂的自然语言描述，生成高质量代码
支持本地和云端运行，灵活集成到 VSCode、终端等开发环境
可与项目文件深度联动，直接操作和分析本地代码

🌐 为什么需要中转访问?

由于 claude code 官方目前并未对中国大陆用户开放服务，直接访问时常常会遇到无法注册、登录或连接失败等问题。通过中转服务，可以绕过地域限制，让国内用户也能顺利体验 claude code 的各项功能。

常见的中转服务有：

anyrouter
claude-api-proxy（支持自建）
claude-api.one
openrouter.ai
api2d.com

选择合适的中转服务后，基本可以顺利体验 claude code。

这里我以anyRouter为例,主要是我发现这个新用户注册可以白嫖$110的claude code额度,使用邀请连接的话,双方都可以白嫖$50的Claude code额度

下面我以anyRouter为例,来演示

📝 注册anyRouter

官网地址:anyrouter.top/

我的邀请连接:anyrouter.top/register?af...

打开anyrouter的官网

点击注册!

我这里选择用github去注册,没有多余的步骤,点击使用github继续之后就直接下一步,就完事了,很快

注册完成之后,查看我们的账号余额,官方送了$110的余额给我们,够我们用一段时间的.

🔑 创建令牌(token)

注册完成之后需要创建一个令牌,后面使用claude code的时候需要设置token

这里按照你自己的需求创建一个token

像上面这样就创建成功了

💻 安装claude code

因为我的电脑是win11,所以需要借助wsl的帮助.

shell 复制代码

wsl -v

先用上面的命令检查一下你有没有安装wsl,如果有,就会像下面这样输出版本信息.

shell 复制代码

wsl --list --verbose

再用这个一下安装的过的子系统列表

像我这边,之前用docker的原因,所以下面有一个docker的子系统.

我们需要安装一个linux的子系统,这里以Ubuntu为例

shell 复制代码

wsl --install -d Ubuntu // 安装乌班图系统
wsl --set-default Ubuntu // 设置为默认系统

可以看到我这里已经安装好了.

第一次使用需要设置用户名和密码,自己的记录一下,免得下次需要的时候忘记账号和密码

接下来需要在ubuntu中安装node和npm

shell 复制代码

// 安装指定版本的nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash 
// 重新加载配置
source ~/.bashrc
// 查看版本
nvm -v

我这里安装的是nvm方便管理node版本,具体的nvm版本可以去github上面看最新的是0.40.3,我这里用的是0.39.0版本

用nvm安装node和npm

shell 复制代码

nvm install --lts
nvm use 22.17.0
node -v 
npm -v

安装完成之后就可以安装claude code

sql 复制代码

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

claude --version

如果打印版本号能够出来,就安装成功了

将前面创建的token,复制过来,并设置环境变量,如下所示

shell 复制代码

export ANTHROPIC_AUTH_TOKEN=[你的token]
export ANTHROPIC_BASE_URL=https://anyrouter.top

设置完成之后,执行claude,就可以打开claude code了,

测试一下

如果可以对话,就成功了

� 测试效果

这里我让他创建一个2048的程序

我打开终端的位置是这里

所以前面生成的代码文件也在这下面,运行效果如下

效果非常不错,但是token消耗的也很大,就这个demo消耗了我7k的token

🛠️ vscode/cursor中使用

那么我们要如何在vscode里面使用呢? 首先要装两个插件

Claude Code for VSCode

wsl

安装完成之后

选择连接到wsl

连接成功之后,可以看到,终端已经变成ubuntu的了

设置一下token和地址

这样就成功启动claude code了,接下来要打开对应的工作区目录

比如刚才生成的那个2048项目放在桌面的ProjectDemo下面,那么我打开的就是 /mnt/c/Users/cathe/Desktop/projectDemo/

这里就成功访问到我的projectdemo项目了

这里我让他读取script.js文件的内容,并且给出哪个文件引用了它

可以看到它给出了结果,并且我也可以直接点击访问,说明已经和vscode集成成功了

前面我们还装了一个插件

这个插件可以在当前目录下快速打开claude,还可以自动将文本添加到claude上下文中

⚙️ 环境变量的配置

前面我们每次启动claude code 都要设置一次环境变量非常的麻烦,我们直接将其写入到bash_profile、bashrc、zshrc文件中去,这样就不用每一次都重复配置了

shell 复制代码

// 写入到bash_profile文件
echo -e '\n export ANTHROPIC_AUTH_TOKEN=[你的token]' >> ~/.bash_profile
echo -e '\n export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.bash_profile
// 写入到bashrc文件
echo -e '\n export ANTHROPIC_AUTH_TOKEN=[你的token]' >> ~/.bashrc
echo -e '\n export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.bashrc
// 写入到zshrc文件
echo -e '\n export ANTHROPIC_AUTH_TOKEN=[你的token]' >> ~/.zshrc
echo -e '\n export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.zshrc

配置前我们每次打开都会提示,token的问题,必须重新配置token才行

配置之后就不会有这种问题了

🛎️ 一些常用 claude code 命令

以下是一些在日常使用 claude code 时比较实用的命令，方便快速上手：

shell 复制代码

# 查看 claude code 版本
claude --version

# 启动 claude code 聊天界面
claude

# 指定工作目录启动（比如当前项目目录）
claude -C /path/to/your/project

# 直接让 claude code 读取某个文件内容
gpt read ./src/App.vue

# 让 claude code 解释某段代码
claude explain ./src/utils/math.js

# 让 claude code 生成单元测试
gpt test ./src/components/Button.vue

# 让 claude code 优化某个文件的代码
claude optimize ./src/pages/Home.vue

# 查看所有可用命令和帮助
claude --help

说明：部分命令可能因版本或集成环境不同略有差异，具体可通过 claude --help 查看详细用法。

🎯 结尾

这样就可以在window+vscode中愉快的使用claude code了

🚀 一文搞定 claude code：国内环境下的安装、配置与体验

前言

🤖 什么是claude code?

🌐 为什么需要中转访问?

📝 注册anyRouter

🔑 创建令牌(token)

💻 安装claude code

� 测试效果

🛠️ vscode/cursor中使用

⚙️ 环境变量的配置

🛎️ 一些常用 claude code 命令

🎯 结尾

🤖 什么是`claude code`?