OpenCode 接入教程

开发者工具命令行工具更新时间：2026-04-17

产品简介

OpenCode 是一款开源的 AI 编程助手，运行在终端中，通过对话方式帮助开发者高效完成代码编写、调试、重构等任务。通过配置海鲸AI的 API 接口，您可以在 OpenCode 中使用 Claude、GPT-5、通义千问等强大模型，无需科学上网即可享受高质量的 AI 编程体验。

核心功能

💻 智能代码生成 - 根据自然语言描述自动生成代码
🐛 代码调试分析 - 快速定位和修复 Bug
♻️ 代码重构优化 - 改进代码结构和性能
📝 文档自动生成 - 为代码添加注释和文档
🔍 代码理解解释 - 解释复杂代码逻辑
🚀 多语言支持 - 支持 Python、JavaScript、Java、Go 等主流语言

为什么选择海鲸AI？

优势	说明
🌐 无需翻墙	国内直连，稳定访问
💰 灵活计费	按需付费，无需订阅
⚡ 高性能	低延迟，响应迅速
🔒 数据安全	代码数据不存储，保护隐私
🤖 多模型	支持 Claude、GPT-5、通义千问等
🆓 新人福利	新用户可获得免费额度

支持的模型

海鲸AI通过 OpenAI 兼容接口，支持多种主流 AI 模型：

模型系列	推荐模型	特点	适用场景
Claude Sonnet	`claude-sonnet-4-6`	代码能力强、推理准确、200K上下文	复杂项目、代码重构
Claude Opus	`claude-opus-4-7`	最强性能、深度推理	架构设计、复杂算法
GPT-5	`gpt-5.4`	多模态能力强、全面均衡	日常开发、多场景
DeepSeek	`deepseek-v3`	国产旗舰、代码能力突出	编码任务、中文理解
通义千问	`qwen-max`	中文能力强、响应快	中文项目开发

模型选择建议

日常编程推荐：claude-sonnet-4-6（代码能力强、性价比高）
复杂任务推荐：claude-opus-4-7（最强性能）
高性价比选择：deepseek-v3（价格低、代码能力强）

前置准备

1. 获取海鲸AI API Key

访问海鲸AI控制台
注册并登录账户
在 API 管理页面生成 API Key
确保账户有足够余额或免费额度

新用户福利

首次注册海鲸AI，可获得新人免费额度，可用于所有模型推理服务。

2. 系统要求

系统	要求
操作系统	macOS 10.15+、Windows 10+、Linux
Node.js	v18.0 及以上版本
npm	v7.0+
终端	支持彩色输出的现代终端

验证 Node.js 版本

bash

node -v

输出版本号 v18.x.x 或以上即满足要求。若未安装，请前往 Node.js 官网下载安装。

安装 OpenCode

全局安装

bash

npm install -g opencode-ai

验证安装

bash

opencode -v

若输出版本号，表示安装成功。

安装提示

若安装失败，请检查 Node.js 版本是否为 18 及以上
国内用户可使用 npm 镜像加速：npm config set registry https://registry.npmmirror.com
macOS/Linux 遇到权限问题可使用 sudo npm install -g opencode-ai

配置海鲸AI

方式一：配置文件（推荐长期使用）

创建或编辑 OpenCode 配置文件：

macOS / Linux：~/.config/opencode/opencode.json
Windows：C:\Users\您的用户名\.config\opencode\opencode.json

Base URL 说明

baseURL 末尾必须附带 /v1，否则会报 404 Not Found 错误。

