安装 Claude Code CLI

确保已安装 Node.js 18+，然后全局安装：npm install -g @anthropic-ai/claude-code

创建配置文件

编辑 ~/.claude/settings.json（Windows 为用户目录下的 .claude/settings.json），填入右侧内容。

跳过引导

在 ~/.claude.json 中添加 "hasCompletedOnboarding": true 跳过首次引导。

启动使用

在项目目录运行 claude，输入 /model 切换模型。

~/.claude/settings.json

// 修改 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.clawease.cn",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": { "allow": [], "deny": [] },
  "alwaysThinkingEnabled": false
}

安装 Roo Code

在 VS Code / Cursor 扩展商店搜索 Roo Code 并安装。

配置 API

Provider 选择 Anthropic，API Key 填入你的 Key，分组选 cc5 或 cc7。

自定义 URL

勾选 Use custom base URL，填入 https://api.clawease.cn。

⚠ 不要勾选

「Anthropic 标头传递」和「1M 上下文」都不要勾选，否则格式不兼容。

Roo Code 配置要点

Provider: Anthropic
API Key: sk-your-api-key
分组: cc5 或 cc7

Use custom base URL: ✅ 勾选
Base URL: https://api.clawease.cn
Model: claude-opus-4-6

// ❌ 不要勾选以下两项
Send as Anthropic header: 不勾选
Enable 1M context: 不勾选

安装 OpenCode

Windows 推荐 npm：npm i -g opencode-ai@latest，macOS/Linux 也可用 curl -fsSL https://opencode.ai/install | bash

注册服务商

运行 opencode auth login，选择 other，输入 Provider ID（如 penguiapi）和 API Key。

编辑配置文件

编辑 ~/.config/opencode/opencode.json，Provider ID 必须与第 2 步完全一致。

启动使用

重启终端后运行 opencode，输入 /models 选择模型。

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "penguiapi": {
      "npm": "@ai-sdk/anthropic",
      "name": "ClawEase-Api",
      "options": {
        "baseURL": "https://api.clawease.cn/v1"
      },
      "models": {
        "claude-opus-4-6": { "name": "claude opus 4.6" },
        "claude-sonnet-4-5": { "name": "claude-sonnet-4-5" }
      }
    }
  }
}

安装 CodeX

终端版：npm install -g @openai/codex
插件版：在 VS Code / Cursor 插件市场搜索 Codex 安装。

使用 cc-switch

使用 cc-switch 一键配置工具，填入 API Key 和地址即可。

获取 Key

从控制台获取 API Key。

重启使用

重启终端 / VS Code / Cursor，输入 codex 开始。

安装命令

# 终端版安装
npm install -g @openai/codex

# 启动
cd your-project
codex

安装（需 Node.js ≥22）

npm install -g openclaw@latest

初始化向导

运行 openclaw onboard --install-daemon，选择 Custom Provider，填入地址 https://api.clawease.cn/v1 和 Key。

获取令牌

从控制台创建令牌，分组选 cc7 或 cc5。

优化配置

编辑 ~/.openclaw/openclaw.json，contextWindow 改为 200000，maxTokens 改为 8192。

~/.openclaw/openclaw.json

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

下载安装

前往 cherry-ai.com/download 下载，支持 Windows / macOS / Linux。

获取 API Key

从控制台创建令牌：Claude 用 cc7 分组，GPT 用 gpt 分组。

配置服务商

打开 Cherry Studio 设置，填入 API 地址 https://api.clawease.cn 和 Key，端点类型选择 OpenAI-Response。

开始使用

选择模型后直接输入问题即可。支持多会话管理。

Cherry Studio 配置

API 地址: https://api.clawease.cn
API Key: sk-your-api-key
端点类型: OpenAI-Response

# Claude 模型 → cc7 分组令牌
# GPT 模型 → gpt 分组令牌

详细教程

Claude Code 教程

📖 约 10 分钟 🕐 2025 更新

什么是 Claude Code？

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

🧠 智能代码理解

深度理解项目结构、依赖关系和代码逻辑

💬 自然语言交互

用中文或英文描述需求，AI 自动生成代码

🖥️ 终端原生体验

无需离开终端，直接在命令行中完成所有操作

📁 多文件编辑

一次对话中可同时修改多个文件，保持一致性

效率对比

场景	传统开发	Claude Code
研究文档 + 后端 + 前端 + 调试	约 2.5 小时	约 15 分钟
查找并修复 Bug	反复调试	自动分析代码，智能建议
多文件批量修改	容易遗漏关联文件	一次对话完成，保持一致

环境要求

支持平台

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

系统要求

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

安装步骤

🚀 一键配置（推荐）

先安装好 Node.js 和 Claude Code CLI（见下方步骤），然后运行 npx pengui-api 即可一键完成配置。

1. 安装 Node.js

使用 nvm 管理版本：

Terminal

# 安装 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

⚠ Windows 用户注意

