claude code安装使用

分别尝试了在Windows下和Ubuntu下安装使用claude code配置方法差不多都是可行的1、Windows下安装1.1 安装Node.jsNode.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/?tabcoding-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 nodejs2.2 安装claude code2.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-ainpm 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-ainpm 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-global2.2.2 找不到命令# 验证发现无输出which claude# 临时解决方法export PATH/home/lx/.npm-global/bin:$PATH# 永久解决方法## bash下echoexport PATH/home/lx/.npm-global/bin:$PATH~/.bashrc## zsh下echoexport PATH/home/lx/.npm-global/bin:$PATH~/.zshrc source~/.bashrc# 或 source ~/.zshrc# 验证claude--version2.3 接入Coding Plan2.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/?tabcoding-plan#/efm/indexhttps://bailian.console.aliyun.com/cn-beijing/?tabcoding-plan#/efm/detail?spm5176.6660585.sfm_codingplan_public_cn-top.i1.15cf7992SrOqr52.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/?tabcoding-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-code2.1.91claude--version# 应显示 2.1.91# 3、禁止自动更新# 找到 claude 命令的实际位置which claude# 假设输出 /usr/bin/claude# 移除写权限使程序无法覆盖自身chmod555/usr/bin/claude完成上面安装步骤后再参考之前的步骤生成和修改配置文件核心命令# 新建文件夹执行curl-Ohttps://cdn.bigmodel.cn/install/claude_code_env.shbash./claude_code_env.sh# 配置参数vim~/.claude.json vim~/.claude/settings.json4.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文件。