Claude Code 教程

什么是 Claude Code？

Claude Code 是 Anthropic 推出的现代开发者 AI 编程助手，通过集成 AI 能力，可大幅提升开发效率。它直接在终端中运行，能够理解你的整个代码库，通过自然语言命令帮助你更快地编码。

效率对比

支持环境与系统要求

支持平台

• macOS 12+（推荐）
• Ubuntu 20.04+ / Debian 11+
• Windows（需额外安装 Git for Windows）

系统要求

• Node.js 18.0 或更高版本
• npm 或 yarn 包管理器
• Windows 用户需安装 Git for Windows
• 4GB+ 可用内存
• 稳定的网络连接

安装步骤

npx dddd-api

1. 安装 Node.js

如果尚未安装 Node.js，推荐使用 nvm 进行版本管理：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 安装 Node.js LTS
nvm install --lts
nvm use --lts

# 验证安装
node --version  # 应显示 v18+ 或 v20+

2. 安装 Claude Code CLI（必须）

这是后续所有配置的前提，必须先在本地安装好 Claude Code CLI 工具：

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

API 配置（关键步骤）

1. 获取令牌

前往 DDDD Api 控制台获取您的 API Key。注册即送免费额度。

2. 配置环境变量

编辑配置文件 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://daidaididi.top",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "alwaysThinkingEnabled": false
}

3. 配置 .claude.json

编辑或新增 ~/.claude.json 文件（Windows 为 用户目录/.claude.json），添加以下内容跳过首次引导流程：

{
  "hasCompletedOnboarding": true
}

基本使用方法

1. 启动 Claude Code

# 在项目目录中启动
cd your-project
claude

2. 首次启动设置

首次启动时，Claude Code 会自动扫描项目结构。你可以直接用自然语言描述需求：

# 示例对话
> 帮我分析这个项目的架构
> 给 UserService 添加一个分页查询方法
> 修复 login 接口的参数校验问题
> 写一个单元测试覆盖 utils/format.ts

3. 基础操作示例

# 让 Claude 解释代码
> 解释一下 src/auth/middleware.ts 的逻辑

# 让 Claude 重构代码
> 把这个 class 组件重构为 hooks

# 让 Claude 生成代码
> 创建一个 REST API 的 CRUD 模板

常用命令参考

交互模式常用命令

压缩上下文

当对话过长导致 token 接近上限时，使用 /compact 命令压缩上下文：

/compact [instructions]  # 可以添加说明，告诉 Claude 保留哪些重要信息

恢复以前的对话

使用 /resume 或在启动时加 --resume 参数恢复之前的对话：

claude --resume        # 启动时恢复上次对话
claude --resume <id>   # 恢复指定 ID 的对话

处理图像信息

Claude Code 支持在对话中传入图片进行分析，可以直接拖拽图片到终端或使用路径引用。

MCP (上下文通用协议)

MCP（Model Context Protocol）允许 Claude Code 连接外部工具和服务。只需在项目根目录创建 .mcp.json 文件即可配置。

MCP 配置示例

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

高级技巧

项目记忆文件 (CLAUDE.md)

在项目根目录创建 CLAUDE.md 文件，Claude 会在每次启动时自动读取，用于了解项目上下文：

# 项目架构
- 前端：React + TypeScript + Tailwind
- 后端：Node.js + Express + Prisma
- 数据库：PostgreSQL

# 编码标准
- 使用 ESLint + Prettier
- 组件使用函数式写法 + Hooks
- API 响应统一使用 { code, data, message } 格式

# 注意事项
- 不要修改 migrations 目录下的文件
- 环境变量在 .env.example 中有模板

IDE 集成

Claude Code 可以与主流 IDE 配合使用：

• VS Code：在内置终端中直接运行 claude
• Cursor：可同时使用 Cursor AI 和 Claude Code
• JetBrains：在 Terminal 面板中启动

VS Code 插件：Claude Code for VS Code

除了在终端中使用，你还可以在 VS Code 中安装官方的 Claude Code for VS Code 插件，获得图形化的交互体验。

安装方式：在 VS Code 扩展商店搜索 Claude Code（发布者为 Anthropic），点击安装即可。

使用说明：

• 安装后插件会自动检测本地的 Claude Code CLI 及其配置
• 如果 CLI 已正确配置好 API Key 和 Base URL，插件会直接可用，不会弹出登录页面
• 如果插件提示需要登录，说明本地 CLI 尚未安装或配置不完整，请先完成上方的安装配置步骤

使用心得 & 常见问题

常见问题

Q: 连接超时怎么办？

检查 ~/.claude/settings.json 中的 API 地址和 Key 是否正确。如果使用环境变量，确认 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 已正确设置。

Q: 如何切换模型？

在对话中输入 /model 即可查看和切换可用模型。

Q: token 用完了怎么办？

使用 /compact 压缩上下文，或 /clear 清除对话重新开始。

参考链接

• Claude Code 官方文档
• Claude Code GitHub 仓库

