> ## Documentation Index
> Fetch the complete documentation index at: https://docs.megallm.io/llms.txt
> Use this file to discover all available pages before exploring further.
# AI 代码助手概览
> 配置 AI 代码助手以使用 MegaLLM - CLI 工具和 GUI 扩展
MegaLLM 支持所有主流 AI 代码助手。本统一指南涵盖了 Claude Code、Codex/Windsurf、OpenCode、Kilocode、RooCode 和 Cline 的配置。
## 可用助手
CLI + 编辑器集成与 JSON 配置
CLI + 编辑器与 TOML 配置
CLI + 编辑器与自动模型获取
VSCode 扩展与内联聊天(CLI 即将推出)
独立应用程序与可视化界面
VSCode 扩展与自主任务(CLI 即将推出)
## 快速比较
| 助手 | 接口 | 配置格式 | 配置级别 | 最适合 |
| ------------------ | ---------------- | --------- | -------- | --------------- |
| **Claude Code** | CLI + VSCode | JSON | 系统 + 项目 | 终端工作流、VSCode 集成 |
| **Codex/Windsurf** | CLI + 编辑器 | TOML | 仅系统 | 高级用户、Cascade AI |
| **OpenCode** | CLI + 编辑器 | JSON | 系统 + 项目 | 多模型切换、灵活性 |
| **Kilocode** | VSCode(CLI 即将推出) | VSCode 设置 | 用户 + 工作区 | 内联聊天、代码补全 |
| **RooCode** | 独立应用 | JSON | 应用级别 | 可视化 UI、独立工作流 |
| **Cline** | VSCode(CLI 即将推出) | VSCode 设置 | 用户 + 工作区 | 自主任务、终端操作 |
## 助手类型
### CLI 优先助手(支持编辑器)
* CLI 优先设计
* VSCode 扩展可用
* JSON 配置
* 系统和项目级别
* 状态栏支持
* CLI 优先设计
* 编辑器集成
* TOML 配置
* Cascade AI (Windsurf)
* Supercomplete 功能
* CLI 优先设计
* 编辑器插件可用
* JSON 配置
* 自动获取模型
* 多提供商支持
**何时使用 CLI 优先助手:**
* 基于终端的工作流
* CI/CD 集成
* 服务器环境
* 脚本和自动化
* 在编辑器中与扩展一起使用也很好
### 仅编辑器助手(CLI 即将推出)
* VSCode 扩展(主要)
* CLI 正在维护中
* 内联聊天界面
* 代码补全
* 文件树集成
* 独立应用
* 可视化界面
* 多项目支持
* 代码审查功能
* VSCode 扩展(主要)
* CLI 正在维护中
* 自主任务执行
* 终端集成
* Git 工作流支持
**Kilocode 和 Cline 的 CLI 支持:** CLI 版本目前正在维护中,即将推出。请暂时使用 VSCode 扩展。
**何时使用编辑器优先助手:**
* 纯可视化编辑工作流
* 内联建议和补全
* 多文件重构
* 代码审查工作流
* IDE 原生体验
## 开始使用
为终端工作流选择 CLI 助手,或为可视化编辑选择 GUI 助手
在 [MegaLLM 仪表板](https://megallm.io/dashboard) 注册并获取以 `sk-mega-` 开头的 API 密钥
遵循你所选助手的具体配置指南(下面的链接)
启动你的助手并开始使用 AI 驱动的编码辅助
## 配置指南
### CLI 优先助手(也适用于编辑器)
**用途:** CLI 工具 + VSCode 扩展
**配置文件:**
* 系统: `~/.claude/settings.json`
* 项目: `./.claude/settings.json`
* 本地: `./.claude/settings.local.json`
**快速设置:**
```json theme={null}
{
"env": {
"ANTHROPIC_BASE_URL": "https://ai.megallm.io",
"ANTHROPIC_API_KEY": "sk-mega-your-api-key-here"
}
}
```
[完整 Claude Code 配置指南 →](/cn/agents/claude)
**用途:** CLI 工具 + 编辑器集成(Windsurf 是增强版本)
**配置文件:**
* 系统: `~/.codex/config.toml` (仅)
**快速设置:**
```toml theme={null}
model_provider = "megallm"
model = "gpt-5"
[model_providers.megallm]
name = "OpenAI using Chat Completions"
base_url = "https://ai.megallm.io/v1"
env_key = "MEGALLM_API_KEY"
[tools]
web_search = true
file_browser = true
```
[完整 Codex/Windsurf 配置指南 →](/cn/agents/codex)
**用途:** CLI 工具 + 编辑器插件(VSCode、Vim 等)
**配置文件:**
* 系统: `~/.config/opencode/opencode.json`
* 项目: `./.opencode/opencode.json`
**快速设置:**
```json theme={null}
{
"providers": [
{
"id": "megallm",
"name": "MegaLLM",
"type": "openai",
"baseURL": "https://ai.megallm.io/v1",
"apiKey": "sk-mega-your-api-key-here"
}
],
"defaultProvider": "megallm"
}
```
[完整 OpenCode 配置指南 →](/cn/agents/opencode)
### 仅编辑器助手
**配置位置:**
* 用户设置(全局): VSCode 设置 UI 或 `settings.json`
* 工作区设置(项目): `.vscode/settings.json`
**快速设置(settings.json):**
```json theme={null}
{
"kilocode.apiProvider": "custom",
"kilocode.customProvider": {
"name": "MegaLLM",
"baseURL": "https://ai.megallm.io/v1",
"apiKey": "${env:MEGALLM_API_KEY}"
},
"kilocode.defaultModel": "gpt-5"
}
```
**环境变量:**
```bash theme={null}
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
```
[完整 Kilocode 配置指南 →](/cn/agents/kilocode)
**配置位置:**
* Windows: `%APPDATA%\RooCode\config.json`
* macOS: `~/Library/Application Support/RooCode/config.json`
* Linux: `~/.config/roocode/config.json`
**快速设置:**
```json theme={null}
{
"provider": "openai-compatible",
"api": {
"baseURL": "https://ai.megallm.io/v1",
"apiKey": "sk-mega-your-api-key-here",
"model": "gpt-5"
},
"features": {
"codeCompletion": true,
"chatInterface": true,
"codeReview": true,
"terminalIntegration": false
}
}
```
[完整 RooCode 配置指南 →](/cn/agents/roocode)
**配置位置:**
* 用户设置(全局): VSCode 设置 UI 或 `settings.json`
* 工作区设置(项目): `.vscode/settings.json`
**GPT 模型快速设置(OpenAI 格式):**
```json theme={null}
{
"cline.apiProvider": "openai",
"cline.openai": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io/v1"
},
"cline.defaultModel": "gpt-5"
}
```
**Claude 模型快速设置(Anthropic 格式):**
```json theme={null}
{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-sonnet-4"
}
```
**环境变量:**
```bash theme={null}
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
```
[完整 Cline 配置指南 →](/cn/agents/cline)
## 模型选择
所有助手通过 MegaLLM 支持相同的模型:
### GPT 模型
* `gpt-5` - 最新 GPT 模型(推荐)
* `gpt-4` - GPT-4
* `gpt-4o` - GPT-4 优化版
* `gpt-4o-mini` - 快速、经济实惠
### Claude 模型
* `claude-opus-4-1-20250805` - 最强大
* `claude-sonnet-4` - 平衡(推荐)
* `claude-haiku-4` - 快速、高效
### Gemini 模型
* `gemini-2.5-pro` - 最新 Gemini
* `gemini-2.0-flash` - 快速响应
[查看完整模型目录 →](/cn/home/models)
## 环境变量
大多数助手支持使用环境变量设置 API 密钥:
```bash theme={null}
# 适用于 CLI 助手和一些 GUI 助手
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
# Claude Code 专用
export ANTHROPIC_BASE_URL="https://ai.megallm.io"
export ANTHROPIC_API_KEY="sk-mega-your-api-key-here"
```
添加到你的 shell 配置:
* Bash: `~/.bashrc`
* Zsh: `~/.zshrc`
* Fish: `~/.config/fish/config.fish`
## 常见配置模式
### 模式 1: 个人使用的系统级配置
**最适合**: 个人项目、单用户
```bash theme={null}
# 系统配置
~/.claude/settings.json
# 环境变量
export ANTHROPIC_BASE_URL="https://ai.megallm.io"
export ANTHROPIC_API_KEY="sk-mega-your-key"
```
```bash theme={null}
# VSCode 用户设置
# 文件 > 首选项 > 设置 > 搜索 "kilocode"
# 环境变量
export MEGALLM_API_KEY="sk-mega-your-key"
```
```bash theme={null}
# 应用配置
~/.config/roocode/config.json
# 在配置中存储 API 密钥或使用环境变量
```
### 模式 2: 团队项目的项目级配置
**最适合**: 团队项目、共享配置
```bash theme={null}
# 共享配置(已提交)
.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://ai.megallm.io"
}
}
# 个人密钥(未提交)
.claude/settings.local.json
{
"env": {
"ANTHROPIC_API_KEY": "your-personal-key"
}
}
# .gitignore
.claude/settings.local.json
```
```bash theme={null}
# 工作区设置(已提交)
.vscode/settings.json
{
"kilocode.apiProvider": "custom",
"kilocode.customProvider": {
"name": "MegaLLM",
"baseURL": "https://ai.megallm.io/v1",
"apiKey": "${env:MEGALLM_API_KEY}"
}
}
# 团队成员设置自己的环境变量
export MEGALLM_API_KEY="personal-key"
```
```bash theme={null}
# 项目配置(已提交)
.opencode/opencode.json
{
"providers": [{
"baseURL": "https://ai.megallm.io/v1"
}]
}
# 通过环境变量设置个人密钥
export MEGALLM_API_KEY="personal-key"
```
### 模式 3: 多模型配置
**最适合**: 不同任务使用不同模型
```json theme={null}
{
"providers": [
{
"id": "megallm-gpt",
"type": "openai",
"baseURL": "https://ai.megallm.io/v1",
"models": ["gpt-5", "gpt-4o"]
},
{
"id": "megallm-claude",
"type": "anthropic",
"baseURL": "https://ai.megallm.io",
"models": ["claude-sonnet-4", "claude-opus-4"]
}
]
}
```
```json theme={null}
{
"providers": [
{
"name": "GPT for Chat",
"model": "gpt-5",
"useFor": ["chat", "completion"]
},
{
"name": "Claude for Review",
"model": "claude-sonnet-4",
"useFor": ["review", "analysis"]
}
]
}
```
## 故障排除
**验证你的 API 密钥:**
```bash theme={null}
# 检查是否以 sk-mega- 开头
echo $MEGALLM_API_KEY
# 直接测试 API
curl -H "Authorization: Bearer $MEGALLM_API_KEY" \
https://ai.megallm.io/v1/models
```
**常见问题:**
* 缺少 `sk-mega-` 前缀
* 多余的空格或引号
* 环境变量名称错误
* Shell 配置未重新加载(运行 `source ~/.bashrc`)
**检查你的基础 URL:**
对于 **OpenAI 兼容格式**(GPT、Gemini):
```
https://ai.megallm.io/v1 (带 /v1)
```
对于 **Anthropic 格式**(Claude):
```
https://ai.megallm.io (不带 /v1)
```
**助手特定端点:**
* Claude Code: `https://ai.megallm.io` (不带 /v1)
* Codex/Windsurf: `https://ai.megallm.io/v1`
* OpenCode: `https://ai.megallm.io/v1`
* Kilocode: `https://ai.megallm.io/v1`
* RooCode: `https://ai.megallm.io/v1`
* Cline: `https://ai.megallm.io` (Anthropic) 或 `https://ai.megallm.io/v1` (OpenAI)
**验证模型名称拼写:**
查看[模型目录](/cn/home/models)获取确切的模型名称:
```bash theme={null}
# 常见错误:
"gpt5" # 缺少连字符
"gpt-5"
"claude-sonnet" # 缺少版本
"claude-sonnet-4"
"gemini-pro" # 版本错误
"gemini-2.5-pro"
```
**检查文件位置:**
```bash theme={null}
# CLI 助手
ls -la ~/.claude/settings.json # Claude Code
ls -la ~/.codex/config.toml # Codex
ls -la ~/.config/opencode/ # OpenCode
# 项目配置
ls -la .claude/settings.json # Claude Code
ls -la .opencode/opencode.json # OpenCode
ls -la .vscode/settings.json # VSCode 扩展
# 验证 JSON/TOML 语法
jq . ~/.claude/settings.json # 测试 JSON
cat ~/.codex/config.toml | grep - # 测试 TOML
```
**检查权限:**
```bash theme={null}
chmod 644 ~/.claude/settings.json
chmod 644 ~/.codex/config.toml
```
**重新加载你的 shell 配置:**
```bash theme={null}
# Bash
source ~/.bashrc
# Zsh
source ~/.zshrc
# Fish
source ~/.config/fish/config.fish
# 验证
echo $MEGALLM_API_KEY
echo $ANTHROPIC_BASE_URL
```
**检查定义位置:**
```bash theme={null}
# 搜索所有 shell 配置
grep -r "MEGALLM_API_KEY" ~/.*rc ~/.config/
```
## 功能比较
### 接口和使用
| 助手 | CLI 可用 | 编辑器/GUI | 聊天界面 | 多文件编辑 |
| -------------- | ---------------------------- | -------------------------------- | -------------------------------- | --------------------- |
| Claude Code | 主要 | VSCode 扩展 | CLI + GUI | |
| Codex/Windsurf | 主要 | 编辑器 | CLI + GUI | |
| OpenCode | 主要 | 插件 | CLI + GUI | |
| Kilocode | 即将推出 | 仅 VSCode | GUI | |
| RooCode | | 独立 | GUI | |
| Cline | 即将推出 | 仅 VSCode | GUI | |
### 集成
| 助手 | 终端访问 | Git 集成 | 文件树 | 代码审查 |
| -------------- | ----------------------------------------------- | ----------------------------- | --------------------- | ---------------------------- |
| Claude Code | 原生 CLI | 原生 | | 在编辑器中 |
| Codex/Windsurf | 原生 CLI | 原生 | | 在编辑器中 |
| OpenCode | 原生 CLI | 原生 | | 在编辑器中 |
| Kilocode | 通过 VSCode | VSCode | | |
| RooCode | 内置 | 内置 | | |
| Cline | VSCode 终端 | VSCode | | |
### 配置灵活性
| 助手 | 系统配置 | 项目配置 | 环境变量 | 团队共享 |
| -------------- | --------------------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
| Claude Code | | | | |
| Codex/Windsurf | | | | 有限 |
| OpenCode | | | | |
| Kilocode | | | | |
| RooCode | | 导入 | 有限 | 导出 |
| Cline | | | | |
## 最佳实践
将 API 密钥存储在环境变量中,切勿提交到版本控制
使用项目级配置共享设置,本地文件存储个人密钥
自动化/CI/CD 使用 CLI,交互式编码和可视化工作流使用 GUI
在配置助手之前使用 curl 验证 API 连接
将敏感文件添加到 .gitignore,开发/生产使用不同的密钥
保持助手更新以获得最新功能、安全补丁和错误修复
## 后续步骤
CLI 与 JSON 配置
CLI 与 TOML 配置
CLI 与自动获取
VSCode 扩展
独立应用
VSCode + 自主功能
浏览所有可用模型
直接 API 集成