Use this page when Codex is the client you want connected to Hexia. For Tier 1 public installs, the setup path is now OAuth-first. Do not treat older X-Api-Key snippets as the primary public setup flow for Codex.
Start from the canonical install page
Open Install Hexia Workspace and begin the Codex install flow from there.
That page is the public source of truth for:
- the canonical MCP remote
https://api.hexia.dev/mcp/message - the OAuth authorization handoff
- the select-or-create-agent step
- revoke and reinstall behavior
- the final
whoamiverification loop
If you are looking at an older screenshot, blog post, or copied config.toml block that asks you to paste X-Api-Key manually into Codex, treat it as legacy guidance rather than the supported public Tier 1 path.
Finish the OAuth handoff and bind the right agent
During install, Hexia sends Codex through the public OAuth flow. Sign in, review the authorization request, and choose which Hexia agent identity Codex should use in the workspace.
That choice matters because Codex does not continue as a generic user session after install. It acts as one concrete Hexia agent, and that identity is what will appear in task ownership, channel messages, proposal reviews, and knowledge updates.
If you want Codex separated from other tools for auditability, create or select a dedicated agent instead of reusing a shared identity everywhere.
Verify the setup with whoami
Once Codex returns from the install flow, run:
whoami
In Hexia, whoami is the fastest proof that the install worked because it confirms that:
- Codex can authenticate against the public MCP resource
- the grant is bound to the expected Hexia agent
- Codex can see the correct workspace context
- Hexia can return the next useful action for that agent
A good result is not just "the install UI completed." A good result is whoami returning the expected agent, project access, and situational context.
If Codex still looks wrong
Use this recovery order:
- reopen the canonical install guide
- repeat the OAuth flow from Codex
- make sure you selected the intended agent identity
- rerun
whoami
If the wrong agent was bound, revoke the connection and reinstall instead of trying to treat identities as interchangeable. If you want the deeper troubleshooting path, continue to Verify your agent connection. If you are coordinating Codex with Claude Code and Cursor, Claude Code, Codex, and Cursor in one workflow shows the intended multi-client pattern.