1. 简介

1.1 什么是 OpenCode

OpenCode 是一个开源、多提供商的 AI 编程代理工具，专为开发者设计，用于自动化代码生成、重构、审查等开发任务。

核心特点：

  • ✅ 开源免费：完全开源，无使用限制

  • ✅ 多模型支持：支持 OpenRouter、Anthropic、Google 等多种 AI 模型

  • ✅ 轻量高效：启动快速，资源占用低

  • ✅ 易于集成：支持 CI/CD、Git 钩子等

  • ✅ 安全可靠：支持权限控制和安全检查

1.2 适用场景

  • 代码生成和重构

  • 代码审查和质量检查

  • 文档编写和更新

  • Bug 修复和调试

  • 测试用例生成

  • 技术债务管理

2. 安装部署

2.1 系统要求

  • Node.js 16.0 或更高版本

  • npm 或 yarn 包管理器

  • 支持 Linux、macOS、Windows（WSL2）

2.2 安装方法

方法一：npm 安装（推荐）
# 全局安装
npm install -g opencode-ai@latest
​
# 验证安装
opencode --version
方法二：Homebrew 安装（macOS/Linux）
# 添加仓库
brew tap anomalyco/tap
​
# 安装 OpenCode
brew install opencode
​
# 验证安装
opencode --version
方法三：手动安装
# 下载二进制文件
wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-linux-x64.tar.gz
​
# 解压
tar -xzf opencode-linux-x64.tar.gz
​
# 移动到系统路径
sudo mv opencode /usr/local/bin/
​
# 验证安装
opencode --version

2.3 认证配置

使用 OpenRouter（推荐）
# 设置 OpenRouter API Key
export OPENROUTER_API_KEY="your-openrouter-api-key"
​
# 或者使用登录命令
opencode auth login
其他提供商配置
# Anthropic
export ANTHROPIC_API_KEY="your-anthropic-api-key"
​
# Google
export GOOGLE_API_KEY="your-google-api-key"
​
# OpenAI
export OPENAI_API_KEY="your-openai-api-key"

2.4 验证安装

# 检查版本
opencode --version
​
# 检查认证状态
opencode auth list
​
# 运行测试任务
opencode run '输出 Hello World'

3. 模型选择

3.1 支持的模型提供商

提供商 推荐模型 特点 适用场景
OpenRouter mistral/mistral-large 性价比高 日常开发
OpenRouter anthropic/claude-sonnet-4 功能强大 复杂任务
OpenRouter google/gemini-pro 快速响应 简单任务
OpenRouter meta-llama/llama-3 开源模型 隐私敏感

3.2 模型选择策略

根据任务复杂度选择
# 简单任务（快速响应）
opencode run '生成一个计算器函数' --model openrouter/google/gemini-pro
​
# 中等任务（平衡性能）
opencode run '实现用户认证API' --model openrouter/mistral/mistral-large
​
# 复杂任务（高性能）
opencode run '重构核心模块' --model openrouter/anthropic/claude-sonnet-4
​
# 创意任务
opencode run '设计数据库架构' --model openrouter/mistral/mistral-large
根据成本选择
# 高性价比组合
opencode run '生成单元测试' --model openrouter/mistral/mistral-large --max-turns 5
​
# 性能优先组合
opencode run '代码审查' --model openrouter/anthropic/claude-sonnet-4 --max-turns 10
​
# 经济实惠组合
opencode run '文档生成' --model openrouter/google/gemini-pro --max-turns 3

3.3 模型参数调优

温度参数（Temperature）
# 创造性任务（温度较高）
opencode run '生成创意代码解决方案' --temperature 0.8
​
# 确定性任务（温度较低）
opencode run '修复语法错误' --temperature 0.2
​
# 平衡任务（默认温度）
opencode run '添加新功能' --temperature 0.5
最大输出长度
# 简短输出
opencode run '解释这段代码' --max-output-tokens 1000
​
# 中等长度
opencode run '生成函数文档' --max-output-tokens 2000
​
# 较长输出
opencode run '重构整个模块' --max-output-tokens 5000

