Claude Code 安装使用文档

发布时间:2026/9/9 13:04:44

Claude Code 安装使用文档 前些天发现了一个巨牛的人工智能学习网站通俗易懂风趣幽默忍不住分享一下给大家。点击跳转到网站https://www.captainai.net/dongkelun一个跑在终端里的 AI 编程助手不是插件是独立工具这东西是什么Claude Code 是 Anthropic 出的一个命令行工具直接在终端里跟 Claude 对话让它帮你写代码、改代码、调试、跑命令。跟 Cursor、Copilot 那些不太一样——它不依赖 IDE不需要 VS Code 或 JetBrains打开终端就能用。适合已经在用命令行工作的人也适合不想被 IDE 插件绑住的人。安装前准备系统要求Node.js 18必须是 18 或以上低版本不行操作系统macOS、Linux、WindowsWindows 需要 WSL2 或原生支持网络需要能访问 Anthropic API检查 Node.js 版本node--version如果没装或者版本不对去 nodejs.org 下载 LTS 版本安装。或者用 nvm 管理macOS/Linux# 安装 nvm如果还没装curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh|bash# 安装 Node.js 18nvminstall18nvm use18Windows用 nvm-windows去 GitHub 下载nvm-setup.exe安装然后nvminstall18nvm use18# 需要管理员权限运行终端安装 Claude Code方法一npm 全局安装推荐npminstall-ganthropic-ai/claude-code装完之后检查一下claude--version能输出版本号就说明装好了。方法二如果 npm 装不上有时候网络问题或者权限问题会导致装不上可以试试# macOS/Linuxsudonpminstall-ganthropic-ai/claude-code# 或者换个 npm 源npmconfigsetregistry https://registry.npmmirror.comnpminstall-ganthropic-ai/claude-codeWindows 用户如果在 WSL 里按上面来就行。如果直接在 Windows 命令行里可能需要用管理员权限运行。登录和认证Claude Code 有多种认证方式下面从简单到复杂依次介绍。方式一官方账号登录claude login会打开浏览器登录 Anthropic 账号授权。这种方式使用的是 Claude Pro/Team 订阅额度或者按量付费。方式二环境变量 配置文件免登录推荐国内用户如果你用的是国内云服务商的 AI 接口比如阿里云百炼、腾讯云等不需要走claude login直接配置环境变量就行。在项目根目录创建.claude/settings.json{env:{ANTHROPIC_AUTH_TOKEN:你的 API Token,ANTHROPIC_BASE_URL:你的服务商 API 地址,ANTHROPIC_MODEL:,ANTHROPIC_DEFAULT_SONNET_MODEL:qwen3.6-max-preview,ANTHROPIC_DEFAULT_OPUS_MODEL:kimi-k2.6,ANTHROPIC_DEFAULT_HAIKU_MODEL:qwen3.6-27b,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1},model:sonnet}各字段说明字段说明ANTHROPIC_AUTH_TOKEN云服务商提供的 API TokenANTHROPIC_BASE_URLAPI 接口地址比如阿里云百炼的地址ANTHROPIC_DEFAULT_SONNET_MODEL当model设为sonnet时实际使用的模型ANTHROPIC_DEFAULT_OPUS_MODEL当model设为opus时实际使用的模型ANTHROPIC_DEFAULT_HAIKU_MODEL当model设为haiku时实际使用的模型CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC禁用非必要请求省 token设为1开启model默认使用的模型档位可选sonnet/opus/haiku关于 sonnet / opus / haiku这是 Anthropic 的三个 Claude 模型档位。Sonnet 是平衡型Opus 最强但最贵最慢Haiku 最快最便宜。在使用国内云服务商时这些名称只是档位标识实际跑的是你映射的具体模型。比如配置里sonnet映射到qwen3.6-max-preview当你输入/model sonnet时实际调用的是 qwen 模型不是 Anthropic 的 Sonnet。配置好之后直接运行claude就能用了不需要登录。注意ANTHROPIC_AUTH_TOKEN不要提交到 Git 里。可以在项目里加一个.gitignore把.claude/settings.json排除掉。方式三全局配置文件免登录适合所有项目通用如果不想每个项目都配一遍.claude/settings.json可以直接改全局配置文件~/.claude/settings.json对所有项目生效。Windows 用户路径C:\Users\你的用户名\.claude\settings.json{env:{ANTHROPIC_AUTH_TOKEN:你的 API Token,ANTHROPIC_BASE_URL:你的服务商 API 地址,ANTHROPIC_DEFAULT_SONNET_MODEL:qwen3.6-max-preview,ANTHROPIC_DEFAULT_OPUS_MODEL:kimi-k2.6,ANTHROPIC_DEFAULT_HAIKU_MODEL:qwen3.6-27b,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1},model:sonnet}或者用命令直接写进去不用手动编辑文件claude configsetANTHROPIC_AUTH_TOKEN你的 API Tokenclaude configsetANTHROPIC_BASE_URL你的服务商 API 地址claude configsetmodel sonnet这种方式的好处是配一次就行不管切到哪个项目目录都能直接用。如果项目目录里也有.claude/settings.json项目配置会覆盖全局配置。方式四纯环境变量也可以不写配置文件纯用环境变量exportANTHROPIC_API_KEYyour-api-key-here加到~/.bashrc或~/.zshrc里每次打开终端自动生效。不过这种方式不如配置文件灵活因为没法设置BASE_URL和模型映射。方式五企业/云服务商认证AWS Bedrock、Google Vertex AI 这些也支持具体看 Anthropic 官方文档。基本使用启动交互式对话最简单的方式直接运行claude进入交互模式可以一直对话直到你退出。退出方式输入/exit或者按CtrlC两次单次提问不想进入交互模式可以直接问一个问题claude这个项目的入口文件在哪里问完就退出不会保持会话。带上下文提问# 让 Claude 看某个文件claude帮我看看这个文件有什么问题src/app.js# 或者指定文件路径claude解释一下这个文件的逻辑--filesrc/utils/helper.ts常用命令在交互模式下除了正常对话还有一些斜杠命令可以用项目相关命令作用/init在当前项目生成 CLAUDE.md 文件记录项目上下文/status查看当前连接状态、模型信息/usage查看 token 消耗和设置各种选项会话管理命令作用/clear清空当前会话上下文重新开始/compact压缩上下文保留关键信息释放 token 空间/resume恢复之前的会话工具和能力命令作用/model切换当前使用的模型sonnet / opus / haiku/doctor检查 Claude Code 运行状态排查问题/config打开配置界面调整设置/permissions查看和管理权限设置/help查看所有可用命令和帮助信息常用命令详解/init— 生成项目上下文在当前项目生成CLAUDE.md文件自动分析代码结构并写入项目背景信息。什么时候用刚接手一个新项目想让 Claude 快速了解全貌项目架构变了需要更新上下文注意事项是一次性快照生成后不会自动更新项目变动后需要手动更新或重新生成会覆盖已有的CLAUDE.md生成前会询问是否覆盖/compact— 压缩上下文把当前会话的前面内容压缩成摘要释放 token 空间让后面的对话可以继续进行。什么时候用聊了很久上下文越来越大响应变慢的时候快要超出 token 限制的时候工作原理纯内存操作不会写到磁盘文件压缩后的摘要留在当前会话里退出终端就没了不影响你手动维护的.session-context.md你自己写的文件不是 Claude 生成的/resume— 恢复之前的会话从 Claude Code 的本地存储中恢复之前的会话记录继续之前的对话。什么时候用同一台机器上中断后回来接着干注意事项恢复的是本地存储的会话记录换台机器就恢复不了/model— 切换模型切换当前会话使用的 Claude 模型比如 sonnet、opus、haiku 等。用法/model sonnet# 切换到 Sonnet/model opus# 切换到 Opus/model haiku# 切换到 Haiku什么时候用当前任务需要更强的模型比如复杂推理用 Opus想省 token 时切换到更轻量的模型比如 Haiku配置文件Claude Code 的配置文件在~/.claude/settings.jsonWindowsC:\Users\你的用户名\.claude\settings.json可以调整一些默认行为。常见配置项{permissions:{allow:[Bash(npm install),Bash(npm test),Bash(git status)],deny:[]},env:{ANTHROPIC_API_KEY:your-key-here}}权限配置Claude Code 在执行一些操作时会请求权限比如运行 shell 命令、编辑文件等。你可以在配置里预先设置允许哪些操作这样就不会每次都弹确认{permissions:{allow:[Bash(npm *),Bash(git *),Read,Edit]}}这样设置后运行 npm 和 git 命令、读文件、编辑文件都不会再问你了。CLAUDE.md 文件这是 Claude Code 特有的一个东西。在项目根目录放一个CLAUDE.md文件Claude 每次启动时会自动读取用来了解你的项目背景。这个文件写什么项目是什么、做什么用的技术栈是什么代码结构大概是怎样的有什么特殊约定或规范常见问题和注意事项示例# 项目说明 这是一个 React TypeScript 的前端项目后端是 Node.js Express。 ## 技术栈 - 前端React 18 TypeScript Vite - 后端Node.js Express PostgreSQL - 样式Tailwind CSS ## 目录结构 - src/ - 前端源码 - server/ - 后端代码 - tests/ - 测试文件 ## 开发约定 - 组件用函数式写法不用 class - API 请求统一放在 src/api/ 目录 - 提交信息用中文 ## 注意事项 - 数据库迁移文件在 server/migrations/改完表结构记得生成迁移 - 环境变量在 .env.example 里有模板生成 CLAUDE.md如果不想自己写可以让 Claude 帮你生成claude /init它会扫描项目结构自动生成一个初版的 CLAUDE.md你再根据实际情况改改就行。实际使用场景场景一理解现有代码接手一个不熟悉的项目或者看别人写的代码claude帮我看看 src/utils/auth.ts 这个文件是做什么的这个项目的 API 路由都在哪里定义的数据库表结构是怎样的有哪些表场景二写新功能告诉 Claude 你要做什么让它帮你写claude帮我写一个用户注册的 API要求 - 用 Express - 接收邮箱和密码 - 密码要加密存储 - 返回格式跟项目里其他 API 保持一致它会看项目里现有的代码风格尽量保持一致。场景三调试问题代码报错了让 Claude 帮忙排查claude运行npmstart 报了这个错 Error: Cannotfindmodule./config/database帮我看看是什么问题它会检查文件结构、导入路径告诉你哪里出了问题。场景四代码重构代码写得不好的地方让 Claude 帮忙改claudesrc/components/UserList.tsx 这个文件太长了有500多行 帮我拆分成几个小组件场景五写测试不想自己写测试用例claude帮我给 src/utils/validate.ts 里的函数写单元测试 用 Jest覆盖主要场景和边界情况场景六跑命令AndGet结果直接在 Claude 里跑命令不用切出去claude跑一下npmtest看看有没有失败的测试检查一下gitstatus看看有哪些文件改了使用技巧1. 描述清楚你要什么不要说帮我优化这段代码要说帮我优化这段代码目标是减少数据库查询次数。越具体Claude 给出的东西越靠谱。2. 利用上下文Claude Code 会记住当前会话的内容所以可以连续对话 帮我看看这个文件 第三十行的那个函数能改一下吗 改完之后跑一下测试不需要每次都重复背景信息。3. 让它先看再做如果要改代码先让 Claude 看看现有代码 先看看 src/api/user.js 现在的代码结构 然后帮我加一个删除用户的接口这样它写出来的代码会更符合项目风格。4. 及时清理上下文聊了很久之后上下文会变得很大响应可能变慢。用/compact压缩一下或者/clear重新开始。5. 用 CLAUDE.md 固定项目信息每次新开会话都要重新解释项目背景很烦。把项目信息写在 CLAUDE.md 里Claude 每次启动都会自动读取省去重复说明。常见问题安装时报错 “permission denied”权限问题试试sudonpminstall-ganthropic-ai/claude-code或者修改 npm 全局安装路径的权限mkdir-p~/.npm-globalnpmconfigsetprefix~/.npm-globalechoexport PATH~/.npm-global/bin:$PATH~/.bashrcsource~/.bashrcnpminstall-ganthropic-ai/claude-code运行时提示 “node version too old”Node.js 版本不够需要 18node--version# 检查当前版本如果版本低于 18升级方法macOS/Linux用 nvmnvminstall18nvm use18Windows用 nvm-windowsnvminstall18nvm use18# 需要管理员权限运行Windows 的 nvm 和 macOS/Linux 的 nvm 不是同一个东西需要用 nvm-windows。安装方式也不一样去 GitHub 页面下载nvm-setup.exe安装就行。登录时浏览器打不开可能是服务器环境没有图形界面可以手动复制链接claude login --no-browser会给你一个链接复制到本地浏览器打开就行。响应很慢可能是上下文太大了用/compact压缩一下或者/clear重新开始。也可能是网络问题检查一下能不能正常访问 Anthropic API。总是提示要确认权限在配置文件里设置允许的操作参考前面权限配置部分。费用相关Claude Code 使用 Claude 的 API会产生费用。个人用户如果有 Claude Pro 订阅$20/月可以使用 Claude Code额度包含在订阅里如果用 API Key按 token 用量计费查看费用在交互模式下用/usage命令打开设置对话框可以看到当前会话的 token 消耗也能调整各种配置。省钱建议问题描述清楚避免反复修改及时用/compact或/clear清理上下文小任务用单次提问claude 问题不要进入交互模式跟其他工具的对比工具类型特点Claude CodeCLI 工具不依赖 IDE终端里直接用灵活CursorIDE基于 VS Code 改的有图形界面GitHub CopilotIDE 插件代码补全为主也支持对话WindsurfIDE类似 Cursor也是 AI IDE选哪个看个人习惯。如果你已经在命令行里工作Claude Code 会很顺手。如果你更喜欢图形界面Cursor 可能更合适。官方资源官方文档https://docs.anthropic.com/en/docs/claude-codeGitHubhttps://github.com/anthropics/claude-code问题反馈https://github.com/anthropics/claude-code/issues
延伸阅读

