告别Cursor!最强AI编程辅助Claude Code安装到使用全流程讲解

Claude Code 是什么?

  • Claude Code 是由 Anthropic 开发的可在本地运行的自动化工具,基于Claude 4系列模型获得强大的能力.

  • 能理解您的代码库,执行命令,自动化管理Git仓库,调用您的Model Context Protocol (MCP)。

  • 能按照您的想法创造、修改项目,出色地完成撰写文档,转写语言等您平时十分繁重的工作。

Claude Code 为什么是最好的助手?

  • 基于 Claude 4 系列模型,具有迄今为止最出色的编程能力。

  • 相较于竞品,Claude Code能够直接使用您本地的工具,帮助您直接部署环境、设计工程。

  • 完全集成于您的命令行,您甚至无需运行任何命令。

  • 无需学习多个技术栈,只需自然语言就能轻松解决您的问题和需求。

  • 经济的计费方式,使您需要极低的成本以最高的效率完成繁重的工作。

  • 兼容所有命令行工具。

前置条件

在开始之前,请确保你的系统满足以下要求:

  • 操作系统:Windows、macOS 或 Linux

  • Node.js 版本 ≥ 18.0

  • 稳定的网络连接

技术文档核心内容

MacOS /Linux系统操作部署教程

安装Claude Code

复制代码
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version

如果遇到权限问题,可以尝试:

复制代码
sudo npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version

注意:如果安装过程中遇到网络问题,可以尝试使用国内 npm 镜像:

复制代码
sudo npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com
# 验证安装
claude --version
配置环境变量

配置好之后重启终端,然后在终端输入

复制代码
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
echo $CLAUDE_CODE_MAX_OUTPUT_TOKENS

检查是否跳出正确的秘钥和 url,如果不正确需要重新配置

为了避免每次使用时重复输入认证信息,建议将环境变量写入配置文件:

写入用户环境变量中,这样不需要每个文件配置,但是注意,文件内的配置优先级高于这个

bash 复制代码
# 如果使用 zsh
echo -e 'export ANTHROPIC_AUTH_TOKEN="sk-你自己的Token"' >> ~/.zshrc
echo -e 'export ANTHROPIC_API_KEY="sk-你自己的Token"' >> ~/.zshrc
echo -e 'export ANTHROPIC_BASE_URL="https://code.ppchat.vip"' >> ~/.zshrc
echo -e 'export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32000' >> ~/.zshrc
source ~/.zshrc
bash 复制代码
# 代理厂商:
echo -e 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo -e 'export ANTHROPIC_API_KEY="sk-xxx"' >> ~/.zshrc
echo -e 'export ANTHROPIC_BASE_URL="https://code.ppchat.vip"' >> ~/.zshrc
echo -e 'export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32000' >> ~/.zshrc
bash 复制代码
# mac 170-180
echo -e 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo -e 'export ANTHROPIC_API_KEY="sk-xxx"' >> ~/.zshrc
echo -e 'export ANTHROPIC_BASE_URL="https://club.claudecode.site"' >> ~/.zshrc
echo -e 'export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32000' >> ~/.zshrc

开始使用Claude Code

在终端输入claude,然后回车运行,问你是否要用这个API key,选完Yes然后一路回车就可以开始使用了!

在你的项目目录下运行 Claude Code:

初始化设置
复制代码
claude

操作教程

复制代码
# 进入您的项目文件
cd your-project-folder

# 启动交互模式
claude

# 以初始查询启动
claude "解释这个项目"

# 运行单个命令并退出
claude -p "这个函数做什么?"

