多款AI操作本地文件


deepseek-v4,KIMI K3,codex (这个是不是绑定 ChatGTP 了?),然后 fable 5,我知道 codex 可以用命令管理器直接更改指定文件夹里面的代码,项目。其他的几个能做到吗?要怎么做到?

Codex / DeepSeek‑V4 / Kimi‑K3 / Fable5:本地文件夹直接改代码对比

核心底层真相大模型本身(API)完全不能碰你电脑本地磁盘;能读写/修改指定文件夹代码,靠的是外层Agent客户端(CLI程序),给模型封装文件读写、目录遍历、shell执行工具,MCP协议是现在主流标准适配器。
Codex CLI不是模型,是OpenAI做的Agent外壳,它可以换底层模型,不是硬绑定GPT/ChatGPT,这点很多人搞错。

1、Codex(@openai/codex CLI)——你在用的命令管理器

  • 是否绑定ChatGPT:
    • 原生默认底层跑OpenAI模型,登录可用ChatGPT账号;但配置文件config.toml可以替换model、base_url,底层可以跑DeepSeek‑V4、K3等第三方模型,不是锁死GPT。
    • Codex = Agent外壳(负责本地文件/命令/审批策略) + 可替换后端大模型
  • 能力:进入项目文件夹,codex init初始化,直接自然语言修改当前工作目录下代码,支持审批策略approval_policy控制自动执行/人工确认、限定工作区,不允许越出指定文件夹。
  • 缺点:官方原生只适配OpenAI;换第三方模型要改配置,部分工具调用行为会有兼容坑。

2、DeepSeek‑V4(deepseek‑v4‑pro/flash,模型API)

模型本体没有任何本地文件能力,必须套一层Agent外壳,三种可行方案:

方案A:复用Codex CLI(最简单,你已经熟悉这套交互)

修改~/.codex/config.toml

1
2
3
4
model = "deepseek-v4-pro"
base_url = "https://api.deepseek.com/v1"
sandbox_mode = "workspace-write"
approval_policy = "on‑request"

cd到你的项目文件夹,codex init,后续操作和原生Codex一模一样,直接改本地项目文件。

方案B:专用终端Agent:Reasonix / DeepSeek‑TUI / OpenCode

1
2
cd 你的项目目录
npx reasonix code

内置文件读写、git、shell,原生适配DeepSeek‑V4,支持MCP,限定工作目录,不用折腾Codex配置。

方案C:MCP + Claude‑Code / Roo‑Code

把DeepSeek‑V4作为后端模型接入,MCP‑filesystem服务器限定允许访问的文件夹路径。

网页版DeepSeek聊天框:完全不能访问本地文件,只能复制粘贴代码片段。

3、Kimi K3(月之暗面K3模型)

同样:网页Kimi只能上传文件,不能直接读写本地文件夹;要直接修改本地项目有两条路:

方案A:官方 Kimi‑Code CLI(原生Agent,最稳)

1
2
3
4
#安装
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
cd 你的项目文件夹
kimi
  • 原生内置:读目录、读写文件、grep、bash shell、MCP协议;会锁定当前文件夹作为workspace,不会乱读其他目录;交互风格≈Codex,直接自然语言让它重构整个项目、改多文件代码。
  • TUI里输入/mcp‑config挂载filesystem MCP,进一步严格限定允许访问的路径,做安全隔离。

方案B:塞进Codex CLI

修改codex配置,base_url指向moonshot接口,model填kimi‑coding;但是社区反馈部分工具调用会偶发异常,稳定性不如原生Kimi‑Code CLI。

4、Fable 5(Anthropic Claude Fable‑5)

Fable5是Claude系列模型,本身API没有本地IO

方案A:Claude‑Code CLI(官方Agent)

1
2
cd 项目文件夹
claude-code
  • 原生支持MCP filesystem服务器,可以严格指定只允许访问哪个文件夹,禁止访问磁盘其他位置;支持批量多文件重构,Fable5长链路工程任务能力很强。
  • MCP配置示例,强制限定仅D:/code/myproj
    1
    2
    3
    4
    5
    6
    "mcpServers": {
    "filesystem": {
    "command":"npx",
    "args":["‑y","@modelcontextprotocol/server‑filesystem","D:/code/myproj"]
    }
    }

    ⚠️重要:MCP filesystem服务器启动时传入的路径,就是它唯一可以触碰的目录,不会越界,这是安全关键。

方案B:第三方Agent外壳Pi / OpenCode接入Fable5 API;也可以塞进Codex CLI,但是兼容性不如Claude‑Code原生。

汇总简表

