文档与帮助

安装与启动

Windows

从下载页下载 .msi 安装包，双击运行，按提示完成安装。安装完成后在开始菜单或桌面找到 OKCode 图标启动。

macOS

下载 .dmg 文件，打开后将 OKCode 拖入 Applications 文件夹。首次启动时系统可能提示"无法验证开发者"，进入 系统偏好设置 → 安全性与隐私，点击"仍要打开"即可。

初次使用

启动 OKCode 后，左侧侧边栏是工具导航区，点击对应图标切换功能模块。顶部 Tab 栏显示当前打开的所有工作区，可通过 + 按钮新建终端 Tab。

首次使用无需注册或激活，默认进入免费版。免费版可长期使用，主要限制项目数、连接数和部分高级能力；需要完整权益时再激活专业版。

终端

OKCode 内置完整 PTY 终端，支持所有常用 Shell（Bash、Zsh、Fish、PowerShell）。

常用操作

• 新建终端 Tab：点击顶部 + 或快捷键 Ctrl+T
• 分屏：在 Tab 内右键菜单选择"水平分屏" / "垂直分屏"
• 关闭 Tab：点击 Tab 上的 × 或 Ctrl+W
• 调整字体大小：设置 → 终端 → 字体大小

SSH 管理

在左侧侧边栏点击 SSH 图标进入 SSH 管理面板，可以保存和管理多个远程服务器连接。

添加连接

• 点击"+"新增连接，填写主机、端口、用户名
• 认证方式支持密码和 SSH 密钥文件（.pem / .key）
• 支持跳板机（Jump Host）配置

数据库管理

支持 MySQL、PostgreSQL、SQLite、SQL Server、MongoDB 和 Redis，可通过 SSH 隧道连接内网数据库。

连接数据库

• 左侧数据库图标 → "新建连接" → 选择数据库类型
• 填写连接信息后点击"测试连接"验证
• 支持 SSL / TLS 加密连接
• 支持 SSH 隧道（跳过防火墙访问内网库）

查询编辑器

内置 SQL 编辑器，支持语法高亮、自动补全。可通过内置 AI 助手辅助编写复杂 SQL。

Git 可视化

在本地项目面板中选择 Git 仓库，可以可视化查看提交历史、管理分支、进行暂存区操作。

• 查看 diff：点击文件名查看改动详情
• 提交：填写 commit message 后点击提交按钮
• 推送/拉取：工具栏按钮一键操作

HTTP 客户端

轻量级 API 调试工具，底层通过 Rust 的 reqwest 发送请求，绕过 WebView CORS 限制，可以直接请求任意接口。

• 支持 GET / POST / PUT / DELETE / PATCH 等所有方法
• 支持自定义 Header 和 Body（JSON、Form、Raw）
• 响应结果支持 JSON 格式化查看

Claude AI 集成

内置 Claude AI 对话面板，需要在 设置 → AI 设置 中配置 API Key 和 API 地址。

支持的 API

• Anthropic 官方 API（claude.ai API Key）
• OpenAI 兼容 API（任意 OpenAI 格式的代理或本地模型）

Claude Code 会话管理

如果你使用 Claude Code CLI，OKCode 可以浏览和恢复历史 Claude Code 会话，在终端中直接 --resume 继续之前的对话。

授权激活

购买专业版授权码后，在 OKCode 中激活：

• 打开 设置（左下角齿轮图标）
• 选择左侧 授权 分类
• 输入授权码（XXXX-XXXX-XXXX-XXXX 格式）和购买时使用的邮箱
• 点击"激活"，联网验证后立即生效

如需购买授权码，请联系 support@okcode.cn。

常见问题