Windows 系统需要额外安装 Git for Windows，否则 Claude Code 可能无法正常运行。

2. 安装 Claude Code CLI

Terminal

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

API 配置

1. 获取令牌

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

2. 配置环境变量

编辑 ~/.claude/settings.json（Windows 为用户目录下 .claude/settings.json）：

~/.claude/settings.json

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

💡 也可以用环境变量

export ANTHROPIC_BASE_URL="https://api.clawease.cn" 和 export ANTHROPIC_AUTH_TOKEN="sk-xxx"

3. 跳过引导

编辑或新增 ~/.claude.json，添加：

~/.claude.json

{ "hasCompletedOnboarding": true }

基本使用

在项目目录运行 claude 启动：

Terminal

cd your-project
claude

# 示例对话
> 帮我分析这个项目的架构
> 给 UserService 添加分页查询方法
> 修复 login 接口的参数校验问题

常用命令

命令	说明
/help	显示帮助信息和所有可用命令
/compact [instructions]	压缩上下文，释放 token 空间
/clear	清除当前对话历史
/cost	查看当前会话的 token 消耗
/resume	恢复上一次的对话
/model	切换使用的模型
/mcp	管理 MCP 服务器连接

MCP 协议

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

.mcp.json

{
  "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 每次启动会自动读取：

CLAUDE.md

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

# 编码标准
- 使用 ESLint + Prettier
- 组件使用函数式写法 + Hooks

# 注意事项
- 不要修改 migrations 目录
- 环境变量在 .env.example 中

常见问题

Q: 连接超时？ 检查 ~/.claude/settings.json 中的 API 地址和 Key 是否正确。

Q: 如何切换模型？ 输入 /model 查看和切换可用模型。

Q: token 溢出？ 使用 /compact 压缩上下文，或 /clear 清除对话。

参考链接

Roo Code 教程

📖 约 5 分钟🕐 2025 更新

什么是 Roo Code？

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

🖥️ VS Code 原生集成

无需离开编辑器，在侧边栏直接与 AI 对话

🤖 多模型支持

支持 Anthropic、OpenAI 等多种 API 提供商

🧠 上下文感知

自动读取当前打开的文件和项目结构

⚙️ 图形化配置

无需编辑配置文件，设置界面直观

安装与配置

安装

在 VS Code / Cursor 扩展商店搜索 Roo Code 并安装，安装完成后在侧边栏找到图标点击进入。

配置

1. Provider 选择 Anthropic
2. API Key 填入 ClawEase Api Key，分组选 cc5 或 cc7
3. 勾选 Use custom base URL，填入 https://api.clawease.cn
4. 不要勾选「Anthropic 标头传递」和「1M 上下文」

⚠ 关键配置

「Anthropic 标头传递」和「1M 上下文」都不要勾选，否则请求格式不兼容。

使用技巧

先选中需要修改的代码，再描述需求，效果更精准
利用多文件编辑能力，一次对话完成关联修改
配合 VS Code 的 Git 集成，方便对比 AI 生成的改动

Q: 配置后无法连接？ 检查是否误勾选了标头传递选项，确认 API Key 和 Base URL 正确。

OpenCode 教程

📖 约 6 分钟🕐 2025 更新

什么是 OpenCode？

OpenCode 是一款基于 Go 的开源免费命令行编程工具（CLI），核心优势是打破模型限制——随意接入 Gemini、Claude、GPT 等任何模型。

🔓 完全开源免费

基于 Go 开发，开源社区驱动

🔀 多模型自由切换

支持 OpenAI、Anthropic、Gemini 及本地模型

🖥️ 交互式终端

基于 Bubble Tea 的流畅 TUI 体验

🔧 LSP 集成

内置代码智能和诊断功能

安装方式

macOS / Linux：curl -fsSL https://opencode.ai/install | bash
Windows（推荐）：npm i -g opencode-ai@latest
macOS 桌面：brew install --cask opencode-desktop

API 配置

1. 运行 opencode auth login，选择 other，输入 Provider ID（如 penguiapi）和 API Key。
2. 编辑 ~/.config/opencode/opencode.json（Windows 为 Users\用户名\.config\opencode\opencode.json）。
3. Provider ID 必须与 auth login 时输入的完全一致。

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "penguiapi": {
      "npm": "@ai-sdk/anthropic",
      "name": "ClawEase-Api",
      "options": {
        "baseURL": "https://api.clawease.cn/v1"
      },
      "models": {
        "claude-opus-4-6": { "name": "claude opus 4.6" }
      }
    }
  }
}

⚠ 重要

baseURL 必须以 /v1 结尾。GPT 模型需要另建一个服务商，使用 gpt 分组的令牌。

CodeX 教程

📖 约 6 分钟🕐 2025 更新

什么是 CodeX？

CodeX 是 OpenAI 推出的基于 GPT 模型的强力编程助手。提供终端 CLI 和 VS Code 插件两种使用方式。

