当前位置： 首页 > news >正文

claude code安装使用

news 2026/5/8 4:28:06

分别尝试了在Windows下和Ubuntu下安装使用claude code，配置方法差不多都是可行的

1、Windows下安装

1.1 安装Node.js

Node.js是claude code必须的依赖环境，只管装就行了。
下载地址：https://nodejs.org/zh-cn/download

选择比较新的LTS长期支持版本即可，注意这里实际上提供了两种安装方法，一种是拉取docker镜像安装，另外一种是下载安装包安装，在Windows下我不太喜欢用docker，直接选择下载Windows的安装程序。当然也可以选择下载独立zip文件，但是这种方式需要手动配置环境变量。
下载完node-v24.14.0-x64.msi双击安装，一路next，能够查到版本信息就说明安装成功了如下图所示：

1.2 安装claude code

参考官方命令：https://code.claude.com/docs/en/setup#windows-setup
阿里云百炼https://bailian.console.aliyun.com/cn-beijing/?tab=coding-plan#/efm/index中使用指南
在PowerShell中执行下面指令：

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

安装完直接输入命令claude，如下出现版本号就是成功了：

可以看到我的电脑在执行claude命令的时候报错了，解决方法很简单，用everything直接全盘搜索.claude.json，一般在C:/User/用户名下面，原始内容图下：

{"firstStartTime":"2026-03-07T10:45:38.989Z","opusProMigrationComplete":true,"sonnet1m45MigrationComplete":true,"userID":"504ad0db2904d8a73d42946d35f56e4c5a903039314c94d020752e87fe837fb7","changelogLastFetched":1772882117780}

在里面加一行"hasCompletedOnboarding": true，注意逗号别漏了，如下图所示：

然后重启Window PowerShell，执行claude解决问题：

在哪个文件下运行的命令，工程默认在哪个目录，接下来选择信任文件夹，但是又报错了：

这个错误出现的原因是我的主机没有settings.json文件，如下图所示，这个是我一开始没有想到的，因为在Ubuntu下这个文件都是自动生成的settings.json和.claude.json文件的不需要操心，一执行claude就会提示配置API KEY。

于是我在这个文件夹下手动创建了settings.json文件，内容如下：

注意实际使用时"ANTHROPIC_AUTH_TOKEN"对应的"YOUR_API_KEY"要替换成在阿里云百炼或者智谱AI的Coding Plan中购买的sh开头的API KEY，注意下面的"ANTHROPIC_BASE_URL"和"ANTHROPIC_MODEL"也要根据选择的平台做配置。这里claude code是干活的手，接入的API KEY对应的模型才是思考的脑子。配置好再次运行就成功了：

2、Ubuntu下安装

2.1 安装npm

# node 需要>=18.0.0curl-fsSL https://deb.nodesource.com/setup_20.x|sudo-E bash-sudo apt install-y nodejs

2.2 安装claude code

2.2.1 第一次安装报错

➜ main_docker git:(main)✗ npm install-g @anthropic-ai/claude-code npm error code EACCES npm error syscall mkdir npm error path/usr/lib/node_modules/@anthropic-ai npm error errno-13npm error Error:EACCES:permission denied,mkdir'/usr/lib/node_modules/@anthropic-ai'npm error atasyncmkdir(node:internal/fs/promises:853:10)npm error atasync/usr/lib/node_modules/npm/node_modules/@npmcli/arborist/lib/arborist/reify.js:624:20npm error atasyncPromise.allSettled(index0)npm error atasync[reifyPackages](/usr/lib/node_modules/npm/node_modules/@npmcli/arborist/lib/arborist/reify.js:325:11)npm error atasyncArborist.reify(/usr/lib/node_modules/npm/node_modules/@npmcli/arborist/lib/arborist/reify.js:142:5)npm error atasyncInstall.exec(/usr/lib/node_modules/npm/lib/commands/install.js:150:5)npm error atasyncNpm.exec(/usr/lib/node_modules/npm/lib/npm.js:207:9)npm error atasyncmodule.exports(/usr/lib/node_modules/npm/lib/cli/entry.js:74:5){npm error errno:-13,npm error code:'EACCES',npm error syscall:'mkdir',npm error path:'/usr/lib/node_modules/@anthropic-ai'npm error}npm error npm error The operation was rejected by your operating system.npm error Itislikely you donothave the permissions to access thisfileasthe current user npm error npm error If you believe this might be a permissions issue,please double-check the npm error permissions of thefileandits containing directories,ortryrunning npm error the command againasroot/Administrator.npm error A complete log of this run can be foundin:/home/lx/.npm/_logs/2026-03-03T09_48_13_007Z-debug-0.log# 解决方法➜ main_docker git:(main)✗ mkdir~/.npm-global➜ main_docker git:(main)✗ npm configsetprefix'~/.npm-global'➜ main_docker git:(main)✗ export PATH=~/.npm-global/bin:$PATH ➜ main_docker git:(main)✗ source~/.bashrc# 验证配置npm config get prefix# 应输出 /home/你的用户名/.npm-global

