掘金 人工智能 07月30日 15:03
Claude Code：介绍与使用教程
index_new5.html
../../../zaker_core/zaker_tpl_static/wap/tpl_guoji1.html

 

Claude Code 是 Anthropic 推出的强大本地化 AI 编程助手，基于 Claude 4 系列模型，能理解代码库、执行命令、管理 Git、自动化任务，并用自然语言处理编程需求。它支持与本地工具集成，直接在命令行中运行，无需学习复杂技术栈，大幅提升开发效率。文章详细介绍了 Claude Code 的部署、安装步骤，包括 Node.js 配置、卸载旧版本以及全局安装方法。同时，还提供了环境变量配置、激活自动执行模式、压缩上下文以节省配额的技巧，并阐述了 Claude Code 的多种交互方式（REPL、单次模式）、IDE 集成、图像处理、深入思考、命令历史管理、记忆文件（CLAUDE.md）以及 Git 高级操作等功能。此外，还介绍了 GitHub Actions 集成、常用的斜杠命令和 CLI 命令，并提供了故障排除和获取帮助的途径，旨在帮助用户充分利用 Claude Code 提升编程效率。

💡 Claude Code 是一款基于 Claude 4 系列模型、可在本地运行的 AI 编程助手，它能够理解您的代码库、执行命令、自动化 Git 操作，并能通过自然语言处理创造、修改项目，撰写文档等繁重任务，旨在提供无需学习成本的编程辅助。

🚀 Claude Code 的核心优势在于其强大的编程能力，能够直接使用本地工具进行环境部署和工程设计，并完全集成于命令行，用户只需使用自然语言即可解决问题，无需学习多项技术栈，且经济的计费方式提供了高效率。

🛠️ 文章提供了详细的 Claude Code 安装步骤，包括跨操作系统的 Node.js 环境配置（Ubuntu/Debian、macOS、Windows），卸载旧版本，以及使用 npm 全局安装，并指导用户配置环境变量（如 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL），确保工具的顺利部署。

⚙️ Claude Code 支持多种高级功能和使用技巧，例如激活“自动执行”模式（--dangerously-skip-permissions）以提高工作流效率，使用 `/compact` 命令压缩上下文以节省配额和提升响应速度，以及通过新的实例或历史回溯管理对话上下文。

💻 Claude Code 提供了丰富的交互方式和集成能力，包括 REPL 模式、单次命令模式、与 VSCode 和 JetBrains IDE 的集成，支持处理图像信息、进行深入思考、管理命令历史、利用 CLAUDE.md 存储项目记忆，并能通过自然语言操作 Git，极大地扩展了其在软件开发中的应用范围。

迄今为止最先进的代码助手：

Claude Code 的介绍与演示：(English)

Claude Code 是什么？

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

Claude Code 如何部署？详细安装步骤

Claude Code 如何部署？详细安装步骤

前置要求

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

mac os系统3步安装cc即配置环境教程 点击查看教程

一、安装 Node.js

如果你已经安装了 Node.js 18+ 版本，可以跳过此步骤。

Ubuntu / Debian 用户

# 添加 NodeSource 存储库curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -# 安装 Node.jssudo apt-get install -y nodejs# 验证安装node --versionnpm --version

macOS 用户

# 安装 Xcode 命令行工具sudo xcode-select --install# 安装 Homebrew（如未安装）/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 使用 Homebrew 安装 Node.jsbrew install node# 验证安装node --versionnpm --version

Windows 用户（目前可以直接安装code）

详细安装教程和配置环境设置

1.安装 Git for Windows

github.com/git-for-win…

2.安装 Node.js(版本 18 以上)

访问 Node.js nodejs.org/zh-cn/downl… 官网 下载并安装最新稳定版

3.打开命令提示符或 PowerShell，验证安装：

node --versionnpm --version

提示

建议使用 Node.js LTS（长期支持）版本以确保稳定性。

二.卸载之前的镜像code(没有下载过可以跳过)

如果您先前安装过镜像Claude Code，请您务必先通过以下命令卸载（如果没有请跳过此步骤）
npm uninstall -g @anthropic-ai/claude-code

卸载后再次输入 claude 命令，如果还是没有卸载成功，那就在终端输入

sudo -inpm uninstall -g @anthropic-ai/claude-code

三、安装 Claude Code

使用 npm 全局安装 Claude Code：

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

