一文教会你如何使用Claude Code
yuewenqian 0 评论 经验分享 77 阅读

一文教会你如何使用Claude Code

一、简介

claude code是由Anthropic推出的一款存在于终端的代理编码工具，可以读取你的代码库、编辑文件并执行命令。它可以在你的终端、IDE、浏览器以及桌面应用中运行。

二、安装及基本配置

部分命令由于系统不同，可能有所区别，以下是我的机器信息

Apple M4 Pro

macOS Sequoia 15.6.1

根据操作系统的不同，官方给出了3种安装方式：Native install、Homebrew、WinGet，但都需要科学上网，所以并不推荐。

我们这里使用npm来安装（无需科学上网）：

npm install -g @anthropic-ai/claude-code

安装完成后使用以下命令验证：

claude --version 或 claude doctor

出现版本号，则说明安装成功

claude version验证.png

或

claude doctor验证.png

claude code的使用方式有两种，一种就是直接登录anthropic的账号（需要有订阅计划），另外一种就是使用api访问。由于anthropic的政策禁止中国访问，并且需要稳定的科学上网节点，所以这里推荐使用api的方式。

以下是目前支持通过api的方式接入claude code的一些国内大模型厂商：

DeepSeek API文档

阿里云百炼

KIMI开放平台

火山方舟大模型平台

Z.ai

......

建议搭配模型厂商推出的coding plan使用，因为agent工具的token消耗十分庞大，如果单纯通过api调用计费的话，成本真的太高了。

智谱GLM coding plan

月之暗面Kimi code

MiniMax coding plan

阿里百炼coding plan

字节方舟coding plan

...

以kimi为例，在环境变量中添加

# linux or mac
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxx
export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/
export ANTHROPIC_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-k2.5
export CLAUDE_CODE_SUBAGENT_MODEL=kimi-k2.5


# windows
setx ANTHROPIC_AUTH_TOKEN sk-xxxxxxxxxxxxxxxxxxxxxxxx
setx ANTHROPIC_BASE_URL https://api.kimi.com/coding/
setx ANTHROPIC_MODEL kimi-k2.5
setx ANTHROPIC_DEFAULT_OPUS_MODEL kimi-k2.5
setx ANTHROPIC_DEFAULT_SONNET_MODEL kimi-k2.5
setx ANTHROPIC_DEFAULT_HAIKU_MODEL kimi-k2.5
setx CLAUDE_CODE_SUBAGENT_MODEL kimi-k2.5

使环境变量生效

# linux or mac
source ~/.zshrc

接下来进入claude，并尝试发送消息

claude

claude正常进行回复，至此就配置好了，可以愉快使用了~

claude发送消息.png

如果切换了服务商模型配置，可以通过/config命令来查看配置的模型信息是否生效

config命令.png

三、快速入门

Claude Code能做些什么？

询问功能列表.png

所以可以使用claude code进行代码开发、代码分析、开发工具使用、文件操作、项目管理以及git操作。

简单尝试下：

使用python实现以下功能：                                                                                                                                                                                                           
  1.爬取当前日期https://steamdb.info/的中国区史低价格游戏                                                                                                                                                                            
  2.根据爬取到的史低游戏列表生成一个html文件，支持分页，一页20条数据。
使用claude code写爬虫.png

可以看到从页面结构分析、代码开发、环境安装、运行测试到操作手册撰写，仅用时7分多钟就全部搞定了。

尝试运行给出的代码，查看生成的html效果。

代码界面.png
生成的html.png

随便点一个查看详情，验证数据准确性

结果验证.png

数据也是准确的，不是随便生成的，总体效果还不错。

四、常用配置

如果你想要使claude code的使用体验更上一层楼，那么以下常用配置是必须要了解的。

1.claude的配置文件

配置文件大致分为三种settings.json 、agents目录 、mcp.json ，分别对应claude code的系统配置、agents配置、mcp配置。

claude的配置文件根据作用域的不同，配置文件的位置也不同。

  1. Managed：通过注册表或managed-settings.json 配置，使用组织范围内的策略配置。

  2. User：存放~/.claude目录下的配置，适用于当前用户的个人偏好设置。

  3. Project：存放在仓库.claude 目录下的配置，适用于当前项目（包括仓库的所有协作者）。

  4. Local：存放在仓库.claude目录下的所有*.local.*的配置文件，适用于当前项目的个人偏好设置，git提交时会自动忽略。