2.2.2 找不到命令

# 验证发现无输出which claude# 临时解决方法export PATH=/home/lx/.npm-global/bin:$PATH# 永久解决方法## bash下echo'export PATH=/home/lx/.npm-global/bin:$PATH'>>~/.bashrc## zsh下echo'export PATH=/home/lx/.npm-global/bin:$PATH'>>~/.zshrc source~/.bashrc# 或 source ~/.zshrc# 验证claude--version

2.3 接入Coding Plan

2.3.1 注册质谱AI获取API Key

注册地址，手机号注册个人账户

https://open.bigmodel.cn/

在个人信息栏目打开,API_Key,如下图所示：

2.3.2 配置

新建一个文件夹，新启一个终端，然后执行下面命令配置环境变量：

curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh

执行完终端显示如下，输入注册好的体验版API Key，如下所示：

执行完上面命令后自动生成~/.claude.json和~/.claude/settings.json
查看~/.claude.json

查看~/.claude/settings.json,内容如下：

2.3.3 使用

新建一个工作文件夹，打开一个终端，然后执行命令：claude，弹出如下界面，

点击Enter选择信任当前文件，然后弹出如下界面，就可以聊天了：

2.4 接阿里云百练的API

地址：https://bailian.console.aliyun.com/cn-beijing/?tab=coding-plan#/efm/index
https://bailian.console.aliyun.com/cn-beijing/?tab=coding-plan#/efm/detail?&spm=5176.6660585.sfm_codingplan_public_cn-top.i1.15cf7992SrOqr5

2.4.1 配置 Coding Plan 接入信息

在Claude Code中接入百炼Coding Plan，需要配置以下信息：

ANTHROPIC_BASE_URL：设置为 https://coding.dashscope.aliyuncs.com/apps/anthropic。

ANTHROPIC_AUTH_TOKEN：设置为Coding Plan专属API Key。

ANTHROPIC_MODEL：设置为Coding Plan支持的模型。

创建并打开配置文件~/.claude/settings.json。
代表用户主目录。如果.claude目录不存在，需要先行创建。可在终端执行mkdir -p ~/.claude来创建。

nano ~/.claude/settings.json
编辑配置文件。将YOUR_API_KEY替换为Coding Plan专属API Key。

{"env":{"ANTHROPIC_AUTH_TOKEN":"YOUR_API_KEY","ANTHROPIC_BASE_URL":"https://coding.dashscope.aliyuncs.com/apps/anthropic","ANTHROPIC_MODEL":"qwen3.5-plus"}}

保存配置文件，重新打开一个终端即可生效。

编辑或新增~/.claude.json文件，将hasCompletedOnboarding字段的值设置为 true并保存文件。

{ "hasCompletedOnboarding": true }

hasCompletedOnboarding作为顶层字段，请勿嵌套于其他字段。
该步骤可避免启动Claude Code时报错：Unable to connect to Anthropic services。

2.4.2 使用

配置好那两个配置文件后，执行claude如下图所示

已经可以聊天了

3、VScode使用

安装Claude Code for VS Code插件

参考：https://bailian.console.aliyun.com/cn-beijing/?tab=coding-plan#/efm/index

  • 请先配置 Coding Plan 接入信息，Windows还需要安装 WSL 或 Git for Windows。

  • 打开VS Code，在扩展市场中搜索 Claude Code for VS Code 并安装。

  • 安装完成后，重启 VSCode。单击右上角图标进入 Claude Code。

  • 切换模型：在对话框中输入/，选择 General config 进入设置页面，在Selected Model中选择支持的模型，新建一个新窗口开始对话。

4、补充

这些工具更新比较快，有些bug可能会修复，但是也可能会产生新的问题

4.1 claude v2.1.103版本问题

