配置说明

对外使用 KCode 时，最值得先确认的是服务地址、默认目录和 Web UI 指向的 server 地址。这些默认值决定了你第一次启动时“为什么会连到这里”。

Server 默认值

变量	默认值	作用
KCODE_SERVER_HOST	127.0.0.1	本地服务监听地址
KCODE_SERVER_PORT	4096	本地服务监听端口
KCODE_DIRECTORY	未设置	显式指定默认目录

Web 默认连接地址

Web 默认会指向：

• VITE_KCODE_SERVER_HOST，默认 127.0.0.1
• VITE_KCODE_SERVER_PORT，默认 4096

如果你没有做额外覆盖，内置 Web UI 会直接访问本地的 http://127.0.0.1:4096。

默认目录按什么顺序决定

当前目录的确定顺序可以按下面理解：

1. 显式传入的 --directory
2. KCODE_DIRECTORY
3. 当前工作目录

因此，最稳妥的使用方式仍然是先进入目标仓库目录，再执行 kcode。

什么时候需要显式改端口

• 4096 已经被占用。
• 你需要同时跑多个实例。
• 你在本地做不同目录或不同 Provider 的隔离验证。

相关阅读

• 需要完整命令说明：看 CLI 参考。
• 需要重新确认安装与启动路径：看 安装与运行。
• 想理解目录为什么会影响状态作用域：看 目录、项目与会话。