在settings.json中，以下是几个比较常用的配置：

key

描述

示例

permissions

权限配置

详见2.权限配置

hooks

配置自定义命令以在生命周期事件处运行。

详见官方使用文档->hook事件

respectGitignore

控制 @ 文件选择器是否遵循 .gitignore 模式。当为 true时，匹配 .gitignore 模式的文件被排除在建议之外

false

enableAllProjectMcpServers

自动批准项目 .mcp.json 文件中定义的所有 MCP servers

true

enabledMcpjsonServers

要批准的 .mcp.json 文件中特定 MCP servers 的列表

["memory", "github"]

disabledMcpjsonServers

要拒绝的 .mcp.json 文件中特定 MCP servers 的列表

["filesystem"]

language

配置 Claude 的首选响应语言（例如 "japanese"、"spanish"、"french"）。Claude 将默认以此语言响应

chinese

除此之外的一些配置详见官方使用文档->可用设置

官方示例settings配置：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  },
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
    "Reminder: Code reviews required for all PRs",
    "New security policy in effect"
  ]
}

其中$schema的作用是，当使用VScode、cursor和任何其他支持JSON Schema验证的编辑器时，启用自动补全和内联验证。

2.权限配置

这一步十分重要，千万不要怕麻烦。因为权限配置大了，可能会导致重要文件丢失；权限配置小了，则无法完成任务；

当你不清楚权限如何配置时，请遵循最小权限原则，即仅授予完成特定任务的最低限度权限。

以下是常用权限配置：

key

描述

示例

allow

允许使用工具的权限规则数组。

[ "Bash(git diff *)" ]

ask

要求在使用工具时询问的权限规则数组。

[ "Bash(git push *)" ]

deny

拒绝使用工具的权限规则数组。

[ "WebFetch", "Bash(curl )", "Read(./.env)", "Read(./secrets/*)" ]

additionalDirectories

claude有权访问的其他工作目录

[ "../docs/" ]

权限规则语法

权限规则使用工具名或工具名(说明符) ，支持通匹符，比如Bash、Bash(git push *)，通匹符可以在命令的开头、中间或结尾。

规则评估优先级为拒绝规则>询问规则>允许规则。

一些工具存在特定权限规则，比如除了Bash的通匹符，还有Read(说明符)和Edit(说明符)命令，其中说明符遵循gitignore规范，例如Read(~/.zshrc)；还有WebFetch(domain:域名)，例如domain:example.com，匹配example.com的请求。

具体详见官方文档->工具特定的权限规则

3.claude的可用工具

claude内置了一组强大的工具库，帮助进行开发：

claude可用工具.png

4.Skills

Skills 扩展了 Claude 能做的事情。创建一个 SKILL.md 文件，其中包含说明，Claude 会将其添加到其工具包中。

SKILL.md的存放位置决定了使用范围。

~/.claude/skills/<skill-name>/SKILL.md 当前用户可以使用

<项目目录>.claude/skills/<skill-name>/SKILL.md 仅此项目下可使用

<plugin>/skills/<skill-name>/SKILL.md 插件启用时可用

SKILL.md应由两部分组成，第一部分是YAML frontmatter在--- 标记间的内容，需要包括name（skill的名字）和description（能做什么以及何时调用），第二部分则是调用skill需要遵循的内容。比如我想创建一个git提交的skill：

 ---
  name: git提交
  description: 智能生成符合规范的 Git 提交信息。当用户请求提交代码、commit、生成提交信息时使用。
  ---

  # Git 提交技能

  根据代码变更自动生成规范的提交信息。

  ## 提交信息格式

  <类型>(<范围>): <描述>

  [可选的详细描述]

  [可选的注脚]

  ## 类型说明

  - `feat`: 新功能
  - `fix`: 修复 bug
  - `docs`: 文档更新
  - `style`: 代码格式调整
  - `refactor`: 重构
  - `test`: 测试相关
  - `chore`: 构建/工具相关

  ## 执行步骤

  1. 使用 `git diff` 查看变更
  2. 分析变更内容
  3. 生成符合规范的提交信息
  4. 执行 `git commit`

可以同过/{Skill名称}来手动触发Skill。

Skill通常用来封装可复用的工具，你可以自己创建，也可以浏览热门的社区下载skill。