模型 模型本身能否读写本地文件夹 推荐Agent外壳(实现直接修改指定目录代码) 特点
Codex CLI(外壳) ❌外壳负责IO,模型可替换 本身就是CLI外壳 交互熟悉,可换后端模型,OpenAI生态优先
DeepSeek‑V4 ❌API无本地IO ①Codex CLI改配置;②Reasonix;③OpenCode MCP兼容,代码能力强,国内API低延迟
Kimi K3 ❌网页端不行 ①Kimi‑Code CLI(官方首选);②Codex(兼容一般) 百万上下文,原生支持视频输入,中文友好
Fable5 ❌API无本地IO ①Claude‑Code CLI(官方首选);②OpenCode/Pi 长链路多文件重构最强,MCP生态完善

通用安全要点(所有Agent都要遵守)

  1. 永远给Agent限定最小权限文件夹,不要直接给整个磁盘;MCP filesystem启动参数写死允许的目录路径。
  2. 审批策略不要无脑auto;优先on‑request,每一次文件修改、shell执行先看diff再确认执行。
  3. 项目先git提交,每次AI修改前保证有回滚快照,防止误删代码。

快速选型建议

  1. 如果你习惯Codex那套操作流:直接Codex CLI改配置切换DeepSeek‑V4,体验无缝。
  2. 用Kimi‑K3优先上Kimi‑Code CLI,少踩第三方适配坑。
  3. Fable5优先Claude‑Code CLI,MCP原生适配。
  4. 不要指望网页聊天框直接操作本地磁盘,网页环境沙箱隔离,所有本地文件操作都需要本地运行的CLI Agent程序。

如果你需要,我可以直接给你一份可复制的Codex config.toml模板,分别适配DeepSeek‑V4、Kimi K3;或者给Windows下一键启动MCP filesystem的配置。

Agent(AI智能体)通俗讲明白

结合你前面玩的 Codex‑CLI、Kimi‑Code、MCP,别被名词唬住,Agent不是某种大模型,它是一套“大模型 + 工具 + 循环逻辑”的执行外壳

一句话定义

大模型 = 大脑(只会思考、写文字,摸不到你的电脑)
Agent = 手脚+调度逻辑,帮大脑去真实世界干活:读文件、改代码、跑命令、调用接口,再把结果还给大脑继续思考

大模型本身只是API,接收文字、输出文字,沙箱隔离,碰不到本地硬盘、不能执行命令
你让它:“把src下面所有接口统一改成新格式”。
纯模型只能输出一段文字告诉你怎么改;
Agent会真的打开文件夹,读一堆.ts,批量修改,保存到磁盘,跑完git diff,把结果反馈回去。

Agent核心三件套(缺一不可)

  1. LLM大脑:DeepSeek‑V4 / Kimi‑K3 / Fable5,负责思考、规划任务,判断现在该干什么。
  2. **工具集(Tools)**:读写本地文件、运行shell命令、git操作、MCP服务、访问网络。
  3. 循环调度(最关键):思考 → 调用工具 → 获取结果 → 再思考,循环直到任务做完。

模拟一遍 Codex‑CLI Agent 的完整循环

用户输入:把这个项目的端口改成8081

  1. Agent把你的需求 + 当前目录文件列表丢给大模型(大脑)
  2. 大模型思考:应该读取config.js,修改port字段
  3. Agent接收模型输出的工具调用指令read_file(path="./config.js")
  4. Agent(本地程序)真正在你电脑上打开这个文件,把文件内容拿回来
  5. 再把文件内容喂回大模型:拿到修改后的代码
  6. 模型输出工具指令:write_file(path="./config.js", content="新内容")
  7. Agent请求你确认(on‑request审批策略),你回车允许
  8. Agent把代码真实写入磁盘
  9. Agent执行git diff拿到改动,把结果丢回大模型,告诉用户任务完成

👉 大模型全程没有碰磁盘,全部是Agent本地程序完成IO。

区分容易混淆概念(对应你前面工具)

东西 属于什么 角色
DeepSeek‑V4 / Kimi‑K3 / Fable5 大模型LLM(大脑) 只思考输出文本,不能操作电脑
Codex‑CLI / Kimi‑Code / Claude‑Code Agent客户端程序 Agent本体,可以换上面任意模型当大脑
MCP‑filesystem Agent的工具插件 给Agent增加“安全读写文件夹”的手脚

误区:很多人以为Codex是模型。Codex‑CLI是Agent程序;早年OpenAI有个叫Codex的代码模型,现在已经废弃。现在大家说的codex就是那个本地Agent命令行工具。

Agent的两种形态

  1. CLI终端Agent(你在用的):Codex、kimi‑code、claude‑code,跑在你电脑终端,可以操作本地项目文件夹。受approval_policy控制,工具调用需要审批。
  2. 网页端Agent:网页版Kimi/DeepSeek的“智能体模式”。网页Agent手脚在服务商服务器,访问不到你电脑本地文件,只能上传文件。

    所以网页聊天框永远不能直接改你D盘的代码文件。

安全关键点(非常重要)