# 处理管道内容
cat logs.txt | claude -p "分析这些错误"
选择你的 AI 模型
复制代码
省钱小贴士:对于日常任务,推荐使用 Claude 4 Sonnet,计费倍率仅为 Claude 4 Opus 的 1/5;对于有挑战性的任务,可以尝试更为智能的 Claude 4 Opus。
如果:/model claude-sonnet-4-20250514
模型切换
bash 复制代码
# 输入下面命令可以切换模型
/model claude-3-5-haiku-20241022
# 最新款
/model claude-opus-4-1-20250805
# 最新款 思考型
/model claude-opus-4-1-20250805-thinking
# 一般使用这个
/model claude-sonnet-4-20250514
/model claude-sonnet-4-20250514-thinking

|-------------------------------------|----------|-------|-------------|-----------------------------------------------------------------|
| 模型名称 | 类型 | 性能定位 | 适用场景 | 关键特性 |
| claude-3-5-haiku-20241022 | 轻量级 | 快速响应 | 日常问答、轻量代码生成 | ✅ 最快推理速度<br>✅ 成本最低<br>✅ 适合高频调用 |
| claude-opus-4-1-20250805 | 高性能 | 全能旗舰 | 复杂任务、深度推理 | ✅ 当前最强推理能力<br>✅ 支持超长上下文(如200K tokens)<br>✅ 适合复杂代码重构/架构设计 |
| claude-opus-4-1-20250805-thinking | 高性能+思考模式 | 强推理 | 需要"逐步思考"的任务 | ✅ 显式开启思维链(Chain-of-Thought)<br>✅ 更准确的逻辑推理<br>✅ 推荐用于调试、算法设计等 |
| claude-sonnet-4-20250514 | 平衡型 | 中高端通用 | 代码辅助、文档撰写 | ✅ 平衡速度与质量<br>✅ 适合日常开发辅助<br>✅ 成本适中 |
| claude-sonnet-4-20250514-thinking | 平衡型+思考模式 | 中高阶推理 | 需要分步思考的编码任务 | ✅ 启用思考模式后逻辑更清晰<br>✅ 适合写函数注释、解释代码逻辑 |

Windows系统操作部署教程

安装Claude Code

提前准备安装 npm、node
  1. 安装 git for windows,链接:git-scm.com/download/win,使用默认选项安装即可

  2. 访问 Node.js 官网

  3. 下载 LTS 版本的安装包

  4. 运行安装程序,按照提示完成安装

  5. 打开命令提示符或 PowerShell,验证安装:

    node --version
    npm --version

提示:建议使用 Node.js LTS(长期支持)版本以确保稳定性。

开始安装
复制代码
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version

如果遇到权限问题,可以尝试:

复制代码
# Windows 用户(以管理员身份运行)
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

注意:如果安装过程中遇到网络问题,可以尝试使用国内 npm 镜像:

复制代码
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com
# 验证安装
claude --version
配置环境变量
  1. 打开 PowerShell(管理员模式)(临时方案,仅作用于这次会话)

    env:ANTHROPIC_AUTH_TOKEN = "sk-你的Token" env:ANTHROPIC_BASE_URL = "https://club.claudecode.site"
    env:CLAUDE_CODE_MAX_OUTPUT_TOKENS = "32000" env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

然后在终端输入

复制代码
$env:ANTHROPIC_AUTH_TOKEN
$env:ANTHROPIC_BASE_URL

检查是否跳出正确的秘钥和 url,如果不正确需要重新配置

  1. 打开 PowerShell(管理员模式)(一次设置永久可用,选做)

  2. 设置系统环境变量:

复制代码
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你自己的Token", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://club.claudecode.site", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_MAX_OUTPUT_TOKENS", "32000", "User")

或者通过系统设置:

  1. 右键点击"此电脑" → "属性"

  2. 点击"高级系统设置"

  3. 点击"环境变量"

  4. 在"系统变量"中添加上述几个变量

使用教程

在你的项目目录下运行 Claude Code:

初始化设置
复制代码
claude

操作教程

复制代码
# 进入您的项目文件
cd your-project-folder

# 启动交互模式
claude

# 以初始查询启动
claude "解释这个项目"

# 运行单个命令并退出
claude -p "这个函数做什么?"