Roo Code 教程

什么是 Roo Code？

Roo Code 是一款运行在 VS Code（及类 VS Code 编辑器）中的 AI 编程插件，支持接入多种 AI 模型提供商。通过配置 DDDD Api 中转站，你可以在 VS Code 中直接使用 Claude、GPT 等模型进行智能编程辅助。

安装插件

1. 安装 Roo Code

打开 VS Code（或 Cursor 等类 VS Code 编辑器），进入扩展商店（快捷键 Ctrl+Shift+X），搜索 Roo Code 并点击安装。

2. 打开配置界面

安装完成后，在侧边栏找到 Roo Code 图标，点击进入配置界面。

API 配置（关键步骤）

1. 选择 API 提供商

在配置界面中，API Provider 选择 Anthropic。

2. 填写 API 密钥

在 API Key 栏填入你在 DDDD Api 控制台获取的密钥，分组选择 cc5 或 cc7。

3. 设置自定义基础 URL

勾选「Use custom base URL」，在下方输入框填入：

https://daidaididi.top

4. 选择模型

模型推荐选择 claude-opus-4-6，也可以根据需要选择其他可用模型。

配置参考截图

以下是正确的配置界面示例：

基本使用方法

1. 开始对话

配置完成后，点击侧边栏的 Roo Code 图标，在对话框中输入你的需求即可：

> 帮我分析当前打开的文件
> 给这个函数添加类型注解
> 重构这段代码，提升可读性

2. 上下文引用

Roo Code 会自动读取你当前打开的文件作为上下文。你也可以选中代码片段后再发起对话，AI 会针对选中的代码进行分析和修改。

使用技巧

常见问题

Q: 配置后无法连接？

检查是否勾选了不该勾选的选项（Anthropic 标头传递、1M 上下文），确认 API Key 和 Base URL 填写正确。

Q: 支持哪些模型？

通过 DDDD Api 中转站，你可以使用 Anthropic 提供的所有模型，推荐使用 claude-opus-4-6 获得最佳体验。

OpenCode 教程

什么是 OpenCode？

OpenCode 是一款基于 Go 的开源免费命令行编程工具（CLI），为开发者提供强大的 AI 协助。它最核心的优势在于打破了模型限制——你可以随意接入 Gemini、Claude、GPT 等任何一家的模型。

安装方式

方式一：安装脚本（macOS / Linux）

curl -fsSL https://opencode.ai/install | bash

方式二：NPM 安装（全平台，推荐 Windows）

先安装 Node.js，然后运行：

npm i -g opencode-ai@latest

方式三：Homebrew 桌面客户端（macOS）

brew install --cask opencode-desktop

API 配置（关键步骤）

1. 注册自定义服务商

安装后先不要直接启动 OpenCode，在终端执行：

opencode auth login

在服务商列表中选择 other（在最下面，可以直接搜索）：

然后按提示操作：

• Provider ID：输入一个唯一标识名，例如 ddddapi（后续配置需一致）
• API Key：输入你在 DDDD Api 控制台获取的 API Key

2. 修改配置文件

打开配置目录，创建或编辑 opencode.json：

• macOS / Linux：~/.config/opencode/opencode.json
• Windows：Users\你的用户名\.config\opencode\opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ddddapi": {  // 必须和上一步的 Provider ID 完全一致
      "npm": "@ai-sdk/anthropic",
      "name": "dddd-Api",  // UI 中显示的名称，可自定义
      "options": {
        "baseURL": "https://daidaididi.top/v1"
        // "apiKey": "{cred:ddddapi}"  // 可选：自动引用上一步存储的密钥
      },
      "models": {
        "claude-opus-4-5-20251101": {
          "name": "claude-opus-4-5-20251101"
        },
        "claude-sonnet-4-5": {
          "name": "claude-sonnet-4-5"
        },
        "claude-opus-4-6": {
          "name": "claude opus 4.6"
        }
        // 添加更多模型...
      }
    },
    "ddddapigpt": {  // 另开一个 GPT 格式的服务商，可同时用 Claude 和 GPT
      "npm": "@ai-sdk/openai",
      "name": "dddd-gpt",
      "options": {
        "baseURL": "https://daidaididi.top/v1",
        "apiKey": "sk-your-gpt-api-key"  // GPT 用 gpt 分组的令牌
      },
      "models": {
        "gpt-5.2-codex": {
          "name": "gpt-5.2-codex"
        },
        "gpt-5.3-codex": {
          "name": "gpt-5.3-codex"
        },
        "gpt-5.3-codex-spark": {
          "name": "gpt-5.3-codex-spark"
        }
        // 添加更多模型...
      }
    }
  }
}

3. 获取 API 令牌

前往 DDDD Api 令牌页面 生成令牌。

基本使用方法

1. 启动 OpenCode

保存配置文件后，重启终端，然后运行：

opencode

2. 选择模型

在聊天界面输入命令查看可用模型：

/models