4. Skills 技能系统

4.1 Skills 简介

Skills 是 OpenCode 的技能系统，允许你创建、分享和使用专门的技能来自动化特定任务。

技能类型：

  • 代码生成技能：自动生成代码

  • 审查技能：代码质量检查

  • 重构技能：代码优化

  • 文档技能：文档编写

4.2 安装现有技能

从技能库安装
# 查看可用技能
opencode skills list
​
# 安装特定技能
opencode skills install code-review
​
# 安装多个技能
opencode skills install code-review security-audit test-generation
从 GitHub 安装
# 安装 GitHub 上的技能
opencode skills install https://github.com/user/opencode-skill-security
​
# 安装特定版本
opencode skills install https://github.com/user/opencode-skill-review@v1.2.0

4.3 创建自定义技能

基本技能结构
# 创建技能目录
mkdir -p ~/.opencode/skills/my-first-skill
​
# 创建技能文件
cat > ~/.opencode/skills/my-first-skill/skill.md << 'EOF'
---
name: my-first-skill
description: 我的第一个自定义技能
version: 1.0.0
author: Your Name
---
​
# 技能名称
代码审查技能
​
## 功能描述
自动审查代码质量，重点关注：
1. 安全性问题
2. 性能问题  
3. 可维护性
4. 测试覆盖率
​
## 使用方法
@my-first-skill 审查这个文件
​
## 示例
@my-first-skill 审查 src/auth.py
EOF
高级技能示例
# 创建技能配置文件
cat > ~/.opencode/skills/security-audit/config.json << 'EOF'
{
  "name": "security-audit",
  "description": "安全审计技能",
  "model": "openrouter/anthropic/claude-sonnet-4",
  "maxTurns": 10,
  "temperature": 0.2,
  "tools": ["Read", "Edit", "Bash"],
  "prompt": "你是一名安全专家，负责审查代码中的安全问题..."
}
EOF

4.4 使用技能

基本使用
# 使用已安装的技能
opencode run '@code-review 审查这个文件' -f src/auth.py
​
# 使用自定义技能
opencode run '@my-first-skill 审查代码质量' -f src/main.py
技能组合使用
# 组合多个技能
opencode run '使用@code-review审查代码，然后使用@test-generation生成测试' -f src/service.py
​
# 技能链式调用
opencode run '首先@security-audit进行安全审计，然后@refactor技能重构代码' -f src/api.py

4.5 技能管理

列出技能
# 列出所有技能
opencode skills list
​
# 列出已安装技能
opencode skills list --installed
​
# 列出可用技能
opencode skills list --available
更新和删除技能
# 更新技能
opencode skills update code-review
​
# 删除技能
opencode skills uninstall my-first-skill
​
# 更新所有技能
opencode skills update --all

5. Oh-MyOpenCode 增强工具

5.1 Oh-MyOpenCode 简介

Oh-MyOpenCode 是一个强大的 OpenCode 增强工具集，提供：

核心功能：

  • 🎨 主题系统：丰富的界面主题和配色方案

  • 🔌 插件管理：一键安装和管理 OpenCode 插件

  • 🛠️ 工具集成：集成常用开发工具和命令

  • 📊 性能监控：实时监控 OpenCode 的性能和使用统计

  • 🔄 自动更新：自动检测和更新 OpenCode 及相关组件

5.2 安装 Oh-MyOpenCode

自动安装脚本
# Linux/macOS
sh -c "$(curl -fsSL https://raw.githubusercontent.com/oh-my-opencode/oh-my-opencode/master/install.sh)"
​
# Windows (PowerShell)
irm https://raw.githubusercontent.com/oh-my-opencode/oh-my-opencode/master/install.ps1 | iex
手动安装
# 克隆仓库
git clone https://github.com/oh-my-opencode/oh-my-opencode.git ~/.oh-my-opencode
​
# 添加配置
echo 'export PATH="$HOME/.oh-my-opencode/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
​
# 安装依赖
cd ~/.oh-my-opencode && npm install