基础配置最小配置

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "haijing": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "海鲸AI",
      "options": {
        "baseURL": "https://api.atalk-ai.com/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxx"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "limit": {
            "context": 200000,
            "output": 64000
          }
        },
        "claude-opus-4-7": {
          "name": "Claude Opus 4.7",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "limit": {
            "context": 200000,
            "output": 32000
          }
        },
        "deepseek-v3": {
          "name": "DeepSeek V3",
          "modalities": {
            "input": ["text"],
            "output": ["text"]
          },
          "limit": {
            "context": 128000,
            "output": 8192
          }
        },
        "gpt-5.4": {
          "name": "GPT-5.4",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "limit": {
            "context": 128000,
            "output": 16384
          }
        },
        "qwen-max": {
          "name": "通义千问 Max",
          "modalities": {
            "input": ["text"],
            "output": ["text"]
          },
          "limit": {
            "context": 32768,
            "output": 8192
          }
        }
      }
    }
  }
}

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "haijing": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "海鲸AI",
      "options": {
        "baseURL": "https://api.atalk-ai.com/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxx"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "limit": {
            "context": 200000,
            "output": 64000
          }
        }
      }
    }
  }
}

注意事项

将 sk-xxxxxxxxxxxxxxxx 替换为您真实的海鲸AI API Key
配置文件修改后退出并重新启动 OpenCode 使新配置生效
API Key 请妥善保管，不要提交到代码仓库

启动与使用

启动 OpenCode

bash

cd your-project    # 进入项目目录
opencode           # 启动 OpenCode

OpenCode 对话界面

TIP

OpenCode 会以当前目录作为项目上下文，请确保在正确的项目目录中启动。若还没有项目目录，可以运行 mkdir my-project && cd my-project 创建并进入新目录。

常用命令

命令	功能
`/connect`	连接/切换模型服务商
`/models`	查看并切换模型
`/clear`	清空对话历史
`/help`	查看帮助信息

切换模型

在对话框中输入 /models，在搜索框中输入 海鲸AI 或模型名称（如 claude、deepseek）进行模糊搜索，选择目标模型即可切换。

OpenCode 模型选择界面

实战示例

示例 1：代码生成

👤 用户：
写一个 Python 函数，解析 JSON 文件并返回指定字段的值列表

🤖 OpenCode：
def extract_field(filepath, field):
    import json
    with open(filepath, 'r', encoding='utf-8') as f:
        data = json.load(f)
    if isinstance(data, list):
        return [item.get(field) for item in data if isinstance(item, dict)]
    elif isinstance(data, dict):
        return data.get(field)
    return None

示例 2：代码调试

👤 用户：
这个函数报 KeyError，帮我修复：
def get_user_name(user):
    return user['name']

🤖 OpenCode：
使用 .get() 方法安全访问，并提供默认值：
def get_user_name(user):
    return user.get('name', '未知用户')

节省 Token 技巧

1. 在具体项目目录中启动

最佳实践

在具体项目目录中启动 OpenCode，避免在根目录启动
使用 .gitignore 排除 node_modules/、dist/ 等无关目录
删除或移动大型二进制文件（图片、压缩包等）

2. 管理对话历史

命令	时机	效果
`/clear`	开始新任务前	清空全部历史，重置上下文

3. 提出精确指令

❌ 模糊指令	✅ 精确指令
"优化这个代码"	"重构 utils.py 中的 `parse_data` 函数，使用列表推导式"
"帮我改一下"	"在 index.js 第 45 行添加错误处理，捕获 API 调用失败"
"这里有问题"	"修复 calc.py 中的除零错误，添加输入验证"

常见问题

Q1：如何切换到指定模型？

在对话框中输入 /models，在搜索框中输入模型名称（如 claude 或 gpt-5）进行模糊搜索，选择对应模型即可。若搜索结果为空，表示当前版本暂不支持该模型。

Q2：连接失败或 401 / 404 错误怎么办？

检查 API Key 是否正确（以 sk- 开头）
确认配置文件路径为 ~/.config/opencode/opencode.json（注意文件名是 opencode.json，不是 config.json）
确认 baseURL 末尾含 /v1：https://api.atalk-ai.com/v1
登录海鲸AI控制台确认账户余额充足
修改配置后退出并重新启动 OpenCode 使配置生效

