下面是Claude Code的安装与接入第三方API教程:
Claude Code 官方已支持Windows系统!手把手教你免费安装使用Claude Code
手把手教你在Claude Code 中使用Kimi K2 模型,超简单配置教程分享
手把手教你在国内免代理使用Claude Code镜像安装,零门槛免费薅100刀
什么是Claude Code?
Claude Code是由Anthropic开发的革命性编程工具,基于强大的Claude 4系列模型构建。它不仅仅是一个代码生成器,更是一个能够理解整个项目结构、执行命令、管理Git工作流的智能编程伙伴。
为什么Claude Code是最好的编程助手?
Claude Code 迄今为止最先进的代码助手:
Claude Code是为编写代码而生的Agent,您可以像与人对话一样,使用自然语言轻松实现的想法,无需任何学习成本,只需等待一杯咖啡的时间,Claude Code就可以为您解决所有问题。
基于最先进的AI模型:基于 Claude 4 系列模型,具有迄今为止最出色的编程能力。
本地工具集成:相较于竞品,Claude Code能够直接使用您本地的工具,帮助您直接部署环境、设计工程。
完整的开发流程支持:无需学习多个技术栈,只需自然语言就能轻松解决您的问题和需求。
开发兼容性强:完全集成于您的命令行,兼容所有命令行工具,还支持终端与 IDE 深度融合
如何开始使用Claude Code?
1、直接进行交互:
您可了解 Claude Code 常见的工作流,但Claude Code 比您想象的更强大。
Claude Code 提供两种主要的交互方式:
-
交互模式:运行
claude
启动 REPL 会话 -
单次模式:使用
claude -p "查询"
进行快速命令 -
您可以参考:
# 启动交互模式
claude
# 以初始查询启动
claude "解释这个项目"
# 运行单个命令并退出
claude -p "这个函数做什么?"
# 处理管道内容
cat logs.txt | claude -p "分析这些错误"
对于 Claude Code Client的常用参数和功能,您可以访问官方文档:CLI 使用和控制 - Anthropic
2、支持连接到主流IDE:
您可以直接在IDE中看到Claude Code的改动,在IDE中与其交互。

