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