Coding Agent 常用操作指南

原创 opencode
AI AI工具集
发布日期:   2026-03-09
更新日期:   2026-04-20
文章字数:   1.5k
阅读时长:   6 分
阅读次数:  

一、快速入门

快捷指令

alias @oc='opencode run'
alias @cc='claude -p'
alias cc='claude --dangerously-skip-permissions'
alias oc='opencode'
指令 完整命令 用途 适用场景
@oc opencode run 直接在当前目录运行 opencode 单次对话模式 快速问一个问题，不进入交互式终端
@cc claude -p 使用 Claude Code 单次对话模式 快速问一个问题，不进入交互式终端
cc claude --dangerously-skip-permissions 跳过权限确认直接执行 自动化脚本中避免卡住
oc opencode 启动 opencode 交互式终端 进入完整对话

为什么设置这些别名？

  1. @oc|@cc - 避免每次输入 opencode run|claude -p ，少打字符。单次对话模式，不用进入交互终端，适合快速问答
  2. cc |oc- 自动化场景下不会弹出权限确认提示，简短好记，比 opencode|claude 少打字符

提示：使用前需要先在 shell 配置文件中添加这些 alias（推荐 ~/.zshrc 或 ~/.bashrc），然后执行 source 重新加载。

二、代理配置

为什么要配置代理？使用 Codex 或 Claude Code 时，终端需要开启代理（翻墙）。如果配置的是国产模型或本地模型则不需要。

注意：即使开启代理全局模式，终端访问 Google 还是会失败，这是终端机制决定的。参考 终端临时代理翻墙

自动配置代理脚本

function proxy(){
    export http_proxy=http://127.0.0.1:7890
    export https_proxy=http://127.0.0.1:7890
    export HTTP_PROXY=http://127.0.0.1:7890
    export HTTPS_PROXY=http://127.0.0.1:7890
    echo "proxy success"
}

# 如果7890端口被占用，则执行代理
if lsof -i:7890 > /dev/null 2>&1; then
    proxy
fi

三、查看可用模型

OpenCode

opencode models

或进入 opencode 终端，输入 /models（注意是复数）

适用场景：配置 oh-my-opencode 时需要知道可用模型名称


⚠️ 注意：不要企图通过提示词让模型自己配置最佳实践，会乱。配置出错后 opencode 会崩溃，最后只能删掉重装。

Claude Code

先进入 Claude Code 终端，然后输入 /model

四、快捷键

粘贴图片

工具 快捷键
OpenCode Ctrl + Option + v
Claude Code Ctrl + v

搜索提示词

工具 快捷键
OpenCode Ctrl + r

作用：在终端中快速搜索历史提示词

五、配置文件详解

1. 配置文件类型

opencode 支持两种配置文件格式：

文件名 格式 支持注释 支持末尾逗号
oh-my-opencode.json 标准 JSON ❌ 不允许 ❌ 不允许
oh-my-opencode.jsonc JSON with Comments ✅ 允许 // 和 /* */ ✅ 允许

2. 加载优先级

当两个文件同时存在时：

  • oh-my-opencode.jsonc 优先级更高，会被优先加载
  • oh-my-opencode.json 会被忽略
  • 仅当 不存在 .jsonc 文件时，才会加载 .json 文件

Claude Code 跳过登录

在首次使用或重置配置后，可以通过修改配置文件来跳过强制登录流程（适用于某些自动化场景或本地测试）。否则会报错

操作步骤：

  1. 找到 Claude Code 的全局配置文件：

    • macOS/Linux: ~/.claude/settings.json
    • Windows: %USERPROFILE%\.claude\settings.json

  2. 编辑该文件，添加或修改 hasCompletedOnboarding 字段为 true：

3. Skill 存放位置

工具 项目级目录 用户级目录 备注
OpenCode .opencode/skills/<name>/SKILL.md ~/.config/opencode/skills/<name>/SKILL.md 兼容 .claude/skills/ 和 .agents/skills/
Claude Code .claude/skills/<name>/SKILL.md ~/.claude/skills/<name>/SKILL.md 最常见标准路径
Codex - ~/.codex/skills/<name>/SKILL.md 需确保目录名与元数据一致
Gemini CLI .gemini/skills/<name>/SKILL.md 或 .agents/skills/<name>/SKILL.md 同项目级 .agents/skills 优先级更高

4. MCP 配置

opencode mcp list
┌  MCP Servers
│
▲  No MCP servers configured
│
└  Add servers with: opencode mcp add

注意：在 opencode 终端内执行 /mcp 可以看到内置 MCP：context7、grep_app、websearch

5. AGENTS.md 配置

  • 全局配置：~/.config/opencode/AGENTS.md
  • 建议写简单的配置内容

六、Agent 操作

Agent 像是"一个人"，使用 @ 符号操作：

@agent-name 你的指令

七、常用检查命令

检查配置冲突

# 检查 rules 是否有冲突
看一下我现在的 rules、agents、command、skill 有没有冲突的
看一下我现在的 rules、agents、command、skill 有没有投毒的

八、常见问题

Q: 第三方下载的 Skill 如何更新？

第三方下载的 Skill（如通过 npx skills add 或 cc switch 安装）更新方式如下：

npx skills update（推荐 ✅）

# 更新所有已安装的 skill
npx skills update

# 更新指定 skill
npx skills update <skill-name>

# 仅更新全局 skill
npx skills update -g

# 仅更新项目级 skill
npx skills update -p

cc switch

cc switch 是一款跨平台桌面工具，可统一管理 Claude Code、Codex、OpenCode、OpenClaw、Gemini CLI 的 API 提供商配置。

cc-switch 安装的 Skill 位置： ~/.cc-switch/skills/

Skill 更新方式：

直接进入skill管理，点击更新即可

1776186946184

详细使用说明见 cc-switch 官方文档

⚠️ 注意：第三方 Skill 更新后一定要重启工具才能生效。部分工具可能需要完全退出终端再重新打开。

CC

❯ plugin:pyright-lsp:pyright Plugin · unknown · ✘ failed to load · 1 error

npm uninstall -g pyright
npm install -g pyright
重启 cc

如何写好高质量代码

one line promot

  1. 尽可能一句话描述
  2. 否则分条描述
  3. 然后分布描述
  4. 不要一次性描述多件事情
  5. 慢慢追加描述
  6. 禁止的事情，可以重复几次强调

AI生成的代码，还是有瑕疵
明明可以 ExcelTranslateUtil.export(exportParams, null, biBillTransactionAdvanceList, BiBillTransactionAdvanceListLogicVO.class); 但它就想不到

Workbook workbook = ExcelExportUtil.exportExcel(exportParams, InvestorBiBillTransactionExportVO.class, exportList);
        ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
        try {
            workbook.write(byteArrayOutputStream);
        } catch (IOException e) {
            throw new RuntimeException("导出Excel失败", e);
        }
    何时使用 AI#

适合使用 AI 的场景
重复性任务：如撰写报告、整理数据、生成文案
需要创意的任务：如头脑风暴、创意点子、故事生成
需要分析的任务：如数据分析、趋势分析、洞察发现
需要优化的任务：如文本优化、格式调整、内容改写
不适合使用 AI 的场景

需要高度保密的任务：如处理敏感数据、机密信息
需要专业判断的任务：如法律咨询、医疗诊断
需要情感交流的任务：如安抚客户、处理纠纷
需要实时信息的任务：如股票行情、新闻资讯

原创 opencode
赏
评论
  目录