常见问题 (FAQ)

opencode run --model anthropic/claude-sonnet-4
opencode run --model openai/gpt-4-turbo
opencode run --model ollama/llama3  # 本地模型

// opencode.json
{
  "model": {
    "providerID": "anthropic",
    "modelID": "claude-sonnet-4-20250514"
  }
}

opencode models

// opencode.json
{
  "agent": {
    "build": {
      "permission": {
        "delete": "deny",  // 禁止删除
        "bash": "ask"      // 执行命令需要批准
      }
    }
  }
}

opencode plugin uninstall plugin-name

opencode run --no-mcp

opencode history
 
# 查看特定会话
opencode history <session-id>

# 会话存储在 ~/.opencode/sessions/
ls ~/.opencode/sessions/

opencode share <session-id>
 
# 输出: https://opencode.ai/share/xxx

opencode export <session-id> --output session.json

opencode session copy <session-id> --directory /new/project

opencode run
 
> /plan 设计一个 RESTful API
 
# Agent 会在 .opencode/plan/ 创建计划文件
# 不会修改任何实际代码

cat .opencode/plan/latest.md

{
  "agent": {
    "general": {
      "options": {
        "maxParallel": 5
      }
    }
  }
}

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
 
# 下载模型
ollama pull llama3
 
# 不需要 API Key
opencode run --model ollama/llama3

opencode update

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

git clone https://github.com/anomalyco/opencode.git
cd opencode
git pull
bun install
bun run build

# 删除可执行文件
rm /usr/local/bin/opencode
 
# 删除配置和数据
rm -rf ~/.opencode
 
# 删除缓存
rm -rf ~/Library/Caches/opencode  # macOS
rm -rf ~/.cache/opencode          # Linux

# 删除可执行文件
Remove-Item "$env:USERPROFILE\.local\bin\opencode.exe"
 
# 删除配置和数据
Remove-Item -Recurse -Force "$env:USERPROFILE\.opencode"

opencode run --debug

opencode run --log-level debug

git clone https://github.com/anomalyco/opencode.git
cd opencode
bun install
 
# 使用 Node.js 调试器
node --inspect-brk packages/opencode/dist/cli.js run

opencode session <session-id> --show-prompt

// my-plugin.ts
import { z } from "zod"
 
export default async function plugin({ client, $ }) {
  return {
    tool: {
      "my-tool": {
        description: "我的自定义工具",
        parameters: z.object({
          input: z.string()
        }),
        async execute({ input }) {
          return `处理结果: ${input}`
        }
      }
    }
  }
}

// my-mcp-server.ts
import { Server } from "@modelcontextprotocol/sdk/server"
 
const server = new Server(
  { name: "my-server", version: "1.0.0" },
  { capabilities: { tools: {} } }
)
 
server.setRequestHandler("tools/list", async () => ({
  tools: [{
    name: "my-tool",
    description: "我的工具",
    inputSchema: {
      type: "object",
      properties: { input: { type: "string" } }
    }
  }]
}))

// opencode.json
{
  "agent": {
    "my-agent": {
      "description": "专门处理 TypeScript",
      "model": "anthropic/claude-sonnet-4-20250514",
      "temperature": 0.3,
      "prompt": "你是一个 TypeScript 专家...",
      "permission": {
        "*": "allow"
      }
    }
  }
}

---
description: 专门处理 TypeScript 代码
model: anthropic/claude-sonnet-4-20250514
temperature: 0.3
---
 
# TypeScript Expert
 
你是一个 TypeScript 专家，专注于类型安全和最佳实践...

git clone https://github.com/YOUR_USERNAME/opencode.git
cd opencode
git remote add upstream https://github.com/anomalyco/opencode.git

git checkout -b feature/my-feature

bun install
bun test
bun dev

git add .
git commit -m "feat: add my feature"
git push origin feature/my-feature

// my-tool.test.ts
import { describe, expect, it } from "bun:test"
import { MyTool } from "./my-tool"
 
describe("MyTool", () => {
  it("should process input correctly", async () => {
    const tool = new MyTool()
    const result = await tool.execute({ input: "test" })
    expect(result).toBe("处理结果: test")
  })
})

bun test
 
# 运行单个测试文件
bun test my-tool.test.ts

# 测试 API 连接
opencode test --model anthropic/claude-sonnet-4

opencode session <session-id> --stats
# 查看 token 使用量

opencode session <session-id> --show-tools

// opencode.json
{
  "agent": {
    "build": {
      "permission": {
        "*": "allow"
      }
    }
  }
}

opencode snapshot list
opencode snapshot restore <snapshot-id>

git checkout HEAD~1 -- deleted-file.ts

opencode worktree list
opencode worktree restore <worktree-id>

opencode run --model anthropic/claude-3-haiku

{
  "agent": {
    "build": {
      "options": {
        "maxContextTokens": 32000
      }
    }
  }
}

opencode run --model ollama/llama3

{
  "agent": {
    "build": {
      "permission": {
        "codesearch": "deny"
      }
    }
  }
}