更多相关文章

2026/9/9 13:04:11

微软平台助力亚太地区人工智能现代化转型

ISG Provider Lens报告指出,亚太地区企业正借助微软云平台与人工智能平台整合技术生态,打造安全、韧性兼备的现代化运营体系 全球以人工智能为核心的技术研究与咨询公司 Information Services Group(ISG)(纳斯达克代码…

2026/9/9 13:04:08

准大二学生从0开始学AI——机器学习Day3

---type: daily_notetitle: Phase 2.1 Day 3 — 梯度下降date: 2026-07-22person: 吴恩达phase: "2.1"day: 3topics: [梯度下降, 学习率, 批量梯度下降]---# 2026-07-22 学习笔记## 笔记区(学的时候随手记)### 核心观点- **MSE(Mea…

2026/8/31 13:45:07

GPU加速机器人学习:Isaac Gym实战与性能优化

1. 项目概述:当GPU算力遇上机器人学习革命在机器人技能训练领域,我们正经历着从"实验室小批量训练"到"工业级高通量训练"的范式转移。传统机器人学习往往受限于物理样机成本、实验场地限制和训练周期漫长等问题,而NVIDIA…

2026/9/9 13:03:49

Spring Boot企业级实践:从启动原理到AOP与Actuator安全

我见过太多能跑通Spring Boot Demo的人,一到企业级项目就抓瞎:配置类不生效、Bean加载顺序不对、AOP切不到、上线后被扫描器扫出一个Actuator漏洞。这些问题的根子不在代码量,而在对Spring Boot的启动机制、自动配置原理、代理机制缺乏整体认…

2026/9/9 13:03:49

基于Matlab+Yalmip的含电动汽车区域综合能源系统优化调度实践

电动汽车接入区域综合能源系统之后,原来教科书里那套“负荷曲线加机组组合,做一个经济调度”的玩法就开始失灵了。充电桩扎堆、V2G反向送电、车主随机出行导致的负荷脉冲,让配电网侧的净负荷曲线变得极难预测,而区域综合能源系统又…

2026/9/9 13:03:49

基于SSM+Uniapp的移动课程教学辅助平台开发实战

做移动课程教学辅助平台这个项目,前后折腾了大概两个来月,从后端选型到小程序端落地,整体走了一遍完整流程。技术栈就是标题里写的这套:后端 SSM(Spring SpringMVC MyBatis),前端管理端用 Vue…

2026/9/9 13:03:49

基于三菱PLC的3×4立体车库控制设计:仿真与调试全流程

每年到这个季节,总有不少学弟学妹来问我毕业设计选什么课题好。电气自动化、机电一体化方向绕不开一个经典题目——立体车库控制。我手头这个“基于三菱PLC的34立体车库控制设计”项目,就是标准的三菱PLC MCGS画面仿真组合,带视频操作演示和…

2026/9/9 13:03:49

2026年AI论文软件实测:十款MBA论文写作辅助工具深度测评

每年3月到5月,我的私信和微信就会进入“论文季”模式。身边一群MBA同学白天在会议室里给老板汇报经营数据,晚上窝在书房里面对论文空白页发呆,问得最多的一句是:网上那些AI论文软件测评榜单,到底有没有一个是真的&…

2026/9/9 12:58:45

2026软考高项16周备考计划:从基础到论文的全流程通关指南

2026年上半年软考高项(信息系统项目管理师)的备考窗口,其实从去年年底就已经悄悄开启了。但真正让我觉得节奏感对了的,是老金团队这趟“上岸专列”的发布——1月12日起航,16周全速通关。说实话,看了太多“三…

2026/9/8 7:15:10

超人会飞不算本事:系统稳定依赖清晰规则与边界设计

开头先不绕弯子。“#斯坦李吐槽dc 所以超人是无缘无故会飞的嘛哈哈哈哈哈哈哈锤哥真是技术人才啊!#雷神 #复联”这类调侃式短标题,第一波冲击力在于它把两个宇宙的角色塞进同一个吐槽箱里,但细想一下就能发现,它真正碰到的根本不是…

2026/9/8 7:15:15

超人VS蜘蛛侠:拆解超级IP的影响力与传播方法论

把“蜘蛛侠 vs 超人”放在 CSDN 上聊,可能很多人第一反应是走错片场了。但如果把这两个角色看成“两个持续运营了 80 多年的文化产品”,你会发现,这场比较本质上是两个不同 IP 策略的长期结果对比:超人赢在定义了整个超级英雄题材…

2026/9/8 7:15:10

基于CNN的调制信号识别:MATLAB实现时频图分类实战

简介:本资源是一套面向通信工程与信号处理方向学习者、研究者的深度学习实践方案,聚焦调制信号自动检测与识别这一典型无线通信任务,解决传统方法依赖人工特征、低信噪比下性能下降等痛点。压缩包共12个文件(10.73MB)&…

2026/9/9 0:00:48

MHS模型硬件标准:让大模型像调用软件一样控制物理设备

让Claude真正看着显微镜说“这个细胞形态不太对”,或者让大模型自己调一版机械臂的运动轨迹,这事儿听上去已经很接近科幻片了。但你真上手试一次就会发现,模型不缺智商,缺的是一个能插进显微镜、机械臂、激光控制器里的“通用插座…

2026/9/9 0:00:48

AI五大核心方向详解:从机器学习到大模型,零基础转行选哪条?

会有人告诉我,他想转行学AI,但打开招聘网站一看直接傻眼:机器学习、深度学习、自然语言处理、计算机视觉、大模型应用……满屏都是这些词,好像每个都会一点,又好像每个都离自己很远。还有人上来就问“学Python还是学Ja…

2026/9/9 0:00:49

从50行最小循环到生产级AI引擎:工程化改造全解析

直接说干货。这一章我写的不是那种"hello world跑通某个模型"的教程,而是把AI引擎当做一个真正要上线、要被人调用、要扛流量的系统来聊。从最初只有50行的最小循环,到能够承载生产流量的AI引擎,中间差的不是代码量,而是…

2026/9/7 16:23:03

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/7 22:46:00

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/9 10:21:54

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码