Q3：响应速度慢怎么办？

切换到更轻量的模型（如 gpt-5-mini 或 claude-haiku-4-5-20251001）
使用 /clear 清空过长的对话历史，减少上下文长度

Q4：如何更新 OpenCode？

bash

npm install -g opencode-ai@latest

Q5：支持哪些编程语言？

OpenCode 支持所有主流编程语言，包括但不限于：

支持的语言列表

Web 开发：JavaScript、TypeScript、HTML、CSS、Vue、React

后端开发：Python、Java、Go、Rust、C/C++、C#、PHP、Ruby

移动开发：Swift、Kotlin、Dart (Flutter)

数据科学：Python (NumPy/Pandas)、R、SQL

其他：Shell、YAML、JSON、Markdown

错误码说明

HTTP 状态码	含义	解决方案
401	API Key 认证失败	检查 API Key 是否正确；确认配置的 Base URL 为海鲸AI地址
403	权限不足	检查 API Key 权限；确认模型访问权限
429	请求频率限制	稍等片刻后重试；或升级账户配额
500	服务器错误	稍后重试；联系技术支持

📚 快速开始指南 - 了解海鲸AI API基础
💰 价格说明 - 了解计费详情
🎯 模型列表 - 查看所有可用模型
🔧 API参考文档 - 查看完整API接口

其他 AI 编程工具

工具	平台	特点
OpenCode	命令行	开源、轻量、终端交互
Claude Code	命令行	Anthropic 官方、深度代码理解
Cline	VSCode	IDE 插件、自主规划多步骤任务
Cherry Studio	桌面应用	图形界面、多模型管理

技术支持

渠道	响应时间	适用场景
📖 文档中心	即时	查阅常见问题
💬 在线客服	工作日 9:00-18:00	实时技术咨询
📧 邮件支持	24小时内	详细问题描述和反馈

🏠 返回首页
🔑 获取API Key

本文档最后更新于 2026-04-17

OpenCode 接入教程 ​

产品简介 ​

核心功能 ​

为什么选择海鲸AI？ ​

支持的模型 ​

前置准备 ​

1. 获取海鲸AI API Key ​

2. 系统要求 ​

安装 OpenCode ​

全局安装 ​

验证安装 ​

配置海鲸AI ​

方式一：配置文件（推荐长期使用） ​

启动与使用 ​

启动 OpenCode ​

常用命令 ​

切换模型 ​

实战示例 ​

示例 1：代码生成 ​

示例 2：代码调试 ​

节省 Token 技巧 ​

1. 在具体项目目录中启动 ​

2. 管理对话历史 ​

3. 提出精确指令 ​

常见问题 ​

Q1：如何切换到指定模型？ ​

Q2：连接失败或 401 / 404 错误怎么办？ ​

Q3：响应速度慢怎么办？ ​

Q4：如何更新 OpenCode？ ​

Q5：支持哪些编程语言？ ​

错误码说明 ​

相关资源 ​

其他 AI 编程工具 ​

技术支持 ​

OpenCode 接入教程

产品简介

核心功能

为什么选择海鲸AI？

支持的模型

前置准备

1. 获取海鲸AI API Key

2. 系统要求

安装 OpenCode

全局安装

验证安装

配置海鲸AI

方式一：配置文件（推荐长期使用）

启动与使用

启动 OpenCode

常用命令

切换模型

实战示例

示例 1：代码生成

示例 2：代码调试

节省 Token 技巧

1. 在具体项目目录中启动

2. 管理对话历史

3. 提出精确指令

常见问题

Q1：如何切换到指定模型？

Q2：连接失败或 401 / 404 错误怎么办？

Q3：响应速度慢怎么办？

Q4：如何更新 OpenCode？

Q5：支持哪些编程语言？

错误码说明

相关资源

其他 AI 编程工具

技术支持