claude code内置了以下Skill：

  • /simplify ：在完成功能开发或 Bug 修复后运行，找出代码复用、代码质量、运行效率方面的问题并修复。它会并行启动三个审查代理：分别检查代码复用、代码质量、执行效率，汇总问题后自动应用修复。可传入文本以专注指定问题，例如/simplify 专注简化代码，优化内存使用

  • /batch <instruction> ：对代码库进行大规模并行修改。给出修改描述后，使用 /batch 命令，它会分析代码库，把任务拆成 5～30 个独立模块，并生成方案让你批准。批准后，它为每个单元生成一个后台代理，每个都在隔离的 git worktree 中。每个代理实现其单元、运行测试并打开拉取请求。需要 git 存储库。例如，/batch 迁移src目录下的代码，由java实现改为python实现。

  • /debug [description] ：通过读取会话调试日志来排查你当前的 Claude Code 会话。可选地描述问题以专注分析。

  • /loop [interval] <prompt> ：在会话保持打开状态时按间隔重复运行提示。Claude 解析间隔、安排循环 cron 任务并确认节奏。对于轮询部署、监视 PR 或定期重新运行另一个 skill 很有用。示例：/loop 5分钟 确认部署是否完成。

当你的Skill过于内容过于庞大时，建议进行文件拆分，使SKILL.md仅专注要点，同时让Claude仅在需要的时候访问更详细的参考资料。参考目录格式：

my-skill/
├── SKILL.md (必填 - 概述与导航)
├── reference.md (详细 API 文档 - 按需加载)
├── examples.md (使用示例 - 按需加载)
└── scripts/
    └── helper.py (工具脚本 - 执行调用，非加载)

5.MCP

Claude Code 可以通过 Model Context Protocol (MCP)（一个用于 AI 工具集成的开源标准）连接到数百个外部工具和数据源。MCP servers 为 Claude Code 提供对您的工具、数据库和 API 的访问权限。

可以通过claude mcp [commands]命令来查看和管理MCP服务

通过claude mcp -h查看支持的命令操作

claude mcp命令帮助.png

常用的添加mcp方式有两种，一种是直接通过mcp服务商提供的url进行下载，一种是手动添加mcp的json配置。以智谱的联网搜索MCP为例：

智谱联网搜索MCP.png

通过以下命令添加智谱联网搜索MCP

# 通过url添加
claude mcp add -s user -t http web-search-prime https://open.bigmodel.cn/api/mcp/web_search_prime/mcp --header "Authorization: Bearer your_api_key"

# 或者通过json添加, 其中-s的可选参数有local、user、project
# local (默认)：仅在当前项目中对您可用
# project：通过 .mcp.json 文件与项目中的每个人共享
# user：在所有项目中对您可用
claude mcp add-json -s user web-search-prime '{"type":"http","url":"https://open.bigmodel.cn/api/mcp/web_search_prime/mcp","headers":{"Authorization":"sk-xxxxxxx"}}'
add-json命令.png

还有一种最为直接的方式，就是直接修改.claude.json配置文件中的mcpServers

claude的json配置.png

SKILL和MCP都被用来集成工具，由于MCP协议过于繁重，建议仅当SKILL无法满足需要时使用，比如数据库操作。

6.Plugins

Plugins 让你能够使用自定义功能扩展 Claude Code，这些功能可以在项目和团队中共享。

插件的安装依赖于市场，可以通过以下市场进行安装：

  • 官方Anthropic市场（默认使用，需要科学上网）

  • 从github添加市场，/plugin marketplace add owner/repo

  • 从其他git主机添加，适用于任何 Git 主机，包括 GitLab、Bitbucket 和自托管服务器。/plugin marketplace add https://gitlab.com/company/plugins.git

  • 从本地路径添加，添加 marketplace.json 文件的直接路径，/plugin marketplace add ./path/to/marketplace.json

  • 从远程URL添加，添加远程 marketplace.json 文件，/plugin install plugin-name@marketplace-name

可以通过以下命令管理市场

# 列出所有配置的市场
/plugin marketplace list

# 刷新市场的插件列表
/plugin marketplace update marketplace-name

# 删除市场
/plugin marketplace remove marketplace-name

添加市场后，可以直接安装插件：

/plugin install plugin-name@marketplace-name

通过以下命令管理插件：

# 禁用插件
/plugin disable plugin-name@marketplace-name