5.3 配置 Oh-MyOpenCode

基本配置
# 初始化配置
omoc init
​
# 配置主题
omoc theme set <theme-name>
​
# 启用插件
omoc plugin enable <plugin-name>
配置文件示例
# 创建个人配置文件
cat > ~/.oh-my-opencode/config.json << 'EOF'
{
  "theme": "default",
  "plugins": [
    "opencode-integration",
    "git-tools",
    "performance-monitor"
  ],
  "opencode": {
    "defaultModel": "openrouter/mistral/mistral-large",
    "autoUpdate": true,
    "analytics": true
  }
}
EOF

5.4 Oh-MyOpenCode 核心功能

主题管理
# 列出可用主题
omoc theme list
​
# 切换主题
omoc theme set dark
​
# 预览主题
omoc theme preview <theme-name>
​
# 自定义主题
omoc theme create my-theme
插件系统
# 搜索插件
omoc plugin search <keyword>
​
# 安装插件
omoc plugin install <plugin-name>
​
# 更新插件
omoc plugin update <plugin-name>
​
# 列出已安装插件
omoc plugin list --installed
工具集成
# 集成 Git 工具
omoc integrate git
​
# 集成 Docker 工具
omoc integrate docker
​
# 集成 CI/CD 工具
omoc integrate github-actions

5.5 Oh-MyOpenCode 命令参考

核心命令
命令 说明
omoc Oh-MyOpenCode 主命令
omoc init 初始化配置
omoc theme 主题管理
omoc plugin 插件管理
omoc integrate 工具集成
omoc config 配置管理
omoc update 更新检查
omoc doctor 系统检查
实用命令
# 检查系统状态
omoc doctor
​
# 查看使用统计
omoc stats
​
# 生成配置文件
omoc config generate
​
# 备份配置
omoc backup create
​
# 恢复配置
omoc backup restore <backup-file>

5.6 Oh-MyOpenCode 插件推荐

开发效率插件

  • opencode-integration：深度集成 OpenCode

  • git-enhancer：增强 Git 功能

  • code-snippets：代码片段管理

  • template-manager：项目模板管理

性能优化插件

  • performance-monitor：性能监控

  • cache-manager：缓存管理

  • cost-tracker：成本追踪

  • model-optimizer：模型优化

团队协作插件

  • team-sync：团队配置同步

  • review-assistant：代码审查助手

  • doc-generator：文档生成器

  • standard-enforcer：代码规范执行

6. 基本操作

6.1 命令行结构

opencode [command] [options] [arguments]

常用命令：

  • run：执行一次性任务

  • auth：认证管理

  • skills：技能管理

  • session：会话管理

  • config：配置管理

Skills 是 OpenCode 的技能系统，允许你创建、分享和使用专门的技能来自动化特定任务。

技能类型：

  • 代码生成技能：自动生成代码

  • 审查技能：代码质量检查

  • 重构技能：代码优化

  • 文档技能：文档编写

4.2 安装现有技能

从技能库安装
# 查看可用技能
opencode skills list
​
# 安装特定技能
opencode skills install code-review
​
# 安装多个技能
opencode skills install code-review security-audit test-generation
从 GitHub 安装
# 安装 GitHub 上的技能
opencode skills install https://github.com/user/opencode-skill-security
​
# 安装特定版本
opencode skills install https://github.com/user/opencode-skill-review@v1.2.0

4.3 创建自定义技能