🤖 GPT-5.3 驱动

基于最新 GPT 模型，代码生成质量极高

🌐 多语言支持

支持 Python、JavaScript、Go、Rust 等主流语言

🔒 沙箱执行

内置安全沙箱，可直接运行和测试代码

🖥️ 双形态运行

终端 CLI + VS Code/Cursor 插件

安装方式

终端版：npm install -g @openai/codex
插件版：在 VS Code / Cursor 插件市场搜索 Codex 安装。

一键配置（cc-switch）

使用 cc-switch 一键配置工具：

访问 api.clawease.cn 注册
前往充值页面使用兑换码
前往令牌页面创建 API Key
回到 cc-switch 填入配置信息

常用命令

命令	说明
/help	显示帮助信息
/model	切换模型
/clear	清除对话历史
/run	在沙箱中执行代码
/diff	查看代码变更差异

OpenClaw 教程

📖 约 8 分钟🕐 2026 更新

什么是 OpenClaw？

OpenClaw 是一款强大的 AI 编程助手，支持通过 Web UI 或命令行与 AI 模型交互，提供丰富的配置选项和插件系统。

🌐 Web UI 界面

提供友好的 Web 界面，方便查看和管理对话

🤖 多模型支持

支持 Claude、GPT 等多种 AI 模型

🔌 插件系统

丰富的插件生态，扩展更多功能

⚙️ 高度可配置

支持自定义 contextWindow、maxTokens

安装步骤

需 Node.js ≥22：npm install -g openclaw@latest

配置说明

1. 运行 openclaw onboard --install-daemon 启动初始化向导
2. 选择 Custom Provider，API Base URL 填 https://api.clawease.cn/v1
3. Endpoint compatibility 选择 Anthropic-compatible (Uses /messages)
4. Model ID 填 claude-opus-4-6-thinking（或其他模型）
5. 从控制台获取令牌，分组选 cc7 或 cc5

💡 优化配置

编辑 ~/.openclaw/openclaw.json，将 contextWindow 改为 200000，maxTokens 改为 8192。

Cherry Studio 教程

📖 约 5 分钟🕐 2025 更新

什么是 Cherry Studio？

Cherry Studio 是一款功能强大的桌面端 AI 对话客户端，界面美观、操作简单，适合不习惯命令行的用户。

🖥️ 桌面原生

支持 Windows / macOS / Linux 全平台

🔀 多模型切换

同一界面自由切换 Claude、GPT 等模型

⚙️ 图形化配置

无需编辑配置文件，设置界面直观

💬 对话管理

支持多会话管理、历史记录保存

下载安装

前往 cherry-ai.com/download 下载对应系统安装包。

API 配置

从控制台创建令牌：Claude 用 cc7 分组，GPT 用 gpt 分组
打开 Cherry Studio 设置，填入 API 地址 https://api.clawease.cn 和 Key
端点类型务必选择 OpenAI-Response

⚠ 重要

端点类型必须选择 OpenAI-Response。Claude 模型用 cc7 令牌，GPT 模型用 gpt 令牌，不要混用。

使用技巧

Claude 和 GPT 使用不同分组的令牌，避免混用
善用多会话功能，不同项目使用不同对话窗口
复杂任务建议用 Claude，简单问答可用 GPT 节省额度

三步完成 AI 编程助手 接入

选择你的工具

Claude Code

Roo Code

OpenCode

CodeX

OpenClaw

Cherry Studio

安装 Claude Code CLI

创建配置文件

跳过引导

启动使用

安装 Roo Code

配置 API

自定义 URL

⚠ 不要勾选

安装 OpenCode

注册服务商

编辑配置文件

启动使用

安装 CodeX

使用 cc-switch

获取 Key

重启使用

安装（需 Node.js ≥22）

初始化向导

获取令牌

优化配置

下载安装

获取 API Key

配置服务商

开始使用

详细教程

Claude Code 教程

什么是 Claude Code？

🧠 智能代码理解

💬 自然语言交互

🖥️ 终端原生体验

📁 多文件编辑

效率对比

环境要求

支持平台

系统要求

安装步骤

1. 安装 Node.js

2. 安装 Claude Code CLI

API 配置

1. 获取令牌

2. 配置环境变量

3. 跳过引导

基本使用

常用命令

MCP 协议

高级技巧

CLAUDE.md 项目记忆

常见问题

参考链接

Roo Code 教程

什么是 Roo Code？

🖥️ VS Code 原生集成

🤖 多模型支持

🧠 上下文感知

⚙️ 图形化配置

安装与配置

安装

配置

使用技巧

OpenCode 教程

什么是 OpenCode？

🔓 完全开源免费

🔀 多模型自由切换

🖥️ 交互式终端

🔧 LSP 集成

安装方式

API 配置

CodeX 教程

什么是 CodeX？

🤖 GPT-5.3 驱动

🌐 多语言支持

🔒 沙箱执行

三步完成 AI 编程助手接入