如果遇到权限问题，可以尝试：

# macOS/Linux 用户npm install -g @anthropic-ai/claude-code# Windows 用户（以管理员身份运行）npm install -g @anthropic-ai/claude-code

注意

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

npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

配置环境变量

配置文件在 ~/.claude 下，如果没有 setting``s``.json 文件，则新建一个，如果存在，那么进入编辑:

{  "env": {    "ANTHROPIC_API_KEY": "token",    "ANTHROPIC_BASE_URL": "https://code.ppchat.vip"  },  "permissions": {    "allow": [],    "deny": []  },  "apiKeyHelper": "echo 'token'"  }

上面的配置配置复制设置中，同时需要把平台生成的token替换里面的token占位符的内容.

只需修改这3个地方，其他地方不需要修改，注意不要误删标点符号~

可以使用下面的命令帮助创建:

echo "请输入您的token:"read -s TOKENmkdir -p ~/.claudecat << EOF > ~/.claude/settings.json{  "env": {    "ANTHROPIC_API_KEY": "$TOKEN",    "ANTHROPIC_BASE_URL": "https://code.ppchat.vip"  },  "permissions": {    "allow": [],    "deny": []  },  "apiKeyHelper": "echo '$TOKEN'"}EOFecho "设置文件已创建完成！"

打开Claude Code

在命令行执行命令

claude

则进入到 claude code里了，然后应该会识别出你是API KEY用户，直接就可以开始对话使用。

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

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

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

claude --dangerously-skip-permissions

这样，Claude Code 将跳过所有权限检查，自动执行任务，极大提升工作流效率。

减少配额消耗/提升cc返回速度和质量的使用技巧:

1.提问清晰，直接告诉claude修改什么文件/函数/页面，这样可以避免扫描所有文件去自动定位消耗配额

2.大需求改成小需求，一步一步提问，或者先生成一个执行计划，避免一个大需求跑了几百配额，然后发现实现方式不对或者需求理解有问题，又从头再来

3./compact 命令减少上下文和缓存数量，减少cc模型思考时间

> /compact [注释] #您可以添加注释

方法一：为不相关的任务开启新的Claude实例

方法二：手动执行 /compact 命令

方法三：利用历史回溯（如适用，通过 Esc + Esc）

Claude Code 有哪些功能？

Claude Code 直接进行交互：

# 启动交互模式claude# 以初始查询启动claude "解释这个项目"# 运行单个命令并退出claude -p "这个函数做什么？"# 处理管道内容cat logs.txt | claude -p "分析这些错误"

Claude Code 支持连接到主流IDE：

> /ide

Claude Code 支持压缩上下文以节省点数：

/compact [您的描述]

Claude Code 支持恢复上一步修改：[未来支持]

Claude Code 能够恢复以前的对话：

claude --continue
claude --resume

Claude Code 可以处理图像信息：

> 分析这个图像：/path/to/your/image.png
> 这是错误的截图。是什么导致了它？ > 这个图像显示了什么？ > 描述这个截图中的UI元素 > 生成CSS以匹配这个设计模型 > 什么HTML结构可以重新创建这个组件？

Claude Code 支持深入思考：

> 我需要使用OAuth2为我们的API实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。> 思考这种方法中潜在的安全漏洞 > 更深入地思考我们应该处理的边缘情况

Claude Code 支持管理命令历史：

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

> /init

Claude Code 拥有SDK：

Claude Code 支持上下文通用协议（MCP）：

Claude Code 在 Git 中的高级设置：

> 提交我的更改> 创建一个 pr> 哪个提交在去年十二月添加了 markdown 测试？> 在 main 分支上变基并解决任何合并冲突
# 创建带有新分支的工作树 git worktree add ../project-feature-a -b feature-a# 或使用现有分支创建工作树git worktree add ../project-bugfix bugfix-123
# 导航到您的工作树 cd ../project-feature-a# 在这个隔离环境中运行Claude Codeclaude
cd ../project-bugfixclaude
# 列出所有工作树git worktree list# 完成后移除工作树git worktree remove ../project-feature-a

Claude Code 支持 Github Actions：

> /install-github-app
> @claude 根据 issue 描述实现此功能> @claude 我应该如何为此端点实现用户身份验证？

Claude Code 其他的自然语言功能：

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

Claude Code 常见的斜杠命令：