# 处理管道内容
cat logs.txt | claude -p "分析这些错误"
选择你的 AI 模型
复制代码
省钱小贴士:对于日常任务,推荐使用 Claude 4 Sonnet,计费倍率仅为 Claude 4 Opus 的 1/5;对于有挑战性的任务,可以尝试更为智能的 Claude 4 Opus。
如果:/model claude-sonnet-4-20250514
模型切换
复制代码
# 输入下面命令可以切换模型
# 标准模型
/model claude-sonnet-4-20250514

近期claude官方算力不足经常出故障,应用户要求加入刚刚推出的KIMI2
月之暗面大模型kimi-k2直接原生接入claude code,如需体验可以输入下方命令
/model kimi-k2-0711-preview

实操命令手册

连接到IDE

  • 您可以直接在IDE中看到Claude Code的改动,在IDE中与其交互。

  • Claude Code 现在支持 VSCode 与 JetBrains

  • 如果您使用Linux / MacOS,您可以直接使用该插件

  • 您可能需要手动指定IDE或检查DIE连接,通过以下命令测试:

    /ide

模型记忆系统

Claude Code 通过 CLAUDE.md 文件存储重要的项目信息、约定和常用命令。

复制代码
// 设置并且进入你的 work 工作路径
// 如:cd /etc/software/claude/
// 初始化记忆文件

/init

// 快速添加记忆方法

# 永远使用中文回复

// 我是谁?

# 我叫尔康

## 重要约定

- 所有生成的脚本文件和配置文件都必须放在 /Users/qierkang/docker/claude 目录下,方便后续查找
- 如果是修改用户现有的脚本文件,则不需要放到这个目录下,直接在原位置修改即可

// 思考关键字(出发深度思考):
think
think hard
think harder
ultra think
如:南京明天下午天气怎么样,因为我要周末骑摩托车畅游石臼湖。
think hard

Claude Code 支持管理命令历史:

  • 历史按工作目录存储

  • 使用 /clear 命令清除

  • 使用上/下箭头导航(参见上面的键盘快捷键)

  • Ctrl+R:反向搜索历史(如果终端支持)

  • 注意:历史扩展(!)默认禁用

恢复上次对话

复制代码
# 立即恢复最近的对话,- 使用以下命令可以恢复您上次的对话
claude --continue

# 选择特定对话
claude --resume

激活"自动执行"模式 (Bypass Permissions)

默认情况下,Claude Code 在执行修改文件、运行命令等操作前会请求您的授权。为了让它能自动连续工作,您可以激活"Bypass Permissions"模式。

方法:在启动命令后添加 --dangerously-skip-permissions 参数。

复制代码
claude --dangerously-skip-permissions

图像处理

Claude Code 可以处理图像信息,支持多种输入方式:

  • 将图像拖放到 Claude Code 窗口中

  • 复制图像并使用 cmd+v 粘贴到 CLI 中

  • 提供图像路径

    分析这个图像:/path/to/your/image.png

  • 您可以完全使用自然语言要求他进行工作,如:

    这是错误的截图。是什么导致了它?
    这个图像显示了什么?
    描述这个截图中的UI元素
    生成CSS以匹配这个设计模型
    什么HTML结构可以重新创建这个组件?

压缩上下文

  • 建议您使用以下方式压缩上下文,Claude会仅保留核心信息来节约积分:

    使用压缩功会能节省开销:

    /compact 帮我看下明天南京天气怎么样?

    - 过长的上下文可能导致响应速度十分缓慢。为了您的体验,建议您经常使用该命令。

Git 集成

Claude Code 支持使用自然语言操作 Git:

复制代码
> 提交我的更改
> 创建一个 pr
> 帮我查询一下 工艺路线反向查询提交记录,
> 帮我本地分支切换到test 并且合并 dev 解决任何合并冲突

