Coding Agent 常用操作指南

一、快速入门

快捷指令

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 - 自动化场景下不会弹出权限确认提示，简短好记

提示：使用前需要先在 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 文件

3. Claude Code 跳过登录

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

操作步骤：

1. 找到 Claude Code 的全局配置文件：
   • macOS/Linux: ~/.claude/settings.json
   • Windows: %USERPROFILE%\.claude\settings.json
2. 编辑该文件，添加或修改 hasCompletedOnboarding 字段为 true：

{
  "hasCompletedOnboarding": true
}

4. 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 优先级更高

5. MCP 配置

opencode mcp list

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

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

6. 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 管理，点击更新即可。

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

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

---

九、OpenCode 内置命令

命令	功能
/models	查看可用模型
/mcp	查看 MCP 服务器
/new	新建会话
/exit	退出终端
Ctrl + r	搜索历史提示词
Ctrl + Option + v	粘贴图片

---

十、Claude Code 内置命令

命令	功能
/model	切换模型
/cost	查看本会话花费
/reset	清除对话历史
/exit	退出终端
Ctrl + v	粘贴图片