目标从零开始安装和配置 Claude Code支持 Windows 和 Linux (Ubuntu) 系统适用场景软件开发、自动化运维目录Claude Code 简介什么是 Claude Code本地 AI 终端入门科普Windows 系统安装指南启动和使用Linux Ubuntu 系统安装指南启动和使用Linux致谢Claude Code 简介一、什么是 Claude CodeClaude Code 是 Anthropic 官方推出的命令行 AI 编程助手能够读取和编辑文件— 直接操作你的代码仓库执行 Shell 命令— 运行编译、测试、部署、任何 CLI 工具管理 Git 工作流— 提交、创建 PR、解决合并冲突调用外部工具— 通过 MCP 协议连接浏览器、API 等自主规划执行— 理解需求后自动拆解任务并逐步完成支持的系统✅ Windows 10/11 (推荐使用 PowerShell 或 Git Bash)✅ macOS 10.14✅ Linux: Ubuntu 18.04, CentOS 7, 以及其他主流发行版本次用win11-24H2及Linux:Ubuntu 26.04 LTS做演示二、本地 AI 终端入门科普请容我啰嗦几句我们要知道在自己的电脑上装了个什么东西2.1、AI 的三种形态形态代表产品能做什么适合谁网页 AIclaude.ai、ChatGPT聊天、出主意、写建议所有人终端 AIClaude Code、Codex聊天 操作本地文件 跑命令想让 AI 干活的人本地 AIOllama 自建上面两种都能做但能力稍弱追求隐私的人2.2、两种运行位置云端 AI跑在服务器上网页 AI、终端 AI大多都是这个你的对话和数据会传到远程服务器处理优点能力强、更新快缺点数据不在自己手上可能有风险本地 AI跑在电脑里用Ollama这类工具自己装模型数据不出你的电脑完全安全优点零隐私风险离线也能用缺点吃电脑配置能力比云端弱2.3、小白也要尝试终端 AI网页 AI 的局限只能给你建议你自己复制粘贴去改不知道你电脑里有哪些文件无法自动执行重复性任务终端 AI 的优势直接读写你电脑的文件自动跑命令如测试、部署、批量处理处理繁琐任务批量改文件、生成代码、整理文档希望通过本教程可以让Claude 帮你干活三、 Windows 系统安装指南3.1 安装前置依赖安装 Node.js访问 Node.js 官网:https://nodejs.org/zh-cn/download下载 LTS 版本安装包图3‑1 Node.js官网下载页面选择Windows x64 LTS版本运行安装程序按提示完成安装验证安装 winr 输入cmd#出现版本号即可node--version npm--version图3‑2 查看Node.js、npm版本验证安装成功安装Git访问 Git 官网图3-3 Git下载界面下载 Git for Windows 安装程序运行安装确保勾选 “Add a Git Bash Profile to Windows Terminal”图3-4 Git安装界面Git安装要选择很多省事直接一步nxet就可以后期很容易改验证安装#出现版本号即可git--version3.2 安装 Claude Code# 管理员打开cmd winr cmd Ctrl Shift同按即可npm install-g anthropic-ai/claude-code#-g 表示全局安装安装完成后 claude 命令在任何目录下都可用。# 验证安装claude--version如果能输出版本号说明安装成功。图3-5 claude安装界面3.3 获取API key我们用Deepseek的api来举例3.3.1打开Deepseek官网点击API开放平台正常注册登录3.3.2 在创建API keys列表里面创建 起名任意弹出的“sk-XXXXXXXXXX”代码保存好不要公开防止他人调用3.4 安装CC-switchClaude配置本地的agent-是干活的执行体需要“人”来指挥它干活也就是现在来配置它的大脑也就是各个厂商的apiCC-switch 就是个管理多套api案例的工具图形化我们就不用去Claude底层文件去修改添加了。快成功了坚持 备注不直接修改 Claude‑Code 内部源码/配置文件使用独立工具ccc‑switch统一管理API Key支持快速切换不同大模型服务商方便迅速给Claude换脑子访问CCswitch 官网3.4.1 msi格式下载即可图3-6 CC-switch下载界面3.4.2 添加供应商安装一路next,打开点击右上方加号进入供应商配置界面找到Deepseek供应商并且把api key填进去图3-7 供应商填入key下划有模型映射Claude Code 的模型路由机制Claude Code 内部有三种「模型角色」● Opus — 处理最复杂的任务架构设计、大规模重构、复杂分析● Sonnet — 日常主力处理大多数编程和测试任务● Haiku — 轻量级快速任务文件检索、简单问答、命令生成如果网关只有一种模型就把三个都设成同一个。如果有多个模型可以分别为不同难度任务分配不同模型在保证质量的同时节省成本api key 没问题 点击获取模型列表根据自己需要设置好请求模型后保存关闭软件即可图3-8 请求模型四、启动和使用4.1首次启动引导流程我们用cmd启动它注意在哪儿启动哪儿就是它的工作空间了桌面也是个文件夹不要怕 从文件夹a启动它它会访问不到文件夹b桌面新建文件夹1在清空地址栏输入cmd后回车 弹出命令框输入claude图4.9 启动claude键盘上下键选择yes回车它在询问是否新任此文件夹yes 获得读写运行权限no 直接退出随后就是它的工作台可以输入/model切换模型键盘上下键选择模型 左右选择工作强度 工作强度effort说明low低强度响应速度快Token消耗少适合简单的代码修改medium中等强度性能均衡适合日常普通开发high高强度系统默认深度思考适合调试 Bug、业务代码开发max最大强度推理最严谨适合架构梳理消耗Token最多运行速度偏慢图4.10 模型选择界面4.2配置完成验收给他说那个最近很火的open claw 龙虾很火 他和你是本质上什么区别生成个html对比报告出来我看看图4.11 提问claude输出的文件放在附件图4.12 生成内容截图claude4.3 小优化每次打开都要选择是否新任可以专门在D盘建个ai_work的工作空间写个简单脚本点击即可发布命令#都可以自定义#新建记事本 复制进去 另存为ANSI编码的bat格式文件echooff cd/d D:\ai_work claude pause五、Linux Ubuntu系统安装指南演示版本Ubuntu 26.04 LTS5.1 安装前置依赖# 更新系统包sudoaptupdatesudoaptupgrade-y# 安装基础工具sudoaptinstall-ycurlwgetgitbuild-essential5.2 安装 Node.js使用 NodeSource 仓库# 添加 NodeSource 仓库安装 Node.js 18.x LTScurl-fsSLhttps://deb.nodesource.com/setup_18.x|sudo-Ebash-# 安装 Node.jssudoaptinstall-ynodejs# 验证安装node--versionnpm--version图 5.1 检查 Node.js5.3安装 Git# 安装 Gitsudoaptinstall-ygit# 验证安装git--version5.4 安装 Claude Code方法一使用 npm 安装推荐# 全局安装 Claude Codesudonpminstall-ganthropic-ai/claude-code# 验证安装claude--version预期输出claude-code v2.x.x方法二使用官方安装脚本# 下载并运行官方安装脚本curl-fsSLhttps://claude.ai/install.sh|bash# 验证安装claude--version图5.2 输出claude版本号5.5 配置claude环境还是用Deepseek的api举例1. 获取 API Key访问 DeepSeek注册账号并创建 API Key2.配置 Claude Code# 创建 Claude Code 配置目录mkdir-p~/.claude# 创建全局配置文件vim~/.claude/settings.json在~/.claude/settings.json中添加以下内容vim编辑器按“i”插入内容写好后分别按esc :wq保存退出{env:{ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN:sk-XXXXXXXXXXXXXXXXXXXXXXXX,ANTHROPIC_MODEL:deepseek-v4-flash,ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-v4-flash,ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-v4-flash}}#查看一下确认内容写进去cat~/.claude/settings.json配置项说明配置项说明示例值ANTHROPIC_API_KEYAPI 密钥sk-xxxxxxxxxxxxANTHROPIC_BASE_URLAPI 基础 URLhttps://api.deepseek.comANTHROPIC_MODEL默认模型deepseek-chat3.修改配置跳过检测# 编辑 Claude Code 配置vim~/.claude.json添加以下配置#如果进去是个空的 可以先试试运行一下claude,后面再加{hasCompletedOnboarding:true}注意 插入的位置 上方还有个英文,按i插入 写好按了esc 输入:wq图5.3初始化完成标记六. 启动和使用1.启动 Claude Code# 启动 Claude Codeclaude图6.1 收工/是命令库 如/exit就是退出2.常用命令命令说明/help查看所有可用命令/exit或/quit退出 Claude Code/model切换模型/config查看和修改配置/fast切换到快速模式使用 Opus/slow切换到慢速模式使用 Haiku七、致谢感谢各位收看本篇部署教程。整套环境的部署流程并不算复杂本文只覆盖了基础的使用方式该工具还有很多强大的功能没有演示出来希望大家可以多多动手探究、实践测试。在部署调试过程中遇到问题欢迎评论区留言一起交流。我是172同学下次再见 Claude Code 完整安装教程
目标从零开始安装和配置 Claude Code支持 Windows 和 Linux (Ubuntu) 系统适用场景软件开发、自动化运维目录Claude Code 简介什么是 Claude Code本地 AI 终端入门科普Windows 系统安装指南启动和使用Linux Ubuntu 系统安装指南启动和使用Linux致谢Claude Code 简介一、什么是 Claude CodeClaude Code 是 Anthropic 官方推出的命令行 AI 编程助手能够读取和编辑文件— 直接操作你的代码仓库执行 Shell 命令— 运行编译、测试、部署、任何 CLI 工具管理 Git 工作流— 提交、创建 PR、解决合并冲突调用外部工具— 通过 MCP 协议连接浏览器、API 等自主规划执行— 理解需求后自动拆解任务并逐步完成支持的系统✅ Windows 10/11 (推荐使用 PowerShell 或 Git Bash)✅ macOS 10.14✅ Linux: Ubuntu 18.04, CentOS 7, 以及其他主流发行版本次用win11-24H2及Linux:Ubuntu 26.04 LTS做演示二、本地 AI 终端入门科普请容我啰嗦几句我们要知道在自己的电脑上装了个什么东西2.1、AI 的三种形态形态代表产品能做什么适合谁网页 AIclaude.ai、ChatGPT聊天、出主意、写建议所有人终端 AIClaude Code、Codex聊天 操作本地文件 跑命令想让 AI 干活的人本地 AIOllama 自建上面两种都能做但能力稍弱追求隐私的人2.2、两种运行位置云端 AI跑在服务器上网页 AI、终端 AI大多都是这个你的对话和数据会传到远程服务器处理优点能力强、更新快缺点数据不在自己手上可能有风险本地 AI跑在电脑里用Ollama这类工具自己装模型数据不出你的电脑完全安全优点零隐私风险离线也能用缺点吃电脑配置能力比云端弱2.3、小白也要尝试终端 AI网页 AI 的局限只能给你建议你自己复制粘贴去改不知道你电脑里有哪些文件无法自动执行重复性任务终端 AI 的优势直接读写你电脑的文件自动跑命令如测试、部署、批量处理处理繁琐任务批量改文件、生成代码、整理文档希望通过本教程可以让Claude 帮你干活三、 Windows 系统安装指南3.1 安装前置依赖安装 Node.js访问 Node.js 官网:https://nodejs.org/zh-cn/download下载 LTS 版本安装包图3‑1 Node.js官网下载页面选择Windows x64 LTS版本运行安装程序按提示完成安装验证安装 winr 输入cmd#出现版本号即可node--version npm--version图3‑2 查看Node.js、npm版本验证安装成功安装Git访问 Git 官网图3-3 Git下载界面下载 Git for Windows 安装程序运行安装确保勾选 “Add a Git Bash Profile to Windows Terminal”图3-4 Git安装界面Git安装要选择很多省事直接一步nxet就可以后期很容易改验证安装#出现版本号即可git--version3.2 安装 Claude Code# 管理员打开cmd winr cmd Ctrl Shift同按即可npm install-g anthropic-ai/claude-code#-g 表示全局安装安装完成后 claude 命令在任何目录下都可用。# 验证安装claude--version如果能输出版本号说明安装成功。图3-5 claude安装界面3.3 获取API key我们用Deepseek的api来举例3.3.1打开Deepseek官网点击API开放平台正常注册登录3.3.2 在创建API keys列表里面创建 起名任意弹出的“sk-XXXXXXXXXX”代码保存好不要公开防止他人调用3.4 安装CC-switchClaude配置本地的agent-是干活的执行体需要“人”来指挥它干活也就是现在来配置它的大脑也就是各个厂商的apiCC-switch 就是个管理多套api案例的工具图形化我们就不用去Claude底层文件去修改添加了。快成功了坚持 备注不直接修改 Claude‑Code 内部源码/配置文件使用独立工具ccc‑switch统一管理API Key支持快速切换不同大模型服务商方便迅速给Claude换脑子访问CCswitch 官网3.4.1 msi格式下载即可图3-6 CC-switch下载界面3.4.2 添加供应商安装一路next,打开点击右上方加号进入供应商配置界面找到Deepseek供应商并且把api key填进去图3-7 供应商填入key下划有模型映射Claude Code 的模型路由机制Claude Code 内部有三种「模型角色」● Opus — 处理最复杂的任务架构设计、大规模重构、复杂分析● Sonnet — 日常主力处理大多数编程和测试任务● Haiku — 轻量级快速任务文件检索、简单问答、命令生成如果网关只有一种模型就把三个都设成同一个。如果有多个模型可以分别为不同难度任务分配不同模型在保证质量的同时节省成本api key 没问题 点击获取模型列表根据自己需要设置好请求模型后保存关闭软件即可图3-8 请求模型四、启动和使用4.1首次启动引导流程我们用cmd启动它注意在哪儿启动哪儿就是它的工作空间了桌面也是个文件夹不要怕 从文件夹a启动它它会访问不到文件夹b桌面新建文件夹1在清空地址栏输入cmd后回车 弹出命令框输入claude图4.9 启动claude键盘上下键选择yes回车它在询问是否新任此文件夹yes 获得读写运行权限no 直接退出随后就是它的工作台可以输入/model切换模型键盘上下键选择模型 左右选择工作强度 工作强度effort说明low低强度响应速度快Token消耗少适合简单的代码修改medium中等强度性能均衡适合日常普通开发high高强度系统默认深度思考适合调试 Bug、业务代码开发max最大强度推理最严谨适合架构梳理消耗Token最多运行速度偏慢图4.10 模型选择界面4.2配置完成验收给他说那个最近很火的open claw 龙虾很火 他和你是本质上什么区别生成个html对比报告出来我看看图4.11 提问claude输出的文件放在附件图4.12 生成内容截图claude4.3 小优化每次打开都要选择是否新任可以专门在D盘建个ai_work的工作空间写个简单脚本点击即可发布命令#都可以自定义#新建记事本 复制进去 另存为ANSI编码的bat格式文件echooff cd/d D:\ai_work claude pause五、Linux Ubuntu系统安装指南演示版本Ubuntu 26.04 LTS5.1 安装前置依赖# 更新系统包sudoaptupdatesudoaptupgrade-y# 安装基础工具sudoaptinstall-ycurlwgetgitbuild-essential5.2 安装 Node.js使用 NodeSource 仓库# 添加 NodeSource 仓库安装 Node.js 18.x LTScurl-fsSLhttps://deb.nodesource.com/setup_18.x|sudo-Ebash-# 安装 Node.jssudoaptinstall-ynodejs# 验证安装node--versionnpm--version图 5.1 检查 Node.js5.3安装 Git# 安装 Gitsudoaptinstall-ygit# 验证安装git--version5.4 安装 Claude Code方法一使用 npm 安装推荐# 全局安装 Claude Codesudonpminstall-ganthropic-ai/claude-code# 验证安装claude--version预期输出claude-code v2.x.x方法二使用官方安装脚本# 下载并运行官方安装脚本curl-fsSLhttps://claude.ai/install.sh|bash# 验证安装claude--version图5.2 输出claude版本号5.5 配置claude环境还是用Deepseek的api举例1. 获取 API Key访问 DeepSeek注册账号并创建 API Key2.配置 Claude Code# 创建 Claude Code 配置目录mkdir-p~/.claude# 创建全局配置文件vim~/.claude/settings.json在~/.claude/settings.json中添加以下内容vim编辑器按“i”插入内容写好后分别按esc :wq保存退出{env:{ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN:sk-XXXXXXXXXXXXXXXXXXXXXXXX,ANTHROPIC_MODEL:deepseek-v4-flash,ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-v4-flash,ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-v4-flash}}#查看一下确认内容写进去cat~/.claude/settings.json配置项说明配置项说明示例值ANTHROPIC_API_KEYAPI 密钥sk-xxxxxxxxxxxxANTHROPIC_BASE_URLAPI 基础 URLhttps://api.deepseek.comANTHROPIC_MODEL默认模型deepseek-chat3.修改配置跳过检测# 编辑 Claude Code 配置vim~/.claude.json添加以下配置#如果进去是个空的 可以先试试运行一下claude,后面再加{hasCompletedOnboarding:true}注意 插入的位置 上方还有个英文,按i插入 写好按了esc 输入:wq图5.3初始化完成标记六. 启动和使用1.启动 Claude Code# 启动 Claude Codeclaude图6.1 收工/是命令库 如/exit就是退出2.常用命令命令说明/help查看所有可用命令/exit或/quit退出 Claude Code/model切换模型/config查看和修改配置/fast切换到快速模式使用 Opus/slow切换到慢速模式使用 Haiku七、致谢感谢各位收看本篇部署教程。整套环境的部署流程并不算复杂本文只覆盖了基础的使用方式该工具还有很多强大的功能没有演示出来希望大家可以多多动手探究、实践测试。在部署调试过程中遇到问题欢迎评论区留言一起交流。我是172同学下次再见