Claude Code 现在支持 VSCode 与 JetBrains等常用的IDE,像Cursor、Trae这类也是同样支持的;
如果您使用Linux / MacOS,您可以直接使用该插件
-
如果您使用VSCode,在VSCode的内置终端唤起Claude Code,插件将被自动安装
-
如果您使用JetBrains,您需要通过此链接下载:[Claude Code [Beta] - IntelliJ IDEs Plugin | Marketplace](https://docs.anthropic.com/s/claude-code-jetbrains)
您可能需要手动指定IDE或检查DIE连接,通过以下命令测试:
> /ide
如果您使用 VSCode+WSL,请您提前在VSCode 插件商店安装 WSL 插件
对于更多的用法,您可以参考Claude Code的官方文档:IDE integrations - Anthropic
3、如何切换模型?
Claude Code 支持 Claude 4 Opus 与 Claude 4 Sonnet 灵活切换:
我们强烈推荐您使用Claude 4 Sonnet,其使用体验与Claude 4 Opus没有明显差别,但计费倍率仅为1/5。
我们为您默认选择了Claude 4 Sonnet,您可以在登录后在配置中修改这一选项。
-
如果您没有在站点中关闭"强制使用 Sonnet",您在
/model
中切换的模型不会被切换。
在 Claude Code 中使用此命令切换模型:
> /model
4、支持压缩上下文以节省点数:
Claude Code 通常会有长上下文,我们建议您使用以下斜杠命令来压缩以节省点数,较长的上下文往往需要更多点数。
/compact [您的描述]
5、支持恢复上一步修改:
Claude Code 支持使用 Ctrl+Z
或在Vim模式下使用 u
撤销 Claude Code 的上一步修改。
6、恢复以前的对话:
使用以下命令可以恢复您上次的对话
claude --continue
这会立即恢复您最近的对话,无需任何提示。
您如果需要显示时间,可以输入此命令
claude --resume
这会显示一个交互式对话选择器,显示:
-
对话开始时间
-
初始提示或对话摘要
-
消息数量
-
使用箭头键导航并按Enter选择对话,您可以使用这个方法选择上下文。
7、处理图像信息:
您可以使用以下任何方法:
-
将图像拖放到Claude Code窗口中(在MacOS上)
-
复制图像并使用
Ctrl+v
粘贴到CLI中(在MacOS上) -
提供图像路径
> 分析这个图像:/path/to/your/image.png
您可以完全使用自然语言要求他进行工作,如:
> 这是错误的截图。是什么导致了它?
> 这个图像显示了什么?
> 描述这个截图中的UI元素
> 生成CSS以匹配这个设计模型
> 什么HTML结构可以重新创建这个组件?
8、支持深入思考:
您需要通过自然语言要求其进行深入思考
> 我需要使用OAuth2为我们的API实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。
> 思考这种方法中潜在的安全漏洞
> 更深入地思考我们应该处理的边缘情况
-
推荐您在使用复杂问题的时候使用这一功能,这也会消耗大量的额度点数。
9、支持管理命令历史:
-
历史按工作目录存储
-
使用
/clear
命令清除 -
使用上/下箭头导航(参见上面的键盘快捷键)
-
Ctrl+R:反向搜索历史(如果终端支持)
-
注意:历史扩展(
!
)默认禁用
10、通过 Claude.md 存储重要记忆:
您可以使用以下命令设置一个CLAUDE.md文件来存储重要的项目信息、约定和常用命令。
> /init
-
包括常用命令(构建、测试、lint)以避免重复搜索
-
记录代码风格偏好和命名约定
-
添加特定于您项目的重要架构模式
-
CLAUDE.md记忆可用于与团队共享的指令和您的个人偏好。
-
更多关于记忆的设置,您可以访问此官方文档了解:Claude Code 概述 - Anthropic
-
在官方文档中,此部分记录了记忆的常用用法:管理Claude的记忆 - Anthropic
11、Claude Code拥有的SDK:
Claude Code 支持Python SDK,请参考官方文档:Claude Code SDK - Anthropic
把Claude code这个智能编码agent集成到你的应用里,例如python项目里可以使用下面的示例实现:
import anyio
from claude_code_sdk import query, ClaudeCodeOptions, Message
asyncdefmain():
messages: list[Message] = []
asyncfor message in query(
prompt="Write a haiku about foo.py",
options=ClaudeCodeOptions(max_turns=3)
):
messages.append(message)
print(messages)
anyio.run(main)
直接访问 Python SDK Github 仓库:GitHub - anthropics/claude-code-sdk-python
12、支持上下文通用协议(MCP):
模型上下文协议(MCP)是一个开放协议,使LLM能够访问外部工具和数据源。
以安装context7为例,推出claude交互环境,运行下面的命令就添加好了
claude mcp add context7 -- npx -y @upstash/context7-mcp@latest
这是高级功能,您可以访问此文档获取更多配置信息:Introduction - Model Context Protocol
Claude Code不仅支持接入MCP,同样支持作为MCP服务器等各类高级功能,您可以访问此文档获得更多信息:教程 - Anthropic
13、在 Git 中的高级设置:
Claude Code 支持使用自然语言操作Git,如:
> 提交我的更改
> 创建一个 pr
> 哪个提交在去年十二月添加了 markdown 测试?
> 在 main 分支上变基并解决任何合并冲突
您可以使用工作树创建隔离的编码环境。
如果您您需要同时处理多个任务,并在Claude Code实例之间完全隔离代码,您可以使用此功能:
Git工作树允许您从同一存储库中检出多个分支到单独的目录。每个工作树都有自己的工作目录,文件是隔离的,同时共享相同的Git历史。在git-worktree中了解更多。
创建新工作树
# 创建带有新分支的工作树
git worktree add ../project-feature-a -b feature-a
# 或使用现有分支创建工作树
git worktree add ../project-bugfix bugfix-123
这会创建一个包含存储库单独工作副本的新目录。
在每个工作树中运行Claude Code
# 导航到您的工作树
cd ../project-feature-a
# 在这个隔离环境中运行Claude Code
claude
在另一个终端中:
cd ../project-bugfix
claude
管理您的工作树
# 列出所有工作树
git worktree list
# 完成后移除工作树
git worktree remove ../project-feature-a
每个工作树都有自己独立的文件状态,非常适合并行Claude Code会话
在一个工作树中所做的更改不会影响其他工作树,防止Claude实例相互干扰
所有工作树共享相同的Git历史和远程连接
对于长时间运行的任务,您可以让Claude在一个工作树中工作,同时您在另一个工作树中继续开发
使用描述性目录名称,以便轻松识别每个工作树的任务
记得根据项目的设置在每个新工作树中初始化开发环境。根据您的技术栈,这可能包括:
-
JavaScript项目:运行依赖安装(
npm install
、yarn
) -
Python项目:设置虚拟环境或使用包管理器安装
-
其他语言:遵循项目的标准设置流程
14、支持 Github Actions:
此功能仍是Beta版本,您可访问此链接获取使用
这是一个适用于 GitHub PR 和 issues 的通用 Claude Code 动作,可以回答问题并实现代码更改。此动作会在评论中监听触发词并根据请求激活 Claude 动作。
Claude Code GitHub Actions 为您的 GitHub 工作流程带来 AI 驱动的自动化。只需在任何 PR 或 issue 中简单地提及 @claude
,Claude 就可以分析您的代码、创建拉取请求、实现功能和修复错误 - 所有这些都遵循您项目的标准。--Anthropic
通过以下命令部署 Claude Code Github App,此命令将引导您完成设置 GitHub 应用和所需的密钥:
> /install-github-app
安装成功后,您可用@
命令,如:
> @claude 根据 issue 描述实现此功能
> @claude 我应该如何为此端点实现用户身份验证?
15、其他的自然语言功能:
识别未文档化的代码
> 在auth模块中查找没有适当JSDoc注释的函数
生成文档
> 为auth.js中未文档化的函数添加JSDoc注释
理解陌生代码
> 支付处理系统做什么?
> 查找用户权限在哪里被检查
> 解释缓存层是如何工作的
智能编辑代码
> 为注册表单添加输入验证
> 重构日志记录器以使用新的 API
> 修复工作队列中的竞态条件
测试或编辑您的代码
> 运行 auth 模块的测试并修复失败
> 查找并修复安全漏洞
> 解释为什么这个测试失败了
Claude Code 的常用命令
Command | What it does | Example |
---|---|---|
claude |
启动交互模式 | claude |
claude "task" |
运行一次性任务 | claude "fix the build error" |
claude -p "query" |
运行一次性查询,然后退出 | claude -p "explain this function" |
claude -c |
继续最近的对话 | claude -c |
claude -r |
继续上一个对话 | claude -r |
claude commit |
创建 Git 提交 | claude commit |
/clear |
清除对话历史记录 | > /clear |
/help |
显示可用命令 | > /help |
exit or Ctrl+C |
退出 Claude Code | > exit |
Claude Code 的常见问题
1、如何存储记忆?
Claude Code 将记忆存储在~/.claude
中,如果没有特殊要求,请不要删除此目录。
2、偶尔回复错误的模型名称,这是为什么?
GAC 向您承诺不会替换您请求的模型,绝不掺杂其他模型。
这由于Claude Code在使用简单任务时,不会使用Claude 4 系列模型。您可了解:Bedrock, Vertex 和代理 - Anthropic
3、执行的命令行参数错误?
此类问题在WSL上常见,是Agent自身的错误。我们推荐您使用MacOS/Ubuntu,这类环境往往问题较少。
4、如何清理?
Claude Code 如何彻底清理,或曾经的使用Claude Code官方版本的环境在连接到代理站时出错
您可以执行以下命令清理Claude Code的登录信息
rm ~/.claude* -rf
5、出现 API Error,Tools Error?
这通常是网络问题,请您退出后使用claude -c
重新执行。如果问题依然存在,请联系售后支持。
6、在登录使用OAuth时验证错误?
请您确保环境变量中没有配置任何代理再进行登录验证。
如果问题仍然存在,请您无视弹出的浏览器并复制终端中的链接并打开,通过验证码方式验证。
7、长时间没有响应?
我们建议您按下ctrl+c
并重启Claude Code,这往往是网络问题。
如果命令行仍然无响应,我们建议您杀死进程并重新进行会话,这将不会影响您的工作进度。
您可以通过以下命令恢复上次的会话
claude -c
若问题仍然出现,请寻求售后支持。
8、在什么情况下扣除一次积分?
问Claude Code一个问题时会扣除积分。
如果您在任务中选择了"NO",将会被驰为开始新的对话,扣除多一次积分。
使用心得
总结了几个提高效率的小技巧:
-
善用自然语言:不要怕描述得太口语化,Claude Code的理解能力很强
-
合理使用记忆功能:在CLAUDE.md中记录项目特点,让AI更懂你的项目
-
积极使用上下文压缩:长对话时及时压缩,节省成本
-
充分利用图像功能:遇到界面问题直接截图,比文字描述更直观
-
善用深度思考:复杂问题值得花费更多积分获得更好的解决方案
总结
虽然学习使用Claude Code需要一些时间,但一旦掌握,它带来的效率提升是显著的。从繁琐的代码重构到复杂的架构设计,从Git操作到文档生成,Claude Code都能提供有价值的帮助。
Claude Code真正改变了我的编程方式。它不仅仅是一个工具,更像是一个经验丰富的编程伙伴。Claude Code是一个AI驱动的编程助手,它在你的终端中运行,理解你的代码库,并通过自然语言加速开发。
欢迎分享你的体验,咱们一起交流进阶心得