我在容器中执行了之前的claude安装命令，直接自动给我安装了v2.1.103，然后我无论怎么折腾，都报401``错误，实在找不到原因了，我就想是不是版本问题，然后卸载了v2.1.103版本，安装了v2.1.91`版本，安装完就可以使用了，卸载安装方法如下：

# 1、卸载# 找到 claude 命令的位置which claude# 输出通常是 /root/.local/bin/claude 或 /usr/local/bin/claude# 删除可执行文件rm-f~/.local/bin/claude# 如果上面没有，尝试：rm -f /usr/local/bin/claude# 删除配置文件和数据目录（可选，但推荐）rm-rf~/.claude rm-f~/.claude.json# 2、安装# 全局安装指定版本npm install-g @anthropic-ai/claude-code@2.1.91claude--version# 应显示 2.1.91# 3、禁止自动更新# 找到 claude 命令的实际位置which claude# 假设输出 /usr/bin/claude# 移除写权限，使程序无法覆盖自身chmod555/usr/bin/claude

完成上面安装步骤后，再参考之前的步骤生成和修改配置文件，核心命令：

# 新建文件夹执行：curl-O"https://cdn.bigmodel.cn/install/claude_code_env.sh"&&bash./claude_code_env.sh# 配置参数：vim~/.claude.json vim~/.claude/settings.json

4.2 进阶-Memory系统

在使用claude code的时候，经常会遇到下面场景：通过claude code一番交互后实现了某个功能模块，但是过一段再打开这个工程的时候发现之前的会话丢失，claude code新建了会话，这个时候如果想要修改功能就要重新分析当前工程，并且一些细节不一定能很快搞清楚，非常的不方便

claude code提供了Memory系统，可以保存和使用记忆。

查看~/.claude/projects目录，目录结构如下：

其中.jsonl文件都是claude会话的交互日志，记录的信息比较详细，是会话过程中自动生成的。filled_hole_pyramid_algorithm.md相当于摘要卡片是提炼的关键信息，MEMORY.md相当于目录索引，存放所有摘要卡片的清单，这两个文件都需要关键词触发保存，关键词是模糊匹配的词汇，触发关键词保存：

表达方式是否触发说明
“记住我偏好简洁回复”✅明确要记住
“记住这个项目背景”✅明确要记住
“以后不要用emoji”✅暗示要保存行为指导
“保存这个信息”✅明确要保存
“下次这样处理”✅暗示跨会话保留
“记住X，忘了Y”✅ 记住X，删除Y明确指令
“我喜欢简洁”❌ 可能不触发只是表达偏好，没说要记住
“这个很好”❌ 不触发没说要保留

每次开启新的会话时，会话会自动加载MEMORY.md，可以知道之前大概都聊了什么。
查看~/.claude/projects目录通常会发现一堆.jsonl，如果忘记触发记忆存储也没有关系，可以通过下面会话交互提取记忆并保存：

读取~/.claude/projects/-home-lx-Works-src-filled-hole-2d/d188ac2f-c0e8-40f1-903f-594920e3f7aa.jsonl，并保存相关的要点

在新会话中添加了上面的对话后，就会自动生成memory文件夹及md文件，同时生成一个精简版的jsonl文件。

http://www.jsqmd.com/news/774409/

相关文章：

  • SushiSwap智能合约架构解析：V2 vs V3 vs Blade对比
  • StructBERT零样本分类-中文-base实时流式：Kafka接入+微批处理+低延迟分类流水线
  • OpenClaw-Capacities：模块化AI能力集成框架的设计与实战
  • 技术深度解析：Open-Lyrics基于Whisper与LLM的智能字幕生成系统架构设计
  • Enzyme.jl：基于LLVM的编译器级自动微分，突破Julia高性能计算瓶颈
  • 开源词汇管理工具OpenWord：开发者如何构建个人术语库与知识图谱
  • AI编程项目品牌系统生成：一分钟打造语义化设计令牌与CLAUDE.md指南
  • 基于Gemini CLI的多智能体分析框架：从原理到实战部署
  • 构建有礼貌的网页搜索MCP服务器：为AI应用提供合规网络信息获取能力
  • ESP固件烧录终极指南：5分钟掌握esptool核心功能
  • 别急着画板子！手把手教你从零设计STM32F103C8T6最小系统（附立创开源工程）
  • 2026管路胎具厂家大全:TPV管路胎具制作厂家+PA管路胎具生产厂家推荐 - 栗子测评
  • dedao-dl终极指南：如何简单快速地备份你的得到课程资源
  • Windows BAT脚本提权踩坑实录：为什么你的%cd%路径总变成System32？
  • AI编程新范式：用代码蓝图工具提升Claude项目生成效率
  • 本地Git基础知识
  • 质量文化的底层逻辑：规则、工具还是信仰？
  • AISMM模型如何重构产业协同效率：2024年7大头部联盟实证数据深度拆解
  • 安卓误删文件先别慌！5个实用小技巧指南教你补救
  • Linux下将Cursor AppImage封装为系统级deb包的自动化方案
  • 游戏化技能树：用human-skill-tree规划个人成长路径
  • Godot 4游戏开发模板：Takin项目架构与核心模块解析
  • 2026深度学习“炼丹”全解密：从损失函数到优化器，手把手教你驯服神经网络的“野性”
  • 2026梳妆镜供应商企业信誉好的镜子大型制造工厂推荐:智能镜出口企业哪家强?浴室镜批发厂家实力对比 - 栗子测评
  • 五面加工立卧复合加工中心生产厂家权威盘点|2026年靠谱卧式加工中心/龙门加工中心/五轴加工中心生产厂家推荐:台杨领衔 - 栗子测评
  • RepoToText：将Git仓库转换为结构化文本的实用工具
  • 2026杭州青少年心理咨询机构推荐:靠谱心理辅导机构十强榜单/专攻青少年厌学心理咨询难题 - 栗子测评
  • 数据挖掘的技术及应用
  • 第四篇 量子机器学习：重构传统大模型缺陷的全新核心解决方案
  • 4.硬件框图word可以打开但是编辑不了怎么办