Netcatty 接入教程

适合什么场景

Netcatty 适合需要管理服务器的用户，例如 SSH 登录、远程终端、SFTP 文件管理、日志查看和脚本执行。

它和普通 AI 聊天客户端不同。更准确地说，Netcatty 是服务器运维工作台；JiaPi 可以通过 Codex、Open Code、Claude Code 或 Netcatty 内置 AI 能力接入到你的运维流程里。

一、先理解两种接入方式

方式一：Netcatty 负责连接服务器，AI 工具在终端中运行

这是新手最稳的方式：

1. 用 Netcatty 连接服务器。
2. 在服务器终端或本地终端中安装 Codex CLI / Open Code。
3. 按对应教程配置 JiaPi Base URL 和 API Key。
4. 让 AI 帮你分析日志、写脚本、解释命令。

这种方式不要求 Netcatty 本身支持 OpenAI 兼容设置。

方式二：使用 Netcatty 内置 AI 设置

如果你的 Netcatty 版本提供 AI Agent、模型服务商或自定义 Provider 设置，可以直接在 Netcatty 里填写：

如果当前界面没有这些字段，请使用方式一。

二、下载和安装 Netcatty

打开 Netcatty 官方安装说明。

按你的系统下载安装。安装完成后打开 Netcatty。

三、创建服务器连接

新手可以按下面流程创建 SSH 连接：

1. 点击新建连接或添加主机。
2. 填写服务器 IP 或域名。
3. 填写 SSH 端口，常见为 22。
4. 填写用户名，例如 root、ubuntu 或你的运维账号。
5. 选择密码或私钥登录。
6. 保存连接。
7. 点击连接，确认能进入服务器终端。

如果你还没有服务器，可以先只安装 Netcatty，不需要继续后面的运维操作。

四、在 Netcatty 终端里使用 JiaPi

使用 Codex

如果你希望 AI 直接处理服务器上的项目，可以参考 Codex 教程 完成配置。

适合输入的任务：

请查看当前目录，不要修改文件，先说明这个服务可能是什么技术栈。

请分析 logs 目录下最近的错误日志，并总结可能原因。

使用 Open Code

如果你更喜欢开源终端编码智能体，可以参考 Open Code 教程。

适合输入的任务：

请帮我写一个只读的检查清单，用来判断这个 Nginx 配置是否有明显问题。

五、运维任务的安全建议

服务器运维比本地聊天风险更高，建议遵守下面原则：

1. 先让 AI 只读分析，不要一开始就执行删除、覆盖、重启服务等命令。
2. 重要命令执行前，让 AI 解释命令作用和风险。
3. 涉及生产服务器时，先备份配置文件。
4. 不要把 SSH 私钥、数据库密码、完整 API Key 粘贴到对话里。
5. 给服务器运维工具单独创建 JiaPi API Key，便于后续停用。

六、常见问题

Netcatty 里没有 Base URL 输入框

这说明当前版本可能没有内置 AI Provider 设置。你仍然可以用 Netcatty 连接服务器，然后在终端中运行 Codex CLI 或 Open Code。

AI 工具在服务器上无法访问 JiaPi

检查：

1. 服务器是否能访问外网。
2. 防火墙或公司网络是否限制 https://ai-api.jiapi.com/v1。
3. API Key 是否配置在服务器当前用户的环境或配置目录里。
4. 模型名称是否正确。

应该在本地还是服务器上安装 AI 工具

如果项目文件在本地，优先本地安装。
如果项目文件只在服务器上，且你希望 AI 直接读取服务器文件，可以在服务器上安装。
如果是生产服务器，建议先在测试服务器或本地副本验证。

参考入口

• Netcatty 安装说明