Claude Code 通过 Claude.md 存储重要记忆

  • 您可以使用以下命令设置一个CLAUDE.md文件来存储重要的项目信息、约定和常用命令。

    /init

  • 包括常用命令(构建、测试、lint)以避免重复搜索

  • 记录代码风格偏好和命名约定

  • 添加特定于您项目的重要架构模式

  • CLAUDE.md记忆可用于与团队共享的指令和您的个人偏好。

  • 更多关于记忆的设置,您可以访问此官方文档了解:Claude Code 概述 - Anthropic

  • 在官方文档中,此部分记录了记忆的常用用法:管理Claude的记忆 - Anthropic

Claude Code 支持上下文通用协议(MCP)

  • 模型上下文协议(MCP)是一个开放协议,使LLM能够访问外部工具和数据源。

  • 这是高级功能,您可以访问此文档获取更多配置信息:Introduction - Model Context Protocol

  • Claude Code不仅支持接入MCP,同样支持作为MCP服务器等各类高级功能,您可以访问此文档获得更多信息:教程 - Anthropic

Claude Code 其他的自然语言功能

  • 识别未文档化的代码

    在auth模块中查找没有适当JSDoc注释的函数
    为auth.js中未文档化的函数添加JSDoc注释
    支付处理系统做什么?
    查找用户权限在哪里被检查
    解释缓存层是如何工作的
    为注册表单添加输入验证
    重构日志记录器以使用新的 API
    修复工作队列中的竞态条件

📋斜杠命令表

常见的斜杠命令

|---------------------------|------------------------------------------|
| 命令 | 用途 |
| /bug | 报告错误(将对话发送给 Anthropic) |
| /clear | 清除对话历史 |
| /compact [instructions] | 压缩对话,可选择焦点说明 |
| /config | 查看/修改配置 |
| /cost | 显示令牌使用统计 |
| /doctor | 检查 Claude Code 安装的健康状况 |
| /help | 获取使用帮助 |
| /init | 使用 CLAUDE.md 指南初始化项目 |
| /login | 切换 Anthropic 账户 |
| /logout | 从 Anthropic 账户登出 |
| /memory | 编辑 CLAUDE.md 记忆文件 |
| /pr_comments | 查看拉取请求评论 |
| /review | 请求代码审查 |
| /status | 查看账户和系统状态 |
| /terminal-setup | 安装 Shift+Enter 换行键绑定(仅限 iTerm2 和 VSCode) |
| /vim | 进入 vim 模式以切换插入和命令模式 |

Claude Code 常见的 CLI 命令

|------------------------------------|----------------|--------------------------------------|
| 命令 | 描述 | 示例 |
| claude | 启动交互式 REPL | claude |
| claude "query" | 使用初始提示启动 REPL | claude "explain this project" |
| claude -p "query" | 通过 SDK 查询,然后退出 | claude -p "explain this function" |
| cat file | claude -p "query" | 处理管道内容 | cat logs.txt | claude -p "explain" |
| claude -c | 继续最近的对话 | claude -c |
| claude -c -p "query" | 通过 SDK 继续 | claude -c -p "Check for type errors" |
| claude -r "<session-id>" "query" | 通过 ID 恢复会话 | claude -r "abc123" "Finish this PR" |

Claude Code 常用的快捷键

  • 通用控制:

|-----------|-------------------|---------------|
| 快捷键 | 描述 | 上下文 |
| Ctrl+C | 取消当前输入或生成 | 标准中断 |
| Ctrl+D | 退出 Claude Code 会话 | EOF 信号 |
| Ctrl+L | 清除终端屏幕 | 保留对话历史 |
| 上/下箭头 | 导航命令历史 | 回调之前的输入 |
| Esc + Esc | 编辑上一条消息 | 双击 Escape 键修改 |

Claude Code 常用的快捷键

  • 多行输入:

