跳转到主要内容
OpenCode 是一款面向开发者的开源 AI 编程智能体(Coding Agent),主打“终端原生”体验:通过 TUI/CLI 在命令行内完成需求讨论、代码生成、重构、解释与调试等工作流。它强调“模型无关”,可接入 Claude、GPT、Gemini 等多家模型服务,也支持对接本地或 OpenAI 兼容接口,便于在成本、效果与隐私之间自由取舍。OpenCode 还提供可扩展的插件/工具机制与配置体系,能把项目上下文、命令执行等能力纳入自动化流程,适合重度终端用户与希望自定义 AI 编程工作流的团队使用。

安装及接入

安装

curl -fsSL https://opencode.ai/install | bash
其他安装方式见 OpenCode 官方网站:https://opencode.ai/docs/#install

启动 OpenCode

cd /path/to/project  # 进入项目路径

opencode  # 启动 OpenCode

接入 JieKou API

  • 全局配置:~/.config/opencode/opencode.json
  • 项目配置:项目根目录下的 opencode.json
(若没有 opencode.json,可以手动创建) 配置如下:
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JieKou",
      "options": {
        "baseURL": "https://api.jiekou.ai/openai/v1"
      },
      "models": {
        "claude-sonnet-4-5-20250929": {
          "name": "claude-sonnet-4-5-20250929"
        },
        "gpt-5.2": {
          "name": "gpt-5.2"
        },
      }
    }
  }
}
配置第三方供应商时,需要注意选择正确的 npm 包:
npm 包API 类型适用场景
@ai-sdk/openai-compatibleChat Completion APIGPT、Claude 等大部分模型
@ai-sdk/openaiResponse APICodex 系列模型
注意: Codex 模型(如 gpt-5.1-codex)需要使用 @ai-sdk/openai(Response API),其他模型使用 @ai-sdk/openai-compatible(Chat Completion API)。

配置 KEY

进入 opencode,使用 /connect 选择供应商后,填写 API KEY,enter 确定 opencode_input_api_key

开始使用

连接供应商后,可使用 /models 命令选择模型 opencode_choose_model

其他用法

示例:本地 MCP 配置(以计算 MCP 为例)

  1. 使用 python + MCP SDK 编写计算器 mcp server 代码,并保存到本地路径中
import asyncio
import math
from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import Tool, TextContent

# Create server instance
server = Server("calculator")

@server.list_tools()
async def list_tools() -> list[Tool]:
    """List available calculator tools."""
    return [
        Tool(
            name="add",
            description="Add two numbers",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "First number"},
                    "b": {"type": "number", "description": "Second number"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="subtract",
            description="Subtract second number from first number",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "First number"},
                    "b": {"type": "number", "description": "Second number to subtract"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="multiply",
            description="Multiply two numbers",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "First number"},
                    "b": {"type": "number", "description": "Second number"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="divide",
            description="Divide first number by second number",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "Dividend"},
                    "b": {"type": "number", "description": "Divisor"},
                },
                "required": ["a", "b"],
            },
        ),
        Tool(
            name="power",
            description="Raise a number to a power",
            inputSchema={
                "type": "object",
                "properties": {
                    "base": {"type": "number", "description": "Base number"},
                    "exponent": {"type": "number", "description": "Exponent"},
                },
                "required": ["base", "exponent"],
            },
        ),
        Tool(
            name="sqrt",
            description="Calculate square root of a number",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "Number to calculate square root of"},
                },
                "required": ["a"],
            },
        ),
        Tool(
            name="modulo",
            description="Calculate remainder of division",
            inputSchema={
                "type": "object",
                "properties": {
                    "a": {"type": "number", "description": "Dividend"},
                    "b": {"type": "number", "description": "Divisor"},
                },
                "required": ["a", "b"],
            },
        ),
    ]

@server.call_tool()
async def call_tool(name: str, arguments: dict) -> list[TextContent]:
    """Handle tool calls for calculator operations."""
    try:
        if name == "add":
            result = arguments["a"] + arguments["b"]
        elif name == "subtract":
            result = arguments["a"] - arguments["b"]
        elif name == "multiply":
            result = arguments["a"] * arguments["b"]
        elif name == "divide":
            if arguments["b"] == 0:
                return [TextContent(type="text", text="Error: Division by zero")]
            result = arguments["a"] / arguments["b"]
        elif name == "power":
            result = math.pow(arguments["base"], arguments["exponent"])
        elif name == "sqrt":
            if arguments["a"] < 0:
                return [TextContent(type="text", text="Error: Cannot calculate square root of negative number")]
            result = math.sqrt(arguments["a"])
        elif name == "modulo":
            if arguments["b"] == 0:
                return [TextContent(type="text", text="Error: Modulo by zero")]
            result = arguments["a"] % arguments["b"]
        else:
            return [TextContent(type="text", text=f"Error: Unknown tool '{name}'")]

        return [TextContent(type="text", text=str(result))]

    except Exception as e:
        return [TextContent(type="text", text=f"Error: {str(e)}")]

async def main():
    """Run the calculator MCP server."""
    async with stdio_server() as (read_stream, write_stream):
        await server.run(read_stream, write_stream, server.create_initialization_options())

if __name__ == "__main__":
    asyncio.run(main())

  1. 在 opencode.json 添加本地 mcp
{
  "mcp": {
    "calc_mcp": {
      "type": "local",
      "command": ["python3", "{your_local_path}/calc_mcp.py"],
      "enabled": true
    }
  }
}
  1. 使用 /mcps 查看 mcp 连接状态,Enabled 状态时,可令 opencode 调用
opencode_mcp