Agent有手脚,就有破坏力:可以删文件、跑shell。

  • approval_policy = on‑request:每一步手脚干活都问你,最安全。
  • approval_policy = auto:Agent自己随便读写文件跑命令,省事但是有风险。
  • MCP filesystem:强制限定允许访问的文件夹,Agent手脚被锁死在指定目录,不能乱跑读取你其它隐私文档。

类比生活化记忆

  • LLM大模型:一个绝顶聪明,但手被绑住的程序员,只能嘴上告诉你怎么改代码
  • Agent:给他配上双手,同时配一个监工(审批策略/MCP权限),让他按指令去改硬盘上真实代码;监工可以限制他只能碰哪个文件夹,每动一次手要问过你。

补充:普通聊天 vs Agent聊天

普通聊天:一轮提问一轮回答,到此结束。
Agent聊天:多轮闭环,模型发现需要读文件,就叫Agent去读,拿到内容继续处理,自动循环,直到任务完成。

如果你想,我可以简单讲下 MCP 和 Agent 的关系,MCP就是Agent标准化的“工具接口协议”。

Codex CLI config.toml 完整模板

文件位置:

  • Windows:%USERPROFILE%\.codex\config.toml
    直接在资源管理器地址栏粘贴 %USERPROFILE%\.codex 打开目录,没有就新建 config.toml

⚠️注意:Codex CLI 的 approval_policy、sandbox,第三方模型不是100%完美;Kimi K3工具调用偶尔会错乱,DeepSeek‑V4稳定性更好。
API key 填自己的,不要把密钥上传到任何地方。

① 适配 DeepSeek‑V4‑Pro 完整 config.toml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# ~/.codex/config.toml
model = "deepseek-v4-pro"
base_url = "https://api.deepseek.com/v1"
api_key = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 工作区沙箱:仅允许修改当前cd进入的文件夹,禁止访问磁盘其他位置
sandbox_mode = "workspace-write"

# on‑request = 每次修改文件/执行shell需要你手动确认;auto自动执行;reject全部拒绝
approval_policy = "on-request"

# 最大上下文,deepseek支持很大,不要拉满
max_context_tokens = 128000

# 关闭openai原生特性,第三方模型不需要
enable_browser = false
enable_artifacts = false

# shell命令白名单,按需开启
shell_allowlist = ["ls", "dir", "cat", "type", "git", "grep", "find"]
shell_blocklist = ["rm -rf", "del /f /s /q", "format", "rd /s"]

② 适配 Kimi‑K3(moonshot)config.toml

提醒:Kimi 在 codex cli 下工具调用偶发异常,优先还是官方 kimi-code;这里仅做可用版本

1
2
3
4
5
6
7
8
9
10
11
12
13
model = "kimi-k3"
base_url = "https://api.moonshot.cn/v1"
api_key = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

sandbox_mode = "workspace-write"
approval_policy = "on-request"
max_context_tokens = 200000

enable_browser = false
enable_artifacts = false

shell_allowlist = ["ls", "dir", "cat", "type", "git", "grep"]
shell_blocklist = ["rm -rf", "del /f /s /q", "format", "rd /s"]

使用步骤

  1. 修改好 api_key;
  2. 打开终端 cd D:/mycode/projectA 进入你的目标项目文件夹;
  3. 执行:
    1
    2
    codex init
    codex
    之后就可以自然语言让它修改当前目录下代码。

Windows MCP‑filesystem 一键配置(用于 Roo‑Code / Claude‑Code)

MCP filesystem:严格限制 AI 只能访问你写死的文件夹路径,不能访问磁盘其他目录。
这个配置是 json,文件名:mcp_config.json,可以放在项目根目录。

1
2
3
4
5
6
7
8
9
10
11
12
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"D:\\mycode\\projectA"
]
}
}
}

⚠️Windows路径注意:用双反斜杠 D:\\mycode\\projectA,不要写单斜杠。
多个允许访问文件夹就继续追加参数:

1
2
3
4
5
6
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"D:\\mycode\\projectA",
"D:\\mycode\\projectB"
]

前提环境

本地装好 Node.js,npx 命令可用。

1
2
node -v
npx -v

重要避坑提醒

  1. Codex CLI 切换第三方模型时,部分内置高级工具(网页浏览等)会失效,属于正常现象,只保留文件读写+shell。
  2. sandbox_mode = "workspace‑write":codex 会强制限定工作目录;但第三方模型兼容问题,不要把根目录 C:\\ 作为工作目录
  3. 安全:永远用 approval_policy = "on‑request",不要直接 auto;修改前项目做好 git commit。
  4. Fable5 不建议塞进 codex,直接用 claude‑code + 上面这份 mcp_config.json,体验远好于套 codex。

如果你需要,我可以给你一份 powershell 的小脚本,一键切换 codex 在 deepseek‑v4 / kimi‑k3 两套配置之间切换。


文章作者: 花粱
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 花粱 !
  目录