|----------|--------------|----------------------|
| 方法 | 快捷键 | 上下文 |
| 快速转义 | \ + Enter | 在所有终端中工作 |
| macOS 默认 | Option+Enter | macOS 上的默认设置 |
| 终端设置 | Shift+Enter | 在 /terminal-setup 之后 |
| 粘贴模式 | 直接粘贴 | 用于代码块、日志 |

  • 快速命令:

|-------|-----------------------|------------------------------------------------------------------------------------|
| 快捷键 | 描述 | 注释 |
| 开头的 # | 内存快捷键 - 添加到 CLAUDE.md | 提示文件选择 |
| 开头的 / | 斜杠命令 | 参见 斜杠命令 |

故障排除

常见问题

Q: 安装时提示权限错误 A: 尝试使用 sudo(Linux/macOS)或以管理员身份运行命令(Windows)

Q: 无法连接到 API A: 检查网络连接和 API 地址是否正确配置

Q: 令牌认证失败 A: 确认令牌格式正确(以 sk- 开头)且未过期

Q: 命令找不到 A: 确保 Node.js 和 npm 已正确安装,并且 PATH 环境变量包含 npm 全局安装目录

--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons怎么解决?

启动报错:claude --dangerously-skip-permissions

--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

解决:

IS_SANDBOX=1 claude --dangerously-skip-permissions

IS_SANDBOX=1 ccr code --dangerously-skip-permissions

写入环境变量:

IS_SANDBOX=1 是一个 环境变量(Environment Variable),它告诉 Claude CLI 工具当前运行在"沙箱模式"下。

Invalid API Key · Please run /login 怎么解决?

这表明 Claude Code 没有检测到 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 环境变量。不用 /login,只需参考快速开始部分设置环境变量即可。

如何更新 Claude Code?

一行命令搞定:claude update

获取帮助

如果遇到问题,可以:

  1. 查看 Claude Code 官方文档

  2. 在终端中运行 claude --help

  3. 联系技术支持

落地实践与案例分析

场景 1:claude code X 通义灵码,连接 IDE,读取项目,直接修改业务代码。claude code 已经执行完毕,灵码还在修改中
场景 2:服务器上面使用 claude code 开发我的 docker-compose.yml 脚本,然后测试过后在提交到 git 上面并且附录上提交注释

相关地址

官网:Claude Code - 智能 AI 编程助手

github官网:https://github.com/anthropics/claude-code

项目总结与展望

效率提升:代码生成更快,重复工作减少

质量改善:代码风格统一,结构更清晰

学习加速:新功能开发和项目上手更容易

不做代码倒爷!!不止搬运工,效率火箭🚀+1+1+1

相关推荐
cpp加油站2 小时前
打脸来的太快了,又发现一个Trae的宝藏功能--内置浏览器可以指定机型来显示前端界面
前端·ai编程·trae
一只爱撸猫的程序猿2 小时前
创建一个使用Spring AI结合MCP(Model Context Protocol)和Dify构建智能客服系统的简单案例
spring boot·aigc·ai编程
win4r2 小时前
🚀Cursor CLI+GPT-5保姆级教程+编程能力测评!Cursor CLI零成本免费使用GPT-5!Claude Code的劲敌来了!从安装到实战演示
gpt·aigc·openai
jzy37113 小时前
京东开源王炸!JoyAgent-JDGenie 通用智能体一键部署指南,DeepSeek 大模型完美适配
后端·openai·ai编程
POLOAPI3 小时前
Claude Opus:从智能升级到场景落地的旗舰模型进阶之路
人工智能·ai编程·claude
hogwarts4 小时前
MCP+LLM+Agent:测试工程师如何构建下一代智能测试基座?
aigc·openai
hogwarts4 小时前
2025大模型应用平台选型指南:测试工程师的智能化转型路线图
aigc·openai
hogwarts4 小时前
Playwright等待策略深度解析:告别sleep的自动化测试新时代
aigc·openai
hogwarts4 小时前
Playwright与Page Object模式深度实践:构建可维护的现代化测试体系
aigc·openai