基本技能结构
# 创建技能目录
mkdir -p ~/.opencode/skills/my-first-skill
​
# 创建技能文件
cat > ~/.opencode/skills/my-first-skill/skill.md << 'EOF'
---
name: my-first-skill
description: 我的第一个自定义技能
version: 1.0.0
author: Your Name
---
​
# 技能名称
代码审查技能
​
## 功能描述
自动审查代码质量，重点关注：
1. 安全性问题
2. 性能问题  
3. 可维护性
4. 测试覆盖率
​
## 使用方法
@my-first-skill 审查这个文件
​
## 示例
@my-first-skill 审查 src/auth.py
EOF
高级技能示例
# 创建技能配置文件
cat > ~/.opencode/skills/security-audit/config.json << 'EOF'
{
  "name": "security-audit",
  "description": "安全审计技能",
  "model": "openrouter/anthropic/claude-sonnet-4",
  "maxTurns": 10,
  "temperature": 0.2,
  "tools": ["Read", "Edit", "Bash"],
  "prompt": "你是一名安全专家，负责审查代码中的安全问题..."
}
EOF

4.4 使用技能

基本使用
# 使用已安装的技能
opencode run '@code-review 审查这个文件' -f src/auth.py
​
# 使用自定义技能
opencode run '@my-first-skill 审查代码质量' -f src/main.py
技能组合使用
# 组合多个技能
opencode run '使用@code-review审查代码，然后使用@test-generation生成测试' -f src/service.py
​
# 技能链式调用
opencode run '首先@security-audit进行安全审计，然后@refactor技能重构代码' -f src/api.py

4.5 技能管理

列出技能
# 列出所有技能
opencode skills list
​
# 列出已安装技能
opencode skills list --installed
​
# 列出可用技能
opencode skills list --available
更新和删除技能
# 更新技能
opencode skills update code-review
​
# 删除技能
opencode skills uninstall my-first-skill
​
# 更新所有技能
opencode skills update --all

5. 基本操作

5.1 命令行结构

opencode [command] [options] [arguments]

常用命令：

  • run：执行一次性任务

  • auth：认证管理

  • skills：技能管理

  • session：会话管理

  • config：配置管理

5.2 文件操作