# 启用插件
/plugin enable plugin-name@marketplace-name

# 卸载插件
/plugin uninstall plugin-name@marketplace-name

也可以自己创建插件，这里不详细展开了，详见官方文档->创建插件

7.SubAgent

Subagents 是处理特定类型任务的专门 AI 助手。每个 subagent 在自己的 context window 中运行，具有自定义系统提示、特定的工具访问权限和独立的权限。当 Claude 遇到与 subagent 描述相匹配的任务时，它会委托给该 subagent，该 subagent 独立工作并返回结果。

SubAgent的作用

  1. 通过将探索和实现保持在主对话之外，保留上下文。

  2. 通过限制subagents可以使用的工具，强制执行约束。

  3. 使用用户级subagents，可以跨项目重用配置

  4. 为特定领域提供专注的系统提示。

  5. 通过将任务路由到更快、更便宜的模型来控制成本。

Claude 使用每个 subagent 的描述来决定何时委托任务。创建 subagent 时，请编写清晰的描述，以便 Claude 知道何时使用它。

内置SubAgents

Claude Code 包括内置 subagents，Claude 在适当时自动使用。每个都继承父对话的权限，并有额外的工具限制。

  1. Explore：一个快速的、只读的代理，针对搜索和分析代码库进行了优化。当 Claude 需要搜索或理解代码库而不进行更改时，它会委托给 Explore。这样可以将探索结果保持在主对话上下文之外。调用 Explore 时，Claude 指定一个彻底程度级别：quick 用于有针对性的查找，medium 用于平衡的探索，或 very thorough 用于全面分析。

  2. Plan：一个研究代理，在 plan mode 期间使用，以在呈现计划之前收集上下文。

  3. General-purpose：一个能够处理复杂、多步骤任务的代理。当任务需要探索和修改、复杂推理来解释结果或多个依赖步骤时，Claude 会委托给 general-purpose。

使用/agents 快速创建一个agent，比如我要创建一个专注于搜索的agent

创建agent.png

选择安装位置，project或者personal

选择安装位置.png

创建方式，可以通过claude生成，也可以进行手动配置。推荐使用claude生成

通过claude直接生成.png

输入agent的描述

agent描述.png

选择工具

选择工具.png

选择模型

选择模型.png

定义背景颜色

定义背景颜色.png

配置记忆范围

配置记忆范围.png

生成的agent预览

agent预览.png

可以键入e进入编辑页面，键入i开始编辑

完整的agent定义.png

生成的agent定义还是非常全面的。键入:wq 保存并关闭

至此就成功创建了一个搜索agent。

五、增强体验

IDE插件

如果使用Pycharm、Idea等工具，可以在插件商店中搜索Claude Code [Beta] 进行下载，也可以通过链接https://docs.claude.com/s/claude-code-jetbrains下载。安装该插件后，可以直接引用代码或审查代码等，比在终端操作要方便一些。

除此之外，记得settings.json中加入以下配置，可以启用上述编译器的内联检查。

"$schema": "https://json.schemastore.org/claude-code-settings.json"

Everything-claude-code

一整套完整系统：技能体系、本能行为、记忆优化、持续学习、安全扫描，以及研究优先的开发模式。 包含可直接用于生产环境的智能体、技能模块、钩子、规则、MCP 配置，以及兼容传统命令的适配层。

强烈推荐安装，极大增强了编程体验。github 地址：https://github.com/affaan-m/everything-claude-code

Frontend-design

为了避免千篇一律的AI前端模板风格，Anthropic官方推出的一个skill。github 地址：https://github.com/anthropics/skills/tree/main/skills/frontend-design

Chrome-devtools-mcp

谷歌官方推出的chrome浏览器mcp服务，可以实现chrome的自动化操作、前端Debug、页面视图分析等等，比较推荐装一下。

github地址：https://github.com/ChromeDevTools/chrome-devtools-mcp

安装方式有两种，任选其一就可：

# 方式一，直接在终端执行以下命令，添加mcp服务
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest

# 方式二，作为插件安装mcp服务和相关skills
# 进入claude界面，执行以下命令
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp

文章标签
#实用工具
许可协议
本文采用 署名-非商业性使用-相同方式共享 4.0 国际 许可协议，转载请注明出处。
手把手教你linux云服务器搭建openclaw 2026-03-03
一文教你玩转OpenClaw 2026-03-25

评论区