shy的学习笔记

Appearance

Claude Code ​

简介 ​

Claude Code 是由 Anthropic 公司开发 的 AI 编码工具，支持在 Terminal 和 IDE 中使用。

安装 ​

安装命令行工具 ​

bash
curl -fsSL https://claude.ai/install.sh | bash
bash
irm https://claude.ai/install.ps1 | iex
bash
npm install -g @anthropic-ai/claude-code
bash
brew install --cask claude-code

安装完成后首次使用需要登录 claude 账户。

bash
claude
# 首次使用时系统会提示您登录

/login

安装 IDE 插件 ​

以 VSCode 为例，安装 Claude Code 插件，登录后即可使用。

使用兼容 Anthropic API 的 AI 模型 ​

说明

目前 Claude AI 在中国大陆不能直接使用，需要替换为其他兼容 Anthropic API 的 AI 模型。

以下是部分国内 AI 大模型厂商兼容 Anthropic API 的相关文档：

需要获取模型的几个关键配置项：

  1. 兼容 Anthropic API 的 Base URL
  2. 调用大模型的 API Key
  3. 模型名称

以通义千问为例，进行配置：

  1. 获取模型配置项：

    1. 兼容 Anthropic API 的 Base URL：https://coding.dashscope.aliyuncs.com/apps/anthropic
    2. 调用大模型的 API Key：sk-xxx
    3. 模型名称：qwen3.5-plus

  2. 编辑或创建 Claude Code 的配置文件 settings.json 和 .claude.json

    不同系统的配置文件路径不同

    MacOS & Linux 为 ~/.claude/settings.json 和 ~/.claude/.claude.json Windows 为用户目录\.claude\settings.json 和 用户目录\.claude\.claude.json

    json
    {
    "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "qwen3.5-plus"
  }
}
    json
    {
  "hasCompletedOnboarding": true
}

  3. 启动 Claude Code 命令行工具或 IDE 插件，即可正常使用对话功能

进阶使用 ​

claude code 支持多种特色功能高效处理任务。

注册 MCP 工具 ​

注册 MCP 工具，可以扩展 Claude Code 的功能，使其能够调用外部工具。

bash
# 基本语法
claude mcp add-json <name> <xxx.json>
# name: mcp 名称
# xxx.json: mcp 配置文件路径

或在项目根目录下编辑 mcp.json 文件，内容格式如下：

json
{
  "mcpServers": {
    "my-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

使用 Skills 技能 ​

Claude Code 支持使用 Skills 技能，可以扩展 Claude Code 的功能。例如，指定某个任务如何处理，嵌入脚本，运行指定命令，调用外部工具等。

Skill 是一个包含 SKILL.md 文件的目录，一个 Skill 包含以下内容：

bash
my-skill/
├── SKILL.md           # 入口说明（必需）
├── template.md        # Claude 要填写的模板
├── examples/
│   └── sample.md      # 显示预期格式的示例输出
├── scripts/
│   └── validate.sh    # Claude 可以执行的脚本
└── ...

SKILL.md 的格式如下

md
---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

# My Skill Name

[Add your instructions here that Claude will follow when this skill is active]

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

skill 的作用范围： skill 可以在全局或当前项目下注册使用。

  1. 全局注册：将 skill 的目录添加到 ~/.claude/skills 目录下，claude code 会自动识别并加载。
  2. 项目注册：将 skill 的目录添加到项目根目录下的 .claude/skills 目录下，claude code 会自动识别并加载。

下载 skills

目前已有多个公共 skill 仓库，需要特定的 skill 时，可以从这些仓库中下载。

参考 ​