命令用途
/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启动交互式 REPLclaude
claude "query"使用初始提示启动 REPLclaude "explain this project"
claude -p "query"通过 SDK 查询，然后退出claude -p "explain this function"
cat fileclaude -p "query"处理管道内容cat logs.txtclaude -p "explain"
claude -c继续最近的对话claude -c
claude -c -p "query"通过 SDK 继续claude -c -p "Check for type errors"
claude -r "" "query"通过 ID 恢复会话claude -r "abc123" "Finish this PR"
claude mcp配置模型上下文协议 (MCP) 服务器请参阅 Claude Code MCP 文档。

Claude Code 常见的 CLI 参数：

标志描述示例
--print, -p在非交互模式下运行claude -p "query"
--output-format指定输出格式（text、json、stream-json）claude -p --output-format json
--resume, -r通过会话 ID 恢复对话claude --resume abc123
--continue, -c继续最近的对话claude --continue
--verbose启用详细日志记录claude --verbose
--max-turns在非交互模式下限制代理轮次claude --max-turns 3
--system-prompt覆盖系统提示（仅适用于 --print）claude --system-prompt "Custom instruction"
--append-system-prompt附加到系统提示（仅适用于 --print）claude --append-system-prompt "Custom instruction"
--allowedTools允许的工具的空格分隔列表，或允许的工具的逗号分隔列表字符串claude --allowedTools mcp__slack mcp__filesystem,claude --allowedTools "Bash(npm install),mcp__filesystem"
--disallowedTools拒绝的工具的空格分隔列表，或拒绝的工具的逗号分隔列表字符串claude --disallowedTools mcp__splunk mcp__github,claude --disallowedTools "Bash(git commit),mcp__github"
--mcp-config从 JSON 文件加载 MCP 服务器claude --mcp-config servers.json
--permission-prompt-tool用于处理权限提示的 MCP 工具（仅适用于 --print）claude --permission-prompt-tool mcp__auth__prompt
--logout退出GAC登录
--pick-relay选择GAC节点

Claude Code 常用的快捷键：

快捷键描述上下文
Ctrl+C取消当前输入或生成标准中断
Ctrl+D退出 Claude Code 会话EOF 信号
Ctrl+L清除终端屏幕保留对话历史
上/下箭头导航命令历史回调之前的输入
Esc + Esc编辑上一条消息双击 Escape 键修改
方法快捷键上下文
快速转义\ + Enter在所有终端中工作
macOS 默认Option+EntermacOS 上的默认设置
终端设置Shift+Enter在 /terminal-setup 之后
粘贴模式直接粘贴用于代码块、日志
快捷键描述注释
开头的 #内存快捷键 - 添加到 CLAUDE.md提示文件选择
开头的 /斜杠命令参见 斜杠命令

Claude Code 其他的高级功能：

Claude code 接入cursor

故障排除

常见问题

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

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

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

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

获取帮助

如果遇到问题，可以：

    查看 Claude Code 官方文档在终端中运行 claude --help百度google一下

现在你已经成功配置了 Claude Code，可以开始享受 AI 辅助编程的强大功能了！记住，Claude Code 是你的编程搭档，善用它可以大大提高开发效率。

Fish AI Reader

Fish AI Reader

AI辅助创作，多种专业模板，深度分析，高质量内容生成。从观点提取到深度思考，FishAI为您提供全方位的创作支持。新版本引入自定义参数，让您的创作更加个性化和精准。

FishAI

FishAI

鱼阅，AI 时代的下一个智能信息助手，助你摆脱信息焦虑

联系邮箱 441953276@qq.com

相关标签

Claude Code AI编程 代码助手 自然语言编程 开发效率
相关文章
在 VSCode 中管理项目：工作区和文件夹结构
简化代码的 10 多个 JavaScript 基本功能 | JavaScript 指南
VS 代码扩展
Tabnine Adds Support for Anthropic Claude 3 Model to Accelerate and Optimize Software Development
.NET 9 and C# 13: New Features and Improvements
Show HN: 使用 ChatGPT 查找酷软件源
发布的应用程序 99% 由人工智能编写
Show HN: 我制作了一个开源模板
Micro Agent: An AI Agent that Writes and Fixes Code for You
Thread: A Jupyter Notebook that Combines the Experience of OpenAI’s Code Interpreter with the Familiar Development Environment of a Python Notebook