读取文件
# 分析单个文件
opencode run '分析这个Python文件' -f src/main.py
​
# 分析多个文件
opencode run '分析这些组件' -f src/components/*.js
​
# 分析目录
opencode run '分析整个项目结构' -f src/ -f tests/ -f docs/
编辑文件
# 修改文件
opencode run '优化这个函数' -f src/utils.py
​
# 创建新文件
opencode run '创建配置文件' -f config/settings.yaml
​
# 批量修改
opencode run '更新所有测试文件' -f tests/*.py

5.3 代码生成

函数生成
# 生成简单函数
opencode run '生成一个计算阶乘的函数' -f src/math_utils.py
​
# 生成类方法
opencode run '为User类生成CRUD方法' -f src/models/user.py
​
# 生成API端点
opencode run '生成用户注册API端点' -f src/api/users.py
测试生成
# 生成单元测试
opencode run '为这个函数生成单元测试' -f src/calculator.py
​
# 生成集成测试
opencode run '生成API集成测试' -f src/api/users.py
​
# 生成测试数据
opencode run '生成测试用的用户数据' -f tests/data/users.json

5.4 代码审查

基本审查
# 代码质量审查
opencode run '审查代码质量' -f src/service.py
​
# 安全性审查
opencode run '审查安全漏洞' -f src/auth.py
​
# 性能审查
opencode run '分析性能问题' -f src/database.py
专项审查
# 审查特定问题
opencode run '审查是否有SQL注入风险' -f src/queries.py
​
# 审查代码风格
opencode run '检查代码风格是否符合PEP8' -f src/*.py
​
# 审查依赖安全
opencode run '检查依赖漏洞' -f package.json

6. 高级使用

6.1 会话管理

创建持久会话
# 开始新会话
opencode session start --name my-project
​
# 继续会话
opencode session continue my-project
​
# 列出会话
opencode session list
​
# 恢复特定会话
opencode session resume <session-id>
会话上下文管理
# 添加上下文
opencode session context add --file README.md --description "项目说明"
​
# 查看上下文
opencode session context list
​
# 清理上下文
opencode session context clear

6.2 批量处理

并行任务处理
# 创建多个并行任务
opencode run '处理文件1' -f file1.py --session task1
opencode run '处理文件2' -f file2.py --session task2
opencode run '处理文件3' -f file3.py --session task3
​
# 监控任务进度
opencode session list --status
​
# 获取任务结果
opencode session result task1
批量文件处理
# 处理目录中的所有文件
for file in src/*.py; do
  opencode run "优化 $file" -f "$file" --max-turns 5
done
​
# 批量重命名
opencode run '重命名所有变量，遵循命名规范' -f src/ --max-turns 10

6.3 Git 集成

代码审查集成
# 审查暂存区变更
opencode run '审查暂存区的代码变更' -f $(git diff --cached --name-only)
​
# 审查PR变更
opencode run '审查这个PR的变更' -f $(git diff origin/main...HEAD --name-only)
​
# 生成提交信息
opencode run '生成详细的提交信息' -f $(git diff --cached)
预提交钩子
# 创建预提交钩子
cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
opencode run '检查代码风格和潜在问题' -f $(git diff --cached --name-only) --max-turns 3
if [ $? -ne 0 ]; then
    echo "OpenCode检测到严重问题，请修复后再提交"
    exit 1
fi
EOF
​
# 使钩子可执行
chmod +x .git/hooks/pre-commit

6.4 CI/CD 集成

GitHub Actions
# .github/workflows/opencode-review.yml
name: OpenCode Code Review
on: [pull_request]
​
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Setup Node.js
        uses: actions/setup-node@v2
        with:
          node-version: '18'
          
      - name: Install OpenCode
        run: npm install -g opencode-ai@latest
        
      - name: Run OpenCode Review
        env:
          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
        run: |
          opencode run '审查PR变更，重点关注安全性和性能' \
            -f $(git diff origin/main...HEAD --name-only) \
            --max-turns 10 \
            --model openrouter/mistral/mistral-large
GitLab CI
# .gitlab-ci.yml
stages:
  - review
​
opencode-review:
  stage: review
  image: node:18
  script:
    - npm install -g opencode-ai@latest
    - opencode run '审查代码质量' -f $(git diff origin/main...HEAD --name-only)
  only:
    - merge_requests

6.5 自定义配置

项目配置
# 创建项目配置文件
cat > .opencode/config.json << 'EOF'
{
  "defaultModel": "openrouter/mistral/mistral-large",
  "maxTurns": 8,
  "temperature": 0.5,
  "defaultSkills": ["code-review", "security-audit"],
  "costLimit": 0.5,
  "autoApprove": false
}
EOF
用户配置
# 创建用户配置
cat > ~/.opencode/config.json << 'EOF'
{
  "providers": {
    "openrouter": {
      "apiKey": "your-api-key",
      "defaultModel": "mistral/mistral-large"
    }
  },
  "behavior": {
    "autoSave": true,
    "verbose": false,
    "backup": true
  },
  "skills": {
    "autoUpdate": true,
    "installSuggestions": true
  }
}
EOF

7. OpenCode + Oh-MyOpenCode 配合使用

7.1 协同工作优势

OpenCode 与 Oh-MyOpenCode 的配合使用可以带来：

效率提升：

  • 🚀 一键操作：Oh-MyOpenCode 提供快捷命令，简化 OpenCode 操作

  • 🔄 自动化流程：自动化的代码生成、审查、测试流程

  • 📊 智能推荐：基于使用习惯的智能命令推荐

体验优化：

  • 🎨 主题美化：Oh-MyOpenCode 提供丰富的主题，改善 OpenCode 使用体验

  • 📈 性能监控：实时监控 OpenCode 的性能和资源使用

  • 🔔 智能提醒：重要事件和更新的智能提醒

7.2 配置集成

Oh-MyOpenCode 中配置 OpenCode
# 在 Oh-MyOpenCode 配置中集成 OpenCode
cat > ~/.oh-my-opencode/plugins/opencode-integration.json << 'EOF'
{
  "enabled": true,
  "defaultModel": "openrouter/mistral/mistral-large",
  "autoStart": true,
  "plugins": {
    "smart-suggestions": true,
    "cost-monitoring": true,
    "performance-tracking": true
  },
  "shortcuts": {
    "gen": "opencode run '生成代码'",
    "review": "opencode run '代码审查'",
    "test": "opencode run '生成测试'"
  }
}
EOF
OpenCode 使用 Oh-MyOpenCode 主题
# 启用 Oh-MyOpenCode 主题
omoc theme set opencode-dark
​
# 在 OpenCode 配置中使用主题
cat > ~/.opencode/config.json << 'EOF'
{
  "ui": {
    "theme": "opencode-dark",
    "colorScheme": "dark"
  },
  "behavior": {
    "useOhMyOpenCodeTheme": true
  }
}
EOF

7.3 高效工作流程

开发流程自动化
# 使用 Oh-MyOpenCode 快捷命令
omoc dev start  # 开始开发会话
omoc gen api    # 生成API代码
omoc review     # 代码审查
omoc test       # 生成测试
omoc commit     # 生成提交信息
Oh-MyOpenCode 快捷命令
# 创建自定义快捷命令
cat > ~/.oh-my-opencode/shortcuts.json << 'EOF'
{
  "shortcuts": {
    "opencode:generate": {
      "command": "opencode run '根据需求生成代码'",
      "description": "生成代码实现",
      "context": ["development"]
    },
    "opencode:review": {
      "command": "opencode run '审查代码质量'",
      "description": "代码质量审查",
      "context": ["review", "pre-commit"]
    },
    "opencode:refactor": {
      "command": "opencode run '重构代码以提高可维护性'",
      "description": "代码重构",
      "context": ["refactoring"]
    }
  }
}
EOF

7.4 插件协同

推荐插件组合
# 安装推荐插件组合
omoc plugin install opencode-integration
omoc plugin install git-enhancer
omoc plugin install code-snippets
omoc plugin install cost-tracker
​
# 配置插件协同工作
cat > ~/.oh-my-opencode/config.json << 'EOF'
{
  "plugins": {
    "opencode-integration": {
      "enabled": true,
      "autoModelSelection": true,
      "skillSuggestions": true
    },
    "git-enhancer": {
      "enabled": true,
      "autoCommitMessage": true,
      "branchManagement": true
    },
    "cost-tracker": {
      "enabled": true,
      "alertThreshold": 0.5,
      "autoOptimization": true
    }
  }
}
EOF

7.5 性能优化

智能模型选择
# Oh-MyOpenCode 智能模型选择配置
cat > ~/.oh-my-opencode/plugins/model-optimizer.json << 'EOF'
{
  "rules": {
    "code-generation": {
      "model": "openrouter/mistral/mistral-large",
      "maxTokens": 2000,
      "temperature": 0.7
    },
    "code-review": {
      "model": "openrouter/anthropic/claude-sonnet-4",
      "maxTokens": 1500,
      "temperature": 0.3
    },
    "simple-tasks": {
      "model": "openrouter/google/gemini-pro",
      "maxTokens": 1000,
      "temperature": 0.5
    }
  }
}
EOF
缓存优化
# 配置缓存策略
omoc config set cache.enabled true
omoc config set cache.maxSize 1000
omoc config set cache.autoClear true

7.6 团队协作

团队配置同步
# 使用 Oh-MyOpenCode 同步团队配置
omoc team sync --config .opencode/team-config.json
​
# 团队配置文件示例
cat > .opencode/team-config.json << 'EOF'
{
  "team": "backend-developers",
  "opencode": {
    "defaultModel": "openrouter/mistral/mistral-large",
    "requiredSkills": ["code-review", "security-audit"],
    "codeStandards": {
      "indentation": "4-space",
      "naming": "camelCase",
      "testing": "required"
    }
  },
  "oh-my-opencode": {
    "theme": "team-theme",
    "plugins": ["team-sync", "standard-enforcer"]
  }
}
EOF
代码审查流程
# 使用 Oh-MyOpenCode 的审查助手
omoc review create --type security --files src/auth.py,src/api.py
omoc review assign --reviewer @team-lead
omoc review track --status

8. 最佳实践

8.1 任务分解策略

复杂任务分解

7.1 任务分解策略

复杂任务分解
# 不要这样做
opencode run '开发一个完整的电商系统'
​
# 应该这样做
opencode run '设计数据库模式'
opencode run '实现用户认证API'
opencode run '创建商品管理功能'
opencode run '实现订单处理系统'

7.2 上下文管理

有效利用上下文
# 提供足够的上下文
opencode run '实现用户登录功能' \
  -f src/models/user.py \
  -f src/config/database.py \
  -f src/utils/encryption.py \
  -f requirements.txt

7.3 成本控制

成本监控
# 设置成本上限
opencode run '重构模块' --max-cost 0.1
​
# 使用经济模型
opencode run '生成测试数据' --model openrouter/google/gemini-pro
​
# 批量处理减少开销
opencode run '处理所有Python文件' -f src/*.py --batch

7.4 质量保证

代码验证
# 生成代码后验证
opencode run '生成代码' -f src/new_feature.py
opencode run '验证生成的代码是否符合规范' -f src/new_feature.py
​
# 测试生成
opencode run '为生成的代码创建测试' -f src/new_feature.py

8. 常见问题

8.1 安装问题

Q: 安装时出现权限错误

# 解决方案
sudo npm install -g opencode-ai@latest --unsafe-perm=true

Q: 命令找不到

# 检查PATH
echo $PATH
​
# 重新安装
npm uninstall -g opencode-ai
npm install -g opencode-ai@latest

10.2 认证问题

Q: API Key 无效

# 检查环境变量
echo $OPENROUTER_API_KEY
​
# 重新设置
export OPENROUTER_API_KEY="your-new-key"

Q: 认证失败

# 清除缓存
opencode auth clear
​
# 重新登录
opencode auth login

10.3 性能问题

Q: 响应缓慢

# 使用更快的模型
opencode run '简单任务' --model openrouter/google/gemini-pro
​
# 减少上下文
opencode run '任务' -f single-file.py --max-turns 3

Q: 内存占用高

# 限制并发
opencode run '任务' --max-concurrent 1
​
# 清理缓存
opencode cache clear

10.4 使用技巧

Q: 如何获得更好的结果

  1. 提供清晰的指令

  2. 给出足够的上下文

  3. 分步骤处理复杂任务

  4. 验证和测试生成的代码

Q: 如何节省成本

  1. 选择合适的模型

  2. 限制交互轮次

  3. 批量处理任务

  4. 重用会话上下文

9. 附录

9.1 命令参考

# 查看所有命令
opencode --help
​
# 查看特定命令帮助
opencode run --help
opencode auth --help
opencode skills --help

9.2 快捷键

快捷键 功能
Ctrl+C 取消当前操作
Ctrl+D 退出交互模式
Up/Down 浏览历史命令
Tab 自动补全

9.3 支持资源

# 开源
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

cover

Agent 网关崩溃重启：会话状态持久化方案选型与 ClawHub 技能冲突预防

avatar 龙虾开发者社区
cover

Agent 边缘部署实录：NanoClaw 内存水位与 swap 触发的雪崩诊断

avatar 龙虾开发者社区
cover

跨洲 Agent 工具调用超时设计：从 RTT 热力图到阶梯熔断策略

avatar 龙虾开发者社区