在模型列表中可以看到你配置的中转站及其模型（如 "claude-opus-4-6"），选择后即可正常使用。

3. 开始编程

> 帮我分析这个项目的架构
> 给这个函数添加错误处理
> 优化这段代码的性能

使用技巧

常见问题

Q: 启动后看不到自定义模型？

检查 opencode.json 中的 Provider ID 是否和 opencode auth login 时输入的完全一致。

Q: 连接失败？

确认 baseURL 和 apiKey 填写正确，令牌分组使用 cc5。

CodeX 教程

什么是 CodeX？

CodeX 是 OpenAI 推出的基于 GPT 模型的强力编程助手。它能够理解自然语言指令并生成高质量代码，支持多种编程语言和框架。提供终端 CLI 和 VS Code 插件两种使用方式。

安装方式

方式一：终端 CLI 版本

适配任何有终端或 CMD 的 IDE，确保已安装 Node.js 18+：

# 验证 Node.js
node --version
npm --version

# 安装 CodeX
npm install -g @openai/codex

方式二：VS Code / Cursor 插件版本

在插件市场搜索 Codex 并安装，适配所有 VS Code 及其衍生产品（Cursor、Antigravity 等）：

一键配置（cc-switch）

1. 打开配置工具

使用 cc-switch 一键配置工具，无需手动编辑配置文件：

2. 获取 API Key 并填写配置

1. 访问 daidaididi.top 注册账号
2. 前往 充值页面 使用兑换码兑换额度
3. 前往 令牌页面 创建 API Key
4. 回到 cc-switch，填入配置信息

3. 重启生效

配置完成后，重启终端 / VS Code / Cursor，即可开始使用。

基本使用方法

1. 启动 CodeX

cd your-project
codex

2. 开始编程

CodeX 启动后会自动索引项目文件，直接输入需求即可：

> 帮我写一个用户注册的 API 接口
> 优化这个数据库查询的性能
> 给这个函数添加错误处理

常用命令

OpenClaw 教程

什么是 OpenClaw？

OpenClaw 是一款强大的 AI 编程助手工具，支持通过 Web UI 或命令行与 AI 模型交互。它提供了丰富的配置选项和插件系统，可以接入各种 AI 模型提供商，是开发者提升编程效率的利器。

安装步骤

前提条件

确保已安装 Node.js ≥ 22。可以通过以下命令检查版本：

node --version

安装 OpenClaw

在终端运行以下命令全局安装 OpenClaw：

npm install -g openclaw@latest
# 或使用 pnpm
pnpm add -g openclaw@latest

配置说明

1. 启动初始化程序

安装完成后，运行以下命令启动初始化向导：

openclaw onboard --install-daemon

2. 配置向导步骤

按照向导提示进行配置，关键步骤如下：

1. Install daemon? - 选择 yes
2. Onboarding mode - 选择第一个选项
3. Model/auth provider - 选择 Custom Provider (Any OpenAI or Anthropic compatible endpoint)
4. API Base URL - 输入 https://daidaididi.top/v1
5. API Key - 输入从控制台获取的 API Key（见下方说明）
6. Endpoint compatibility - 选择 Anthropic-compatible (Uses /messages)
7. Model ID - 输入 claude-opus-4-6-thinking（或其他模型）
8. Endpoint ID - 使用默认值即可
9. Model alias - 可选，例如输入 opus4.6
10. 后续的 QuickStart、Skills、Hooks 等选项可根据需要选择，初次使用可全部跳过
11. How do you want to hatch your bot? - 选择 Open the Web UI 方便查看

3. 获取 API Key

前往 DDDD Api 令牌页面 创建令牌：

1. 点击「添加令牌」
2. 输入名称（随意），分组选择 cc7 或 cc5
3. 模型限制列表和 IP 白名单留空，直接点击提交
4. 复制生成的 Key，粘贴到 OpenClaw 配置中

4. 优化配置文件

初始化完成后，编辑配置文件 ~/.openclaw/openclaw.json，优化以下参数：

• 将 contextWindow 从 4096 提升到 200000
• 将 maxTokens 从 4096 提升到 8192
• 确认 baseUrl 为 https://daidaididi.top

{
  "models": {
    "providers": {
      "custom-api-daidaididi.top": {
        "baseUrl": "https://daidaididi.top",
        "apiKey": "sk-your-api-key",
        "api": "anthropic-messages",
        "models": [{
          "id": "claude-opus-4-6-thinking",
          "contextWindow": 200000,
          "maxTokens": 8192
        }]
      }
    }
  }
}

基本使用

配置完成后，OpenClaw 会自动打开 Web UI 界面。你可以在浏览器中与 AI 进行对话，进行代码编写、问题解答等操作。

配置截图参考

以下是配置过程中的关键步骤截图：

步骤 1：Install daemon 选择 yes

步骤 2：选择 Custom Provider

步骤 3：获取 API Key

步骤 4：创建令牌

步骤 5：验证成功